Calendar.IsLeapMonth 方法

參考

定義

命名空間:: System.Globalization

組件:: System.Globalization.dll

組件:: System.Runtime.dll

組件:: mscorlib.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

在衍生類別覆寫時，判斷某個月份是否為閏月。

多載

IsLeapMonth(Int32, Int32, Int32)	當在衍生類別中覆寫時，判斷指定紀元的指定年份中指定的月份是否為閏月。
IsLeapMonth(Int32, Int32)	判斷目前紀元的指定年份中指定的月份是否為閏月。

IsLeapMonth(Int32, Int32, Int32)

來源:: Calendar.cs

來源:: Calendar.cs

來源:: Calendar.cs

當在衍生類別中覆寫時，判斷指定紀元的指定年份中指定的月份是否為閏月。

public:
 abstract bool IsLeapMonth(int year, int month, int era);

public abstract bool IsLeapMonth (int year, int month, int era);

abstract member IsLeapMonth : int * int * int -> bool

Public MustOverride Function IsLeapMonth (year As Integer, month As Integer, era As Integer) As Boolean

參數

year: Int32

表示年份的整數。

month: Int32

正整數，表示月份。

era: Int32

表示紀元的整數。

傳回

Boolean

如果指定的月份是閏月，則為 true，否則為 false。

例外狀況

ArgumentOutOfRangeException

year 不在曆法支援的範圍內。

-或-

month 不在曆法支援的範圍內。

-或-

era 不在曆法支援的範圍內。

備註

為了構成日曆年度與地球繞著太陽旋轉的實際時間，或月球繞著地球旋轉的實際時間之間的差異，閏年與標準行事歷年份有不同的天數。每個實作會 Calendar 以不同的方式定義閏年。

閏月是只發生在閏年中的整個月份。例如，在希伯來歷中，Adar Beit 是唯一的閏月。

給實施者的注意事項

當衍生類別當做 era 參數傳遞時，必須支援CurrentEra它。其中一個支援 CurrentEra 方式是將它取代為儲存在中的 Eras[0]值，也就是行事歷目前紀元的值。

另請參閱

適用於

IsLeapMonth(Int32, Int32)

來源:: Calendar.cs

來源:: Calendar.cs

來源:: Calendar.cs

判斷目前紀元的指定年份中指定的月份是否為閏月。

public:
 virtual bool IsLeapMonth(int year, int month);

public virtual bool IsLeapMonth (int year, int month);

abstract member IsLeapMonth : int * int -> bool
override this.IsLeapMonth : int * int -> bool

Public Overridable Function IsLeapMonth (year As Integer, month As Integer) As Boolean

參數

year: Int32

表示年份的整數。

month: Int32

正整數，表示月份。

傳回

Boolean

如果指定的月份是閏月，則為 true，否則為 false。

例外狀況

ArgumentOutOfRangeException

year 不在曆法支援的範圍內。

-或-

month 不在曆法支援的範圍內。

範例

下列程式代碼範例會比較類別的不同實作 Calendar 。

using namespace System;
using namespace System::Globalization;
int main()
{
   
   // Creates an instance of every Calendar type.
   array<Calendar^>^myCals = gcnew array<Calendar^>(8);
   myCals[ 0 ] = gcnew GregorianCalendar;
   myCals[ 1 ] = gcnew HebrewCalendar;
   myCals[ 2 ] = gcnew HijriCalendar;
   myCals[ 3 ] = gcnew JapaneseCalendar;
   myCals[ 4 ] = gcnew JulianCalendar;
   myCals[ 5 ] = gcnew KoreanCalendar;
   myCals[ 6 ] = gcnew TaiwanCalendar;
   myCals[ 7 ] = gcnew ThaiBuddhistCalendar;

   // For each calendar, displays the current year, the number of months in that year,
   // and the number of days in each month of that year.
      int i;
   int j;
   int iYear;
   int iMonth;
   int iDay;
   DateTime myDT = DateTime::Today;
   for ( i = 0; i < myCals->Length; i++ )
   {
      iYear = myCals[ i ]->GetYear( myDT );
      Console::WriteLine();
      Console::WriteLine( " {0}, Year: {1}", myCals[ i ]->GetType(), myCals[ i ]->GetYear( myDT ) );
      Console::WriteLine( "   MonthsInYear: {0}", myCals[ i ]->GetMonthsInYear( iYear ) );
      Console::WriteLine( "   DaysInYear: {0}", myCals[ i ]->GetDaysInYear( iYear ) );
      Console::WriteLine( "   Days in each month:" );
      Console::Write( "      " );
      for ( j = 1; j <= myCals[ i ]->GetMonthsInYear( iYear ); j++ )
         Console::Write( " {0, -5}", myCals[ i ]->GetDaysInMonth( iYear, j ) );
      Console::WriteLine();
      iMonth = myCals[ i ]->GetMonth( myDT );
      iDay = myCals[ i ]->GetDayOfMonth( myDT );
      Console::WriteLine( "   IsLeapDay: {0}", myCals[ i ]->IsLeapDay( iYear, iMonth, iDay ) );
      Console::WriteLine( "   IsLeapMonth: {0}", myCals[ i ]->IsLeapMonth( iYear, iMonth ) );
      Console::WriteLine( "   IsLeapYear: {0}", myCals[ i ]->IsLeapYear( iYear ) );

   }
}

