Project Chimera
Меню

Исходники

96 строк · 5 КиБ

code/crates/chl-capture/src/timestamp.rs

1//! Имя файла из текущего момента, без внешней зависимости на дату/время.
2//!
3//! Тот же приём, что и `chl_wine::snapshot::format_date` — алгоритм
4//! гражданского календаря Хиннанта плюс `libc::localtime_r` за смещением
5//! пояса — только с точностью до секунды и в виде, безопасном для имени
6//! файла (`_`/`-`, не `:` и не пробел). Заводить `chrono` ради одной строки
7//! несоразмерно; свою копию алгоритма делаем не потому что нельзя было
8//! вынести общую в `chl-core`, а потому что снапшоты и скриншоты не тянут
9//! друг от друга других зависимостей — так и осталось два маленьких
10//! private-хелпера вместо общего публичного API ради одной функции.
11
12/// `YYYY-MM-DD_HH-MM-SS` в местном времени на момент вызова.
13pub fn stamp() -> String {
14 let now = std::time::SystemTime::now()
15 .duration_since(std::time::UNIX_EPOCH)
16 .map(|d| d.as_secs())
17 .unwrap_or(0);
18 format_local(now)
19}
20
21fn format_local(secs: u64) -> String {
22 let secs = secs as i64 + local_offset(secs as i64);
23 let days = secs.div_euclid(86_400);
24 let time = secs.rem_euclid(86_400) as u64;
25
26 let z = days + 719_468;
27 let era = z.div_euclid(146_097);
28 let doe = z.rem_euclid(146_097);
29 let yoe = (doe - doe / 1460 + doe / 36_524 - doe / 146_096) / 365;
30 let y = yoe + era * 400;
31 let doy = doe - (365 * yoe + yoe / 4 - yoe / 100);
32 let mp = (5 * doy + 2) / 153;
33 let d = doy - (153 * mp + 2) / 5 + 1;
34 let m = if mp < 10 { mp + 3 } else { mp - 9 };
35 let y = if m <= 2 { y + 1 } else { y };
36
37 format!(
38 "{y:04}-{m:02}-{d:02}_{:02}-{:02}-{:02}",
39 time / 3600,
40 (time % 3600) / 60,
41 time % 60
42 )
43}
44
45fn local_offset(when: i64) -> i64 {
46 let t = when as libc::time_t;
47 let mut tm: libc::tm = unsafe { std::mem::zeroed() };
48 if unsafe { libc::localtime_r(&t, &mut tm) }.is_null() {
49 return 0;
50 }
51 tm.tm_gmtoff as i64
52}
53
54#[cfg(test)]
55mod tests {
56 use super::*;
57
58 #[test]
59 fn формат_не_содержит_запрещённых_для_имени_файла_символов() {
60 let s = stamp();
61 assert!(!s.contains(':'), "двоеточие в имени файла ломает FAT/exFAT");
62 assert!(!s.contains(' '), "пробел неудобен в имени файла");
63 }
64
65 #[test]
66 fn эпоха_считается_верно_в_utc() {
67 // Проверяем сам разбор календаря без смещения пояса.
68 assert_eq!(format_local_utc_for_test(0), "1970-01-01_00-00-00");
69 assert_eq!(format_local_utc_for_test(1_583_020_800), "2020-03-01_00-00-00");
70 }
71
72 /// `format_local`, но со смещением, принудительно занулённым — чтобы
73 /// проверить разбор календаря отдельно от часового пояса машины,
74 /// на которой гоняются тесты.
75 fn format_local_utc_for_test(secs: u64) -> String {
76 let days = (secs / 86_400) as i64;
77 let time = secs % 86_400;
78 let z = days + 719_468;
79 let era = z.div_euclid(146_097);
80 let doe = z.rem_euclid(146_097);
81 let yoe = (doe - doe / 1460 + doe / 36_524 - doe / 146_096) / 365;
82 let y = yoe + era * 400;
83 let doy = doe - (365 * yoe + yoe / 4 - yoe / 100);
84 let mp = (5 * doy + 2) / 153;
85 let d = doy - (153 * mp + 2) / 5 + 1;
86 let m = if mp < 10 { mp + 3 } else { mp - 9 };
87 let y = if m <= 2 { y + 1 } else { y };
88 format!(
89 "{y:04}-{m:02}-{d:02}_{:02}-{:02}-{:02}",
90 time / 3600,
91 (time % 3600) / 60,
92 time % 60
93 )
94 }
95}
96