1 unstable release

Uses new Rust 2024

0.0.2 Aug 25, 2025
0.0.1 Aug 24, 2025

#2526 in Algorithms

30 downloads per month

MIT/Apache

24KB
485 lines

Calz   Build Status Latest Version

Status: Work in Progress
This library is not production-ready. APIs and calculations may change, and bugs are expected. Please do not use in production until a stable release is announced.

Calz (calendars(z)) is a Rust library for multi-calendar conversions. Inspired by the book Calendrical Calculations by Dershowitz & Reingold. It aims to be a scientific reference for calendar arithmetic and conversions.

Supported Calendars

  • Coptic
  • Gregorian
  • Islamic

See docs/INTRO.md for a full explanation of calendar, and formulas.

Installation

cargo add calz

Disclaimer

This crate is for educational and research purposes. This crate was developed by translating known calendar algorithms into Rust. Despite careful testing, there may be mistakes in calculations or edge cases. DO NOT use for mission-critical or scientific purposes without verifying results.

Contributing

Contributions, bug reports, and feature requests are welcome!
Feel free to open an issue or submit a pull request. All contributions must comply with the GPLv3 license.

License

Licensed under either of LICENSE-APACHE, Version 2.0 or LICENSE-MIT at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in Calz by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~0.3–1MB
~20K SLoC