Struct EastAsianTraditional 

pub struct EastAsianTraditional<R>(pub R);

The traditional East-Asian lunisolar calendar.

This calendar used traditionally in China as well as in other countries in East Asia is often used today to track important cultural events and holidays like the Lunar New Year.

The type parameter specifies a particular set of calculation rules and local time information, which differs by country and over time. It must implement the currently-unstable Rules trait, at the moment this crate exports two stable implementors of Rules: China and Korea. Please comment on this issue if you would like to see this trait stabilized.

This corresponds to the "chinese" and "dangi" CLDR calendars respectively, when used with the China and Korea [Rules] types.

Year and Era codes

Unlike most calendars, the traditional East-Asian calendar does not traditionally count years in an infinitely increasing sequence. Instead, 10 “celestial stems” and 12 “terrestrial branches” are combined to form a cycle of year names which repeats every 60 years. However, for the purposes of calendar calculations and conversions, this calendar also counts years based on the Gregorian (ISO) calendar. This “related ISO year” marks the Gregorian year in which a traditional East-Asian year begins.

Because the traditional East-Asian calendar does not traditionally count years, era codes are not used in this calendar.

For more information, suggested reading materials include:

• Calendrical Calculations by Reingold & Dershowitz
• The Mathematics of the Chinese Calendar by Helmer Aslaksen https://citeseerx.ist.psu.edu/viewdoc/download?doi=10.1.1.139.9311&rep=rep1&type=pdf
• Wikipedia: https://en.wikipedia.org/wiki/Chinese_calendar

Months and days

The 12 months (M01-M12) don’t use names in modern usage, instead they are referred to as e.g. 三月 (third month) using Chinese characters.

As a lunar calendar, the lengths of the months depend on the lunar cycle (a month starts on the day of local new moon), and will be either 29 or 30 days. As 12 such months fall short of a solar year, a leap month is inserted roughly every 3 years; this can be after any month (e.g. M02L).

Both the lengths of the months and the occurence of leap months are determined by the concrete [Rules] implementation.

The length of the year is 353-355 days, and the length of the leap year 383-385 days.

Calendar drift

As leap months are determined with respect to the solar year, this calendar stays anchored to the seasons.

Tuple Fields

0: R

Implementations

impl EastAsianTraditional<Korea>

pub const fn new() -> EastAsianTraditional<Korea>

Creates a new KoreanTraditional calendar.

pub fn try_new_with_buffer_provider( _provider: &(impl BufferProvider + ?Sized), ) -> Result<EastAsianTraditional<Korea>, DataError>

👎Deprecated since 2.1.0: use `Self::new()

Use Self::new. A version of Self::new that uses custom data provided by a BufferProvider.

✨ Enabled with the serde feature.

📚 Help choosing a constructor

pub fn try_new_unstable<D>( _provider: &D, ) -> Result<EastAsianTraditional<Korea>, DataError>

where D: ?Sized,

👎Deprecated since 2.1.0: use `Self::new()

Use Self::new. A version of Self::new that uses custom data provided by a DataProvider.

📚 Help choosing a constructor

⚠️ The bounds on provider may change over time, including in SemVer minor releases.

pub fn new_always_calculating() -> EastAsianTraditional<Korea>

👎Deprecated since 2.1.0: use `Self::new()

Use Self::new.

impl EastAsianTraditional<China>

pub const fn new() -> EastAsianTraditional<China>

Creates a new ChineseTraditional calendar.

pub fn try_new_with_buffer_provider( _provider: &(impl BufferProvider + ?Sized), ) -> Result<EastAsianTraditional<China>, DataError>

👎Deprecated since 2.1.0: use `Self::new()

A version of Self::new that uses custom data provided by a BufferProvider.

✨ Enabled with the serde feature.

📚 Help choosing a constructor

pub fn try_new_unstable<D>( _provider: &D, ) -> Result<EastAsianTraditional<China>, DataError>

where D: ?Sized,

👎Deprecated since 2.1.0: use `Self::new()

A version of Self::new that uses custom data provided by a DataProvider.

📚 Help choosing a constructor

⚠️ The bounds on provider may change over time, including in SemVer minor releases.

pub fn new_always_calculating() -> EastAsianTraditional<China>

👎Deprecated since 2.1.0: use `Self::new()

Use Self::new().

Trait Implementations

impl<R> Calendar for EastAsianTraditional<R>

where R: Rules,

fn debug_name(&self) -> &'static str

Obtain a name for the calendar for debug printing

fn month( &self, date: &<EastAsianTraditional<R> as Calendar>::DateInner, ) -> MonthInfo

The calendar-specific month code represented by date; since the Chinese calendar has leap months, an “L” is appended to the month code for leap months. For example, in a year where an intercalary month is added after the second month, the month codes for ordinal months 1, 2, 3, 4, 5 would be “M01”, “M02”, “M02L”, “M03”, “M04”.

fn day_of_month( &self, date: &<EastAsianTraditional<R> as Calendar>::DateInner, ) -> DayOfMonth

The calendar-specific day-of-month represented by date

fn day_of_year( &self, date: &<EastAsianTraditional<R> as Calendar>::DateInner, ) -> DayOfYear

Information of the day of the year

type DateInner = ChineseDateInner<R>

The internal type used to represent dates

type Year = CyclicYear

The type of YearInfo returned by the date

type DifferenceError = Infallible

The type of error returned by until

fn from_codes( &self, era: Option<&str>, year: i32, month_code: MonthCode, day: u8, ) -> Result<<EastAsianTraditional<R> as Calendar>::DateInner, DateError>

Construct a date from era/month codes and fields

fn from_rata_die( &self, rd: RataDie, ) -> <EastAsianTraditional<R> as Calendar>::DateInner

