JapaneseLunisolarCalendar 類別

定義

命名空間:

System.Globalization

組件:

System.Runtime.dll

來源:

JapaneseLunisolarCalendar.cs

表示劃分的時間，例如月、日和年。 年份的計算方式與日本曆法相同，而日期與月份則是使用陰陽曆計算。

public ref class JapaneseLunisolarCalendar : System::Globalization::EastAsianLunisolarCalendar

public class JapaneseLunisolarCalendar : System.Globalization.EastAsianLunisolarCalendar

type JapaneseLunisolarCalendar = class
    inherit EastAsianLunisolarCalendar

Public Class JapaneseLunisolarCalendar
Inherits EastAsianLunisolarCalendar

繼承

Object

Calendar

EastAsianLunisolarCalendar

JapaneseLunisolarCalendar

備註

類別 JapaneseLunisolarCalendar 衍生自 EastAsianLunisolarCalendar 類別，代表 lunisolar 行事曆。 類別 EastAsianLunisolarCalendar 支援性別年週期 (，除了太陽能年和月曆之外，每隔 60 年重複一次) 一次。 行事曆中的每個太陽能年都與性別年、Celestial Stem 和一個分葉相關聯，而且這些行事曆可以在一年的任何月份之後有閏月。 方法 GetMonth 會傳回介於 1 到 13 之間的數位，指出與指定日期相關聯的月份。 如果年份第八個月和第九個月之間有閏月， GetMonth 則方法會傳回 8 代表第八個月，9 表示閏第八個月，而第九個月則傳回 10。

注意

如需在 .NET 類別庫中使用 JapaneseLunisolarCalendar 類別和其他行事曆類別的相關信息，請參閱 使用行事曆。

類別 JapaneseLuniSolarCalendar 會辨識每一個紀元的重新命名。 例如，兩個最近的紀元是 Heisei 紀元，從公曆年 1989 開始，而 Reiwa 紀元則從公曆年 2019 開始。 紀元名稱通常會顯示在年份之前。 例如，公曆年 2001 年是日曆年份 Heisei 13。 請注意，紀元的第一年稱為 “Gannen”。因此，公曆年 1989 是日曆年 Heisei Gannen。

重要

日本曆法的紀元是以天皇的統治為基礎，因此有變更是正常的。 例如，2019 年 5 月 1 日之後，JapaneseCalendar 與 JapaneseLunisolarCalendar 中將開始使用「令和」。 此變更對使用這些日曆的所有應用程式都有影響。 如需詳細資訊，以及判斷您的應用程式是否受到影響，請參閱 在 .NET 的日曆中處理新紀元。 如需在 Windows 系統上測試應用程式以確保其整備時間變更的相關信息，請參閱 準備您的應用程式以進行日文紀元變更。 如需 .NET 中支援多個紀元的行事曆功能，以及使用支援多個紀元的行事歷時的最佳做法，請參閱 使用紀元。

JapaneseCalendar不同於 類別，類別JapaneseLunisolarCalendar不支援 Meiji 和 Taisho 紀元範圍內的日期。

此類別會將數位指派給紀元，如下所示：

