holidays-ru

Russian holidays and working days lookup. Updated annually with the official production calendar.

Usage

Without dependencies — just year, month, day:

use holidays_ru::{self, Federal};

let result = holidays_ru::flags_ymd::<Federal>(2026, 1, 9).unwrap();
let flags = result.value();

assert!(flags.is_day_off());
assert!(!flags.is_holiday());
assert!(flags.is_transferred());

With chrono (feature chrono) or time (feature time):

use chrono::NaiveDate;
use holidays_ru::{Federal, Resolved, flags};

let date = NaiveDate::from_ymd_opt(2026, 1, 9).unwrap();

match flags::<Federal, _>(date).unwrap() {
    Resolved::Fact(flags) => println!("official: {flags:?}"),
    Resolved::Predict(flags) => println!("prediction: {flags:?}"),
}

Bool shortcuts:

holidays_ru::is_day_off_ymd::<holidays_ru::Federal>(2026, 1, 9).unwrap().value();   // true
holidays_ru::is_holiday_ymd::<holidays_ru::Federal>(2026, 1, 1).unwrap().value();    // true
holidays_ru::is_short_day_ymd::<holidays_ru::Federal>(2026, 11, 3).unwrap().value(); // true

Full calendar with regional holidays:

use holidays_ru::regions::Tatarstan;

let flags = holidays_ru::flags_with_region_ymd::<Tatarstan>(2026, 11, 6)
    .unwrap()
    .value();

assert!(flags.is_day_off()); // Tatarstan Constitution Day

Date ranges use a half-open interval [start, end):

use holidays_ru::WorkWeek;

let days_off = holidays_ru::non_working_days_between_ymd::<holidays_ru::Federal>(2026, 1, 1, 2027, 1, 1)
    .unwrap()
    .value();
let minutes = holidays_ru::working_minutes_between_ymd::<holidays_ru::Federal>(
    2026,
    1,
    1,
    2027,
    1,
    1,
    WorkWeek::FortyHours,
)
.unwrap()
.value();

assert_eq!(days_off, 118);
assert_eq!(minutes, 1972 * 60);

Supported years

Federal calendar (Federal)

• 1993–2026 — official production calendar data, returned as Resolved::Fact.
• 1900–2100 outside the official-data range — deterministic prediction based on the Labor Code, returned as Resolved::Predict.

Regional calendars (calendar::regions::*)

Overlay calendars with non-working holidays specific to subjects of the Russian Federation (e.g. Tatarstan, Bashkortostan, Crimea). Each region has its own fact range and falls back to a fixed-date prediction outside it. Regional calendars must be combined with the federal calendar for a complete picture.

Prediction is deterministic and conservative. It is not an official production calendar. Official transfers are defined by yearly government decrees and may differ from the prediction.

Features

No features enabled — use flags_ymd::<Federal>(year, month, day).