Documentation For U.S. Holidays PHP Carbon Wrapper

U.S. Holidays Wrapper for the Carbon DateTime Library. Adds support for 42 holidays

See on Github

Supported Holidays

• April Fool's Day
• Armed Forces Day
• Ash Wednesday
• Black Friday
• Christmas Day
• Christmas Eve
• Cinco de Mayo
• Columbus Day
• Cyber Monday
• Daylight Saving (End)
• Daylight Saving (Start)
• Earth Day
• Easter
• Father's Day
• Flag Day
• Good Friday
• Groundhog Day
• Halloween
• Hanukkah
• Independence Day
• Indigenous Peoples' Day
• Juneteenth
• Kwanzaa
• Labor Day
• Martin Luther King Jr. Day
• Memorial Day
• Mother's Day
• New Year's Day
• New Year's Eve
• Orthodox Easter
• Palm Sunday
• Passover
• Patriot Day
• Pearl Harbor Remembrance Day
• Presidents' Day
• Rosh Hashanah
• St. Patrick's Day
• Tax Day
• Thanksgiving
• Valentine's Day
• Veterans Day
• Yom Kippur

How To Use Use With Composer

$ composer require geoffreyrose/us-holidays

require 'vendor/autoload.php';
use USHolidays\Carbon;

$holidays = new Carbon();

How To Use Use Without Composer

require 'path/to/nesbot/Carbon.php';
require 'path/to/geoffreyrose/Carbon.php';

use USHolidays\Carbon;

$holidays = new Carbon();

Utilities

addHoliday()

Add your own holiday

$holidays = new Carbon();
$holidays->addHoliday([
    'name' => "Spongebob's Birthday",
    'date' => Carbon::create(1986, 7, 14),
    'bank_holiday' => false
]);

$holidays = new Carbon();
$holidays->addHoliday([
    'name' => "Q1 Tax Payments",
    'date' => function() use($holidays) {
        $q1 = Carbon::create($holidays->year, 4, 15, 0, 0, 0);
        if($q1->isBankHoliday()) {
            $q1->addDay();

            if($q1->isWeekend()) {
                $q1->next(Carbon::MONDAY);
            }
        }

        if($q1->isWeekend()) {
            $q1->next(Carbon::MONDAY);
        }

        if($q1 < $holidays) {
            $q1 = Carbon::create($holidays->year + 1, 4, 15, 0, 0, 0);

            if($q1->isBankHoliday()) {
                $q1->addDay();

                if($q1->isWeekend()) {
                    $q1->next(Carbon::MONDAY);
                }
            }

            if($q1->isWeekend()) {
                $q1->next(Carbon::MONDAY);
            }
        }

        if($q1->isBankHoliday()) {
            $q1->addDay();
        }

        return $q1;
    },
    'bank_holiday' => false
]);

setHolidays()

Set which holidays you want to use. By default will use all holidays.

setHolidays(array : $holidays)

$holiday = Carbon::create(2020, 1, 1);
$holiday->setHolidays(['April Fools']);

// the only holiday that will be used is April Fools Day

getHolidaysByYear()

Get holidays for the current year of the Carbon object.

getHolidaysByYear(string|array $name, int $year=null) : array : object

$carbon = Carbon::create(2020, 1, 1);
$holidays = $carbon->getHolidaysByYear('all');

// [
//     {
//         "name": "New Year's Day", // string
//         "date": "2020-01-01 00:00:00", // Carbon object
//         "bank_holiday": true, // boolean
//         "days_away": 0, // int
//     },
//     {
//     	"name": "Martin Luther King Jr. Day", // string
//     	"date": "2020-01-20 00:00:00", // Carbon object
//     	"bank_holiday": true, // boolean
//     	"days_away": 19 // int
//     }
//     ...
// ]

foreach ($holidays as $holiday) {
    echo $holiday->name . '<br>' . $holiday->date . '<br>' . $holiday->days_away . '<br><br>';
}

$carbon = Carbon::create(2020, 1, 1);
$holidays = $carbon->getHolidaysByYear('all', 1999);

// [
//     ...
//     {
//         "name": "April Fool's Day", // string
//         "date": "1999-04-01 00:00:00", // Carbon object
//         "bank_holiday": false, // boolean
//         "days_away": 7580 // int
//     }
//     ...
// ]

$carbon = Carbon::create(2020, 3, 8);
$holidays = $carbon->getHolidaysByYear(["Christmas Day", "Easter", "Independence Day"]);

// [
//     {
//     	"name": "Easter", // string
//     	"date": "2020-04-12 00:00:00", // Carbon object
//     	"bank_holiday": false, // boolean
//     	"days_away": 35 // int
//     }, {
//     	"name": "Independence Day", // string
//     	"date": "2020-07-04 00:00:00", // Carbon object
//     	"bank_holiday": true, // boolean
//     	"days_away": 118 // int
//     }, {
//     	"name": "Christmas Day", // string
//     	"date": "2020-12-25 00:00:00", // Carbon object
//     	"bank_holiday": true, // boolean
//     	"days_away": 292 // int
//     }
// ]

$carbon = Carbon::create(2020, 3, 8);
$holidays = $carbon->getHolidaysByYear(["Christmas Day", "Easter", "Independence Day"], 2024);

// [
//     {
//     	"name": "Easter", // string
//     	"date": "2024-03-31 00:00:00", // Carbon object
//     	"bank_holiday": false, // boolean
//     	"days_away": 1484 // int
//     }, {
//     	"name": "Independence Day", // string
//     	"date": "2024-07-04 00:00:00", // Carbon object
//     	"bank_holiday": true, // boolean
//     	"days_away": 1579 // int
//     }, {
//     	"name": "Christmas Day", // string
//     	"date": "2024-12-25 00:00:00", // Carbon object
//     	"bank_holiday": true, // boolean
//     	"days_away": 1753 // int
//     }
// ]

getHolidaysInDays()

Get holidays in the next amount of days. To only check for certain holidays pass either a string or array of names to $holidays

getHolidaysInDays(int $days, string|array $holidays=null) : array : object

$carbon = Carbon::create(2020, 5, 28);

$holidays = $carbon->getHolidaysInDays(300, 'all');
// or
$holidays = $carbon->getHolidaysInDays(300);

// [
//     {
//         "name": "Flag Day", // string
//         "date": "2020-06-14 00:00:00", // Carbon object
//         "bank_holiday": false, // boolean
//         "days_away": 17 // int
//     }, {
//         "name": "Juneteenth", // string
//         "date": "2020-06-19 00:00:00", // Carbon object
//         "bank_holiday": false, // boolean
//         "days_away": 22 // int
//     },
//     ...
// ]

