Calendar​Identifiers Calendar​Identifiers Calendar​Identifiers Class

Definition

Contains the calendar identifiers for the supported calendars, as static properties.

public static class CalendarIdentifierspublic static class CalendarIdentifiersPublic Static Class CalendarIdentifiers
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Properties

ChineseLunar ChineseLunar ChineseLunar

Gets the identifier for the Chinese lunisolar calendar.

public static PlatForm::String ChineseLunar { get; }public static string ChineseLunar { get; }Public Static ReadOnly Property ChineseLunar As string
Value
string string string

The string "ChineseLunarCalendar", which is the identifier for the Chinese lunar calendar.

Attributes
Additional features and requirements
Device family
Windows 10 Anniversary Edition (introduced v10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v3)

Remarks

This calendar 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 calendar calculates years based on solar calculations, and months and days based on lunar calculations.

A leap month can occur after any month in a year. For example, when you get a month from this calendar, you get 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, getting the month returns 8 for the eighth month, 9 for the leap eighth month, and 10 for the ninth month.

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

Gregorian Gregorian Gregorian

Gets the identifier for the Gregorian calendar.

public static PlatForm::String Gregorian { get; }public static string Gregorian { get; }Public Static ReadOnly Property Gregorian As string
Value
string string string

The string "GregorianCalendar", which is the identifier for the Gregorian calendar.

Attributes

Remarks

The returned identifier is suitable for use anywhere a calendar identifier is required.

The Gregorian calendar recognizes two eras: B.C. or B.C.E., and A.D. or C.E. This implementation of the Gregorian calendar system recognizes only the current era (A.D.).

A leap year in the Gregorian calendar is defined as a year that is evenly divisible by four, except if it is divisible by 100. However, years that are divisible by 400 are leap years. For example, the year 1900 was not a leap year, but the year 2000 was. A common year has 365 days and a leap year has 366 days.

The Gregorian calendar has 12 months with 28 to 31 days each: January (31 days), February (28 or 29 days), March (31 days), April (30 days), May (31 days), June (30 days), July (31 days), August (31 days), September (30 days), October (31 days), November (30 days), and December (31 days). February has 29 days during leap years and 28 during common years.

Gregorian calendar strings for day of the week names and month names are localized for all supported locales and hence will appear in the language corresponding to the ResolvedLanguage property of the calendar object.

Hebrew Hebrew Hebrew

Gets the identifier for the Hebrew calendar.

public static PlatForm::String Hebrew { get; }public static string Hebrew { get; }Public Static ReadOnly Property Hebrew As string
Value
string string string

The string "HebrewCalendar", which is the identifier for the Hebrew calendar.

Attributes

Remarks

The Hebrew calendar recognizes two eras: B.C.E. (before the common era) and C.E. (current era). This implementation of the Hebrew calendar system recognizes only the current era (C.E.) and the Hebrew years 5343 to 5999 (1583 to 2239 in the Gregorian calendar).

In every 19-year cycle that ends with a year that is evenly divisible by 19, the 3rd, 6th, 8th, 11th, 14th, 17th, and 19th years are leap years. A common year can have from 353 to 355 days, depending on the placement of Jewish holidays. A leap year can have from 383 to 385 days.

The Hebrew calendar has 12 months during common years and 13 months during leap years:

MonthAsNumericString (common year)MonthAsNumericString (leap year)MonthDays in common yearsDays in leap years
11תשרי (Tishrei)3030
22חשון (Cheshvan)29/3029/30
33כסלו (Kislev)29/3029/30
44טבת (Tevet)2929
55שבט (Shevat)3030
6-אדר (Adar)29-
-6אדר א (Adar Alef)-30
-7אדר ב (Adar Beit)-29
78ניסן (Nissan)3030
89אייר (Iyar)2929
910סיון (Sivan)3030
1011תמוז (Tamuz)2929
1112אב (Av)3030
1213אלול (Elul)2929

The days in Cheshvan and Kislev vary depending on the placement of Jewish holidays. During leap years, Adar is replaced by Adar Alef with 30 days and Adar Beit with 29 days. Adar Beit is considered the leap month. The last day of Adar Alef and all the days in Adar Beit are considered leap days.

