Astrolabe
Status
Astrolabe is currently in heavy development. Please do not use the crate in production yet.
Overview
Astrolabe is a date and time library for Rust which aims to be feature rich, lightweight (zero dependencies) and easy-to-use.
Features
At this stage of development, not all features have been fully implemented.
DateTime, a wrapper aroundstd::time::SystemTimewhich implements formatting and manipulation functions- Formatting
- RFC3339 timestamp
- Formatting with format strings based on Unicode Date Field Symbols. (Which allows formatting
SystemTimeinto basically any string format)
- Manipulation
- Manipulation functions like
DateTime::addorDateTime::subto create a new, modifiedDateTimestruct
- Manipulation functions like
- Timezone
- Specify a timezone offset which will be applied in any format function
- Zero dependencies
Example
A basic example which demonstrates creating, formatting and manipulating a DateTime instance.
use astrolabe::{DateTime, Precision, Unit};
// Create a DateTime instance from year, month, and days (day of month)
let date_time = DateTime::from_ymd(2022, 5, 2).unwrap();
// Use the format function to freely format your `DateTime` instance
assert_eq!("2022/05/02", date_time.format("yyyy/MM/dd").unwrap());
// Create a new instance with a modified `DateTime`
// The previous instance is not modified and is still in scope
let modified_dt = date_time.add(11, Unit::Hour).add(23, Unit::Min);
assert_eq!("2022/05/02 11:23:00", modified_dt.format("yyyy/MM/dd HH:mm:ss").unwrap());
assert_eq!("2022-05-02T11:23:00Z", modified_dt.format_rfc3339(Precision::Seconds));
To see all implementations for the DateTime struct, check out it's documentation.
MSRV
This crate uses the Rust 2021 Edition and requires at least version 1.56.1.
License
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT) at your option.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
7 Dec 2, 2022
4 Sep 21, 2022
294 Dec 23, 2022
162 Dec 31, 2022
20 Dec 29, 2022
14 Aug 5, 2023
221 Dec 26, 2022
5.4k Jan 4, 2023
58 Dec 26, 2022
574 Jan 5, 2023
679 Jan 1, 2023
49 Dec 24, 2022
2.5k Jan 8, 2023
5 Aug 1, 2022
43 Nov 25, 2022
43 Oct 31, 2022
2 Sep 7, 2022
2 May 17, 2022
51 Dec 19, 2022
6 Nov 21, 2022
3 Dec 31, 2022
9 Oct 23, 2022
64 Dec 26, 2022
7 Nov 17, 2021
8 Jul 14, 2022
111 Dec 28, 2022
159 Jan 2, 2023
27 Mar 5, 2022