foreach ($holidays as $holiday) {
    echo $holiday->name . '<br>' . $holiday->date . '<br>' . $holiday->days_away . '<br><br>';
}

$carbon = Carbon::create(2020, 5, 28);
$holidays = $carbon->getHolidaysInDays(300, ["Christmas Day", "Easter", "Independence Day"]);

// [
//     {
//     	"name": "Independence Day", // string
//     	"date": "2020-07-04 00:00:00", // Carbon object
//     	"bank_holiday": true, // boolean
//     	"days_away": 37 // int
//     }, {
//     	"name": "Christmas Day", // string
//     	"date": "2020-12-25 00:00:00", // Carbon object
//     	"bank_holiday": true, // boolean
//     	"days_away": 211 // int
//     }
//
//
//     // notice how easter is on 2020-04-12 and not returned because it is not in the next 300 days
// ]

getHolidaysInYears()

Get holidays in the next amount of years. To only check for certain holidays pass either a string or array of names to $holidays

getHolidaysInYears(int $years, string|array $holidays=null) : array : object

$carbon = Carbon::create(2020, 8, 18);

$holidays = $carbon->getHolidaysInYears(1, 'all');
// or
$holidays = $carbon->getHolidaysInYears(1);

// [
//     {
//     	"name": "Labor Day", // string
//     	"date": "2020-09-07 00:00:00", // Carbon object
//     	"bank_holiday": true,// boolean
//     	"days_away": 20 // int
//     }, {
//     	"name": "Patriot Day", // string
//     	"date": "2020-09-11 00:00:00", // Carbon object
//     	"bank_holiday": false, // boolean
//     	"days_away": 24 // int
//     },
//     ...
// ]

foreach ($holidays as $holiday) {
    echo $holiday->name . '<br>' . $holiday->date . '<br>' . $holiday->days_away . '<br><br>';
}

$carbon = Carbon::create(2020, 8, 18);
$holidays = $carbon->getHolidaysInYears(2, ["Christmas Day", "Easter", "Independence Day"]);

// [
//     {
//     	"name": "Christmas Day", // string
//     	"date": "2020-12-25 00:00:00", // Carbon object
//     	"bank_holiday": true, // boolean
//     	"days_away": 129 // int
//     }, {
//     	"name": "Easter", // string
//     	"date": "2021-04-04 00:00:00", // Carbon object
//     	"bank_holiday": false, // boolean
//     	"days_away": 229 // int
//     }, {
//     	"name": "Independence Day", // string
//     	"date": "2021-07-04 00:00:00", // Carbon object
//     	"bank_holiday": true, // boolean
//     	"days_away": 320 // int
//     }, {
//     	"name": "Christmas Day", // string
//     	"date": "2021-12-25 00:00:00", // Carbon object
//     	"bank_holiday": true, // boolean
//     	"days_away": 494 // int
//     }, {
//     	"name": "Easter", // string
//     	"date": "2022-04-17 00:00:00", // Carbon object
//     	"bank_holiday": false, // boolean
//     	"days_away": 607 // int
//     }, {
//     	"name": "Independence Day", // string
//     	"date": "2022-07-04 00:00:00", // Carbon object
//     	"bank_holiday": true, // boolean
//     	"days_away": 685 // int
//     }
// ]

isHoliday()

Check if date is holiday. Returns boolean

isHoliday() : boolean

$carbon = Carbon::create(2020, 1, 1);
$carbon->isHoliday(); // true

$carbon = Carbon::create(2020, 1, 2);
$carbon->isHoliday(); // false

setBankHolidays()

Set which holidays are bank holidays. Defaults are all standard bank holidays.

setBankHolidays(array : $holidays)

$holiday->setBankHolidays(['April Fools']);

// April Fools Day is now the only bank holiday

isBankHoliday()

Check if date is a Bank Holiday and the day it is observed on. I.E. if the holiday falls if a holiday falls on Sunday, the holiday is observed the next day (Monday). Note: Bank holidays are Monday - Friday Only. Holidays that are always on weekends are not consider bank holidays. Also holidays that are Bank Holidays but fall on Saturday are NOT observed on the previous Friday. Returns boolean

Does not work if you override BusinessDays with setBusinessDays()

isBankHoliday() : boolean

$carbon = Carbon::create(2020, 1, 1); // New Years Day - Wednesday
$carbon->isBankHoliday(); // boolean (true)

$carbon = Carbon::create(2020, 1, 2);
$carbon->isBankHoliday(); // boolean (false)

$carbon = Carbon::create(2018, 03, 17); // St Patrick's Day
$carbon->isBankHoliday(); // boolean (false)

$carbon = Carbon::create(2018, 12, 25); // Christmas - Tuesday
$carbon->isBankHoliday(); // boolean (true)

$carbon = Carbon::create(2016, 12, 25); // Christmas - Sunday
$carbon->isBankHoliday(); // boolean (false)

$carbon = Carbon::create(2016, 12, 26); // Monday
$carbon->isBankHoliday(); // boolean (true)

$carbon = Carbon::create(2021, 12, 25); // Christmas - Saturday
$carbon->isBankHoliday(); // boolean (false)

$carbon = Carbon::create(2021, 12, 24); // Friday
$carbon->isBankHoliday(); // boolean (false)

isFederalHoliday()

Check if date is a Federal Holiday and the day it is observed on. I.E. if the holiday falls on Saturday, the holiday is observed the previous day (Friday). Or if a holiday falls on Sunday, the holiday is observed the next day (Monday). Note: Federal holidays are Monday - Friday Only. Holidays that are always on weekends are not consider bank holidays. Returns boolean

Does not work if you override BusinessDays with setBusinessDays()

isFederalHoliday() : boolean

$carbon = Carbon::create(2020, 1, 1); // New Years Day - Wednesday
$carbon->isFederalHoliday(); // boolean (true)

$carbon = Carbon::create(2020, 1, 2);
$carbon->isFederalHoliday(); // boolean (false)

$carbon = Carbon::create(2018, 03, 17); // St Patrick's Day
$carbon->isFederalHoliday(); // boolean (false)

$carbon = Carbon::create(2018, 12, 25); // Christmas - Tuesday
$carbon->isFederalHoliday(); // boolean (true)

