isdayoff::calendars

Публичный репозиторий для наполнения базы проекта isdayoff.ru

Проект растёт и без помощи пользователей тут не обойтись, поэтому был придуман формат файла, для пополнения базы данных выходных и рабочих дней

Описание формата файла

Формат пополнения представляет из себя просто JSON файл следующего содержания (удобно разобрать на примере Казахстана за 2022 г. kz2022.json):

{
    "year": 2022,
    "countrycode": "kz",
    "dayoff": ["0101", "0102", "0103", "0104", "0107", "0307", "0308", "0321", "0322", "0323", "0501", "0502", "0509", "0510", "0507", "0706", "0709", "0829", "0830", "1201", "1216", "1217", "1219"],
    "dayoff6": ["0101", "0102", "0103", "0104", "0107", "0307", "0308", "0321", "0322", "0323", "0501", "0502", "0509", "0510", "0507", "0706", "0709", "0829", "0830", "1201", "1216", "1217", "1219"],
    "predayoff": [],
    "predayoff6": [],
    "workday": ["0305", "0827"],
    "covidday": [],
    "holiday": ["0101", "0102", "0803", "0321", "0322", "0323", "0501", "0507", "0509", "0706", "0830", "1201", "1216", "1217"],
    "author": "Goodwin <goodwin@emerald.city>"
}

По-умолчанию считается, что страна живёт по режиму 5 рабочих дней, 2 выходных (без учёта каких либо праздников)

kz2022.json: Имя файла состоит из кода страны и года

Формат даты: "ММДД", где ММ - месяц с лидирующем нулём, ДД - день с лидирующим нулём

Поле	Тип данных	Значение в API	Назначение
year	Целое		Год, для которого заполняется файл
countrycode	Строка		Код страны, для которой заполняется файл
dayoff	Массив строк	1	Выходной день. Формат "ММДД"
predayoff	Массив строк	2	Сокращённый/предпраздничный день. Формат элемента строки: "ММДД"
dayoff6	Массив строк	1	Выходной день, в случае 6-ти дневной рабочей недели. Формат элемента строки: "ММДД"
predayoff6	Массив строк	2	Сокращённый/предпраздничный день, в случае 6-ти дневной рабочей недели. Формат элемента строки: "ММДД"
workday	Массив строк	0	Рабочий день, например в результате переноса выходного дня. Формат элемента строки: "ММДД"
covidday	Массив строк	4	Нерабочий день. В случае, если рабочий день, становится нерабочим, то есть с начислением з/п. Формат элемента строки: "ММДД"
holiday	Массив строк	8	(в разработке) Праздничный день. Формат элемента строки: "ММДД"
author	Массив строк		Имя автора и любые контакты для связи (e-mail, Telegram, Jabber, etc...)

Добавление в базу

После создания файла, необходимо создать PR, в котором указать откуда была взята информация (чем официальнее источник, тем лучше)

Вопросы/предложения/замечания

Telegram: @la_stik

Telegram канал: @isdayoff

E-mail: andrey@esin.name

Спасибо!