JapaneseCalendar 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
代表日本曆法。
public ref class JapaneseCalendar : System::Globalization::Calendarpublic class JapaneseCalendar : System.Globalization.Calendar[System.Serializable]
public class JapaneseCalendar : System.Globalization.Calendar[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class JapaneseCalendar : System.Globalization.Calendartype JapaneseCalendar = class
inherit Calendar[<System.Serializable>]
type JapaneseCalendar = class
inherit Calendar[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type JapaneseCalendar = class
inherit CalendarPublic Class JapaneseCalendar
Inherits Calendar- 繼承
- 屬性
備註
日本曆法，也稱為和木曆，運作方式與格里曆完全相同，只是年份和時代不同。
Note
如需在 .NET 中使用 JapaneseCalendar 類別和其他行事曆類別的相關信息，請參閱 使用行事曆。
日本曆法對每位天皇的在位都承認一個時代。 最近的兩個時代分別是平成時代（始於公曆1989年）和令和時代（始於公曆2019年）。 年號通常會顯示在年份之前。 例如，格里曆2001年是日本平成十三年。 請注意，一個時代的第一年稱為「Gannen」。因此，1989年格里曆是日本平成願年。 預設情況下，格式操作會以指定日期與時間格式字串（如「D」、「F」和「Y」）輸出 Gannen 而非結果字串中的「1」。
Important
日本日曆中的紀元基於皇帝的統治，因此預計將改變。 例如，2019 年 5 月 1 日在 JapaneseCalendar 和 JapaneseLunisolarCalendar中標示了 Reiwa 時代的開頭。 這種時代變更會影響使用這些行事曆的所有應用程式。 如需詳細資訊，以及判斷您的應用程式是否受到影響，請參閱 處理 .NET 中日曆中的新紀元。 如需在 Windows 系統上測試應用程式，以確保其準備迎接時代變更的相關信息，請參閱 準備您的應用程式以取得日本年號變更。 如需 .NET 中支援具有多個紀元的行事曆功能，以及使用支援多個紀元的行事曆時的最佳作法，請參閱 使用紀元。
此類別為時代分配編號如下：
| GetEra 值 | 年號 | 紀元縮寫 | 格里曆日期 |
|---|---|---|---|
| 5 | 令和 （Reiwa） | 令和 （R， r） | 2019年5月1日至今 |
| 4 | 平成（Heisei） | 平 （H， h） | 1989年1月8日至2019年4月30日 |
| 3 | 昭和（昭和） | 昭（S， s） | 1926年12月25日至1989年1月7日 |
| 2 | 大正（Taisho） | 大（T， t） | 1912年7月30日至1926年12月24日 |
| 1 | 明治（明治） | 明 （M， m） | 1868年10月23日至1912年7月29日 |
此類別涵蓋明治1年10月23日（格里曆為1868年10月23日）的日期。 雖然日本曆法在明治6年（公曆1873年）由陰曆改為陽曆，但此實施僅基於太陽曆。
日本曆法中的閏年與格里曆相同的閏年相符。 在格里曆中，閏年被定義為一個格里曆年，且能被四整除，除非能被100整除。 然而，可以被400整除的格里曆年是閏年。 平年有365天，閏年有366天。
日本曆法有12個月，每個月有28到31天：
| GetMonth 價值 | 月 | English | 平年的日子 | 閏年的天數 |
|---|---|---|---|---|
| 1 | 1月 （市葛） | 一月 | 31 | 31 |
| 2 | 2月 （Nigatsu） | 二月 | 28 | 二十九 |
| 3 | 3月（三つ） | 三月 | 31 | 31 |
| 4 | 4月（志賀） | 四月 | 30 | 30 |
| 5 | 5月 （五月） | 五月 | 31 | 31 |
| 6 | 6月（六月） | 6 月 | 30 | 30 |
| 7 | 7月 （七葛） | 7 月 | 31 | 31 |
| 8 | 8月（八帳） | 8 月 | 31 | 31 |
| 9 | 9月 （Kugatsu） | 9 月 | 30 | 30 |
| 10 | 10月（十月） | 10 月 | 31 | 31 |
| 11 | 11月 （十一月） | 十一月 | 30 | 30 |
| 12 | 12月 （十國月） | 十二月 | 31 | 31 |
Nigatsu相當於格里曆二月，閏年有29天，平年有28天。
公曆2001年1月1日相當於日本平成十三年的市政元年。
如果是 JapaneseCalendar 日本文化的現行曆法， DateTime.Parse 年份前會標示年號縮寫。 縮寫要麼是單字大小寫不區分的拉丁字母縮寫，要麼是單字漢字縮寫。 DateTime.Parse 同時也承認「1」或元年（Gannen）為元年元年。
每個 CultureInfo 物件都支援一組行事曆。 該 Calendar 屬性回傳該文化的預設日曆，而該 OptionalCalendars 屬性則回傳一個包含該文化所支援的所有日曆的陣列。 要更改 所 CultureInfo使用的日曆，請將屬性設 DateTimeFormatInfo.Calendar 為新的 Calendar。
建構函式
| 名稱 | Description |
|---|---|
| JapaneseCalendar() |
初始化 JapaneseCalendar 類別的新執行個體。 |
欄位
| 名稱 | Description |
|---|---|
| CurrentEra |
代表當前曆法的時代。 此欄位的值為 0。 (繼承來源 Calendar) |
屬性
| 名稱 | Description |
|---|---|
| AlgorithmType |
會得到一個值，表示當前曆法是太陽、月亮或兩者結合。 |
| DaysInYearBeforeMinSupportedYear |
取得該房產指定 MinSupportedDateTime 年份之前的年份天數。 (繼承來源 Calendar) |
| Eras |
取得時代列表。JapaneseCalendar |
| IsReadOnly |
取得一個值，表示該 Calendar 物件是否為唯讀。 (繼承來源 Calendar) |
| MaxSupportedDateTime |
取得目前 JapaneseCalendar 物件所支援的最新日期和時間。 |
| MinSupportedDateTime |
取得目前 JapaneseCalendar 物件支持的最早日期和時間。 |
| TwoDigitYearMax |
取得或設定一個百年範圍的最後一年，該範圍可用兩位數年份表示。 |