$carbon = Carbon::create(2016, 12, 25); // Christmas - Sunday
$carbon->isFederalHoliday(); // boolean (false)

$carbon = Carbon::create(2016, 12, 26); // Monday
$carbon->isFederalHoliday(); // boolean (true)

$carbon = Carbon::create(2021, 12, 25); // Christmas - Saturday
$carbon->isFederalHoliday(); // boolean (false)

$carbon = Carbon::create(2021, 12, 24); // Friday
$carbon->isFederalHoliday(); // boolean (true)

getHoliday()

Checks if the date is a holiday and will return an array of holiday(s)

getHoliday(): array

$carbon = Carbon::create(2020, 1, 1);
$carbon->getHoliday();

// [{
//    "name": "New Year's Day",
//    "date": "2020-01-01 00:00:00",
//    "bank_holiday": true,
//    "days_away": 0
// }]

$carbon = Carbon::create(2020, 1, 2);
$carbon->getHoliday();

// []

getHolidayName()

Get name if date is holiday. Returns string or false

getHolidayName() : string|false

$carbon = Carbon::create(2020, 1, 1);
$carbon->getHolidayName(); // New Year's Day

$carbon = Carbon::create(2016, 12, 26); // Monday
$carbon->getHolidayName(); // Christmas Day (Observed), Kwanzaa

getNextHolidays()

Get the next $number of holidays

getNextHolidays(int $number=1) : array : object

$carbon = Carbon::create(2020, 5, 17);
$carbon->getNextHolidays(2);

// [
//     {
//     	"name": "Memorial Day", // string
//     	"date": "2020-05-25 00:00:00", // Carbon object
//     	"bank_holiday": true,// boolean
//     	"days_away": 8 // int
//     }, {
//     	"name": "Flag Day", // string
//     	"date": "2020-06-14 00:00:00", // Carbon object
//     	"bank_holiday": false, // boolean
//     	"days_away": 28 // int
//     },
// ]

getPrevHolidays()

Get the previous $number of holidays

getPrevHolidays(int $number=1) : array : object

$carbon = Carbon::create(2020, 2, 9);
$carbon->getPrevHolidays(2);

// [
//     {
//     	"name": "Groundhog Day", // string
//     	"date": "2020-02-02 00:00:00", // Carbon object
//     	"bank_holiday": false,// boolean
//     	"days_away": 7 // int
//     }, {
//     	"name": "Martin Luther King Jr. Day", // string
//     	"date": "2020-01-20 00:00:00", // Carbon object
//     	"bank_holiday": true, // boolean
//     	"days_away": 20 // int
//     },
// ]

getNextHolidayName()

Get name of the next holiday. Returns string

getNextHolidayName() : string

$carbon = Carbon::create(2020, 6, 12);
$carbon->getNextHolidayName(); // Flag Day

getNextHolidayDays()

Get number of days away the next holiday is. Returns int

getNextHolidayDays() : int

$carbon = Carbon::create(2020, 6, 12);
$carbon->getNextHolidayDays(); // 2

getPrevHolidayName()

Get name of the previous holiday. Returns string

getPrevHolidayName() : string

$carbon = Carbon::create(2020, 11, 7);
$carbon->getPrevHolidayName(); // Daylight Saving (End)

getPrevHolidayDays()

Get number of days away the previous holiday is. Returns int

getPrevHolidayDays() : int

$carbon = Carbon::create(2020, 11, 7);
$carbon->getPrevHolidayDays(); // 6

Business Days

setBusinessDays()

Set which days are business days. Defaults to Monday - Friday. If overridden, isBankHoliday() will not work

setBusinessDays(array : $days)

$carbon = Carbon::create(2021, 1, 3);
$carbon->setBusinessDays([1,2,3]);

// Sets business days to Monday, Tuesday, Wednesday

isBusinessDay()

Check if day is business day

isBusinessDay() : boolean

$carbon = Carbon::create(2021, 1, 4); // Monday
$carbon->isBusinessDay(); // true

nextBusinessDay()

Get next business day

nextBusinessDay() : object

$carbon = Carbon::create(2021, 1, 4); // Monday
$carbon->nextBusinessDay();
// Returns Carbon object for 2021-01-05

prevBusinessDay()

Get previous business day

prevBusinessDay() : object

$carbon = Carbon::create(2021, 1, 6); // Wednesday
$carbon->prevBusinessDay();
// Returns Carbon object for 2021-01-05

currentOrNextBusinessDay()

Returns today (if business day) or the next business day

currentOrNextBusinessDay() : object

$carbon = Carbon::create(2021, 1, 4); // Monday
$carbon->currentOrNextBusinessDay();
// Returns Carbon object for 2021-01-04

$carbon = Carbon::create(2021, 1, 10); // Sunday
$carbon->currentOrNextBusinessDay();
// Returns Carbon object for 2021-01-11

currentOrPreviousBusinessDay()

Returns today (if business day) or the previous business day

currentOrPreviousBusinessDay() : object

$carbon = Carbon::create(2021, 1, 4); // Monday
$carbon->currentOrPreviousBusinessDay();
// Returns Carbon object for 2021-01-04

$carbon = Carbon::create(2021, 1, 10); // Sunday
$carbon->currentOrPreviousBusinessDay();
// Returns Carbon object for 2021-01-08

Holidays

getAprilFoolsDayHoliday()

Get April Fool's Day for the current year of the Carbon object. Optionally pass in a $year to get April Fool's Day in a given year.

getAprilFoolsDayHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getAprilFoolsDayHoliday();

// {
//    "name": "April Fool's Day",
//    "date": "2020-04-01 00:00:00",
//    "bank_holiday": false
//    "days_away": 91
// }

$holidays->name // April Fool's Day
$holidays->date->format('m-d-Y') // 04-01-2020
$holidays->days_away // 91
$holidays->bank_holiday // false

$holidays = Carbon::create(2020, 1, 1);
$holidays->getAprilFoolsDayHoliday(2022);

// {
//    "name": "April Fool's Day",
//    "date": "2022-04-01 00:00:00",
//    "bank_holiday": false
//    "days_away": 821
// }

getArmedForcesDayHoliday()

Get Armed Forces Day for the current year of the Carbon object. Optionally pass in a $year to get Armed Forces Day in a given year.

getArmedForcesDayHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getArmedForcesDayHoliday();

// {
//    "name": "Armed Forces Day",
//    "date": "2020-05-16 00:00:00",
//    "bank_holiday": false
//    "days_away": 136
// }