/*
This code produces the following output.  The results vary depending on the date.

System::Globalization::GregorianCalendar, Year: 2002
MonthsInYear: 12
DaysInYear: 365
Days in each month:
31    28    31    30    31    30    31    31    30    31    30    31
IsLeapDay:   False
IsLeapMonth: False
IsLeapYear:  False

System::Globalization::HebrewCalendar, Year: 5763
MonthsInYear: 13
DaysInYear: 385
Days in each month:
30    30    30    29    30    30    29    30    29    30    29    30    29
IsLeapDay:   False
IsLeapMonth: False
IsLeapYear:  True

System::Globalization::HijriCalendar, Year: 1423
MonthsInYear: 12
DaysInYear: 355
Days in each month:
30    29    30    29    30    29    30    29    30    29    30    30
IsLeapDay:   False
IsLeapMonth: False
IsLeapYear:  True

System::Globalization::JapaneseCalendar, Year: 14
MonthsInYear: 12
DaysInYear: 365
Days in each month:
31    28    31    30    31    30    31    31    30    31    30    31
IsLeapDay:   False
IsLeapMonth: False
IsLeapYear:  False

System::Globalization::JulianCalendar, Year: 2002
MonthsInYear: 12
DaysInYear: 365
Days in each month:
31    28    31    30    31    30    31    31    30    31    30    31
IsLeapDay:   False
IsLeapMonth: False
IsLeapYear:  False

System::Globalization::KoreanCalendar, Year: 4335
MonthsInYear: 12
DaysInYear: 365
Days in each month:
31    28    31    30    31    30    31    31    30    31    30    31
IsLeapDay:   False
IsLeapMonth: False
IsLeapYear:  False

System::Globalization::TaiwanCalendar, Year: 91
MonthsInYear: 12
DaysInYear: 365
Days in each month:
31    28    31    30    31    30    31    31    30    31    30    31
IsLeapDay:   False
IsLeapMonth: False
IsLeapYear:  False

System::Globalization::ThaiBuddhistCalendar, Year: 2545
MonthsInYear: 12
DaysInYear: 365
Days in each month:
31    28    31    30    31    30    31    31    30    31    30    31
IsLeapDay:   False
IsLeapMonth: False
IsLeapYear:  False

*/

using System;
using System.Globalization;

public class SamplesCalendar  {

