Laravel Carbon Macros

Laravel Carbon Macros is a handy collection of Carbon date helper macros for Laravel projects by Dan Soppelsa. It provides country-specific important dates for the US, Canda, Brazil, and Ukraine:

$carbon = new Illuminate\Support\Carbon;
 
// US date examples
$instance->isNewYearsDay();
$instance->isIndependenceDay();
$instance->isAmericanThanksgiving();
 
// CA date examples
$instance->isBoxingDay();
$instance->isCanadianThanksgiving();
$instance->isRemembranceDay();
 
// Brazil examples
$instance->isTiradentesDay();
$instance->isBrazilianIndependenceDay();
 
// Ukraine examples
$instance->isUkrainianIndependenceDay();
$instance->isKupalaNight();

Here’s the complete list of macros provided at the time of writing:

#US Dates

• isNewYearsDay
• isMlkJrDay
• isPresidentsDay
• isGoodFriday
• isEasterSunday
• isMemorialDay
• isIndependenceDay
• isLaborDay
• isColumbusDay
• isVeteransDay
• isAmericanThanksgiving
• isChristmasDay
• isNewYearsEve

#Canadian Dates

• isNewYearsDay
• isFamilyDay
• isGoodFriday
• isEasterSunday
• isVictoriaDay
• isCanadaDay
• isCivicHoliday
• isLabourDay
• isCanadianThanksgiving
• isRemembranceDay
• isChristmasDay
• isBoxingDay
• isNewYearsEve

#Brazilian Dates

• isBrazilianIndependenceDay
• isBrazilianLaborDay
• isBrazilianRepublicProclamationDay
• isTheDayOfOurLadyAparecida
• isTiradentesDay

#Ukrainian Dates

• isKupalaNight
• isUkraineDefenderDay
• isUkrainianConstitutionDay
• isUkrainianIndependenceDay
• isUkrainianLabourDay
• isVictoryDayOverNazism

These macros are automatically registered in Laravel projects from the package’s service provider. It’s unclear if the author has planned adding other countries or is open to pull requests for additional countries. This package is an excellent reminder that Carbon provides macros you can use to create more readable code around your dates that might not ship out-of-the-box with Carbon.

#Learn More

You can learn more about this package, get full installation instructions, and view the source code on GitHub. If you’re interested in adding another country, I’d suggest checking out the package’s Traits folder that contains dates for Brazil and Ukraine.