Collaborative Date library for identification of holidays and commemorative dates from countries, states and cities with automatic calculation of business days and office hours.
This library was inspired by the checkdomain/holiday project, completely rewritten to support holidays and commemorative dates from countries, states and cities with automatic calculation of business days and office hours without having to write a new class for each. Events are loaded from a CSV that may be updated from an collaborative API in the future.
- 🇧🇷 BR Brazil
- National holidays
- Estate holidays
- City holidays
- Commemorative dates
- Business days
- Office hours
joaosalless/dates is open source. If you use this library it would be great to get some support for currently not implemented countries which you are familiar with. Pull requests will be reviewed and merged fast.
Via Composer
$ composer require joaosalless/dates
$dates = new Joaosalless\Dates\Dates('BR');
// Get only national holidays
$dates->getHolidays('2019-09-07');
// Check if a given date is holiday only national holidays
$dates->isHoliday('2019-09-07');
// Get national and state holidays
$dates->getHolidays(
'2019-09-07', // Date
'SP' // State code
);
// Check if a given date is holiday in national and state holidays
$dates->isHoliday(
'2019-09-07', // Date
'SP' // State code
);
// Get national, state and city holidays
$dates->getHolidays(
'2019-09-07', // Date
'SP', // State code
'3550308' // City code
);
// Check if a given date is holiday in national, state and city holidays
$dates->isHoliday(
'2019-09-07', // Date
'SP', // State code
'3550308' // City code
);
$dates = new Joaosalless\Dates\Dates('BR');
// Get only national commemorative dates
$dates->getCommemorativeDates('2019-09-07');
// Get national and state commemorative dates
$dates->getCommemorativeDates(
'2019-09-07', // Date
'SP' // State code
);
// Get national, state and city commemorative dates
$dates->getCommemorativeDates(
'2019-09-07', // Date
'SP', // State code
'3550308' // City code
);
Calculates business days from a start date and a specified number of days
// Configure business days and office hours
$config = [
'week' => [
'office_hours_start' => '09:00',
'office_hours_end' => '18:00',
'check_office_hours' => false,
'days' => [
'sun' => [
'business_day' => false,
],
'mon' => [
'business_day' => true,
],
'tue' => [
'business_day' => true,
],
'wed' => [
'business_day' => false,
],
'thu' => [
'business_day' => true,
],
'fri' => [
'business_day' => true,
],
'sat' => [
'business_day' => true,
'office_hours_start' => '09:00',
'office_hours_end' => '14:00',
],
]
]
];
$dates = new Dates('BR', $config);
$dates->calculateBusinessDays(
10, // Number of days
'2019-09-07', // Start date
'SP', // Check state holidays
'3550308', // Check city holidays
);
$dateTime = new DateTime('2019-07-31 08:23:00');
// Check if given DateTime instance is a business day
$dates->isBusinessDay($dateTime); // Returns bool
// Check if given datetime string is a business day
$dates->isBusinessDay('2019-07-31 08:23:00'); // Returns bool
// Returns \DateTime;
Checks if given DateTime instance or datetime string is a office hours
$dates = new Joaosalless\Dates\Dates('BR');
$dateTime = new DateTime('2019-07-31 08:23:00');
// Check if given DateTime instance is a office hour
$dates->isOfficeHour($dateTime); // Returns bool
// Check if given string date is office hours
$dates->isOfficeHour('2019-07-31 08:23:00'); // Returns bool
Please see CHANGELOG for more information on what has changed recently.
$ composer test
Please see CONTRIBUTING and CODE_OF_CONDUCT for details.
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
The MIT License (MIT). Please see License File for more information.