PHP code example of geoffreyrose / useful-dates-us-holidays

1. Go to this page and download the library: Download geoffreyrose/useful-dates-us-holidays library. Choose the download type require.

2. Extract the ZIP file and open the index.php.

3. Add this code to the index.php. 
    
        
<?php
require_once('vendor/autoload.php');

/* Start to develop here. Best regards https://php-download.com/ */

geoffreyrose / useful-dates-us-holidays example snippets


use UsefulDates\UsefulDates;

...

$usefulDates = new UsefulDates;
$usefulDates = $usefulDates->setDate(\Carbon\Carbon::create(2000, 4, 1))
$usefulDates->addExtension(\UsefulDatesUsHolidays\UsefulDatesUsHolidaysExtension::class);

$myDates = $usefulDates->getUsefulDatesInDays(100);

// Or
// $myDates = $usefulDates->getUsefulDatesByYear() // Uses current year set in UsefulDates with setDate();
// $myDates = $usefulDates->getUsefulDatesByYear(2026);
// $myDates = $usefulDates->getUsefulDatesInYears(2);

foreach ($myDates as $myDate) {
   echo $myDate->name . ' -- ' . $myDate->usefulDate()->format('F n, Y') . ' -- Days Away: ' . $myDate->daysAway();
}


use UsefulDates\UsefulDates;

...

$usefulDates = new UsefulDates;
$usefulDates = $usefulDates->setDate(\Carbon\Carbon::now());
$usefulDates->addExtension(\UsefulDatesUsHolidays\UsefulDatesUsHolidaysExtension::class, [
    '

$usefulDates = new UsefulDates;
$usefulDates = $usefulDates->setDate(\Carbon\Carbon::parse('2026-01-01')); // New Year's Day (Thursday)
$usefulDates->addExtension(\UsefulDatesUsHolidays\UsefulDatesUsHolidaysExtension::class);

if ($usefulDates->isBankHoliday()) {
    echo "Banks are closed today!";
}


$usefulDates = new UsefulDates;
$usefulDates = $usefulDates->setDate(\Carbon\Carbon::parse('2026-07-03')); // July 4th observed (Friday)
$usefulDates->addExtension(\UsefulDatesUsHolidays\UsefulDatesUsHolidaysExtension::class);

if ($usefulDates->isFederalHoliday()) {
    echo "Federal offices are closed today!";
}


$usefulDates = new UsefulDates;
$usefulDates = $usefulDates->setDate(\Carbon\Carbon::parse('2026-12-25'));
$usefulDates->addExtension(\UsefulDatesUsHolidays\UsefulDatesUsHolidaysExtension::class);

$dates = $usefulDates->getUsefulDate();
foreach ($dates as $date) {
    echo $date->name; // "Christmas Day"
}


$usefulDates = new UsefulDates;
$usefulDates = $usefulDates->setDate(\Carbon\Carbon::now());
$usefulDates->addExtension(\UsefulDatesUsHolidays\UsefulDatesUsHolidaysExtension::class);

$holidays2026 = $usefulDates->getUsefulDatesByYear(2026);


$usefulDates = new UsefulDates;
$usefulDates = $usefulDates->setDate(\Carbon\Carbon::parse('2026-01-19'));
$usefulDates->addExtension(\UsefulDatesUsHolidays\UsefulDatesUsHolidaysExtension::class);

$dates = $usefulDates->getUsefulDate();
foreach ($dates as $date) {
    echo $date->name; // "Martin Luther King Jr. Day"
    echo $date->is_federal_holiday; // true
    echo $date->federal_holiday_start_year; // 1986
}

bash
./vendor/bin/phpstan analyse src --memory-limit 2G