#timezone #chrono #time #zero #sized #typed #utc

no-std chrono-simpletz

Simple Zero Sized Typed timezones for chrono

5 unstable releases

0.3.0 Jan 20, 2024
0.2.0 Dec 24, 2023
0.1.3 Apr 2, 2021
0.1.1 Apr 1, 2021
0.1.0 Apr 1, 2021

#131 in Date and time

Download history 3/week @ 2023-12-22 9/week @ 2024-01-19 6/week @ 2024-02-16 12/week @ 2024-02-23 4/week @ 2024-03-01 45/week @ 2024-03-08 36/week @ 2024-03-15

98 downloads per month

MIT license

36KB
591 lines

chrono-simpletz

Doc Crate

Simple Zero Sized Typed Utc timezones for chrono. This needs const generic (for rust >= 1.51 in stable).

use chrono::*;
use chrono_simpletz::TimeZoneZst;
use chrono_simpletz::known_timezones::*;
use std::mem::size_of_val;
//construct by new() or Default::default()
let p9 = UtcP9::new();
//size of UtcP9 is zero
assert_eq!(size_of_val(&p9), 0);
assert_eq!(&p9.to_string(), "+09:00");
assert_eq!(UtcP9::IS_IN_VALID_RANGE, true);
let time = p9.ymd(2000, 1, 1).and_hms(12, 00, 00);
let naive_time = NaiveDate::from_ymd_opt(2000, 1, 1).and_hms(3, 0, 0);
assert_eq!(time.naive_utc(), naive_time);
//same size as naive datetime
assert_eq!(size_of_val(&time),size_of_val(&naive_time));
let fixed = time.with_timezone(&p9.fix());
assert_eq!(time, fixed);
//same Display with FixedOffset
assert_eq!(time.to_string(), fixed.to_string());
// smaller size than fixed offset size
assert!(size_of_val(&time) < size_of_val(&fixed) )

features

std (default)

with std

clock (default)

Adds today and now function for TimeZoneZst.

serde

serde_ts_(seconds|milliseconds|microseconds|nanoseconds)(|\_option)

Adds modules for de/serialize functions to use with de/serialize_with function.

serde_ts_rfc3339(|\_option)

Adds modules for de/serialize functions to use with de/serialize_with function. You need this when you want to de/serialize like DateTime<Utc>, because DateTime<UtcZtc<H,M>> cannot impl De/Serialize.

Dependencies

~1–7.5MB
~26K SLoC