#chinese #calendar #lunar #solar #leap

chinese-lunisolar-calendar

The traditional Chinese Calendar, called 農曆 or 陰曆 in Chinese, is based on the moon, so it’s also known as Lunar Calendar

6 releases

new 0.1.5 Aug 21, 2019
0.1.4 Jul 28, 2019
0.1.3 Dec 21, 2018

#18 in Date and time

Download history 5/week @ 2019-05-03 9/week @ 2019-05-10 12/week @ 2019-05-17 17/week @ 2019-05-24 16/week @ 2019-06-07 34/week @ 2019-06-21 16/week @ 2019-06-28 16/week @ 2019-07-05 16/week @ 2019-07-12 4/week @ 2019-07-19 18/week @ 2019-07-26 13/week @ 2019-08-02 14/week @ 2019-08-09

58 downloads per month

MIT license

78KB
1.5K SLoC

Chinese Lunisolar Calendar

Build Status

The traditional Chinese Calendar, called 農曆 or 陰曆 in Chinese, is based on the moon, so it's also known as Lunar Calendar.

Because the cycle of Lunar Calendar is 60 years and there are no regular rules for the days in each lunar month and even the number of months in a lunar year, it's hard to use Lunar Calendar without referencing any other calendars. The Lunisolar Calendar is a way to combine both of the Solar Calendar (Gregorian Calendar) and the Lunar Calendar in order to make it accurate, predictable and useful.

The Lunisolar Calendar relies on three datasets, BIG_MONTHS, LEAP_MONTHS, and NEW_YEAR_DIFFERENCE which are written in the constants.rs file. Currently, the data range is from 1901 to 2100 (lunisolar year), so this Lunisolar Calendar supports from 1901-02-19 to 2101-01-28 (in Solar Calendar).

This library allows you to convert a date between the Lunisolar Calendar and the Solar Calendar, and to compute the weight of Ba Zi(八字). Moreover, it can convert a date to a Chinese text string and parse a Chinese text string to a date in Simple Chinese or Traditional Chinese.

Examples

extern crate chinese_lunisolar_calendar;

use chinese_lunisolar_calendar::chrono::prelude::*;

use chinese_lunisolar_calendar::SolarDate;

let solar_date = SolarDate::from_naive_date(NaiveDate::from_ymd(2019, 1, 15)).unwrap();

assert_eq!("二零一九年一月十五日", solar_date.to_chinese_string());
extern crate chinese_lunisolar_calendar;

use chinese_lunisolar_calendar::chrono::prelude::*;

use chinese_lunisolar_calendar::{ChineseVariant, LunisolarDate};

let lunisolar_date = LunisolarDate::from_naive_date(NaiveDate::from_ymd(2019, 1, 15)).unwrap();

assert_eq!(2019, lunisolar_date.get_solar_year().to_u16());
assert_eq!("二零一八 戊戌、狗年 臘月 初十", lunisolar_date.to_chinese_string(ChineseVariant::Traditional));
assert_eq!("二零一八 戊戌、狗年 腊月 初十", lunisolar_date.to_chinese_string(ChineseVariant::Simple));

assert_eq!(4.3, lunisolar_date.get_ba_zi_weight_by_time(NaiveTime::from_hms(15, 30, 0)));

Crates.io

https://crates.io/crates/chinese-lunisolar-calendar

Documentation

https://docs.rs/chinese-lunisolar-calendar

License

MIT

Dependencies

~0.6–1MB
~15K SLoC