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- 繼承
- 屬性
備註
日曆也稱為 Wareki 行事曆，其運作方式與公曆完全相同，不同之處在於年份和紀元不同。
注意
如需在 .NET 中使用 JapaneseCalendar 類別和其他行事曆類別的相關信息，請參閱 使用行事曆。
日曆可辨識每一個紀元的重新簽署。 最近兩個紀元是 Heisei 紀元，從公曆年 1989 開始，而 Reiwa 紀元則從公曆年 2019 開始。 紀元名稱通常會顯示在年份之前。 例如，公曆年 2001 年是日曆年份 Heisei 13。 請注意，紀元的第一年稱為 “Gannen”。因此，公曆年 1989 是日曆年 Heisei Gannen。 根據預設，格式化具有指定日期和時間格式字串的作業，例如 “D”、“F” 和 “Y”，輸出 Gannen，而不是結果字串中的 “1”。
重要
日本曆法的紀元是以天皇的統治為基礎，因此有變更是正常的。 例如，2019 年 5 月 1 日之後，JapaneseCalendar 與 JapaneseLunisolarCalendar 中將開始使用「令和」。 此變更對使用這些日曆的所有應用程式都有影響。 如需詳細資訊，以及判斷您的應用程式是否受到影響，請參閱 在 .NET 的日曆中處理新紀元。 如需在 Windows 系統上測試應用程式以確保其整備時間變更的相關信息，請參閱 準備您的應用程式以進行日文紀元變更。 如需 .NET 中支援多個紀元的行事曆功能，以及使用支援多個紀元的行事歷時的最佳做法，請參閱 使用紀元。
此類別會將數位指派給紀元，如下所示：
| GetEra 值 | 紀元名稱 | 紀元縮寫 | 公曆日期 |
|---|---|---|---|
| 5 | (Reiwa) | 管理與 (R、r) | 2019 年 5 月 1 日至目前 |
| 4 | 平成 (Heisei) | 平 (H、 h) | 1989 年 1 月 8 日到 2019 年 4 月 30 日 |
| 3 | (Showa) | (S) | 1926 年 12 月 25 日到 1989 年 1 月 7 日 |
| 2 | 大正 (Taisho) | 大 (T， t) | 1912 年 7 月 30 日到 1926 年 12 月 24 日 |
| 1 | (Meiji) | 明 (M， m) | 1868 年 9 月 8 日到 1912 年 7 月 29 日 |
此類別會處理 Meiji 1 年 9 月 8 日 (公曆 1868 年 9 月 8 日) 的日期。 雖然日曆從月曆切換為 Meiji 6 (1873 年公曆) 的月曆，但此實作僅以太陽能歷為基礎。
日曆中的閏年對應至公曆中的相同閏年。 公曆中的閏年會定義為公曆的公曆年，該年會平均除以四個，除非 100 會將其除開。 不過，由 400 除的公曆年是閏年。 一般年份有 365 天，而閏年有 366 天。
日曆有 12 個月，每個月 28 到 31 天：
| GetMonth 值 | Month | 英文 | 常見年份的天數 | 閏年天數 |
|---|---|---|---|---|
| 1 | 1 月 (一月) | 一月 | 31 | 31 |
| 2 | 2 月 (Nigatsu) | 二月 | 28 | 29 |
| 3 | 3 月 (Stsutsu) | 3 月 | 31 | 31 |
| 4 | 4 月 (Shigatsu) | 四月 | 30 | 30 |
| 5 | 5 月 (Gogatsu) | 五月 | 31 | 31 |
| 6 | 6 月 (Rokugatsu) | 6 月 | 30 | 30 |
| 7 | 7 月 (Shichigatsu) | 7 月 | 31 | 31 |
| 8 | 8 月 (Hachigatsu) | 8 月 | 31 | 31 |
| 9 | 9 月 (Kugatsu) | 9 月 | 30 | 30 |
| 10 | 10 月 (Juugatsu) | 10 月 | 31 | 31 |
| 11 | 11 月 (Juutsugatsu) | 11 月 | 30 | 30 |
| 12 | 12 月 (Juunigatsu) | 12 月 | 31 | 31 |
Nigatsu 相當於 2 月的公曆月，在閏年和一般年份有 28 天。
2001 年 1 月 1 日 A.D 中的日期，相當於日曆的 Heisei 13 年第一天。
JapaneseCalendar如果 是日本文化的目前行事曆，DateTime.Parse則會辨識年份前面的紀元縮寫。 縮寫是單一字元不區分大小寫的拉丁字母縮寫或單一字元漢字縮寫。 DateTime.Parse 也會辨識 「1」 或 Gannen (元年) 為紀元的第一年。
每個 CultureInfo 物件都支援一組行事曆。 屬性 Calendar 會傳回文化特性的預設行事曆，而 OptionalCalendars 屬性會傳回陣列，其中包含文化特性支援的所有行事曆。 若要變更 所使用的 CultureInfo行事曆，請將 DateTimeFormatInfo.Calendar 屬性設定為新的 Calendar。
建構函式
| JapaneseCalendar() |
初始化 JapaneseCalendar 類別的新執行個體。 |
欄位
| CurrentEra |
表示目前曆法的目前紀元。 此欄位的值為 0。 (繼承來源 Calendar) |
屬性
| AlgorithmType |
取得值，指出目前的月曆是以陽曆為主、以陰曆為主，還是同時包含兩種曆法。 |
| AlgorithmType |
取得值，指出目前的月曆是以陽曆為主、以陰曆為主，還是同時包含兩種曆法。 (繼承來源 Calendar) |
| DaysInYearBeforeMinSupportedYear |
取得 MinSupportedDateTime 屬性指定之年的前一年的天數。 (繼承來源 Calendar) |
| Eras |
取得 JapaneseCalendar 中的紀元清單。 |
| IsReadOnly |
取得值，指出 Calendar 物件是否為唯讀。 (繼承來源 Calendar) |
| MaxSupportedDateTime |
取得受目前 JapaneseCalendar 物件所支援的最晚日期和時間。 |
| MaxSupportedDateTime |
取得受 Calendar 物件所支援的最晚日期和時間。 (繼承來源 Calendar) |
| MinSupportedDateTime |
取得受目前 JapaneseCalendar 物件所支援的最早日期和時間。 |
| MinSupportedDateTime |
取得受 Calendar 物件所支援的最早日期和時間。 (繼承來源 Calendar) |
| TwoDigitYearMax |
取得或設定以二位數年份表示時，該 100 年範圍的最後一年。 |
