Astrolabe

Date and time library for Rust. Feature rich, lightweight and easy-to-use.

Documentation | Github | Crate | Example

Overview

Astrolabe is a date and time library for Rust which aims to be feature rich, lightweight (zero dependencies) and easy-to-use. It implements formatting and manipulating functions for date and time values.

Features

Formatting with format strings based on Unicode Date Field Symbols
RFC3339 timestamp parsing and formatting
Manipulation functions to easily add, remove or set date units
Timezone offset
Zero dependencies

Example

A basic example which demonstrates creating, formatting and manipulating a DateTime instance.

```rust use astrolabe::{DateTime, Precision, DateTimeUnit};

// Create a DateTime instance from year, month, and days (day of month) let datetime = DateTime::fromymd(2022, 5, 2).unwrap();

// Use the format function to freely format your DateTime instance asserteq!("2022/05/02", datetime.format("yyyy/MM/dd"));

// Create a new instance with a modified DateTime // The previous instance is not modified and is still in scope let modifieddt = datetime .apply(11, DateTimeUnit::Hour).unwrap() .apply(23, DateTimeUnit::Min).unwrap();

asserteq!("2022/05/02 11:23:00", modifieddt.format("yyyy/MM/dd HH:mm:ss")); asserteq!("2022-05-02T11:23:00Z", modifieddt.format_rfc3339(Precision::Seconds)); ``To see all implementations for theDateTime` struct, check out it's documentation.

MSRV

This crate uses the Rust 2021 Edition and requires at least version 1.56.

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.