The date January 1, 2012 A.D. in the Gregorian calendar is equivalent to the sixth day of Tevet in the year 5772 C.E. in the Hebrew calendar.

Hebrew calendar strings for day of the week names and month names are not localized and hence will appear in Hebrew regardless of the current value of the ResolvedLanguage property of the calendar object.

Hijri Hijri Hijri

Gets the identifier for the Hijri calendar.

public static PlatForm::String Hijri { get; }public static string Hijri { get; }Public Static ReadOnly Property Hijri As string
Value
string string string

The string "HijriCalendar", which is the identifier for the Hijri calendar.

Attributes

Remarks

The Hijri calendar system recognizes one era: A.H. (Latin "Anno Hegirae", which means "the year of the migration", in reference to the migration of Muhammad from Mecca).

In every 30-year cycle that ends with a year that is evenly divisible by 30, the 2nd, 5th, 7th, 10th, 13th, 16th, 18th, 21st, 24th, 26th, and 29th years are leap years. A common year has 354 days and a leap year has 355 days.

The Hijri calendar has 12 months with 29 to 30 days each:

MonthAsNumericString MonthDays in common yearsDays in leap years
1محرم (Muharram)3030
2صفر (Safar)2929
3‏ربيع الاول (Rabi I)3030
4‏ربيع الثاني (Rabi II)2929
5جمادى الاولى (Jumada I)3030
6جمادى الثانية (Jumada II)2929
7رجب (Rajab)3030
8شعبان (Shaban)2929
9رمضان (Ramadan)3030
10شوال (Shawwal)2929
11ذو القعدة (Zulkadah)3030
12ذو الحجة (Zulhijjah)2930

Ramadan, the month of fasting in the Muslim world, officially starts and ends according to a decree that is based on the observation of the new moon. Therefore, the number of days in Shaban and the number of days in Ramadan vary.

The date January 1, 2012 A.D. in the Gregorian calendar is roughly equivalent to the seventh day of Safar in the year 1433 A.H. in the Hijri calendar.

Hijri calendar strings for day of the week names and month names are not localized and hence will appear in Arabic regardless of the current value of the ResolvedLanguage property of the calendar object.

Japanese Japanese Japanese

Gets the identifier for the Japanese calendar.

public static PlatForm::String Japanese { get; }public static string Japanese { get; }Public Static ReadOnly Property Japanese As string
Value
string string string

The string "JapaneseCalendar", which is the identifier for the Japanese calendar.

Attributes

Remarks

The Japanese calendar, also known as the Wareki calendar, works exactly like the Gregorian calendar, except that the year and era are different.

The Japanese calendar recognizes one era for every emperor's reign. The current era is the Heisei era, which began in the Gregorian calendar year 1989. The era name is typically displayed before the year. For example, the Gregorian calendar year 2012 is the Japanese calendar year Heisei 24.

The CalendarIdentifiers class assigns numbers to the Japanese eras as follows:

Era valueEraAsString Gregorian Dates
4平成 (Heisei)January 8, 1989 to present
3昭和 (Showa)December 25, 1926 to January 7, 1989
2大正 (Taisho)July 30, 1912 to December 24, 1926
1明治 (Meiji)January 1, 1868 to July 29, 1912

The CalendarIdentifiers class handles dates only from the first day of the first month in the year Meiji 1 (January 1, 1868 of the Gregorian calendar). Although the Japanese calendar was switched from a lunar calendar to a solar calendar in the year Meiji 6 (1873 of the Gregorian calendar), this implementation is based on the solar calendar only.

Leap years in the Japanese calendar correspond to the same leap years in the Gregorian calendar. A leap year in the Gregorian calendar is defined as a Gregorian year that is evenly divisible by four, except if it is divisible by 100. However, Gregorian years that are divisible by 400 are leap years. A common year has 365 days and a leap year has 366 days.

The Japanese calendar has 12 months with 28 to 31 days each:

