JapaneseCalendar JapaneseCalendar JapaneseCalendar JapaneseCalendar Class

定义

表示日本历。Represents the Japanese calendar.

public ref class JapaneseCalendar : System::Globalization::Calendar
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class JapaneseCalendar : System.Globalization.Calendar
type JapaneseCalendar = class
    inherit Calendar
Public Class JapaneseCalendar
Inherits Calendar
继承
JapaneseCalendarJapaneseCalendarJapaneseCalendarJapaneseCalendar
属性

注解

不过,一年和纪元是不同,日语日历,这是也称为 Wareki 日历,工作方式完全相同公历日历。The Japanese calendar, which is also known as the Wareki calendar, works exactly like the Gregorian calendar, except that the year and era are different.

备注

有关使用信息JapaneseCalendar类和其他日历类在.NET 中的,请参阅使用日历For information about using the JapaneseCalendar class and the other calendar classes in .NET, see Working with Calendars.

日本历识别为每个皇帝 reign 一个纪元。The Japanese calendar recognizes one era for every emperor's reign. 两个最新纪元是日本平成 12 时代,公历 1989 年,从开始和 Reiwa 时代,从开始公历 2019 年。The two most recent eras are the Heisei era, beginning in the Gregorian calendar year 1989, and the Reiwa era, beginning in the Gregorian calendar year 2019. 纪元名称通常显示年份。The era name is typically displayed before the year. 例如,公历 2001 年为日语日历年平成 13。For example, the Gregorian calendar year 2001 is the Japanese calendar year Heisei 13. 请注意,第一年的某个时间段称为"元年。"Note that the first year of an era is called "Gannen." 因此,公历 1989 年是日语日历平成元年。Therefore, the Gregorian calendar year 1989 was the Japanese calendar year Heisei Gannen. 默认情况下的格式设置操作指定的日期和时间格式字符串,例如"D"、"F"和"Y",输出元年而不是"1"中的结果字符串。By default, formatting operations with specified date and time format strings, such as "D", "F", and "Y", output Gannen rather than "1" in the result string.

重要

日本历法中的年号是根据天皇统治来命名的,因此预计会发生变化。Eras in the Japanese calendars are based on the emperor's reign and are therefore expected to change. 例如,2019 年 5 月 1 日在 JapaneseCalendarJapaneseLunisolarCalendar 中标志着令和年号的开始。For example, May 1, 2019 marked the beginning of the Reiwa era in the JapaneseCalendar and JapaneseLunisolarCalendar. 这种年号的变化会影响使用这些日历的所有应用程序。Such a change of era affects all applications that use these calendars. 请参阅 Handling a new era in the Japanese calendar in .NET(使用 .NET 处理日语日历中的新元号),了解详细信息并确定是否会影响你的应用程序。See Handling a new era in the Japanese calendar in .NET for more information and to determine whether your applications are affected. 请参阅针对日语元号更改准备应用程序,了解有关在 Windows 系统上测试应用程序以确保针对元号更改的准备情况信息。See Prepare your application for the Japanese era change for information on testing your applications on Windows systems to ensure their readiness for the era change. 有关 .Net 中支持多个年号日历的功能,以及在使用支持多个年号的日历时的最佳做法,请参阅使用年号See Working with eras for features in .NET that support calendars with multiple eras and for best practices when working with calendars that support multiple eras.

此类将分配数字到纪元,如下所示:This class assigns numbers to the eras as follows:

GetEra 值GetEra value 纪元名称Era Name 纪元的缩写Era Abbreviation 公历日期Gregorian Dates
55 令和 (Reiwa)令和 (Reiwa) 令和 (R,r)令和 (R, r) 1,2019 年 5 提供May 1, 2019 to present
44 平成 (日本平成 12)平成 (Heisei) 平 (H,h)平 (H, h) 1989 年 1 月 8日日到 2019 年 4 月 30日日January 8, 1989 to April 30, 2019
33 昭和 (Showa)昭和 (Showa) 昭 (S,s)昭 (S, s) 1926 年 12 月 25日日,到 1989 年 1 月 7日日December 25, 1926 to January 7, 1989
22 大正 (Taisho)大正 (Taisho) 大 (T,t)大 (T, t) 1912 年 7 月 30日日到 1926 年 12 月 24日,July 30, 1912 to December 24, 1926
11 明治 (明治)明治 (Meiji) 明 (M、 m)明 (M, m) 1868 年 9 月 8日日至 1912 年 7 月 29日日September 8, 1868 to July 29, 1912

