Calendar 類別

定義

命名空間:

System.Globalization

組件:

mscorlib.dll

以週、月、年等單位表示時間。

public ref class Calendar abstract : ICloneable

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Calendar : ICloneable

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Calendar = class
    interface ICloneable

Public MustInherit Class Calendar
Implements ICloneable

繼承

Object

Calendar

衍生

System.Globalization.EastAsianLunisolarCalendar

System.Globalization.GregorianCalendar

System.Globalization.HebrewCalendar

System.Globalization.HijriCalendar

System.Globalization.JapaneseCalendar

System.Globalization.JulianCalendar

System.Globalization.KoreanCalendar

System.Globalization.PersianCalendar

System.Globalization.TaiwanCalendar

System.Globalization.ThaiBuddhistCalendar

System.Globalization.UmAlQuraCalendar

屬性

SerializableAttribute ComVisibleAttribute

實作

ICloneable

範例

以下程式碼範例展示了該 Calendar 類別的成員。

using System;
using System.Globalization;

public class SamplesCalendar  {

   public static void Main()  {

      // Sets a DateTime to April 3, 2002 of the Gregorian calendar.
      DateTime myDT = new DateTime( 2002, 4, 3, new GregorianCalendar() );

      // Uses the default calendar of the InvariantCulture.
      Calendar myCal = CultureInfo.InvariantCulture.Calendar;

      // Displays the values of the DateTime.
      Console.WriteLine( "April 3, 2002 of the Gregorian calendar:" );
      DisplayValues( myCal, myDT );

      // Adds 5 to every component of the DateTime.
      myDT = myCal.AddYears( myDT, 5 );
      myDT = myCal.AddMonths( myDT, 5 );
      myDT = myCal.AddWeeks( myDT, 5 );
      myDT = myCal.AddDays( myDT, 5 );
      myDT = myCal.AddHours( myDT, 5 );
      myDT = myCal.AddMinutes( myDT, 5 );
      myDT = myCal.AddSeconds( myDT, 5 );
      myDT = myCal.AddMilliseconds( myDT, 5 );

      // Displays the values of the DateTime.
      Console.WriteLine( "After adding 5 to each component of the DateTime:" );
      DisplayValues( myCal, myDT );
   }

   public static void DisplayValues( Calendar myCal, DateTime myDT )  {
      Console.WriteLine( "   Era:          {0}", myCal.GetEra( myDT ) );
      Console.WriteLine( "   Year:         {0}", myCal.GetYear( myDT ) );
      Console.WriteLine( "   Month:        {0}", myCal.GetMonth( myDT ) );
      Console.WriteLine( "   DayOfYear:    {0}", myCal.GetDayOfYear( myDT ) );
      Console.WriteLine( "   DayOfMonth:   {0}", myCal.GetDayOfMonth( myDT ) );
      Console.WriteLine( "   DayOfWeek:    {0}", myCal.GetDayOfWeek( myDT ) );
      Console.WriteLine( "   Hour:         {0}", myCal.GetHour( myDT ) );
      Console.WriteLine( "   Minute:       {0}", myCal.GetMinute( myDT ) );
      Console.WriteLine( "   Second:       {0}", myCal.GetSecond( myDT ) );
      Console.WriteLine( "   Milliseconds: {0}", myCal.GetMilliseconds( myDT ) );
      Console.WriteLine();
   }
}


/*
This code produces the following output.

April 3, 2002 of the Gregorian calendar:
   Era:          1
   Year:         2002
   Month:        4
   DayOfYear:    93
   DayOfMonth:   3
   DayOfWeek:    Wednesday
   Hour:         0
   Minute:       0
   Second:       0
   Milliseconds: 0

After adding 5 to each component of the DateTime:
   Era:          1
   Year:         2007
   Month:        10
   DayOfYear:    286
   DayOfMonth:   13
   DayOfWeek:    Saturday
   Hour:         5
   Minute:       5
   Second:       5
   Milliseconds: 5

*/

Imports System.Globalization