GetEra 值	紀元名稱	紀元縮寫	公曆日期
5	(Reiwa)	管理與 (R、r)	2019 年 5 月 1 日至目前
4	平成 (Heisei)	平 (H， h)	1989 年 1 月 8 日到 2019 年 4 月 30 日
3	和 (Showa)	(S， 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 日

目前， JapaneseLunisolarCalendar 類別所支援 CultureInfo 的任何文化特性都不會使用 。 因此，這個類別只能用來計算日文月曆中的日期。 它不能做為 類別所支援 CultureInfo 之任何文化特性的預設行事曆。

每個 CultureInfo 物件都支援一組行事曆。 屬性 CultureInfo.Calendar 會傳回文化特性的預設行事曆，而 CultureInfo.OptionalCalendars 屬性會傳回陣列，其中包含文化特性支援的所有行事曆。 您可以將預設行事曆變更為 實例所支援 CultureInfo 的任何選擇性行事曆。 若要這樣做，請將 Calendar 屬性所CultureInfo.DateTimeFormat傳回之 物件的 屬性DateTimeFormatInfo設定為新的 Calendar。

建構函式

JapaneseLunisolarCalendar()

初始化 JapaneseLunisolarCalendar 類別的新執行個體。

欄位

CurrentEra	表示目前曆法的目前紀元。 此欄位的值為 0。 (繼承來源 Calendar)
JapaneseEra	指定目前的紀元。

屬性

AlgorithmType	取得值，指出目前的月曆是以陽曆為主、以陰曆為主，還是同時包含兩種曆法。 (繼承來源 EastAsianLunisolarCalendar)
DaysInYearBeforeMinSupportedYear	取得 MinSupportedDateTime 屬性指定之年的前一年的天數。
Eras	取得與 JapaneseLunisolarCalendar 物件相關的紀元。
IsReadOnly	取得值，指出 Calendar 物件是否為唯讀。 (繼承來源 Calendar)
MaxSupportedDateTime	取得受 JapaneseLunisolarCalendar 類別所支援的日期和時間的最大值。
MinSupportedDateTime	取得受 JapaneseLunisolarCalendar 類別所支援的日期和時間的最小值。
TwoDigitYearMax	取得或設定以二位數年份表示時，該 100 年範圍的最後一年。 (繼承來源 EastAsianLunisolarCalendar)

方法

AddDays(DateTime, Int32)	傳回與指定 DateTime 相差指定日數的 DateTime。 (繼承來源 Calendar)
AddHours(DateTime, Int32)	傳回與指定 DateTime 相差指定時數的 DateTime。 (繼承來源 Calendar)
AddMilliseconds(DateTime, Double)	傳回與指定 DateTime 相差指定毫秒數的 DateTime。 (繼承來源 Calendar)
AddMinutes(DateTime, Int32)	傳回與指定 DateTime 相差指定分鐘數的 DateTime。 (繼承來源 Calendar)
AddMonths(DateTime, Int32)	計算與指定日期相差指定月數的日期。 (繼承來源 EastAsianLunisolarCalendar)
AddSeconds(DateTime, Int32)	傳回與指定 DateTime 相差指定秒數的 DateTime。 (繼承來源 Calendar)
AddWeeks(DateTime, Int32)	傳回與指定 DateTime 相差指定週數的 DateTime。 (繼承來源 Calendar)
AddYears(DateTime, Int32)	計算與指定日期相差指定年份的日期。 (繼承來源 EastAsianLunisolarCalendar)
Clone()	建立目前 Calendar 物件複本的新物件。 (繼承來源 Calendar)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetCelestialStem(Int32)	計算以六十年 (60 年) 為週期中指定年份的天干。 (繼承來源 EastAsianLunisolarCalendar)
GetDayOfMonth(DateTime)	計算指定日期中月份的日期。 (繼承來源 EastAsianLunisolarCalendar)
GetDayOfWeek(DateTime)	計算指定日期中一週的日期。 (繼承來源 EastAsianLunisolarCalendar)
GetDayOfYear(DateTime)	計算指定日期中年份的日期。 (繼承來源 EastAsianLunisolarCalendar)
GetDaysInMonth(Int32, Int32)	傳回目前紀元之指定月份和年份中的天數。 (繼承來源 Calendar)
GetDaysInMonth(Int32, Int32, Int32)	計算指定年份和紀元的指定月份中的天數。 (繼承來源 EastAsianLunisolarCalendar)
GetDaysInYear(Int32)	傳回目前紀元之指定年份中的天數。 (繼承來源 Calendar)
GetDaysInYear(Int32, Int32)	計算指定年份和紀元中的天數。 (繼承來源 EastAsianLunisolarCalendar)
GetEra(DateTime)	擷取對應於指定的 DateTime 之紀元。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetHour(DateTime)	傳回指定 DateTime 中的小時值。 (繼承來源 Calendar)
GetLeapMonth(Int32)	計算指定年份的閏月。 (繼承來源 Calendar)
GetLeapMonth(Int32, Int32)	計算指定年份和紀元的閏月。 (繼承來源 EastAsianLunisolarCalendar)
GetMilliseconds(DateTime)	傳回指定 DateTime 中的毫秒值。 (繼承來源 Calendar)
GetMinute(DateTime)	傳回指定 DateTime 中的分鐘值。 (繼承來源 Calendar)
GetMonth(DateTime)	傳回指定日期中的月份。 (繼承來源 EastAsianLunisolarCalendar)
GetMonthsInYear(Int32)	傳回目前紀元的指定年份中的月數。 (繼承來源 Calendar)
GetMonthsInYear(Int32, Int32)	計算指定年份和紀元中的月數。 (繼承來源 EastAsianLunisolarCalendar)
GetSecond(DateTime)	傳回指定 DateTime 中的秒值。 (繼承來源 Calendar)
GetSexagenaryYear(DateTime)	計算以六十年 (60 年) 為週期中對應至指定日期的年份。 (繼承來源 EastAsianLunisolarCalendar)
GetTerrestrialBranch(Int32)	計算以六十年 (60 年) 為週期中指定年份的地支。 (繼承來源 EastAsianLunisolarCalendar)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek)	傳回年份中的週，其中包含指定之 DateTime 值中的日期。 (繼承來源 Calendar)
GetYear(DateTime)	傳回指定日期中的年份。 (繼承來源 EastAsianLunisolarCalendar)
IsLeapDay(Int32, Int32, Int32)	判斷目前紀元中指定日期是否為閏日。 (繼承來源 Calendar)
IsLeapDay(Int32, Int32, Int32, Int32)	判斷指定紀元中指定的日期是否為閏日。 (繼承來源 EastAsianLunisolarCalendar)
IsLeapMonth(Int32, Int32)	判斷目前紀元的指定年份中指定的月份是否為閏月。 (繼承來源 Calendar)
IsLeapMonth(Int32, Int32, Int32)	判斷指定年份和紀元中的指定月份是否為閏月。 (繼承來源 EastAsianLunisolarCalendar)
IsLeapYear(Int32)	判斷目前紀元中指定的年份是否為閏年。 (繼承來源 Calendar)
IsLeapYear(Int32, Int32)	判斷指定紀元中指定的年份是否為閏年。 (繼承來源 EastAsianLunisolarCalendar)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)	傳回設定為目前紀元中指定日期和時間的 DateTime。 (繼承來源 Calendar)
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)	傳回 DateTime 物件，其設定為指定日期、時間和紀元。 (繼承來源 EastAsianLunisolarCalendar)
ToFourDigitYear(Int32)	將指定的年份轉換成 4 位數年份。 (繼承來源 EastAsianLunisolarCalendar)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• JapaneseCalendar
• 使用行事曆