此类处理从 9 月 8 明治第 1 年 (公历,1868 年 9 月 8 日) 中的日期。This class handles dates from September 8 in the year Meiji 1 (in the Gregorian calendar, September 8, 1868). 尽管日本历切换从一种阴历日历到太阳能日历年明治 6 (1873 公历日历) 中,此实现基于太阳日历。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. 用公历日历闰年中,被指由 4 个,但如果是整除 100 除外的整除公历年。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. 但是,由 400 是整除的公历年是闰年。However, Gregorian years that are divisible by 400 are leap years. 常见的一 365 年天,闰年 366 天。A common year has 365 days and a leap year has 366 days.

日本日历具有 12 个月 28 至 31 天内使用:The Japanese calendar has 12 months with 28 to 31 days each:

GetMonth 值GetMonth value 月份Month 英语English 在平年中的天Days in common years 中的日闰年Days in leap years
11 1月 (Ichigatsu)1月 (Ichigatsu) 年 1 月January 3131 3131
22 2月 (Nigatsu)2月 (Nigatsu) 年 2 月February 2828 2929
33 3月 (Sangatsu)3月 (Sangatsu) 年 3 月March 3131 3131
44 4月 (Shigatsu)4月 (Shigatsu) 年 4 月April 3030 3030
55 5月 (Gogatsu)5月 (Gogatsu) 5 月May 3131 3131
66 6月 (Rokugatsu)6月 (Rokugatsu) JuneJune 3030 3030
77 7月 (Shichigatsu)7月 (Shichigatsu) 年 7 月July 3131 3131
88 8月 (Hachigatsu)8月 (Hachigatsu) 年 8 月August 3131 3131
99 9月 (Kugatsu)9月 (Kugatsu) 年 9 月September 3030 3030
1010 10月 (Juugatsu)10月 (Juugatsu) 年 10 月October 3131 3131
1111 11月 (Juuichigatsu)11月 (Juuichigatsu) 年 11 月November 3030 3030
1212 12月 (Juunigatsu)12月 (Juunigatsu) 年 12 月December 3131 3131

Nigatsu,相当于 2 月的公历月,已在闰年的 29 天和 28 在平年。Nigatsu, which is equivalent to the Gregorian calendar month of February, has 29 days during leap years and 28 during common years.

日期公元 2001 年 1 月 1 日The date January 1, 2001 A.D. 在公历中等同 Ichigatsu 日本历平成 13 年中的第一天。in the Gregorian calendar is equivalent to the first day of Ichigatsu in the year Heisei 13 in the Japanese calendar.

如果JapaneseCalendar是日语区域性的当前日历DateTime.Parse识别前面一年的纪元缩写。If the JapaneseCalendar is the current calendar of the Japanese culture, DateTime.Parse recognizes the era abbreviations in front of the year. 缩写是单字符不区分大小写拉丁字母缩写或单字符日文汉字缩写。The abbreviation is either the single-character case-insensitive Latin alphabet abbreviation or the single-character Kanji abbreviation. xref:System.DateTime.Parse%2A?displayProperty=nameWithType > 还将"1"或元年 (元年) 识别为某个时间段的第一年。xref:System.DateTime.Parse%2A?displayProperty=nameWithType> also recognizes either "1" or Gannen (元年) as the first year of an era.

每个CultureInfo对象支持一组的日历。Each CultureInfo object supports a set of calendars. Calendar属性返回区域性的默认日历和OptionalCalendars属性返回一个数组,包含所有支持的区域性的日历。The Calendar property returns the default calendar for the culture, and the OptionalCalendars property returns an array containing all the calendars supported by the culture. 若要更改使用的日历CultureInfo,将DateTimeFormatInfo.Calendar属性设置为一个新CalendarTo change the calendar used by a CultureInfo, set the DateTimeFormatInfo.Calendar property to a new Calendar.