$holidays->name // Armed Forces Day
$holidays->date->format('m-d-Y') // 05-16-2020
$holidays->days_away // 136
$holidays->bank_holiday // false

$holidays = Carbon::create(2020, 1, 1);
$holidays->getArmedForcesDayHoliday(2022);

// {
//    "name": "Armed Forces Day",
//    "date": "2022-05-21 00:00:00",
//    "bank_holiday": false
//    "days_away": 871
// }

getAshWednesdayHoliday()

Get Ash Wednesday for the current year of the Carbon object. Optionally pass in a $year to get Ash Wednesday in a given year.

getAshWednesdayHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getAshWednesdayHoliday();

// {
//    "name": "Ash Wednesday",
//    "date": "2020-02-26 00:00:00",
//    "bank_holiday": false
//    "days_away": 56
// }

$holidays->name // Ash Wednesday
$holidays->date->format('m-d-Y') // 02-26-2020
$holidays->days_away // 56
$holidays->bank_holiday // false

$holidays = Carbon::create(2020, 1, 1);
$holidays->getAshWednesdayHoliday(2022);

// {
//    "name": "Ash Wednesday",
//    "date": "2022-03-02 00:00:00",
//    "bank_holiday": false
//    "days_away": 791
// }

getBlackFridayHoliday()

Get Black Friday for the current year of the Carbon object. Optionally pass in a $year to get Black Friday in a given year.

getBlackFridayHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getBlackFridayHoliday();

// {
//    "name": "Black Friday",
//    "date": "2020-11-27 00:00:00",
//    "bank_holiday": false
//    "days_away": 331
// }

$holidays->name // Black Friday
$holidays->date->format('m-d-Y') // 11-27-2020
$holidays->days_away // 331
$holidays->bank_holiday // false

$holidays = Carbon::create(2020, 1, 1);
$holidays->getBlackFridayHoliday(2022);

// {
//    "name": "Black Friday",
//    "date": "2022-11-25 00:00:00",
//    "bank_holiday": false
//    "days_away": 1059
// }

getChristmasDayHoliday()

Get Christmas Day for the current year of the Carbon object. Optionally pass in a $year to get Christmas Day in a given year.

getChristmasDayHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getChristmasDayHoliday();

// {
//    "name": "Christmas Day",
//    "date": "2020-12-25 00:00:00",
//    "bank_holiday": true,
//    "days_away": 359
// }

$holidays->name // Christmas Day
$holidays->date->format('m-d-Y') // 12-25-2020
$holidays->days_away // 359
$holidays->bank_holiday // true

$holidays = Carbon::create(2020, 1, 1);
$holidays->getChristmasDayHoliday(2022);

// {
//    "name": "Christmas Day",
//    "date": "2022-12-25 00:00:00",
//    "bank_holiday": true,
//    "days_away": 1089
// }

getChristmasEveHoliday()

Get Christmas Eve for the current year of the Carbon object. Optionally pass in a $year to get Christmas Eve in a given year.

getChristmasEveHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getChristmasEveHoliday();

// {
//    "name": "Christmas Eve",
//    "date": "2020-12-24 00:00:00",
//    "bank_holiday": false
//    "days_away": 358
// }

$holidays->name // Christmas Eve
$holidays->date->format('m-d-Y') // 12-24-2020
$holidays->days_away // 358
$holidays->bank_holiday // false

$holidays = Carbon::create(2020, 1, 1);
$holidays->getChristmasEveHoliday(2022);

// {
//    "name": "Christmas Eve",
//    "date": "2022-12-24 00:00:00",
//    "bank_holiday": false
//    "days_away": 1088
// }

getCincoDeMayoHoliday()

Get Cinco de Mayo for the current year of the Carbon object. Optionally pass in a $year to get Cinco de Mayo in a given year.

getCincoDeMayoHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getCincoDeMayoHoliday();

// {
//    "name": "Cinco de Mayo",
//    "date": "2020-05-05 00:00:00",
//    "bank_holiday": false
//    "days_away": 125
// }

$holidays->name // Cinco de Mayo
$holidays->date->format('m-d-Y') // 05-05-2020
$holidays->days_away // 125
$holidays->bank_holiday // false

$holidays = Carbon::create(2020, 1, 1);
$holidays->getCincoDeMayoHoliday(2022);

// {
//    "name": "Cinco de Mayo",
//    "date": "2022-05-05 00:00:00",
//    "bank_holiday": false
//    "days_away": 855
// }

getColumbusDayHoliday()

Get Columbus Day for the current year of the Carbon object. Optionally pass in a $year to get Columbus Day in a given year.

getColumbusDayHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getColumbusDayHoliday();

// {
//    "name": "Columbus Day",
//    "date": "2020-10-12 00:00:00",
//    "bank_holiday": true,
//    "days_away": 285
// }

$holidays->name // Columbus Day
$holidays->date->format('m-d-Y') // 10-12-2020
$holidays->days_away // 285
$holidays->bank_holiday // true

$holidays = Carbon::create(2020, 1, 1);
$holidays->getColumbusDayHoliday(2022);

// {
//    "name": "Columbus Day",
//    "date": "2022-10-10 00:00:00",
//    "bank_holiday": true,
//    "days_away": 1013
// }

getCyberMondayHoliday()

Get Cyber Monday for the current year of the Carbon object. Optionally pass in a $year to get Cyber Monday in a given year.

getCyberMondayHoliday(int $year=null) : object

getCyberMondayHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getCyberMondayHoliday();

// {
//    "name": "Cyber Monday",
//    "date": "2020-11-30 00:00:00",
//    "bank_holiday": false
//    "days_away": 334
// }

$holidays->name // Cyber Monday
$holidays->date->format('m-d-Y') // 11-30-2020
$holidays->days_away // 334
$holidays->bank_holiday // false

$holidays = Carbon::create(2020, 1, 1);
$holidays->getCyberMondayHoliday(2022);

// {
//    "name": "Cyber Monday",
//    "date": "2022-11-28 00:00:00",
//    "bank_holiday": false
//    "days_away": 1062
// }

getDaylightSavingEndHoliday()

Get Daylight Saving (End) for the current year of the Carbon object. Optionally pass in a $year to get Daylight Saving (End) in a given year.

getDaylightSavingEndHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getDaylightSavingEndHoliday();

// {
//    "name": "Daylight Saving (End)",
//    "date": "2020-11-01 00:00:00",
//    "bank_holiday": false
//    "days_away": 305
// }

