deep-time 0.1.0-alpha.9

High-precision, no-std, no-alloc date-time library, leap-seconds, time scales, relativistic time, and a powerful date & duration parser
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82

use crate::ParseCfg;
use alloc::boxed::Box;
use core::ops::RangeInclusive;
use once_cell::race::OnceBox;

static DEFAULT_DATE_PARSE_OPTIONS: OnceBox<ParseCfg> = OnceBox::new();
pub(crate) fn default_date_parse_options() -> &'static ParseCfg {
    DEFAULT_DATE_PARSE_OPTIONS.get_or_init(|| Box::new(ParseCfg::default()))
}

#[cfg(feature = "locale")]
use {once_cell::race::OnceBool, sys_locale};

#[cfg(feature = "locale")]
const MONTH_FIRST_LOCALES: &[&str] = &[
    "en-us", // United States (by far the most common)
    "en-ca", // English Canada (very common in practice due to US influence)
    "en-ph", // Philippines (strong US influence)
    "en-bz", // Belize
    "en-jm", // Jamaica
    "en-tt", // Trinidad & Tobago
    "en-bb", // Barbados
    // Spanish-speaking Caribbean / Central America that predominantly use MM/DD
    "es-do", // Dominican Republic
    "es-pa", // Panama
    "es-pr", // Puerto Rico (US territory influence)
];

#[cfg(feature = "locale")]
static LOCALE_PREFERS_DAY_FIRST: OnceBool = OnceBool::new();

#[cfg(feature = "locale")]
pub(crate) fn locale_prefers_day_first() -> bool {
    LOCALE_PREFERS_DAY_FIRST.get_or_init(|| {
        sys_locale::get_locale()
            .map(|locale| {
                let lower = locale.to_ascii_lowercase();

                // If the locale starts with any of the month-first entries
                // → we want Month, so return `false`
                if MONTH_FIRST_LOCALES.iter().any(|&m| lower.starts_with(m)) {
                    false
                } else {
                    true // Day (default for the rest of the world)
                }
            })
            .unwrap_or(true) // fallback: Day
    })
}

pub(crate) const DIGIT_CHARS: [char; 10] = ['0', '1', '2', '3', '4', '5', '6', '7', '8', '9'];

pub(crate) const MAX_DATE_STRING_LEN: usize = 255;
pub(crate) const MIN_YEAR: i32 = -9999;
pub(crate) const MAX_YEAR: i32 = 9999;

/// Year range considered plausible for legacy/business ordinal dates (YYYYJJJ / YYJJJ).
/// - 7-digit (YYYYJJJ): full 1850–2300 supported via %Y.
/// - 5-digit (YYJJJ): limited to Chrono's %y window (~1969–2068).
///   Pre-1969 legacy ordinals must use 4-digit year or explicit format.
pub(crate) const LEGACY_ORDINAL_YEAR_RANGE: RangeInclusive<i32> = 1850..=2300;
/// Year range considered plausible for YYYYMM pure-numeric input.
/// Used in Auto mode to distinguish modern "202403" (year-month) from the far more common
/// legacy YYMMDD case "240301" (2024-03-01). 1900–2150 covers all realistic use while
/// excluding fake future years like 2403.
pub(crate) const PLAUSIBLE_YYYYMM_YEAR_RANGE: RangeInclusive<i32> = 1900..=2150;

/// Modified Julian Date range for 5-digit pure-numeric input.
/// Covers ~1968–2130.
pub(crate) const MJD_RANGE: RangeInclusive<i64> = 40_000..=85_000;
/// Julian Day (JD) range for 7-digit pure-numeric input.
/// Covers ~5000 BC to ~10,700 AD
pub(crate) const JD_RANGE: RangeInclusive<i64> = 1_400_000..=4_000_000;

pub(crate) const SEC_PER_HALF_DAYI64: i64 = 43_200;
pub(crate) const NS_PER_YEAR: i128 = 31_557_600_000_000_000; // 365.25 days
pub(crate) const NS_PER_MONTH: i128 = 2_629_800_000_000_000; // 30.4375 days
pub(crate) const NS_PER_WEEK: i128 = 604_800_000_000_000;
pub(crate) const NS_PER_HOUR: i128 = 3_600_000_000_000;
pub(crate) const NS_PER_MINUTE: i128 = 60_000_000_000;
pub(crate) const NS_PER_DAY: i128 = 86_400_000_000_000;
pub(crate) const NS_PER_SEC: i128 = 1_000_000_000;