构造函数

JapaneseCalendar() JapaneseCalendar() JapaneseCalendar() JapaneseCalendar()

初始化 JapaneseCalendar 类的新实例。Initializes a new instance of the JapaneseCalendar class.

属性

AlgorithmType AlgorithmType AlgorithmType AlgorithmType

获取一个值,该值指示当前日历是阳历、阴历还是二者的组合。Gets a value that indicates whether the current calendar is solar-based, lunar-based, or a combination of both.

DaysInYearBeforeMinSupportedYear DaysInYearBeforeMinSupportedYear DaysInYearBeforeMinSupportedYear DaysInYearBeforeMinSupportedYear

获取 MinSupportedDateTime 属性指定的年份之前的年中天数。Gets the number of days in the year that precedes the year that is specified by the MinSupportedDateTime property.

(Inherited from Calendar)
Eras Eras Eras Eras

获取 JapaneseCalendar 中的纪元列表。Gets the list of eras in the JapaneseCalendar.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

获取一个值,该值指示此 Calendar 对象是否为只读。Gets a value indicating whether this Calendar object is read-only.

(Inherited from Calendar)
MaxSupportedDateTime MaxSupportedDateTime MaxSupportedDateTime MaxSupportedDateTime

获取当前 JapaneseCalendar 对象支持的最晚日期和时间。Gets the latest date and time supported by the current JapaneseCalendar object.

MinSupportedDateTime MinSupportedDateTime MinSupportedDateTime MinSupportedDateTime

获取当前 JapaneseCalendar 对象支持的最早日期和时间。Gets the earliest date and time supported by the current JapaneseCalendar object.

TwoDigitYearMax TwoDigitYearMax TwoDigitYearMax TwoDigitYearMax

获取或设置可以用两位数年份表示的 100 年范围内的最后一年。Gets or sets the last year of a 100-year range that can be represented by a 2-digit year.

方法

AddDays(DateTime, Int32) AddDays(DateTime, Int32) AddDays(DateTime, Int32) AddDays(DateTime, Int32)

返回与指定 DateTime 相距指定天数的 DateTimeReturns a DateTime that is the specified number of days away from the specified DateTime.

(Inherited from Calendar)
AddHours(DateTime, Int32) AddHours(DateTime, Int32) AddHours(DateTime, Int32) AddHours(DateTime, Int32)

返回与指定 DateTime 相距指定小时数的 DateTimeReturns a DateTime that is the specified number of hours away from the specified DateTime.

(Inherited from Calendar)
AddMilliseconds(DateTime, Double) AddMilliseconds(DateTime, Double) AddMilliseconds(DateTime, Double) AddMilliseconds(DateTime, Double)

返回与指定 DateTime 相距指定毫秒数的 DateTimeReturns a DateTime that is the specified number of milliseconds away from the specified DateTime.

(Inherited from Calendar)
AddMinutes(DateTime, Int32) AddMinutes(DateTime, Int32) AddMinutes(DateTime, Int32) AddMinutes(DateTime, Int32)

返回与指定 DateTime 相距指定分钟数的 DateTimeReturns a DateTime that is the specified number of minutes away from the specified DateTime.

(Inherited from Calendar)
AddMonths(DateTime, Int32) AddMonths(DateTime, Int32) AddMonths(DateTime, Int32) AddMonths(DateTime, Int32)

返回与指定 DateTime 相距指定月数的 DateTimeReturns a DateTime that is the specified number of months away from the specified DateTime.

AddSeconds(DateTime, Int32) AddSeconds(DateTime, Int32) AddSeconds(DateTime, Int32) AddSeconds(DateTime, Int32)

返回与指定 DateTime 相距指定秒数的 DateTimeReturns a DateTime that is the specified number of seconds away from the specified DateTime.

(Inherited from Calendar)
AddWeeks(DateTime, Int32) AddWeeks(DateTime, Int32) AddWeeks(DateTime, Int32) AddWeeks(DateTime, Int32)

返回与指定 DateTime 相距指定周数的 DateTimeReturns a DateTime that is the specified number of weeks away from the specified DateTime.

