pub fn format_rfc3339_ms(ms: i64) -> Option<String> {
let seconds = ms.div_euclid(1000);
let days = seconds.div_euclid(86_400);
let tod = seconds.rem_euclid(86_400) as u32;
let hour = tod / 3600;
let min = (tod % 3600) / 60;
let sec = tod % 60;
let (year, month, day) = civil_from_days(days)?;
if !is_rfc3339_year(year) {
return None;
}
Some(format!(
"{year:04}-{month:02}-{day:02}T{hour:02}:{min:02}:{sec:02}Z"
))
}
pub fn format_date_ms(ms: i64) -> Option<String> {
let days = ms.div_euclid(86_400_000);
let (year, month, day) = civil_from_days(days)?;
if !is_rfc3339_year(year) {
return None;
}
Some(format!("{year:04}-{month:02}-{day:02}"))
}
fn is_rfc3339_year(year: i32) -> bool {
(1..=9999).contains(&year)
}
pub fn now_utc_ms() -> i64 {
std::time::SystemTime::now()
.duration_since(std::time::UNIX_EPOCH)
.map(|d| d.as_millis() as i64)
.unwrap_or(0)
}
pub fn now_utc_rfc3339() -> String {
format_rfc3339_ms(now_utc_ms()).unwrap_or_else(|| "1970-01-01T00:00:00Z".to_string())
}
fn civil_from_days(days: i64) -> Option<(i32, u32, u32)> {
let z = days + 719_468; let era = z.div_euclid(146_097);
let doe = z.rem_euclid(146_097) as u64; let yoe = (doe - doe / 1460 + doe / 36524 - doe / 146_096) / 365; let y = (yoe as i64) + era * 400;
let doy = doe - (365 * yoe + yoe / 4 - yoe / 100); let mp = (5 * doy + 2) / 153; let d = (doy - (153 * mp + 2) / 5 + 1) as u32;
let m = (if mp < 10 { mp + 3 } else { mp - 9 }) as u32;
let y = y + i64::from(m <= 2);
let year = i32::try_from(y).ok()?;
Some((year, m, d))
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn epoch_formats_to_unix_midnight() {
assert_eq!(format_rfc3339_ms(0).unwrap(), "1970-01-01T00:00:00Z");
}
#[test]
fn known_timestamp_matches_expected() {
let ms: i64 = 1_776_470_400_000;
assert_eq!(format_rfc3339_ms(ms).unwrap(), "2026-04-18T00:00:00Z");
}
#[test]
fn sub_second_ms_truncates_to_seconds() {
let a: i64 = 1_776_470_400_123;
let b: i64 = 1_776_470_400_987;
assert_eq!(format_rfc3339_ms(a), format_rfc3339_ms(b));
}
#[test]
fn leap_day_2024_02_29() {
let ms = 1_709_210_096_000;
assert_eq!(format_rfc3339_ms(ms).unwrap(), "2024-02-29T12:34:56Z");
}
#[test]
fn pre_epoch_formats_correctly() {
let ms: i64 = -1_000;
assert_eq!(format_rfc3339_ms(ms).unwrap(), "1969-12-31T23:59:59Z");
}
#[test]
fn format_date_ms_returns_date_only() {
let ms: i64 = 1_776_470_400_000; assert_eq!(format_date_ms(ms).unwrap(), "2026-04-18");
}
#[test]
fn now_utc_rfc3339_is_well_formed() {
let s = now_utc_rfc3339();
assert_eq!(s.len(), 20, "expected YYYY-MM-DDTHH:MM:SSZ: {s}");
assert!(s.ends_with('Z'));
assert!(s.chars().nth(4) == Some('-'));
assert!(s.chars().nth(10) == Some('T'));
}
#[test]
fn century_boundary_2000_03_01() {
let ms = 951_868_800_000;
assert_eq!(format_rfc3339_ms(ms).unwrap(), "2000-03-01T00:00:00Z");
}
#[test]
fn non_leap_century_2100_03_01() {
let ms: i64 = 4_107_542_400_000;
assert_eq!(format_rfc3339_ms(ms).unwrap(), "2100-03-01T00:00:00Z");
}
#[test]
fn year_after_9999_returns_none() {
let year_10000: i64 = 253_402_300_800_000;
assert!(format_rfc3339_ms(year_10000).is_none());
assert!(format_date_ms(year_10000).is_none());
let last_9999: i64 = 253_402_300_799_000;
assert_eq!(
format_rfc3339_ms(last_9999).unwrap(),
"9999-12-31T23:59:59Z"
);
}
#[test]
fn year_before_0001_returns_none() {
let very_early: i64 = -62_167_219_200_001;
assert!(format_rfc3339_ms(very_early).is_none());
}
#[test]
fn now_utc_ms_and_rfc3339_agree_to_the_second() {
let ms = now_utc_ms();
let s = now_utc_rfc3339();
assert_eq!(s.len(), 20);
let from_s = format_rfc3339_ms(ms).unwrap();
assert_eq!(s, from_s, "both calls must render the same second");
}
}