Public Class SamplesCalendar   

   Public Shared Sub Main()

      ' Sets a DateTime to April 3, 2002 of the Gregorian calendar.
      Dim myDT As New DateTime(2002, 4, 3, New GregorianCalendar())

      ' Uses the default calendar of the InvariantCulture.
      Dim myCal As Calendar = CultureInfo.InvariantCulture.Calendar

      ' Displays the values of the DateTime.
      Console.WriteLine("April 3, 2002 of the Gregorian calendar:")
      DisplayValues(myCal, myDT)

      ' Adds 5 to every component of the DateTime.
      myDT = myCal.AddYears(myDT, 5)
      myDT = myCal.AddMonths(myDT, 5)
      myDT = myCal.AddWeeks(myDT, 5)
      myDT = myCal.AddDays(myDT, 5)
      myDT = myCal.AddHours(myDT, 5)
      myDT = myCal.AddMinutes(myDT, 5)
      myDT = myCal.AddSeconds(myDT, 5)
      myDT = myCal.AddMilliseconds(myDT, 5)

      ' Displays the values of the DateTime.
      Console.WriteLine("After adding 5 to each component of the DateTime:")
      DisplayValues(myCal, myDT)

   End Sub

   Public Shared Sub DisplayValues(myCal As Calendar, myDT As DateTime)
      Console.WriteLine("   Era:          {0}", myCal.GetEra(myDT))
      Console.WriteLine("   Year:         {0}", myCal.GetYear(myDT))
      Console.WriteLine("   Month:        {0}", myCal.GetMonth(myDT))
      Console.WriteLine("   DayOfYear:    {0}", myCal.GetDayOfYear(myDT))
      Console.WriteLine("   DayOfMonth:   {0}", myCal.GetDayOfMonth(myDT))
      Console.WriteLine("   DayOfWeek:    {0}", myCal.GetDayOfWeek(myDT))
      Console.WriteLine("   Hour:         {0}", myCal.GetHour(myDT))
      Console.WriteLine("   Minute:       {0}", myCal.GetMinute(myDT))
      Console.WriteLine("   Second:       {0}", myCal.GetSecond(myDT))
      Console.WriteLine("   Milliseconds: {0}", myCal.GetMilliseconds(myDT))
      Console.WriteLine()
   End Sub

End Class


'This code produces the following output.
'
'April 3, 2002 of the Gregorian calendar:
'   Era:          1
'   Year:         2002
'   Month:        4
'   DayOfYear:    93
'   DayOfMonth:   3
'   DayOfWeek:    Wednesday
'   Hour:         0
'   Minute:       0
'   Second:       0
'   Milliseconds: 0
'
'After adding 5 to each component of the DateTime:
'   Era:          1
'   Year:         2007
'   Month:        10
'   DayOfYear:    286
'   DayOfMonth:   13
'   DayOfWeek:    Saturday
'   Hour:         5
'   Minute:       5
'   Second:       5
'   Milliseconds: 5

備註

日曆將時間劃分為單位，例如週、月和年。 各組別的數量、長度及起始日期在各日曆中有所不同。

Note

關於在.NET中使用日曆類別的資訊，請參見與日曆合作。

任何時刻都可以用特定的曆法表示為一組數值。 例如，在格里曆的（1999年3月20日，即公元8：46：0：0.0）發生了春分，時間為公元1999年3月20日，時間為8：46：00：0.0。 的 Calendar 實作可以將特定曆法範圍內的任一日期映射到類似的數值集合，並 DateTime 可利用來自 Calendar 和 DateTimeFormatInfo的資訊將這些數值集合映射到文字表示。 文字表示可以是文化敏感的，例如 en-US 文化的「8：46 AM March 20 AD」，或是不文化敏感的，例如ISO 8601格式的「1999-03-20T08：46：00」。

一個 Calendar 實作可以定義一個或多個時代。 該 Calendar 類別將時代識別為列舉整數，其中當前時代（CurrentEra）值為0。

Important

日本日曆中的紀元基於皇帝的統治，因此預計將改變。 例如，2019 年 5 月 1 日在 JapaneseCalendar 和 JapaneseLunisolarCalendar中標示了 Reiwa 時代的開頭。 這種時代變更會影響使用這些行事曆的所有應用程式。 如需詳細資訊，以及判斷您的應用程式是否受到影響，請參閱 處理 .NET 中日曆中的新紀元。 如需在 Windows 系統上測試應用程式，以確保其準備迎接時代變更的相關信息，請參閱 準備您的應用程式以取得日本年號變更。 如需 .NET 中支援具有多個紀元的行事曆功能，以及使用支援多個紀元的行事曆時的最佳作法，請參閱 使用紀元。

為了彌補曆年與地球繞太陽公轉時間或月亮繞地球轉動時間之間的差異，閏年與標準曆年有不同的天數。 每個 Calendar 實施方式對閏年的定義都不同。

為了保持一致，每個區間的第一個單位（例如第一個月）會被賦予 1。

命名 System.Globalization 空間包含以下 Calendar 實作：

• ChineseLunisolarCalendar

• EastAsianLunisolarCalendar

• GregorianCalendar

• HebrewCalendar

• HijriCalendar

• JapaneseCalendar

• JapaneseLunisolarCalendar

• JulianCalendar

• KoreanCalendar

• KoreanLunisolarCalendar

• PersianCalendar

• TaiwanCalendar

• TaiwanLunisolarCalendar

• ThaiBuddhistCalendar

• UmAlQuraCalendar

建構函式

名稱	Description
Calendar()	初始化 Calendar 類別的新執行個體。

欄位

名稱	Description
CurrentEra	代表當前曆法的時代。 此欄位的值為 0。

屬性

名稱	Description
AlgorithmType	會得到一個值，表示當前曆法是太陽、月亮或兩者結合。
DaysInYearBeforeMinSupportedYear	取得該房產指定 MinSupportedDateTime 年份之前的年份天數。
Eras	當在派生類別中覆寫時，會獲得當前日曆中的時代列表。
IsReadOnly	取得一個值，表示該 Calendar 物件是否為唯讀。
MaxSupportedDateTime	取得此 Calendar 物件支持的最新日期與時間。
MinSupportedDateTime	獲得此 Calendar 物件支持的最早日期與時間。
TwoDigitYearMax	取得或設定一個百年範圍的最後一年，該範圍可用兩位數年份表示。