$holidays->name // Daylight Saving (End)
$holidays->date->format('m-d-Y') // 11-01-2020
$holidays->days_away // 305
$holidays->bank_holiday // false

$holidays = Carbon::create(2020, 1, 1);
$holidays->getDaylightSavingEndHoliday(2022);

// {
//    "name": "Daylight Saving (End)",
//    "date": "2022-11-06 00:00:00",
//    "bank_holiday": false
//    "days_away": 1040
// }

getDaylightSavingStartHoliday()

Get Daylight Saving (Start) for the current year of the Carbon object. Optionally pass in a $year to get Daylight Saving (Start) in a given year.

getDaylightSavingStartHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getDaylightSavingStartHoliday();

// {
//    "name": "Daylight Saving (Start)",
//    "date": "2020-03-08 00:00:00",
//    "bank_holiday": false
//    "days_away": 67
// }

$holidays->name // Daylight Saving (Start)
$holidays->date->format('m-d-Y') // 03-08-2020
$holidays->days_away // 67
$holidays->bank_holiday // false

$holidays = Carbon::create(2020, 1, 1);
$holidays->getDaylightSavingStartHoliday(2022);

// {
//    "name": "Daylight Saving (Start)",
//    "date": "2022-03-13 00:00:00",
//    "bank_holiday": false
//    "days_away": 802
// }

getEarthDayHoliday()

Get Earth Day for the current year of the Carbon object. Optionally pass in a $year to get Earth Day in a given year.

getEarthDayHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getEarthDayHoliday();

// {
//    "name": "Earth Day",
//    "date": "2020-04-22 00:00:00",
//    "bank_holiday": false
//    "days_away": 112
// }

$holidays->name // Earth Day
$holidays->date->format('m-d-Y') // 04-22-2020
$holidays->days_away // 112
$holidays->bank_holiday // false

$holidays = Carbon::create(2020, 1, 1);
$holidays->getEarthDayHoliday(2022);

// {
//    "name": "Earth Day",
//    "date": "2022-04-22 00:00:00",
//    "bank_holiday": false
//    "days_away": 842
// }

getEasterHoliday()

Get Easter for the current year of the Carbon object. Optionally pass in a $year to get Easter in a given year.

getEasterHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getEasterHoliday();

// {
//    "name": "Easter",
//    "date": "2020-04-12 00:00:00",
//    "bank_holiday": false
//    "days_away": 102
// }

$holidays->name // Easter
$holidays->date->format('m-d-Y') // 04-12-2020
$holidays->days_away // 102
$holidays->bank_holiday // false

$holidays = Carbon::create(2020, 1, 1);
$holidays->getEasterHoliday(2022);

// {
//    "name": "Easter",
//    "date": "2022-04-17 00:00:00",
//    "bank_holiday": false
//    "days_away": 837
// }

getFathersDayHoliday()

Get Father's Day for the current year of the Carbon object. Optionally pass in a $year to get Father's Day in a given year.

getFathersDayHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getFathersDayHoliday();

// {
//    "name": "Father's Day",
//    "date": "2020-06-21 00:00:00",
//    "bank_holiday": false
//    "days_away": 172
// }

$holidays->name // Father's Day
$holidays->date->format('m-d-Y') // 06-21-2020
$holidays->days_away // 172
$holidays->bank_holiday // false

$holidays = Carbon::create(2020, 1, 1);
$holidays->getFathersDayHoliday(2022);

// {
//    "name": "Father's Day",
//    "date": "2022-06-19 00:00:00",
//    "bank_holiday": false
//    "days_away": 900
// }

getFlagDayHoliday()

Get Flag Day for the current year of the Carbon object. Optionally pass in a $year to get Flag Day in a given year.

getFlagDayHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getFlagDayHoliday();

// {
//    "name": "Flag Day",
//    "date": "2020-06-14 00:00:00",
//    "bank_holiday": false
//    "days_away": 165
// }

$holidays->name // Flag Day
$holidays->date->format('m-d-Y') // 06-14-2020
$holidays->days_away // 165
$holidays->bank_holiday // false

$holidays = Carbon::create(2020, 1, 1);
$holidays->getFlagDayHoliday(2022);

// {
//    "name": "Flag Day",
//    "date": "2022-06-14 00:00:00",
//    "bank_holiday": false
//    "days_away": 895
// }

getGoodFridayHoliday()

Get Good Friday for the current year of the Carbon object. Optionally pass in a $year to get Good Friday in a given year.

getGoodFridayHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getGoodFridayHoliday();

// {
//    "name": "Good Friday",
//    "date": "2020-04-10 00:00:00",
//    "bank_holiday": false
//    "days_away": 100
// }

$holidays->name // Good Friday
$holidays->date->format('m-d-Y') // 04-10-2020
$holidays->days_away // 100
$holidays->bank_holiday // false

$holidays = Carbon::create(2020, 1, 1);
$holidays->getGoodFridayHoliday(2022);

// {
//    "name": "Good Friday",
//    "date": "2022-04-15 00:00:00",
//    "bank_holiday": false
//    "days_away": 835
// }

getGroundhogDayHoliday()

Get Groundhog Day for the current year of the Carbon object. Optionally pass in a $year to get Groundhog Day in a given year.

getGroundhogDayHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getGroundhogDayHoliday();

// {
//    "name": "Groundhog Day",
//    "date": "2020-02-02 00:00:00",
//    "bank_holiday": false
//    "days_away": 32
// }

$holidays->name // Groundhog Day
$holidays->date->format('m-d-Y') // 02-02-2020
$holidays->days_away // 32
$holidays->bank_holiday // false

$holidays = Carbon::create(2020, 1, 1);
$holidays->getGroundhogDayHoliday(2022);

// {
//    "name": "Groundhog Day",
//    "date": "2022-02-02 00:00:00",
//    "bank_holiday": false
//    "days_away": 763
// }

getHalloweenHoliday()

Get Halloween for the current year of the Carbon object. Optionally pass in a $year to get Halloween in a given year.

getHalloweenHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getHalloweenHoliday();

// {
//    "name": "Halloween",
//    "date": "2020-10-31 00:00:00",
//    "bank_holiday": false
//    "days_away": 304
// }

$holidays->name // Halloween
$holidays->date->format('m-d-Y') // 10-31-2020
$holidays->days_away // 304
$holidays->bank_holiday // false

$holidays = Carbon::create(2020, 1, 1);
$holidays->getHalloweenHoliday(2022);

