Calendar.IsLeapYear Method (Int32)

Determines whether the specified year in the current era is a leap year.

Namespace: System.Globalization
Assembly: mscorlib (in mscorlib.dll)

public:
virtual bool IsLeapYear (
	int year
)
public boolean IsLeapYear (
	int year
)
public function IsLeapYear (
	year : int
) : boolean
Not applicable.

Parameters

year

An integer that represents the year.

Return Value

true if the specified year is a leap year; otherwise, false.

Exception typeCondition

ArgumentOutOfRangeException

year is outside the range supported by the calendar.

To make up for the difference between the calendar year and the actual time that the earth rotates around the sun or the actual time that the moon rotates around the earth, a leap year has a different number of days from a standard calendar year. Each Calendar implementation defines leap years differently.

The following code example compares different implementations of the Calendar class.

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

*/

import System.* ;
import System.Globalization.* ;

public class SamplesCalendar
{
    public static void main(String[] args)
    {
        // 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.get_Today();

        for(i = 0;i < myCals.length;i++) {
            iYear = myCals[i].GetYear(myDT);
            Console.WriteLine();
            Console.WriteLine("{0}, Year: {1}", 
                System.Convert.ToString(myCals[i].GetType()), 
                System.Convert.ToString(myCals[i].GetYear(myDT)));
            Console.WriteLine("   MonthsInYear: {0}", 
                System.Convert.ToString(myCals [i].GetMonthsInYear(iYear)));
            Console.WriteLine("   DaysInYear: {0}",
                System.Convert.ToString( 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}", 
                System.Convert.ToString(myCals[i].GetDaysInMonth(iYear, j)));
            } 
            Console.WriteLine();
                
            iMonth = myCals[i].GetMonth(myDT);
            iDay = myCals[i].GetDayOfMonth(myDT);
            Console.WriteLine("   IsLeapDay:   {0}",
            System.Convert.ToString(myCals[i].IsLeapDay(iYear, iMonth, iDay)));
            Console.WriteLine("   IsLeapMonth: {0}", 
                System.Convert.ToString(myCals[i].IsLeapMonth(iYear, iMonth)));
            Console.WriteLine("   IsLeapYear:  {0}", 
                System.Convert.ToString(myCals[i].IsLeapYear(iYear)));
        }  
    } //main
} //SamplesCalendar
 
/*
System.Globalization.GregorianCalendar, Year: 2004
   MonthsInYear: 12
   DaysInYear: 366
   Days in each month:
       31    29    31    30    31    30    31    31    30    31    30    31
   IsLeapDay:   False
   IsLeapMonth: False
   IsLeapYear:  True

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

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

System.Globalization.JapaneseCalendar, Year: 16
   MonthsInYear: 12
   DaysInYear: 366
   Days in each month:
       31    29    31    30    31    30    31    31    30    31    30    31
   IsLeapDay:   False
   IsLeapMonth: False
   IsLeapYear:  True

System.Globalization.JulianCalendar, Year: 2004
   MonthsInYear: 12
   DaysInYear: 366
   Days in each month:
       31    29    31    30    31    30    31    31    30    31    30    31
   IsLeapDay:   False
   IsLeapMonth: False
   IsLeapYear:  True

System.Globalization.KoreanCalendar, Year: 4337
   MonthsInYear: 12
   DaysInYear: 366
   Days in each month:
       31    29    31    30    31    30    31    31    30    31    30    31
   IsLeapDay:   False
   IsLeapMonth: False
   IsLeapYear:  True

System.Globalization.TaiwanCalendar, Year: 93
   MonthsInYear: 12
   DaysInYear: 366
   Days in each month:
       31    29    31    30    31    30    31    31    30    31    30    31
   IsLeapDay:   False
   IsLeapMonth: False
   IsLeapYear:  True

System.Globalization.ThaiBuddhistCalendar, Year: 2547
   MonthsInYear: 12
   DaysInYear: 366
   Days in each month:
       31    29    31    30    31    30    31    31    30    31    30    31
   IsLeapDay:   False
   IsLeapMonth: False
   IsLeapYear:  True
 */

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

XNA Framework

Supported in: 1.0

Community Additions

ADD
Show: