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;

let result = holidays_ru::flags_ymd(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::{flags, Resolved};

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

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

Bool shortcuts:

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

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

use holidays_ru::WorkWeek;

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

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

Supported years

• 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.

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(year, month, day).