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 类和其他日历类的信息，请参阅 使用日历。
日本历承认每个皇帝统治的一个时代。 最近两个时代是海西时代，从1989年的公历年开始，从2019年公历年开始的雷瓦时代。 纪元名称通常显示在年份之前。 例如，2001 年公历年是日本日历年 Heisei 13。 请注意，一个时代的第一年被称为“甘宁”。因此，1989年公历年是日本历年海西甘宁。 默认情况下，使用指定的日期和时间格式字符串（如“D”、“F”和“Y”）的格式设置操作，输出 Gannen 而不是结果字符串中的“1”。
Important
日本日历中的纪元基于皇帝的统治，因此预计将改变。 例如，2019 年 5 月 1 日在 JapaneseCalendar 和 JapaneseLunisolarCalendar 中标志着令和年号的开始。 这种时代变化会影响使用这些日历的所有应用程序。 有关详细信息以及确定您的应用程序是否受到影响，请参阅 在 .NET 中处理日语日历的新纪元。 有关在 Windows 系统上测试应用程序以确保其为纪元更改做好准备的信息，请参阅 为日本时代更改准备应用程序。 有关支持具有多个纪元的日历以及处理支持多个纪元的日历的最佳做法的 .NET 中的功能，请参阅 “使用纪元”。
此类将数字分配给纪元，如下所示：
| GetEra 值 | 纪元名称 | 纪元缩写 | 公历日期 |
|---|---|---|---|
| 5 | 令和 （Reiwa） | 令和 （R， r） | 2019 年 5 月 1 日至今 |
| 4 | 平成 （海西） | 平 （H， h） | 1989 年 1 月 8 日至 2019 年 4 月 30 日 |
| 3 | 昭和 （Showa） | 昭 （S， s） | 1926年12月25日至1989年1月7日 |
| 2 | 大正 （大正） | 大 （T， t） | 1912 年 7 月 30 日至 1926 年 12 月 24 日 |
| 1 | 明治 （梅吉） | 明 （M， m） | 1868 年 10 月 23 日到 1912 年 7 月 29 日 |
此类处理日期从 10 月 23 日（在公历，1868 年 10 月 23 日）。 虽然日本日历从农历改为“梅吉六”（公历1873年）的一年日历，但这一实现仅基于太阳历。
日本日历中的 Leap 年对应于公历中的同一跃年。 公历中的一个跃年定义为公历的公历年，该年被四者均匀地分割，除非它被 100 分割。 然而，被400分可见的公历年是飞跃年。 常见年份有 365 天，跃年有 366 天。
日本日历有 12 个月，每个月 28 到 31 天：
| GetMonth 值 | 月 | 英语 | 常见年份中的天数 | 跨越年份中的天数 |
|---|---|---|---|---|
| 1 | 1 月 （Ichigatsu） | 1 月 | 31 | 31 |
| 2 | 2 月 （日松） | 2 月 | 28 | 二十九 |
| 3 | 3 月 （桑加松） | 三月 | 31 | 31 |
| 4 | 4 月 （石加松） | 4 月 | 30 | 30 |
| 5 | 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 月 （朱一加松） | 11 月 | 30 | 30 |
| 12 | 12 月 （朱尼加松） | 12 月 | 31 | 31 |
Nigatsu 相当于 2 月的公历月，在跨年有 29 天，在普通年份有 28 天。
2001年1月1日，公历的A.D.相当于日历第一天一日。
JapaneseCalendar如果这是日本文化的当前日历，DateTime.Parse则识别年度前的纪元缩写。 缩写是单字符不区分大小写的拉丁字母缩写或单字符汉字缩写。 DateTime.Parse 还承认“1”或甘宁（元年）是时代的第一年。
每个 CultureInfo 对象支持一组日历。 该 Calendar 属性返回区域性的默认日历，该 OptionalCalendars 属性返回包含区域性支持的所有日历的数组。 若要更改 a CultureInfo使用的日历，请将 DateTimeFormatInfo.Calendar 属性设置为新 Calendar日历。
构造函数
| 名称 | 说明 |
|---|---|
| JapaneseCalendar() |
初始化 JapaneseCalendar 类的新实例。 |
字段
| 名称 | 说明 |
|---|---|
| CurrentEra |
表示当前日历的当前纪元。 此字段的值为 0。 (继承自 Calendar) |
属性
| 名称 | 说明 |
|---|---|
| AlgorithmType |
获取一个值，该值指示当前日历是基于太阳的、基于月球的还是两者的组合。 |
| DaysInYearBeforeMinSupportedYear |
获取属性指定的 MinSupportedDateTime 年份之前的年份中的天数。 (继承自 Calendar) |
| Eras |
获取 . 中的 JapaneseCalendar纪元列表。 |
| IsReadOnly |
获取一个值，该值指示此 Calendar 对象是否为只读。 (继承自 Calendar) |
| MaxSupportedDateTime |
获取当前 JapaneseCalendar 对象支持的最新日期和时间。 |
| MinSupportedDateTime |
获取当前 JapaneseCalendar 对象支持的最早日期和时间。 |
| TwoDigitYearMax |
获取或设置一个 100 年范围的上一年，该范围可以由 2 位年份表示。 |
