GregorianCalendar.IsLeapMonth(Int32, Int32, Int32) Método

Definição

Namespace:

System.Globalization

Assembly:

System.Runtime.dll

Origem:

GregorianCalendar.cs

Determina se o mês especificado no ano especificado na era especificada é um mês bissexto.

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

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

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

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

Parâmetros

year

Int32

Um inteiro que representa o ano.

month

Int32

Um inteiro de 1 a 12 que representa o mês.

era

Int32

Um inteiro que representa a era.

Retornos

Boolean

Esse método sempre retorna false, a menos que substituído por uma classe derivada.

Exceções

ArgumentOutOfRangeException

era está fora do intervalo com suporte do calendário.

- ou -

year está fora do intervalo com suporte do calendário.

- ou -

month está fora do intervalo com suporte do calendário.

Exemplos

O exemplo de código a seguir chama IsLeapMonth para todos os meses em cinco anos na era atual.

using namespace System;
using namespace System::Globalization;
int main()
{
   
   // Creates and initializes a GregorianCalendar.
   GregorianCalendar^ myCal = gcnew GregorianCalendar;
   
   // Checks all the months in five years in the current era.
   int iMonthsInYear;
   for ( int y = 2001; y <= 2005; y++ )
   {
      Console::Write( " {0}:\t", y );
      iMonthsInYear = myCal->GetMonthsInYear( y, GregorianCalendar::CurrentEra );
      for ( int m = 1; m <= iMonthsInYear; m++ )
         Console::Write( "\t {0}", myCal->IsLeapMonth( y, m, GregorianCalendar::CurrentEra ) );
      Console::WriteLine();

   }
}

/*
This code produces the following output.

2001:           False   False   False   False   False   False   False   False   False   False   False   False
2002:           False   False   False   False   False   False   False   False   False   False   False   False
2003:           False   False   False   False   False   False   False   False   False   False   False   False
2004:           False   False   False   False   False   False   False   False   False   False   False   False
2005:           False   False   False   False   False   False   False   False   False   False   False   False

*/

using System;
using System.Globalization;

public class SamplesGregorianCalendar  {

   public static void Main()  {

      // Creates and initializes a GregorianCalendar.
      GregorianCalendar myCal = new GregorianCalendar();

      // Checks all the months in five years in the current era.
      int iMonthsInYear;
      for ( int y = 2001; y <= 2005; y++ )  {
         Console.Write( "{0}:\t", y );
         iMonthsInYear = myCal.GetMonthsInYear( y, GregorianCalendar.CurrentEra );
         for ( int m = 1; m <= iMonthsInYear; m++ )
            Console.Write( "\t{0}", myCal.IsLeapMonth( y, m, GregorianCalendar.CurrentEra ) );
         Console.WriteLine();
      }
   }
}

/*
This code produces the following output.

2001:           False   False   False   False   False   False   False   False   False   False   False   False
2002:           False   False   False   False   False   False   False   False   False   False   False   False
2003:           False   False   False   False   False   False   False   False   False   False   False   False
2004:           False   False   False   False   False   False   False   False   False   False   False   False
2005:           False   False   False   False   False   False   False   False   False   False   False   False

*/

Imports System.Globalization

Public Class SamplesGregorianCalendar   
   
   Public Shared Sub Main()

      ' Creates and initializes a GregorianCalendar.
      Dim myCal As New GregorianCalendar()

      ' Checks all the months in five years in the current era.
      Dim iMonthsInYear As Integer
      Dim y As Integer
      For y = 2001 To 2005
         Console.Write("{0}:" + ControlChars.Tab, y)
         iMonthsInYear = myCal.GetMonthsInYear(y, GregorianCalendar.CurrentEra)
         Dim m As Integer
         For m = 1 To iMonthsInYear
            Console.Write(ControlChars.Tab + "{0}", myCal.IsLeapMonth(y, m, GregorianCalendar.CurrentEra))
         Next m
         Console.WriteLine()
      Next y

   End Sub

End Class


'This code produces the following output.
'
'2001:           False   False   False   False   False   False   False   False   False   False   False   False
'2002:           False   False   False   False   False   False   False   False   False   False   False   False
'2003:           False   False   False   False   False   False   False   False   False   False   False   False
'2004:           False   False   False   False   False   False   False   False   False   False   False   False
'2005:           False   False   False   False   False   False   False   False   False   False   False   False

Comentários

Um ano bissexto no calendário gregoriano é definido como um ano uniformemente divisível por quatro, exceto se for divisível por 100. No entanto, anos divisível por 400 são anos bissextos. Por exemplo, o ano 1900 não foi um ano bissexto, mas o ano 2000 foi. Um ano comum tem 365 dias e um ano bissexto tem 366 dias.

Um mês bissexto é um mês inteiro que ocorre apenas em um ano bissexto. O calendário gregoriano não tem meses bissextos.

Confira também

• CurrentEra
• ADEra
• Eras
• GetMonthsInYear(Int32, Int32)
• IsLeapYear(Int32, Int32)
• IsLeapDay(Int32, Int32, Int32, Int32)