MonthAsNumericString MonthEnglishDays in common yearsDays in leap years
11月 (Ichigatsu)January3131
22月 (Nigatsu)February2829
33月 (Sangatsu)March3131
44月 (Shigatsu)April3030
55月 (Gogatsu)May3131
66月 (Rokugatsu)June3030
77月 (Shichigatsu)July3131
88月 (Hachigatsu)August3131
99月 (Kugatsu)September3030
1010月 (Juugatsu)October3131
1111月 (Juuichigatsu)November3030
1212月 (Juunigatsu)December3131

Nigatsu, which is equivalent to the Gregorian calendar month of February, has 29 days during leap years and 28 during common years.

The date January 1, 2012 A.D. in the Gregorian calendar is equivalent to the first day of Ichigatsu in the year Heisei 24 in the Japanese calendar.

Japanese calendar strings for era, day of the week names and month names are not localized and hence will appear in Japanese regardless of the current value of the ResolvedLanguage property of the calendar object.

JapaneseLunar JapaneseLunar JapaneseLunar

This name is reserved for a future update. Do not access or use this property in your code, as accessing the property will result in errors or exceptions being thrown.

public static PlatForm::String JapaneseLunar { get; }public static string JapaneseLunar { get; }Public Static ReadOnly Property JapaneseLunar As string
Value
string string string

The string "JapaneseLunarCalendar", which is the identifier for the Japanese lunar calendar.

Attributes
Additional features and requirements
Device family
Windows 10 Anniversary Edition (introduced v10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v3)

Remarks

This name is reserved for a future update. Do not access or use this property in your code, as accessing the property will result in errors or exceptions being thrown.

Julian Julian Julian

Gets the identifier for the Julian calendar.

public static PlatForm::String Julian { get; }public static string Julian { get; }Public Static ReadOnly Property Julian As string
Value
string string string

The string "JulianCalendar", which is the identifier for the Julian calendar.

Attributes

Remarks

In 45 B.C., Julius Caesar ordered a calendar reform, which resulted in the calendar called the Julian calendar. The Julian calendar is the predecessor of the Gregorian calendar.

The Julian calendar system recognizes only the current era.

Unlike the Gregorian calendar, the Julian calendar defines a leap year as a year that is evenly divisible by four with no exceptions. Therefore, the calendar is inaccurate by one day every 128 years. A common year has 365 days and a leap year has 366 days.

Like the Gregorian calendar, the Julian calendar has 12 months with 28 to 31 days each: January (31 days), February (28 or 29 days), March (31 days), April (30 days), May (31 days), June (30 days), July (31 days), August (31 days), September (30 days), October (31 days), November (30 days), and December (31 days). February has 29 days during leap years and 28 during common years.

The date January 1, 2012 A.D. in the Gregorian calendar is equivalent to the 19th day of December in the year 2011 in the Julian calendar.

Julian calendar strings for day of the week names and month names are localized for all supported locales and hence will appear in the language corresponding to the ResolvedLanguage property of the calendar object.

Korean Korean Korean

Gets the identifier for the Korean calendar.

public static PlatForm::String Korean { get; }public static string Korean { get; }Public Static ReadOnly Property Korean As string
Value
string string string

The string "KoreanCalendar", which is the identifier for the Korean calendar.

Attributes

Remarks

The Korean calendar is exactly like the Gregorian calendar, except that the year and era are different.

The Korean calendar system recognizes only the current era.

Leap years in the Korean calendar correspond to the same leap years in the Gregorian calendar. A leap year in the Gregorian calendar is defined as a Gregorian year that is evenly divisible by four, except if it is divisible by 100. However, Gregorian years that are divisible by 400 are leap years. A common year has 365 days and a leap year has 366 days.

The Korean calendar has 12 months with 28 to 31 days each:

MonthAsNumericString MonthDays in common yearsDays in leap years
11월 (January)3131
22월 (February)2829
33월 (March)3131
44월 (April)3030
55월 (May)3131
66월 (June)3030
77월 (July)3131
88월 (August)3131
99월 (September)3030
1010월 (October)3131
1111월 (November)3030
1212월 (December)3131

February has 29 days during leap years and 28 days during common years.

