devmakis/prodcalendar

Библиотека для работы с производственным календарем России, Белоруссии, Казахстана и Узбекистана

1.3.3 2022-12-29 16:53 UTC

Requires

• php: >=5.6
• ext-curl: *
• ext-json: *

MIT

• Kiselev Maxim

README

Библиотека для работы с производственным календарем России, Белоруссии, Казахстана и Узбекистана. Реализованы клиенты для двух источников данных - Data.gov.ru или xmlcalendar.ru. Есть возможность реализовать свой клиент для получения данных от других источников.

Установка

composer require devmakis/prodcalendar

Примеры использования

use Devmakis\ProdCalendar\Clients\DataGovClient;
use Devmakis\ProdCalendar\Calendar;

$client = new DataGovClient('YOUR_TOKEN');
$calendar = new Calendar($client);

use Devmakis\ProdCalendar\Cache\FileJsonCache;
use Devmakis\ProdCalendar\Clients\XmlCalendarClient;
use Devmakis\ProdCalendar\Calendar;
use Devmakis\ProdCalendar\Country;

$cache = new FileJsonCache('FILE_PATH', 3600);
$client = new XmlCalendarClient(Country::RUSSIA, $cache);
$calendar = new Calendar($client);

Проверяем является ли день нерабочим (выходным | праздничным | перенесенным праздником)

$calendar->isNonWorking(new DateTime('01-01-2018'));
$calendar->isWeekend(new DateTime('01-01-2018'));
$calendar->isHoliday(new DateTime('01-01-2018'));
$calendar->isTransferredHoliday(new DateTime('24-03-2020'));

Проверяем является ли день предпраздничным

$calendar->isPreHoliday(new DateTime('22-02-2018'));

Получаем количество рабочих | нерабочих дней за определенный период

$dateBegin = new DateTime('31-01-2018');
$dateEnd = new DateTime('08-05-2018');
$countWorkingDays = $calendar->countWorkingDaysForPeriod($dateBegin, $dateEnd);
$countNonWorkingDays = $calendar->countNonWorkingDaysForPeriod($dateBegin, $dateEnd);

Получаем производственный календарь за определенный год, узнаем количество рабочих | нерабочих дней в году, в месяце

$year2018 = $calendar->getYear('2018');
$countWorkingDays = $year2018->countWorkingDays();
$countNonWorkingDays = $year2018->countNonWorkingDays();
$countWorkingDaysInMay = $year2018->getMonth('05')->countWorkingDays();