   public static void Main()  {

      // Creates an instance of every Calendar type.
      Calendar[] myCals = new Calendar[8];
      myCals[0] = new GregorianCalendar();
      myCals[1] = new HebrewCalendar();
      myCals[2] = new HijriCalendar();
      myCals[3] = new JapaneseCalendar();
      myCals[4] = new JulianCalendar();
      myCals[5] = new KoreanCalendar();
      myCals[6] = new TaiwanCalendar();
      myCals[7] = new ThaiBuddhistCalendar();

      // For each calendar, displays the current year, the number of months in that year,
      // and the number of days in each month of that year.
      int i, j, iYear, iMonth, iDay;
      DateTime myDT = DateTime.Today;

      for ( i = 0; i < myCals.Length; i++ )  {
         iYear = myCals[i].GetYear( myDT );
         Console.WriteLine();
         Console.WriteLine( "{0}, Year: {1}", myCals[i].GetType(), myCals[i].GetYear( myDT ) );
         Console.WriteLine( "   MonthsInYear: {0}", myCals[i].GetMonthsInYear( iYear ) );
         Console.WriteLine( "   DaysInYear: {0}", myCals[i].GetDaysInYear( iYear ) );
         Console.WriteLine( "   Days in each month:" );
         Console.Write( "      " );

         for ( j = 1; j <= myCals[i].GetMonthsInYear( iYear ); j++ )
            Console.Write( " {0,-5}", myCals[i].GetDaysInMonth( iYear, j ) );
         Console.WriteLine();

         iMonth = myCals[i].GetMonth( myDT );
         iDay = myCals[i].GetDayOfMonth( myDT );
         Console.WriteLine( "   IsLeapDay:   {0}", myCals[i].IsLeapDay( iYear, iMonth, iDay ) );
         Console.WriteLine( "   IsLeapMonth: {0}", myCals[i].IsLeapMonth( iYear, iMonth ) );
         Console.WriteLine( "   IsLeapYear:  {0}", myCals[i].IsLeapYear( iYear ) );
      }
   }
}


/*
This code produces the following output.  The results vary depending on the date.

System.Globalization.GregorianCalendar, Year: 2002
   MonthsInYear: 12
   DaysInYear: 365
   Days in each month:
       31    28    31    30    31    30    31    31    30    31    30    31
   IsLeapDay:   False
   IsLeapMonth: False
   IsLeapYear:  False

System.Globalization.HebrewCalendar, Year: 5763
   MonthsInYear: 13
   DaysInYear: 385
   Days in each month:
       30    30    30    29    30    30    29    30    29    30    29    30    29
   IsLeapDay:   False
   IsLeapMonth: False
   IsLeapYear:  True

System.Globalization.HijriCalendar, Year: 1423
   MonthsInYear: 12
   DaysInYear: 355
   Days in each month:
       30    29    30    29    30    29    30    29    30    29    30    30
   IsLeapDay:   False
   IsLeapMonth: False
   IsLeapYear:  True

System.Globalization.JapaneseCalendar, Year: 14
   MonthsInYear: 12
   DaysInYear: 365
   Days in each month:
       31    28    31    30    31    30    31    31    30    31    30    31
   IsLeapDay:   False
   IsLeapMonth: False
   IsLeapYear:  False

System.Globalization.JulianCalendar, Year: 2002
   MonthsInYear: 12
   DaysInYear: 365
   Days in each month:
       31    28    31    30    31    30    31    31    30    31    30    31
   IsLeapDay:   False
   IsLeapMonth: False
   IsLeapYear:  False

System.Globalization.KoreanCalendar, Year: 4335
   MonthsInYear: 12
   DaysInYear: 365
   Days in each month:
       31    28    31    30    31    30    31    31    30    31    30    31
   IsLeapDay:   False
   IsLeapMonth: False
   IsLeapYear:  False

System.Globalization.TaiwanCalendar, Year: 91
   MonthsInYear: 12
   DaysInYear: 365
   Days in each month:
       31    28    31    30    31    30    31    31    30    31    30    31
   IsLeapDay:   False
   IsLeapMonth: False
   IsLeapYear:  False

System.Globalization.ThaiBuddhistCalendar, Year: 2545
   MonthsInYear: 12
   DaysInYear: 365
   Days in each month:
       31    28    31    30    31    30    31    31    30    31    30    31
   IsLeapDay:   False
   IsLeapMonth: False
   IsLeapYear:  False

*/

Imports System.Globalization