// {
//    "name": "Halloween",
//    "date": "2022-10-31 00:00:00",
//    "bank_holiday": false
//    "days_away": 1034
// }

getHanukkahHoliday()

Get Hanukkah for the current year of the Carbon object. Optionally pass in a $year to get Hanukkah in a given year.

getHanukkahHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getHanukkahHoliday();

// {
//    "name": "Hanukkah",
//    "date": "2020-12-11 00:00:00",
//    "bank_holiday": false
//    "days_away": 345
// }

$holidays->name // Hanukkah
$holidays->date->format('m-d-Y') // 12-11-2020
$holidays->days_away // 345
$holidays->bank_holiday // false

$holidays = Carbon::create(2020, 1, 1);
$holidays->getHanukkahHoliday(2022);

// {
//    "name": "Hanukkah",
//    "date": "2022-12-19 00:00:00",
//    "bank_holiday": false
//    "days_away": 1083
// }

getIndependenceDayHoliday()

Get Independence Day for the current year of the Carbon object. Optionally pass in a $year to get Independence Day in a given year.

getIndependenceDayHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getIndependenceDayHoliday();

// {
//    "name": "Independence Day",
//    "date": "2020-07-04 00:00:00",
//    "bank_holiday": true,
//    "days_away": 185
// }

$holidays->name // Independence Day
$holidays->date->format('m-d-Y') // 07-04-2020
$holidays->days_away // 185
$holidays->bank_holiday // true

$holidays = Carbon::create(2020, 1, 1);
$holidays->getIndependenceDayHoliday(2022);

// {
//    "name": "Independence Day",
//    "date": "2022-07-04 00:00:00",
//    "bank_holiday": true,
//    "days_away": 915
// }

getIndigenousPeoplesDayHoliday()

Get Indigenous Peoples' Day for the current year of the Carbon object. Optionally pass in a $year to get Indigenous Peoples' Day in a given year.

getIndigenousPeoplesDayHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getIndigenousPeoplesDayHoliday();

// {
//    "name": "Indigenous Peoples' Day",
//    "date": "2020-10-12 00:00:00",
//    "bank_holiday": true,
//    "days_away": 285
// }

$holidays->name // Indigenous Peoples' Day
$holidays->date->format('m-d-Y') // 10-12-2020
$holidays->days_away // 285
$holidays->bank_holiday // true

$holidays = Carbon::create(2020, 1, 1);
$holidays->getIndigenousPeoplesDayHoliday(2022);

// {
//    "name": "Indigenous Peoples' Day",
//    "date": "2022-10-10 00:00:00",
//    "bank_holiday": true,
//    "days_away": 1013
// }

getJuneteenthHoliday()

Get Juneteenth for the current year of the Carbon object. Optionally pass in a $year to get Juneteenth in a given year.

getJuneteenthHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getJuneteenthHoliday();

// {
//    "name": "Juneteenth",
//    "date": "2020-06-19 00:00:00",
//    "bank_holiday": false
//    "days_away": 170
// }

$holidays->name // Juneteenth
$holidays->date->format('m-d-Y') // 06-19-2020
$holidays->days_away // 170
$holidays->bank_holiday // false

$holidays = Carbon::create(2020, 1, 1);
$holidays->getJuneteenthHoliday(2022);

// {
//    "name": "Juneteenth",
//    "date": "2022-06-19 00:00:00",
//    "bank_holiday": false
//    "days_away": 900
// }

getKwanzaaHoliday()

Get Kwanzaa for the current year of the Carbon object. Optionally pass in a $year to get Kwanzaa in a given year.

getKwanzaaHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getKwanzaaHoliday(2022);

// {
//    "name": "Kwanzaa",
//    "date": "2022-12-26 00:00:00",
//    "bank_holiday": false
//    "days_away": 1090
// }

$holidays = Carbon::create(2020, 1, 1);
$holidays->getKwanzaaHoliday();

// {
//    "name": "Kwanzaa",
//    "date": "2020-12-26 00:00:00",
//    "bank_holiday": false
//    "days_away": 360
// }

$holidays->name // Kwanzaa
$holidays->date->format('m-d-Y') // 12-26-2020
$holidays->days_away // 360
$holidays->bank_holiday // false

getLaborDayHoliday()

Get Labor Day for the current year of the Carbon object. Optionally pass in a $year to get Labor Day in a given year.

getLaborDayHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getLaborDayHoliday();

// {
//    "name": "Labor Day",
//    "date": "2020-09-07 00:00:00",
//    "bank_holiday": true,
//    "days_away": 250
// }

$holidays->name // Labor Day
$holidays->date->format('m-d-Y') // 09-07-2020
$holidays->days_away // 250
$holidays->bank_holiday // true

$holidays = Carbon::create(2020, 1, 1);
$holidays->getLaborDayHoliday(2022);

// {
//    "name": "Labor Day",
//    "date": "2022-09-05 00:00:00",
//    "bank_holiday": true,
//    "days_away": 978
// }

getMemorialDayHoliday()

Get Memorial Day for the current year of the Carbon object. Optionally pass in a $year to get Memorial Day in a given year.

getMemorialDayHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getMemorialDayHoliday();

// {
//    "name": "Memorial Day",
//    "date": "2020-05-25 00:00:00",
//    "bank_holiday": true,
//    "days_away": 145
// }

$holidays->name // Memorial Day
$holidays->date->format('m-d-Y') // 05-25-2020
$holidays->days_away // 145
$holidays->bank_holiday // true

$holidays = Carbon::create(2020, 1, 1);
$holidays->getMemorialDayHoliday(2022);

// {
//    "name": "Memorial Day",
//    "date": "2022-05-30 00:00:00",
//    "bank_holiday": true,
//    "days_away": 880
// }

getMLKDayHoliday()

Get Martin Luther King Jr. Day for the current year of the Carbon object. Optionally pass in a $yearto get Martin Luther King Jr. Day in a given year.

getMLKDayHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getMLKDayHoliday();

// {
//    "name": "Martin Luther King Jr. Day",
//    "date": "2020-01-20 00:00:00",
//    "bank_holiday": true,
//    "days_away": 19
// }

$holidays->name // Martin Luther King Jr. Day
$holidays->date->format('m-d-Y') // 01-20-2020
$holidays->days_away // 19
$holidays->bank_holiday // true

$holidays = Carbon::create(2020, 1, 1);
$holidays->getMLKDayHoliday(2022);

// {
//    "name": "Martin Luther King Jr. Day",
//    "date": "2022-01-17 00:00:00",
//    "bank_holiday": true,
//    "days_away": 747
// }