Construct the date from a RataDie

fn to_rata_die( &self, date: &<EastAsianTraditional<R> as Calendar>::DateInner, ) -> RataDie

Obtain a RataDie from this date

fn has_cheap_iso_conversion(&self) -> bool

Whether from_iso/to_iso is more efficient than from_rata_die/to_rata_die.

fn days_in_year( &self, date: &<EastAsianTraditional<R> as Calendar>::DateInner, ) -> u16

Count the number of days in a given year, specified by providing a date from that year

fn days_in_month( &self, date: &<EastAsianTraditional<R> as Calendar>::DateInner, ) -> u8

Count the number of days in a given month, specified by providing a date from that year/month

fn year_info( &self, date: &<EastAsianTraditional<R> as Calendar>::DateInner, ) -> <EastAsianTraditional<R> as Calendar>::Year

Information about the year

fn is_in_leap_year( &self, date: &<EastAsianTraditional<R> as Calendar>::DateInner, ) -> bool

Calculate if a date is in a leap year

fn calendar_algorithm(&self) -> Option<CalendarAlgorithm>

Returns the CalendarAlgorithm that is required to match when parsing into this calendar.

fn months_in_year( &self, date: &<EastAsianTraditional<R> as Calendar>::DateInner, ) -> u8

Count the number of months in a given year, specified by providing a date from that year

fn from_iso(&self, iso: IsoDateInner) -> Self::DateInner

Construct the date from an ISO date.

fn to_iso(&self, date: &Self::DateInner) -> IsoDateInner

Obtain an ISO date from this date.

fn extended_year(&self, date: &Self::DateInner) -> i32

The extended year.

impl CldrCalendar for EastAsianTraditional<China>

type YearNamesV1 = DatetimeNamesYearChineseV1

The data marker for loading year symbols for this calendar.

type MonthNamesV1 = DatetimeNamesMonthChineseV1

The data marker for loading month symbols for this calendar.

type SkeletaV1 = DatetimePatternsDateChineseV1

The data marker for loading skeleton patterns for this calendar.

impl CldrCalendar for EastAsianTraditional<Korea>

type YearNamesV1 = DatetimeNamesYearDangiV1

The data marker for loading year symbols for this calendar.

type MonthNamesV1 = DatetimeNamesMonthDangiV1

The data marker for loading month symbols for this calendar.

type SkeletaV1 = DatetimePatternsDateDangiV1

The data marker for loading skeleton patterns for this calendar.

impl<R> Clone for EastAsianTraditional<R>

where R: Clone,

fn clone(&self) -> EastAsianTraditional<R>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<R> Debug for EastAsianTraditional<R>

where R: Debug,

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<R> Default for EastAsianTraditional<R>

where R: Default,

fn default() -> EastAsianTraditional<R>

Returns the “default value” for a type.

impl From<EastAsianTraditional<China>> for AnyCalendar

fn from(value: EastAsianTraditional<China>) -> AnyCalendar

Converts to this type from the input type.

impl From<EastAsianTraditional<Korea>> for AnyCalendar

fn from(value: EastAsianTraditional<Korea>) -> AnyCalendar

Converts to this type from the input type.

impl IntoAnyCalendar for EastAsianTraditional<China>

fn to_any(self) -> AnyCalendar

Convert this calendar into an AnyCalendar, moving it

fn kind(&self) -> AnyCalendarKind

The AnyCalendarKind enum variant associated with this calendar

fn from_any( any: AnyCalendar, ) -> Result<EastAsianTraditional<China>, AnyCalendar>

Move an AnyCalendar into a Self, or returning it as an error if the types do not match.

fn from_any_ref(any: &AnyCalendar) -> Option<&EastAsianTraditional<China>>

Convert an AnyCalendar reference into a Self reference.

fn date_to_any( &self, d: &<EastAsianTraditional<China> as Calendar>::DateInner, ) -> AnyDateInner

Convert a date for this calendar into an AnyDateInner

impl IntoAnyCalendar for EastAsianTraditional<Korea>

fn to_any(self) -> AnyCalendar

Convert this calendar into an AnyCalendar, moving it

fn kind(&self) -> AnyCalendarKind

The AnyCalendarKind enum variant associated with this calendar

fn from_any( any: AnyCalendar, ) -> Result<EastAsianTraditional<Korea>, AnyCalendar>

Move an AnyCalendar into a Self, or returning it as an error if the types do not match.

fn from_any_ref(any: &AnyCalendar) -> Option<&EastAsianTraditional<Korea>>

Convert an AnyCalendar reference into a Self reference.

fn date_to_any( &self, d: &<EastAsianTraditional<Korea> as Calendar>::DateInner, ) -> AnyDateInner

Convert a date for this calendar into an AnyDateInner

impl<R> Ord for EastAsianTraditional<R>

where R: Ord,

fn cmp(&self, other: &EastAsianTraditional<R>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl<R> PartialEq for EastAsianTraditional<R>

where R: PartialEq,

fn eq(&self, other: &EastAsianTraditional<R>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<R> PartialOrd for EastAsianTraditional<R>

where R: PartialOrd,

fn partial_cmp(&self, other: &EastAsianTraditional<R>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<R> Copy for EastAsianTraditional<R>

where R: Copy,

impl<R> Eq for EastAsianTraditional<R>

where R: Eq,

impl IntoFormattableAnyCalendar for EastAsianTraditional<China>

impl IntoFormattableAnyCalendar for EastAsianTraditional<Korea>

impl<R> StructuralPartialEq for EastAsianTraditional<R>

impl UnstableSealed for EastAsianTraditional<China>

impl UnstableSealed for EastAsianTraditional<Korea>