Public Class SamplesCalendar   

   Public Shared Sub Main()

      ' Creates an instance of every Calendar type.
      Dim myCals(7) As Calendar
      myCals(0) = New GregorianCalendar()
      myCals(1) = New HebrewCalendar()
      myCals(2) = New HijriCalendar()
      myCals(3) = New JapaneseCalendar()
      myCals(4) = New JulianCalendar()
      myCals(5) = New KoreanCalendar()
      myCals(6) = New TaiwanCalendar()
      myCals(7) = New ThaiBuddhistCalendar()

      ' For each calendar, displays the current year, the number of months in that year,
      ' and the number of days in each month of that year.
      Dim i, j, iYear, iMonth, iDay As Integer
      Dim myDT As DateTime = DateTime.Today

      For i = 0 To myCals.Length - 1
         iYear = myCals(i).GetYear(myDT)
         Console.WriteLine()
         Console.WriteLine("{0}, Year: {1}", myCals(i).GetType(), myCals(i).GetYear(myDT))
         Console.WriteLine("   MonthsInYear: {0}", myCals(i).GetMonthsInYear(iYear))
         Console.WriteLine("   DaysInYear: {0}", myCals(i).GetDaysInYear(iYear))
         Console.WriteLine("   Days in each month:")
         Console.Write("      ")
         
         For j = 1 To myCals(i).GetMonthsInYear(iYear)
            Console.Write(" {0,-5}", myCals(i).GetDaysInMonth(iYear, j))
         Next j
         Console.WriteLine()
         
         iMonth = myCals(i).GetMonth(myDT)
         iDay = myCals(i).GetDayOfMonth(myDT)
         Console.WriteLine("   IsLeapDay:   {0}", myCals(i).IsLeapDay(iYear, iMonth, iDay))
         Console.WriteLine("   IsLeapMonth: {0}", myCals(i).IsLeapMonth(iYear, iMonth))
         Console.WriteLine("   IsLeapYear:  {0}", myCals(i).IsLeapYear(iYear))
      Next i 

   End Sub

End Class


'This code produces the following output.  The results vary depending on the date.
'
'System.Globalization.GregorianCalendar, Year: 2002
'   MonthsInYear: 12
'   DaysInYear: 365
'   Days in each month:
'       31    28    31    30    31    30    31    31    30    31    30    31   
'   IsLeapDay:   False
'   IsLeapMonth: False
'   IsLeapYear:  False
'
'System.Globalization.HebrewCalendar, Year: 5763
'   MonthsInYear: 13
'   DaysInYear: 385
'   Days in each month:
'       30    30    30    29    30    30    29    30    29    30    29    30    29   
'   IsLeapDay:   False
'   IsLeapMonth: False
'   IsLeapYear:  True
'
'System.Globalization.HijriCalendar, Year: 1423
'   MonthsInYear: 12
'   DaysInYear: 355
'   Days in each month:
'       30    29    30    29    30    29    30    29    30    29    30    30   
'   IsLeapDay:   False
'   IsLeapMonth: False
'   IsLeapYear:  True
'
'System.Globalization.JapaneseCalendar, Year: 14
'   MonthsInYear: 12
'   DaysInYear: 365
'   Days in each month:
'       31    28    31    30    31    30    31    31    30    31    30    31   
'   IsLeapDay:   False
'   IsLeapMonth: False
'   IsLeapYear:  False
'
'System.Globalization.JulianCalendar, Year: 2002
'   MonthsInYear: 12
'   DaysInYear: 365
'   Days in each month:
'       31    28    31    30    31    30    31    31    30    31    30    31   
'   IsLeapDay:   False
'   IsLeapMonth: False
'   IsLeapYear:  False
'
'System.Globalization.KoreanCalendar, Year: 4335
'   MonthsInYear: 12
'   DaysInYear: 365
'   Days in each month:
'       31    28    31    30    31    30    31    31    30    31    30    31   
'   IsLeapDay:   False
'   IsLeapMonth: False
'   IsLeapYear:  False
'
'System.Globalization.TaiwanCalendar, Year: 91
'   MonthsInYear: 12
'   DaysInYear: 365
'   Days in each month:
'       31    28    31    30    31    30    31    31    30    31    30    31   
'   IsLeapDay:   False
'   IsLeapMonth: False
'   IsLeapYear:  False
'
'System.Globalization.ThaiBuddhistCalendar, Year: 2545
'   MonthsInYear: 12
'   DaysInYear: 365
'   Days in each month:
'       31    28    31    30    31    30    31    31    30    31    30    31   
'   IsLeapDay:   False
'   IsLeapMonth: False
'   IsLeapYear:  False

備註

閏月是只發生在閏年中的整個月份。例如，在希伯來歷中，Adar Beit 是唯一的閏月。

另請參閱

適用於

共用方式為

Calendar.IsLeapMonth 方法

定義

多載

IsLeapMonth(Int32, Int32, Int32)

參數

傳回

例外狀況

備註

給實施者的注意事項

另請參閱

適用於

IsLeapMonth(Int32, Int32)

參數

傳回

例外狀況

範例

備註

另請參閱

適用於

其他資源