getMothersDayHoliday()

Get Mother's Day for the current year of the Carbon object. Optionally pass in a $year to get Mother's Day in a given year.

getMothersDayHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getMothersDayHoliday();

// {
//    "name": "Mother's Day",
//    "date": "2020-05-10 00:00:00",
//    "bank_holiday": false
//    "days_away": 130
// }

$holidays->name // Mother's Day
$holidays->date->format('m-d-Y') // 05-10-2020
$holidays->days_away // 130
$holidays->bank_holiday // false

$holidays = Carbon::create(2020, 1, 1);
$holidays->getMothersDayHoliday(2022);

// {
//    "name": "Mother's Day",
//    "date": "2022-05-08 00:00:00",
//    "bank_holiday": false
//    "days_away": 858
// }

getNewYearsDayHoliday()

Get New Year's Day for the current year of the Carbon object. Optionally pass in a $year to get New Year's Day in a given year.

getNewYearsDayHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getNewYearsDayHoliday();

// {
//    "name": "New Year's Day",
//    "date": "2020-01-01 00:00:00",
//    "bank_holiday": true,
//    "days_away": 0
// }

$holidays->name // New Year's Day
$holidays->date->format('m-d-Y') // 01-01-2020
$holidays->days_away // : 0
$holidays->bank_holiday // true

$holidays = Carbon::create(2020, 1, 1);
$holidays->getNewYearsDayHoliday(2022);

// {
//    "name": "New Year's Day",
//    "date": "2022-01-01 00:00:00",
//    "bank_holiday": true,
//    "days_away": 731
// }

getNewYearsEveHoliday()

Get New Year's Eve for the current year of the Carbon object. Optionally pass in a $year to get New Year's Eve in a given year.

getNewYearsEveHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getNewYearsEveHoliday();

// {
//    "name": "New Year's Eve",
//    "date": "2020-12-31 00:00:00",
//    "bank_holiday": false
//    "days_away": 365
// }

$holidays->name // New Year's Eve
$holidays->date->format('m-d-Y') // 12-31-2020
$holidays->days_away // 365
$holidays->bank_holiday // false

$holidays = Carbon::create(2020, 1, 1);
$holidays->getNewYearsEveHoliday(2022);

// {
//    "name": "New Year's Eve",
//    "date": "2022-12-31 00:00:00",
//    "bank_holiday": false
//    "days_away": 1095
// }

getOrthodoxEasterHoliday()

Get Orthodox Easter for the current year of the Carbon object. Optionally pass in a $year to get Orthodox Easter in a given year.

getOrthodoxEasterHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getOrthodoxEasterHoliday();

// {
//    "name": "Orthodox Easter",
//    "date": "2020-04-19 00:00:00",
//    "bank_holiday": false
//    "days_away": 109
// }

$holidays->name // Orthodox Easter
$holidays->date->format('m-d-Y') // 04-19-2020
$holidays->days_away // 109
$holidays->bank_holiday // false

$holidays = Carbon::create(2020, 1, 1);
$holidays->getOrthodoxEasterHoliday(2022);

// {
//    "name": "Orthodox Easter",
//    "date": "2022-04-24 00:00:00",
//    "bank_holiday": false
//    "days_away": 844
// }

getPalmSundayHoliday()

Get Palm Sunday for the current year of the Carbon object. Optionally pass in a $year to get Palm Sunday in a given year.

getPalmSundayHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getPalmSundayHoliday();

// {
//    "name": "Palm Sunday",
//    "date": "2020-04-05 00:00:00",
//    "bank_holiday": false
//    "days_away": 95
// }

$holidays->name // Palm Sunday
$holidays->date->format('m-d-Y') // 04-05-2020
$holidays->days_away // 95
$holidays->bank_holiday // false

$holidays = Carbon::create(2020, 1, 1);
$holidays->getPalmSundayHoliday(2022);

// {
//    "name": "Palm Sunday",
//    "date": "2022-04-10 00:00:00",
//    "bank_holiday": false
//    "days_away": 830
// }

getPassoverHoliday()

Get Passover for the current year of the Carbon object. Optionally pass in a $yearto get Passover in a given year.

getPassoverHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getPassoverHoliday();

// {
//    "name": "Passover",
//    "date": "2020-04-09 00:00:00",
//    "bank_holiday": false
//    "days_away": 99
// }

$holidays->name // Passover
$holidays->date->format('m-d-Y') // 04-09-2020
$holidays->days_away // 99
$holidays->bank_holiday // false

$holidays = Carbon::create(2020, 1, 1);
$holidays->getPassoverHoliday(2022);

// {
//    "name": "Passover",
//    "date": "2022-04-16 00:00:00",
//    "bank_holiday": false
//    "days_away": 836
// }

getPatriotDayHoliday()

Get Patriot Day for the current year of the Carbon object. Optionally pass in a $year to get Patriot Day in a given year.

getPatriotDayHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getPatriotDayHoliday();

// {
//    "name": "Patriot Day",
//    "date": "2020-09-11 00:00:00",
//    "bank_holiday": false
//    "days_away": 254
// }

$holidays->name // Patriot Day
$holidays->date->format('m-d-Y') // 09-11-2020
$holidays->days_away // 254
$holidays->bank_holiday // false

$holidays = Carbon::create(2020, 1, 1);
$holidays->getPatriotDayHoliday(2022);

// {
//    "name":"Patriot Day",
//    "date": "2022-09-11 00:00:00",
//    "bank_holiday": false
//    "days_away": 984
// }

getPearlHarborRemembranceDayHoliday()

Get Pearl Harbor Remembrance Day for the current year of the Carbon object. Optionally pass in a $year to get Pearl Harbor Remembrance Day in a given year.

getPearlHarborRemembranceDayHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getPearlHarborRemembranceDayHoliday()

// {
//    "name": "Pearl Harbor Remembrance Day",
//    "date": "2020-12-07 00:00:00",
//    "bank_holiday": false
//    "days_away": 341
// }

$holidays->name // Pearl Harbor Remembrance Day
$holidays->date->format('m-d-Y') // 12-07-2020
$holidays->days_away // 341
$holidays->bank_holiday // false

$holidays = Carbon::create(2020, 1, 1);
$holidays->getPearlHarborRemembranceDayHoliday(2022);

// {
//    "name": "Pearl Harbor Remembrance Day",
//    "date": "2022-12-07 00:00:00",
//    "bank_holiday": false
//    "days_away": 1071
// }

