Russian Calendar

About Russian Calendar

Work Calendar is a self-hosted service that determines whether a given date is a business day or a day off in Russia, using open production calendar data published on data.gov.ru. It runs as a Docker container (via docker or docker-compose) and exposes an HTTP API: a day-lookup endpoint that returns a JSON object indicating holiday status (with a default flag set to true when gov.ru data has not been loaded and the result falls back to weekday-only calculation), and an update endpoint that triggers a data refresh from data.gov.ru.

The project is built as part of the author's home automation ("Smart Home") setup and is intended for developers who need programmatic access to Russian holiday/business-day data, such as for scheduling or automation integrations. The repository is archived and read-only as of October 2023, with a listed TODO (never implemented) to add a personal calendar synced with Google.

Key features

• Determines whether a given date is a Russian business day or holiday
• Returns holiday status via a JSON API endpoint (/calendar/day/)
• Uses official production calendar data from data.gov.ru
• Falls back to weekday-only calculation when gov.ru data isn't loaded
• Endpoint to trigger a data refresh from data.gov.ru (/calendar/update/)
• Runs via Docker or docker-compose

Frequently asked questions