方法

名稱	Description
AddDays(DateTime, Int32)	回傳 a DateTime 即距離指定 DateTime天數的距離。
AddHours(DateTime, Int32)	回傳 a DateTime 為距離指定 的 ，即距離指定 DateTime的時數。
AddMilliseconds(DateTime, Double)	回傳 a DateTime 是與指定 DateTime相距的 m秒數。
AddMinutes(DateTime, Int32)	回傳 a DateTime 為距離指定 DateTime分鐘數的 。
AddMonths(DateTime, Int32)	當在派生類別中覆寫時，回傳的 a DateTime 是距離指定 DateTime的月數。
AddSeconds(DateTime, Int32)	回傳 a DateTime 與指定 DateTime秒數相距。
AddWeeks(DateTime, Int32)	回傳 a DateTime 為距離指定 DateTime週數的距離。
AddYears(DateTime, Int32)	當在派生類別中覆寫時，回傳 a DateTime 與指定 DateTime相距 的指定年數。
Clone()	建立一個新的物件，該物件是目前 Calendar 物件的複製品。
Equals(Object)	判斷指定的 物件是否等於目前的物件。 (繼承來源 Object)
GetDayOfMonth(DateTime)	當在衍生類別中覆寫時，會回傳指定的 DateTime月份日期。
GetDayOfWeek(DateTime)	當在衍生類別中覆寫時，會回傳指定的 DateTime星期幾。
GetDayOfYear(DateTime)	當在派生類別中覆寫時，會回傳指定的 DateTime年份日期。
GetDaysInMonth(Int32, Int32, Int32)	當在派生類別中覆寫時，會回傳指定的月份、年份和時代的天數。
GetDaysInMonth(Int32, Int32)	回傳當前時代指定月份和年份的天數。
GetDaysInYear(Int32, Int32)	當在派生類別中覆寫時，會回傳指定年份和時代的天數。
GetDaysInYear(Int32)	回傳當前時代指定年份的天數。
GetEra(DateTime)	當在派生類別中覆寫時，會回傳指定的 DateTime時代。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetHour(DateTime)	回傳指定的 DateTime工時值。
GetLeapMonth(Int32, Int32)	計算指定年份和時代的閏月。
GetLeapMonth(Int32)	計算指定年份的閏月。
GetMilliseconds(DateTime)	回傳指定的 DateTime毫秒值。
GetMinute(DateTime)	回傳指定的 DateTime分鐘數值。
GetMonth(DateTime)	當在派生類別中覆寫時，會回傳指定的 DateTime月份。
GetMonthsInYear(Int32, Int32)	當在派生類別中覆寫時，會回傳指定年份中指定時代的月份數。
GetMonthsInYear(Int32)	回傳當前時代指定年份的月份數。
GetSecond(DateTime)	回傳指定的 DateTime秒數值。
GetType()	取得目前實例的 Type。 (繼承來源 Object)
GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek)	回傳包含指定值中 DateTime 日期的年度週數。
GetYear(DateTime)	當在派生類別中覆寫時，會回傳指定的 DateTime年份。
IsLeapDay(Int32, Int32, Int32, Int32)	當在派生類別中覆寫時，決定指定時代的指定日期是否為閏日。
IsLeapDay(Int32, Int32, Int32)	判斷當前時代指定的日期是否為閏日。
IsLeapMonth(Int32, Int32, Int32)	當 在派生類別中覆寫時，決定指定年份指定月份是否為閏月。
IsLeapMonth(Int32, Int32)	判定當前時代指定年份的指定月份是否為閏月。
IsLeapYear(Int32, Int32)	當在派生類別中覆寫時，決定指定年代的指定年份是否為閏年。
IsLeapYear(Int32)	判斷當前時代指定的年份是否為閏年。
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
ReadOnly(Calendar)	回傳指定 Calendar 物件的唯讀版本。
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)	當在衍生類別中覆寫時，會回傳設定為指定時代的日期與時間的 a DateTime 。
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)	回傳設定為當前時代指定日期與時間的 a DateTime 。
ToFourDigitYear(Int32)	利用 TwoDigitYearMax 屬性決定適當的世紀，將指定年份轉換為四位數年份。
ToString()	傳回表示目前 物件的字串。 (繼承來源 Object)

另請參閱

• DateTime
• DateTimeFormatInfo
• ChineseLunisolarCalendar
• EastAsianLunisolarCalendar
• GregorianCalendar
• HebrewCalendar
• HijriCalendar
• JapaneseCalendar
• JapaneseLunisolarCalendar
• JulianCalendar
• KoreanCalendar
• KoreanLunisolarCalendar
• PersianCalendar
• TaiwanCalendar
• TaiwanLunisolarCalendar
• ThaiBuddhistCalendar
• UmAlQuraCalendar
• 與日曆合作