Laravel Carbon Macros

News

December 10th, 2020

laravel-calendar-expiration-featured.png

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:

1$carbon = new Illuminate\Support\Carbon;
2 
3// US date examples
4$instance->isNewYearsDay();
5$instance->isIndependenceDay();
6$instance->isAmericanThanksgiving();
7 
8// CA date examples
9$instance->isBoxingDay();
10$instance->isCanadianThanksgiving();
11$instance->isRemembranceDay();
12 
13// Brazil examples
14$instance->isTiradentesDay();
15$instance->isBrazilianIndependenceDay();
16 
17// Ukraine examples
18$instance->isUkrainianIndependenceDay();
19$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.

Filed in:

Paul Redmond

Full stack web developer. Author of Lumen Programming Guide and Docker for PHP Developers.

Laravel News Partners