CalendarIdentifiers CalendarIdentifiers CalendarIdentifiers CalendarIdentifiers Class

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

Syntax

Declaration

public static class CalendarIdentifierspublic static class CalendarIdentifiersPublic Static Class CalendarIdentifierspublic static class CalendarIdentifiers

Properties summary

Gets the identifier for the Chinese lunisolar calendar.

Gets the identifier for the Gregorian calendar.

Gets the identifier for the Hebrew calendar.

Gets the identifier for the Hijri calendar.

Gets the identifier for the Japanese calendar.

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.

Gets the identifier for the Julian calendar.

Gets the identifier for the Korean calendar.

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.

Gets the identifier for the Persian calendar.

Gets the identifier for the Taiwan calendar.

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.

Gets the identifier for the Thai calendar.

Gets the identifier for the Um Al-Qura calendar.

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.

Properties

  • ChineseLunar
    ChineseLunar
    ChineseLunar
    ChineseLunar

    Gets the identifier for the Chinese lunisolar calendar.

    public static string ChineseLunar { get; }public static string ChineseLunar { get; }Public Static ReadOnly Property ChineseLunar As stringpublic static string ChineseLunar { get; }

    Property Value

    • string
      string
      string
      string

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

    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
    Gregorian

    Gets the identifier for the Gregorian calendar.

    public static string Gregorian { get; }public static string Gregorian { get; }Public Static ReadOnly Property Gregorian As stringpublic static string Gregorian { get; }

    Property Value

    • string
      string
      string
      string

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

    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
    Hebrew

    Gets the identifier for the Hebrew calendar.

    public static string Hebrew { get; }public static string Hebrew { get; }Public Static ReadOnly Property Hebrew As stringpublic static string Hebrew { get; }

    Property Value

    • string
      string
      string
      string

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

    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
    Hijri

    Gets the identifier for the Hijri calendar.

    public static string Hijri { get; }public static string Hijri { get; }Public Static ReadOnly Property Hijri As stringpublic static string Hijri { get; }

    Property Value

    • string
      string
      string
      string

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

    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
    Japanese

    Gets the identifier for the Japanese calendar.

    public static string Japanese { get; }public static string Japanese { get; }Public Static ReadOnly Property Japanese As stringpublic static string Japanese { get; }

    Property Value

    • string
      string
      string
      string

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

    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
    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 string JapaneseLunar { get; }public static string JapaneseLunar { get; }Public Static ReadOnly Property JapaneseLunar As stringpublic static string JapaneseLunar { get; }

    Property Value

    • string
      string
      string
      string

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

    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
    Julian

    Gets the identifier for the Julian calendar.

    public static string Julian { get; }public static string Julian { get; }Public Static ReadOnly Property Julian As stringpublic static string Julian { get; }

    Property Value

    • string
      string
      string
      string

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

    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
    Korean

    Gets the identifier for the Korean calendar.

    public static string Korean { get; }public static string Korean { get; }Public Static ReadOnly Property Korean As stringpublic static string Korean { get; }

    Property Value

    • string
      string
      string
      string

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

    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
    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 string KoreanLunar { get; }public static string KoreanLunar { get; }Public Static ReadOnly Property KoreanLunar As stringpublic static string KoreanLunar { get; }

    Property Value

    • string
      string
      string
      string

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

    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
    Persian

    Gets the identifier for the Persian calendar.

    public static string Persian { get; }public static string Persian { get; }Public Static ReadOnly Property Persian As stringpublic static string Persian { get; }

    Property Value

    • string
      string
      string
      string

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

    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
    Taiwan

    Gets the identifier for the Taiwan calendar.

    public static string Taiwan { get; }public static string Taiwan { get; }Public Static ReadOnly Property Taiwan As stringpublic static string Taiwan { get; }

    Property Value

    • string
      string
      string
      string

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

    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
    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 string TaiwanLunar { get; }public static string TaiwanLunar { get; }Public Static ReadOnly Property TaiwanLunar As stringpublic static string TaiwanLunar { get; }

    Property Value

    • string
      string
      string
      string

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

    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
    Thai

    Gets the identifier for the Thai calendar.

    public static string Thai { get; }public static string Thai { get; }Public Static ReadOnly Property Thai As stringpublic static string Thai { get; }

    Property Value

    • string
      string
      string
      string

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

    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
    UmAlQura

    Gets the identifier for the Um Al-Qura calendar.

    public static string UmAlQura { get; }public static string UmAlQura { get; }Public Static ReadOnly Property UmAlQura As stringpublic static string UmAlQura { get; }

    Property Value

    • string
      string
      string
      string

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

    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
    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 string VietnameseLunar { get; }public static string VietnameseLunar { get; }Public Static ReadOnly Property VietnameseLunar As stringpublic static string VietnameseLunar { get; }

    Property Value

    • string
      string
      string
      string

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

    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.

Device family

Windows 10 (introduced v10.0.10240.0)

API contract

Windows.Foundation.UniversalApiContract (introduced v1)

Attributes

Windows.Foundation.Metadata.ContractVersionAttribute
Windows.Foundation.Metadata.DualApiPartitionAttribute
Windows.Foundation.Metadata.MarshalingBehaviorAttribute
Windows.Foundation.Metadata.StaticAttribute
Windows.Foundation.Metadata.StaticAttribute
Windows.Foundation.Metadata.StaticAttribute
Windows.Foundation.Metadata.ThreadingAttribute

Details

Assembly

Windows.Globalization.dll