(Inherited from Calendar)
AddYears(DateTime, Int32) AddYears(DateTime, Int32) AddYears(DateTime, Int32) AddYears(DateTime, Int32)

返回与指定 DateTime 相距指定年数的 DateTimeReturns a DateTime that is the specified number of years away from the specified DateTime.

Clone() Clone() Clone() Clone()

创建表示当前 Calendar 对象副本的新对象。Creates a new object that is a copy of the current Calendar object.

(Inherited from Calendar)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

确定指定的对象是否等于当前对象。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetDayOfMonth(DateTime) GetDayOfMonth(DateTime) GetDayOfMonth(DateTime) GetDayOfMonth(DateTime)

返回指定 DateTime 中的月中日期。Returns the day of the month in the specified DateTime.

GetDayOfWeek(DateTime) GetDayOfWeek(DateTime) GetDayOfWeek(DateTime) GetDayOfWeek(DateTime)

返回指定 DateTime 中的周中日期。Returns the day of the week in the specified DateTime.

GetDayOfYear(DateTime) GetDayOfYear(DateTime) GetDayOfYear(DateTime) GetDayOfYear(DateTime)

返回指定 DateTime 中的日期是该年中的第几天。Returns the day of the year in the specified DateTime.

GetDaysInMonth(Int32, Int32) GetDaysInMonth(Int32, Int32) GetDaysInMonth(Int32, Int32) GetDaysInMonth(Int32, Int32)

返回当前纪元的指定月份和年份中的天数。Returns the number of days in the specified month and year of the current era.

(Inherited from Calendar)
GetDaysInMonth(Int32, Int32, Int32) GetDaysInMonth(Int32, Int32, Int32) GetDaysInMonth(Int32, Int32, Int32) GetDaysInMonth(Int32, Int32, Int32)

返回指定纪元中指定年份的指定月份中的天数。Returns the number of days in the specified month in the specified year in the specified era.

GetDaysInYear(Int32) GetDaysInYear(Int32) GetDaysInYear(Int32) GetDaysInYear(Int32)

返回当前纪元中指定年份的天数。Returns the number of days in the specified year of the current era.

(Inherited from Calendar)
GetDaysInYear(Int32, Int32) GetDaysInYear(Int32, Int32) GetDaysInYear(Int32, Int32) GetDaysInYear(Int32, Int32)

返回指定纪元中指定年份的天数。Returns the number of days in the specified year in the specified era.

GetEra(DateTime) GetEra(DateTime) GetEra(DateTime) GetEra(DateTime)

返回指定 DateTime 中的纪元。Returns the era in the specified DateTime.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

作为默认哈希函数。Serves as the default hash function.

(Inherited from Object)
GetHour(DateTime) GetHour(DateTime) GetHour(DateTime) GetHour(DateTime)

返回指定 DateTime 中的小时值。Returns the hours value in the specified DateTime.

(Inherited from Calendar)
GetLeapMonth(Int32) GetLeapMonth(Int32) GetLeapMonth(Int32) GetLeapMonth(Int32)

计算指定年份的闰月。Calculates the leap month for a specified year.

(Inherited from Calendar)
GetLeapMonth(Int32, Int32) GetLeapMonth(Int32, Int32) GetLeapMonth(Int32, Int32) GetLeapMonth(Int32, Int32)

计算指定纪元年份的闰月。Calculates the leap month for a specified year and era.

GetMilliseconds(DateTime) GetMilliseconds(DateTime) GetMilliseconds(DateTime) GetMilliseconds(DateTime)

返回指定 DateTime 中的毫秒值。Returns the milliseconds value in the specified DateTime.

(Inherited from Calendar)
GetMinute(DateTime) GetMinute(DateTime) GetMinute(DateTime) GetMinute(DateTime)

返回指定 DateTime 中的分钟值。Returns the minutes value in the specified DateTime.

(Inherited from Calendar)
GetMonth(DateTime) GetMonth(DateTime) GetMonth(DateTime) GetMonth(DateTime)

返回指定 DateTime 中的月份。Returns the month in the specified DateTime.

GetMonthsInYear(Int32) GetMonthsInYear(Int32) GetMonthsInYear(Int32) GetMonthsInYear(Int32)

