Trait calendrical_calculations::chinese_based::ChineseBased

pub trait ChineseBased {
    const EPOCH: RataDie;
    const EPOCH_ISO: i32;
    const DEBUG_NAME: &'static str;

    // Required method
    fn location(fixed: RataDie) -> Location;

    // Provided methods
    fn extended_from_iso(iso_year: i32) -> i32 { ... }
    fn iso_from_extended(extended_year: i32) -> i32 { ... }
}

The trait ChineseBased is used by Chinese-based calendars to perform computations shared by such calendar. To do so, calendars should:

• Implement fn location by providing a location at which observations of the moon are recorded, which may change over time (the zone is important, long, lat, and elevation are not relevant for these calculations)
• Define const EPOCH as a RataDie marking the start date of the era of the Calendar for internal use, which may not accurately reflect how years or eras are marked traditionally or seen by end-users

Required Associated Constants

const EPOCH: RataDie

The RataDie of the beginning of the epoch used for internal computation; this may not reflect traditional methods of year-tracking or eras, since Chinese-based calendars may not track years ordinally in the same way many western calendars do.

const EPOCH_ISO: i32

The ISO year that corresponds to year 1

const DEBUG_NAME: &'static str

The name of the calendar for debugging.

Required Methods

fn location(fixed: RataDie) -> Location

Given a fixed date, return the location used for observations of the new moon in order to calculate the beginning of months. For multiple Chinese-based lunar calendars, this has changed over the years, and can cause differences in calendar date.

Provided Methods

fn extended_from_iso(iso_year: i32) -> i32

Given an ISO year, return the extended year

fn iso_from_extended(extended_year: i32) -> i32

Given an extended year, return the ISO year

Object Safety

This trait is not object safe.

Implementors

impl ChineseBased for Chinese

const EPOCH: RataDie = CHINESE_EPOCH

const EPOCH_ISO: i32 = -2_636i32

const DEBUG_NAME: &'static str = "chinese"

impl ChineseBased for Dangi

const EPOCH: RataDie = KOREAN_EPOCH

const EPOCH_ISO: i32 = -2_332i32

const DEBUG_NAME: &'static str = "dangi"