System.Globalization.ChineseLunisolarCalendar Class

Represents time in divisions, such as months, days, and years. Years are calculated using the Chinese calendar, while days and months are calculated using the lunisolar calendar.

See Also: ChineseLunisolarCalendar Members

Syntax

public class ChineseLunisolarCalendar : EastAsianLunisolarCalendar

Remarks

The System.Globalization.ChineseLunisolarCalendar class is derived from the System.Globalization.EastAsianLunisolarCalendar class, which represents the lunisolar calendar. The System.Globalization.EastAsianLunisolarCalendar class supports the sexagenary year cycle (which repeats every 60 years) in addition to solar years and lunar months. Each solar year in the calendar is associated with a Sexagenary Year, a Celestial Stem, and a Terrestrial Branch, and these calendars can have leap months after any month of the year. The System.Globalization.ChineseLunisolarCalendar class calculates years based on solar calculations, and months and days based on lunar calculations.

Note:

For information about using the System.Globalization.ChineseLunisolarCalendar class and the other calendar classes in the .NET Framework, see Working with Calendars.

A leap month can occur after any month in a year. For example, the EastAsianLunisolarCalendar.GetMonth(DateTime) method returns a number between 1 and 13 that indicates the month associated with a specified date. If there is a leap month between the eighth and ninth months of the year, the EastAsianLunisolarCalendar.GetMonth(DateTime) method returns 8 for the eighth month, 9 for the leap eighth month, and 10 for the ninth month.

Currently, the System.Globalization.ChineseLunisolarCalendar is not used by any of the cultures supported by the System.Globalization.CultureInfo class. Therefore, this class can be used only to calculate dates in the Chinese lunisolar calendar.

Each System.Globalization.CultureInfo object supports a set of calendars. The CultureInfo.Calendar property returns the default calendar for the culture, and the CultureInfo.OptionalCalendars property returns an array containing all the calendars supported by the culture. To change the calendar used by a System.Globalization.CultureInfo, the application should set the DateTimeFormatInfo.Calendar property of CultureInfo.DateTimeFormat to a new System.Globalization.Calendar.

Requirements

Namespace: System.Globalization
Assembly: mscorlib (in mscorlib.dll)
Assembly Versions: 2.0.0.0, 4.0.0.0
Since: .NET 2.0