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.
