Edit

Share via

HijriCalendar.IsLeapMonth(Int32, Int32, Int32) Method

  • Reference

Definition

Namespace:
System.Globalization
Assemblies:
mscorlib.dll, System.Globalization.Calendars.dll
Assembly:
System.Runtime.dll
Assembly:
System.Globalization.Calendars.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Source:
HijriCalendar.cs
Source:
HijriCalendar.cs
Source:
HijriCalendar.cs

Determines whether the specified month in the specified year and era is a leap month.

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

Parameters

year
Int32

An integer that represents the year.

month
Int32

An integer from 1 to 12 that represents the month.

era
Int32

An integer that represents the era.

Returns

Boolean

This method always returns false.

Exceptions

ArgumentOutOfRangeException

era is outside the range supported by this calendar.

-or-

year is outside the range supported by this calendar.

-or-

month is outside the range supported by this calendar.

Examples

The following code example calls IsLeapMonth for all the months in five years in the current era.

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

   }
}

/*
This code produces the following output.

1421:           False   False   False   False   False   False   False   False   False   False   False   False
1422:           False   False   False   False   False   False   False   False   False   False   False   False
1423:           False   False   False   False   False   False   False   False   False   False   False   False
1424:           False   False   False   False   False   False   False   False   False   False   False   False
1425:           False   False   False   False   False   False   False   False   False   False   False   False

*/

using System;
using System.Globalization;

public class SamplesHijriCalendar  {

   public static void Main()  {

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

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

/*
This code produces the following output.

1421:           False   False   False   False   False   False   False   False   False   False   False   False
1422:           False   False   False   False   False   False   False   False   False   False   False   False
1423:           False   False   False   False   False   False   False   False   False   False   False   False
1424:           False   False   False   False   False   False   False   False   False   False   False   False
1425:           False   False   False   False   False   False   False   False   False   False   False   False

*/

Imports System.Globalization

Public Class SamplesHijriCalendar   
   
   Public Shared Sub Main()

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

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

   End Sub

End Class


'This code produces the following output.
'
'1421:           False   False   False   False   False   False   False   False   False   False   False   False
'1422:           False   False   False   False   False   False   False   False   False   False   False   False
'1423:           False   False   False   False   False   False   False   False   False   False   False   False
'1424:           False   False   False   False   False   False   False   False   False   False   False   False
'1425:           False   False   False   False   False   False   False   False   False   False   False   False

Remarks

In every 30-year cycle that ends with a year that is evenly divisible by 30, the 2nd, 5th, 7th, 10th, 13th, 16th, 18th, 21st, 24th, 26th, and 29th years are leap years. A common year has 354 days and a leap year has 355 days.

A leap month is an entire month that occurs only in a leap year. The Hijri calendar does not have any leap months.

Applies to

See also