The date January 1, 2012 A.D. in the Gregorian calendar is equivalent to the first day of January in the year 4345 of the current era in the Korean calendar.

Because the Korean calendar corresponds to the Gregorian calendar, Korean calendar strings for day of the week names and month names are localized for all supported locales and hence will appear in the language corresponding to the ResolvedLanguage property of the calendar object.

KoreanLunar KoreanLunar KoreanLunar

This name is reserved for a future update. Do not access or use this property in your code, as accessing the property will result in errors or exceptions being thrown.

public static PlatForm::String KoreanLunar { get; }public static string KoreanLunar { get; }Public Static ReadOnly Property KoreanLunar As string
Value
string string string

The string "KoreanLunarCalendar", which is the identifier for the Korean lunar calendar.

Attributes
Additional features and requirements
Device family
Windows 10 Anniversary Edition (introduced v10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v3)

Remarks

This name is reserved for a future update. Do not access or use this property in your code, as accessing the property will result in errors or exceptions being thrown.

Persian Persian Persian

Gets the identifier for the Persian calendar.

public static PlatForm::String Persian { get; }public static string Persian { get; }Public Static ReadOnly Property Persian As string
Value
string string string

The string "PersianCalendar", which is the identifier for the Persian calendar.

Attributes

Remarks

The Persian calendar is used in most countries where Persian is spoken, although some regions use different month names. The Persian calendar is the official calendar of Iran and Afghanistan, and it is one of the alternative calendars in regions such as Kazakhstan and Tajikistan.

Dates in the Persian calendar start from the year of the Hijra, which corresponds to 622 C.E. and is the year when Muhammad (PBUH) migrated from Mecca to Medina. For example, the date March 21, 2002 C.E. corresponds to the first day of the month of Farvardeen in the year 1381 Anno Persico.

The Persian calendar is based on a solar year and is approximately 365 days long. A year cycles through four seasons, and a new year begins when the sun appears to cross the equator from the southern hemisphere to the northern hemisphere as viewed from the center of the Earth. The new year marks the first day of the month of Farvardeen, which is the first day of spring in the northern hemisphere.

Each of the first six months in the Persian calendar has 31 days, each of the next five months has 30 days, and the last month has 29 days in a common year and 30 days in a leap year. A leap year is a year that, when divided by 33, has a remainder of 1, 5, 9, 13, 17, 22, 26, or 30. For example, the year 1370 is a leap year because dividing it by 33 yields a remainder of 17. There are approximately eight leap years in every 33-year cycle.

Taiwan Taiwan Taiwan

Gets the identifier for the Taiwan calendar.

public static PlatForm::String Taiwan { get; }public static string Taiwan { get; }Public Static ReadOnly Property Taiwan As string
Value
string string string

The string "TaiwanCalendar", which is the identifier for the Taiwan calendar.

Attributes

Remarks

The Taiwan calendar works exactly like the Gregorian calendar, except that the year and era are different. The Taiwan calendar system recognizes only the current era.

Leap years in the Taiwan calendar correspond to the same leap years in the Gregorian calendar. A leap year in the Gregorian calendar is defined as a Gregorian year that is evenly divisible by four, except if it is divisible by 100. However, Gregorian years that are divisible by 400 are leap years. A common year has 365 days and a leap year has 366 days.

The Taiwan calendar has 12 months with 28 to 31 days each:

MonthAsNumericString MonthDays in common yearsDays in leap years
11月 (January)3131
22月 (February)2829
33月 (March)3131
44月 (April)3030
55月 (May)3131
66月 (June)3030
77月 (July)3131
88月 (August)3131
99月 (September)3030
1010月 (October)3131
1111月 (November)3030
1212月 (December)3131

February has 29 days during leap years and 28 during common years.

The date January 1, 2012 C.E. in the Gregorian calendar is equivalent to the first day of January in the year 101 of the current era in the Taiwan calendar.

Because the Taiwan calendar corresponds to the Gregorian calendar, Taiwan calendar strings for day of the week names and month names are localized for all supported locales and hence will appear in the language corresponding to the ResolvedLanguage property of the calendar object.