getPresidentsDayHoliday()

Get Presidents' Day for the current year of the Carbon object. Optionally pass in a $year to get Presidents' Day in a given year.

getPresidentsDayHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getPresidentsDayHoliday();

// {
//    "name": "Presidents' Day",
//    "date": "2020-02-17 00:00:00",
//    "bank_holiday": true,
//    "days_away": 47
// }

$holidays->name // Presidents' Day
$holidays->date->format('m-d-Y') // 02-17-2020
$holidays->days_away // 47
$holidays->bank_holiday // true

$holidays = Carbon::create(2020, 1, 1);
$holidays->getPresidentsDayHoliday(2022);

// {
//    "name": "Presidents' Day",
//    "date": "2022-02-21 00:00:00",
//    "bank_holiday": true,
//    "days_away": 782
// }

getRoshHashanahHoliday()

Get Rosh Hashanah for the current year of the Carbon object. Optionally pass in a $year to get Rosh Hashanah in a given year.

getRoshHashanahHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getRoshHashanahHoliday();

// {
//    "name": "Rosh Hashanah",
//    "date": "2020-09-19 00:00:00",
//    "bank_holiday": false
//    "days_away": 262
// }

$holidays->name // Rosh Hashanah
$holidays->date->format('m-d-Y') // 09-19-2020
$holidays->days_away // 262
$holidays->bank_holiday // false

$holidays = Carbon::create(2020, 1, 1);
$holidays->getRoshHashanahHoliday(2022);

// {
//    "name": "Rosh Hashanah",
//    "date": "2022-09-26 00:00:00",
//    "bank_holiday": false
//    "days_away": 999
// }

getStPatricksDayHoliday()

Get St. Patrick's Day for the current year of the Carbon object. Optionally pass in a $year to get St. Patrick's Day in a given year.

getStPatricksDayHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getStPatricksDayHoliday();

// {
//    "name": "St. Patrick's Day",
//    "date": "2020-03-17 00:00:00",
//    "bank_holiday": false
//    "days_away": 76
// }

$holidays->name // St. Patrick's Day
$holidays->date->format('m-d-Y') // 03-17-2020
$holidays->days_away // 76
$holidays->bank_holiday // false

$holidays = Carbon::create(2020, 1, 1);
$holidays->getStPatricksDayHoliday(2022);

// {
//    "name": "St. Patrick's Day",
//    "date": "2022-03-17 00:00:00",
//    "bank_holiday": false
//    "days_away": 806
// }

getTaxDayHoliday()

Get Tax Day for the current year of the Carbon object. Optionally pass in a $year to get Tax Day in a given year.

getTaxDayHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getTaxDayHoliday();

// {
//    "name": "Tax Day",
//    "date": "2020-04-15 00:00:00",
//    "bank_holiday": false
//    "days_away": 105
// }

$holidays->name // Tax Day
$holidays->date->format('m-d-Y') // 04-15-2020
$holidays->days_away // 105
$holidays->bank_holiday // false

$holidays = Carbon::create(2020, 1, 1);
$holidays->getTaxDayHoliday(2022);

// {
//    "name": "Tax Day",
//    "date": "2022-04-18 00:00:00",
//    "bank_holiday": false
//    "days_away": 838
// }

getThanksgivingHoliday()

Get Thanksgiving for the current year of the Carbon object. Optionally pass in a $year to get Thanksgiving in a given year.

getThanksgivingHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getThanksgivingHoliday();

// {
//    "name": "Thanksgiving",
//    "date": "2020-11-26 00:00:00",
//    "bank_holiday": true,
//    "days_away": 330
// }

$holidays->name // Thanksgiving
$holidays->date->format('m-d-Y') // 11-26-2020
$holidays->days_away // 330
$holidays->bank_holiday // true

$holidays = Carbon::create(2020, 1, 1);
$holidays->getThanksgivingHoliday(2022);

// {
//    "name": "Thanksgiving",
//    "date": "2022-11-24 00:00:00",
//    "bank_holiday": true,
//    "days_away": 1058
// }

getValentinesDayHoliday()

Get Valentine's Day for the current year of the Carbon object. Optionally pass in a $year to get Valentine's Day in a given year.

getValentinesDayHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getValentinesDayHoliday();

// {
//    "name": "Valentine's Day",
//    "date": "2020-02-14 00:00:00",
//    "bank_holiday": false
//    "days_away": 44
// }

$holidays->name // Valentine's Day
$holidays->date->format('m-d-Y') // 02-14-2020
$holidays->days_away // 44
$holidays->bank_holiday // false

$holidays = Carbon::create(2020, 1, 1);
$holidays->getValentinesDayHoliday(2022);

// {
//    "name": "Valentine's Day",
//    "date": "2022-02-14 00:00:00",
//    "bank_holiday": false
//    "days_away": 775
// }

getVeteransDayHoliday()

Get Veterans Day for the current year of the Carbon object. Optionally pass in a $year to get Veterans Day in a given year.

getVeteransDayHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getVeteransDayHoliday();

// {
//    "name": "Veterans Day",
//    "date": "2020-11-11 00:00:00",
//    "bank_holiday": true,
//    "days_away": 315
// }

$holidays->name // Veterans Day
$holidays->date->format('m-d-Y') // 11-11-2020
$holidays->days_away // 315
$holidays->bank_holiday // true

$holidays = Carbon::create(2020, 1, 1);
$holidays->getVeteransDayHoliday(2022);

// {
//    "name": "Veterans Day",
//    "date": "2022-11-11 00:00:00",
//    "bank_holiday": true,
//    "days_away": 1045
// }

getYomKippurHoliday()

Get Yom Kippur for the current year of the Carbon object. Optionally pass in a $year to get Yom Kippur in a given year.

getYomKippurHoliday(int $year=null) : object

$holidays = Carbon::create(2020, 1, 1);
$holidays->getYomKippurHoliday();

// {
//    "name": "Yom Kippur",
//    "date": "2020-09-28 00:00:00",
//    "bank_holiday": false
//    "days_away": 271
// }

$holidays->name // Yom Kippur
$holidays->date->format('m-d-Y') // 09-28-2020
$holidays->days_away // 271
$holidays->bank_holiday // false

$holidays = Carbon::create(2020, 1, 1);
$holidays->getYomKippurHoliday(2022);

// {
//    "name": "Yom Kippur",
//    "date": "2022-10-05 00:00:00",
//    "bank_holiday": false
//    "days_away": 1008
// }