范围

此库适用于 [1970, 4000] 年内的 DateTime 和 schedule。

不支持时区。

月份（>12）、日期（>28、>30、>31）、小时（>23）、分钟/秒（>59）、毫秒（>999）的溢出是不推荐的但允许的，多余的数值将被加到例如 31 月份相当于 1 月份。月份/日期的下溢（=0）将导致 panic。为了避免 panic，请通过 Calendar::validate() 验证手工制作的 DateTime 或通过 Calendar::to_unixtime_opt() 转换为 unixtime。

这些限制背后的原因是保持占用空间合理紧凑并保持性能合理快速，并适应现实生活场景。

典型用法

use chrono_light::prelude::*;

let c = Calendar::create();
let now_in_ms: u64 = 1650412800000;  // represents 20/04/2022 00:00:00:000
let schedule = Schedule {
    start: DateTime { year: 2020, month: 4, day: 30, hour: 0, minute: 0, second: 0, ms: 0 },
    items: vec![(Frequency::Year, 1)],
    end: Some(DateTime { year: 2025, month: 4, day: 30, hour: 0, minute: 0, second: 0, ms: 0 })
};
assert!(c.validate_schedule(&schedule).is_ok());
assert_eq!(Some(10*24*60*60*1000), c.next_occurrence_ms(&c.from_unixtime(now_in_ms), &schedule));  // triggers in 10 days

组件中的实用工具

Chrono-light 作为 scheduler-pallet 的调度机制。