devmakis/prodcalendar

Библиотека для работы с производственным календарем России, Белоруссии, Казахстана и Узбекистана. Production calendar library of Russia, Belarus, Kazakhstan and Uzbekistan.

1.3.7 2025-01-11 10:27 UTC

Requires

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

MIT

• Kiselev Maxim

• calendar
• russian
• production
• working
• Belarus
• Kazakhstan
• Россия
• Казахстан
• Узбекистан
• Uzbekistan
• производственный
• календарь
• РФ
• производственный календарь
• xmlcalendar
• production calendar
• working calendar
• Беларусия

README

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

Установка

composer require devmakis/prodcalendar

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

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();