Calendar::IsLeapDay Method (Int32, Int32, Int32)
Determines whether the specified date in the current era is a leap day.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- year
- Type: System::Int32
An integer that represents the year.
- month
- Type: System::Int32
A positive integer that represents the month.
- day
- Type: System::Int32
A positive integer that represents the day.
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | year is outside the range supported by the calendar. -or- month is outside the range supported by the calendar. -or- day 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.
A leap day is a day that occurs only in a leap year. For example, in the Gregorian calendar, the 29th day of February is the only leap day.
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 */
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.