返回当前纪元中指定年份的月数。Returns the number of months in the specified year in the current era.

(Inherited from Calendar)
GetMonthsInYear(Int32, Int32) GetMonthsInYear(Int32, Int32) GetMonthsInYear(Int32, Int32) GetMonthsInYear(Int32, Int32)

返回指定纪元中指定年份的月数。Returns the number of months in the specified year in the specified era.

GetSecond(DateTime) GetSecond(DateTime) GetSecond(DateTime) GetSecond(DateTime)

返回指定 DateTime 中的秒值。Returns the seconds value in the specified DateTime.

(Inherited from Calendar)
GetType() GetType() GetType() GetType()

获取当前实例的 TypeGets the Type of the current instance.

(Inherited from Object)
GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek) GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek) GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek) GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek)

返回一年中包含指定 DateTime 值中的日期的那个星期。Returns the week of the year that includes the date in the specified DateTime.

GetYear(DateTime) GetYear(DateTime) GetYear(DateTime) GetYear(DateTime)

返回指定 DateTime 中的年份。Returns the year in the specified DateTime.

IsLeapDay(Int32, Int32, Int32) IsLeapDay(Int32, Int32, Int32) IsLeapDay(Int32, Int32, Int32) IsLeapDay(Int32, Int32, Int32)

确定当前纪元中的指定日期是否为闰日。Determines whether the specified date in the current era is a leap day.

(Inherited from Calendar)
IsLeapDay(Int32, Int32, Int32, Int32) IsLeapDay(Int32, Int32, Int32, Int32) IsLeapDay(Int32, Int32, Int32, Int32) IsLeapDay(Int32, Int32, Int32, Int32)

确定指定纪元中的指定日期是否为闰日。Determines whether the specified date in the specified era is a leap day.

IsLeapMonth(Int32, Int32) IsLeapMonth(Int32, Int32) IsLeapMonth(Int32, Int32) IsLeapMonth(Int32, Int32)

确定当前纪元中指定年份的指定月份是否为闰月。Determines whether the specified month in the specified year in the current era is a leap month.

(Inherited from Calendar)
IsLeapMonth(Int32, Int32, Int32) IsLeapMonth(Int32, Int32, Int32) IsLeapMonth(Int32, Int32, Int32) IsLeapMonth(Int32, Int32, Int32)

确定指定纪元中指定年份的指定月份是否为闰月。Determines whether the specified month in the specified year in the specified era is a leap month.

IsLeapYear(Int32) IsLeapYear(Int32) IsLeapYear(Int32) IsLeapYear(Int32)

确定当前纪元中的指定年份是否为闰年。Determines whether the specified year in the current era is a leap year.

(Inherited from Calendar)
IsLeapYear(Int32, Int32) IsLeapYear(Int32, Int32) IsLeapYear(Int32, Int32) IsLeapYear(Int32, Int32)

确定指定纪元中的指定年份是否为闰年。Determines whether the specified year in the specified era is a leap year.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

创建当前 Object 的浅表副本。Creates a shallow copy of the current Object.

(Inherited from Object)
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32) ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32) ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32) ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)

返回设置为当前纪元中指定日期和时间的 DateTimeReturns a DateTime that is set to the specified date and time in the current era.

(Inherited from Calendar)
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)

返回设置为指定纪元中指定日期和时间的 DateTimeReturns a DateTime that is set to the specified date and time in the specified era.

ToFourDigitYear(Int32) ToFourDigitYear(Int32) ToFourDigitYear(Int32) ToFourDigitYear(Int32)

使用 TwoDigitYearMax 属性将指定的年份转换为四位数年份,以确定相应的纪元。Converts the specified year to a four-digit year by using the TwoDigitYearMax property to determine the appropriate century.

ToString() ToString() ToString() ToString()

返回表示当前对象的字符串。Returns a string that represents the current object.

(Inherited from Object)

字段

CurrentEra CurrentEra CurrentEra CurrentEra

表示当前日历的当前纪元。Represents the current era of the current calendar. 字段的值为 0。The value of this field is 0.

(Inherited from Calendar)

适用于

另请参阅