News

Laravel Carbon Macros

Published
Laravel Carbon Macros image

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.

Paul Redmond photo

Staff writer at Laravel News. Full stack web developer and author.

Filed in

Sponsored

serpapi logo
SerpApi

The Web Search API for Your LLM and AI Applications

Visit SerpApi

The latest

View all →
PHP 8.6 is released!  image

PHP 8.6 is released!

Read article
Laravel Warrant: Row-Level Permissions With Eloquent image

Laravel Warrant: Row-Level Permissions With Eloquent

Read article
JSON Schema Validation Rules and a RetryFor Attribute in Laravel 13.43 image

JSON Schema Validation Rules and a RetryFor Attribute in Laravel 13.43

Read article
Durable Workflow: Long-Running Workflows for Laravel image

Durable Workflow: Long-Running Workflows for Laravel

Read article
Session Replay for Laravel: Self-Hosted Browser Recordings image

Session Replay for Laravel: Self-Hosted Browser Recordings

Read article
Laravel AI SDK 1.4 Lets Agents Recover From Tool Failures image

Laravel AI SDK 1.4 Lets Agents Recover From Tool Failures

Read article