TaiwanLunar TaiwanLunar TaiwanLunar

This name is reserved for a future update. Do not access or use this property in your code, as accessing the property will result in errors or exceptions being thrown.

public static PlatForm::String TaiwanLunar { get; }public static string TaiwanLunar { get; }Public Static ReadOnly Property TaiwanLunar As string
Value
string string string

The string "TaiwanLunarCalendar", which is the identifier for the Taiwan Lunar calendar.

Attributes
Additional features and requirements
Device family
Windows 10 Anniversary Edition (introduced v10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v3)

Remarks

This name is reserved for a future update. Do not access or use this property in your code, as accessing the property will result in errors or exceptions being thrown.

Thai Thai Thai

Gets the identifier for the Thai calendar.

public static PlatForm::String Thai { get; }public static string Thai { get; }Public Static ReadOnly Property Thai As string
Value
string string string

The string "ThaiCalendar", which is the identifier for the Thai calendar.

Attributes

Remarks

The Thai calendar works exactly like the Gregorian calendar, except that the year and era are different.

The Thai calendar system recognizes only the current era.

Leap years in the Thai calendar correspond to the same leap years in the Gregorian calendar. A leap year in the Gregorian calendar is defined as a Gregorian year that is evenly divisible by four, except if it is divisible by 100. However, Gregorian years that are divisible by 400 are leap years. A common year has 365 days and a leap year has 366 days. The Thai calendar has 12 months with 28 to 31 days each:

MonthAsNumericString MonthDays in common yearsDays in leap years
1มกราคม (January)3131
2กุมภาพันธ์ (February)2829
3มีนาคม (March)3131
4เมษายน (April)3030
5พฤษภาคม (May)3131
6มิถุนายน (June)3030
7กรกฎาคม (July)3131
8สิงหาคม (August)3131
9กันยายน (September)3030
10ตุลาคม (October)3131
11พฤศจิกายน (November)3030
12ธันวาคม (December)3131

February has 29 days during leap years and 28 during common years.

The date January 1, 2012 A.D. in the Gregorian calendar is equivalent to the first day of January in the year 2555 of the current era in the Thai calendar.

Because the Thai calendar corresponds to the Gregorian calendar, Thai calendar strings for day of the week names and month names are localized for all supported locales and hence will appear in the language corresponding to the ResolvedLanguage property of the calendar object.

UmAlQura UmAlQura UmAlQura

Gets the identifier for the Um Al-Qura calendar.

public static PlatForm::String UmAlQura { get; }public static string UmAlQura { get; }Public Static ReadOnly Property UmAlQura As string
Value
string string string

The string "UmAlQuraCalendar", which is the identifier for the Um Al-Qura calendar.

Attributes

Remarks

The Um Al-Qura calendar or Saudi Hijri system is nearly identical to the Hijri calendar system, except in using a table-based algorithm licensed from the Saudi government to calculate dates, and in supporting dates only for the years 1318 to 1500 (corresponding approximately to Gregorian dates April 30, 1900 through November 16, 2077).

For the Um Al-Qura calendar, each month has either 29 or 30 days, but usually in no discernible order. Whereas the documentation for the Hijri calendar gives a table that shows the corresponding days in each month, no such general table can be produced for the Um Al-Qura calendar.

Like the Hijri calendar, Um Al-Qura calendar strings for day of the week names and month names are not localized and hence will appear in Arabic regardless of the current value of the ResolvedLanguage property of the calendar object.

VietnameseLunar VietnameseLunar VietnameseLunar

This name is reserved for a future update. Do not access or use this property in your code, as accessing the property will result in errors or exceptions being thrown.

public static PlatForm::String VietnameseLunar { get; }public static string VietnameseLunar { get; }Public Static ReadOnly Property VietnameseLunar As string
Value
string string string

The string "VietnameseLunarCalendar", which is the identifier for the Vietnamese lunar calendar.

Attributes
Additional features and requirements
Device family
Windows 10 Anniversary Edition (introduced v10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v3)

Remarks

This name is reserved for a future update. Do not access or use this property in your code, as accessing the property will result in errors or exceptions being thrown.

See Also