Download the PHP package shahruslan/production-calendar without Composer
On this page you can find all versions of the php package shahruslan/production-calendar. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download shahruslan/production-calendar
More information about shahruslan/production-calendar
Files in shahruslan/production-calendar
Package production-calendar
Short Description Производственный календарь
License MIT
Informations about the package production-calendar
Production calendar
Описание:
Библиотека production-calendar позволяет получать данные о производственном календаре из сервиса production-calendar.ru.
Использование:
Чтобы использовать библиотеку, необходимо установить её с помощью Composer:
Далее надо будет подключить какой-нибудь PSR-18 совместимый
http-client. Этот клиент подключается автоматически,
но при желании вы можете его сконфигурировать и передать в конструктор. И в заключении получаем
токен для работы с API. Чтобы его получить, достаточно указать свой email, на
который придет письмо с токеном. Затем можно использовать класс Calendar
для получения данных о производственном
календаре:
Методы класса Calendar
getPeriodForYear(int $year): Period
- Получение календаря на весь год;getPeriodForQuarter(int $year, int $quarter): Period
- Получение календаря на определённый квартал;getPeriodForMonth(int $year, int $month): Period
- Получение календаря на определённый месяц;getPeriodForDay(DateTimeInterface $date): Period
- Получение календаря на определённый день;getPeriod(string $period): Period
- Получение календаря на произвольный период(не более года).
Каждый метод возвращает объект класса Period
, содержащий данные о производственном календаре.
Класс Period
Класс Period
представляет собой объект, содержащий данные о производственном календаре. В свойстве days
массив
объектов типа Day
со свойствами:
date
- текущий день;type
- тип дня(праздничный, рабочий, выходной и тд);weekDay
- день недели;workingHours
- количество рабочих часов.isProject
- находится ли этот день в проекте закона и еще не утвержден.
Свойство statistic
отображает ряд статистических данных для задаваемого периода:
calendarDays
– количество календарных дней в периоде;calendarDaysWithoutHolidays
- количество календарных дней в периоде без учета праздничных дней (полезный показатель для расчета продолжительности отпуска работника);workDays
– количество рабочих дней в периоде;weekends
– количество выходных дней в периоде (без учета праздничных);holidays
– количество праздничных дней в периоде;shortenedWorkingDays
– количество сокращённых рабочих дней в периоде;workingHours
– количество рабочего времени за период.
Output:
Дополнительные настройки
При необходимости можно получить производственный календарь для конкретного региона. Например, в Краснодарском крае 14 мая 2024 года отмечается Радоница, и этот день объявлен выходным днем:
Output:
Помимо региона, еще можно настроить и другие параметры:
All versions of production-calendar with dependencies
php-http/client-common Version ^2.7
php-http/discovery Version ^1.19
psr/http-client Version ^1.0
psr/http-factory Version ^1.0