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 around std::time::SystemTime which implements formatting and manipulation functions * Formatting * RFC3339 timestamp * Formatting with format strings based on Unicode Date Field Symbols. (Which allows formatting SystemTime into basically any string format) * Manipulation * Manipulation functions like DateTime::add or DateTime::sub to create a new, modified DateTime struct * 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.

```rs use astrolabe::{DateTime, Precision, Unit};

// 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").unwrap());

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

asserteq!("2022/05/02 11:23:00", modifieddt.format("yyyy/MM/dd HH:mm:ss").unwrap()); 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.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.