| aspxtreme |
Home Getting Started Web Forms Web Applications ADO.NET ASP/ADO Back to Basics |
  |
Calendar Class
System.Globalization Namespace
Represents time in divisions, such as weeks, months, and years.
Calendar Class Members |
|
Fields| Visibility | Name | Type |
|---|---|---|
| public static const | CurrentEra | Int32 |
Properties
| Visibility | Name | Value Type | Accessibility |
|---|---|---|---|
| public | AlgorithmType | CalendarAlgorithmType | [ Get ] |
| public | Eras | Int32 | [ Get ] |
| public | IsReadOnly | Boolean | [ Get ] |
| public | MaxSupportedDateTime | DateTime | [ Get ] |
| public | MinSupportedDateTime | DateTime | [ Get ] |
| public | TwoDigitYearMax | Int32 | [ Get , Set ] |
Methods
| Visibility | Name | Parameters | Return Type |
|---|---|---|---|
| public | AddDays | ( DateTime time , Int32 days ) | DateTime |
| public | AddHours | ( DateTime time , Int32 hours ) | DateTime |
| public | AddMilliseconds | ( DateTime time , Double milliseconds ) | DateTime |
| public | AddMinutes | ( DateTime time , Int32 minutes ) | DateTime |
| public | AddMonths | ( DateTime time , Int32 months ) | DateTime |
| public | AddSeconds | ( DateTime time , Int32 seconds ) | DateTime |
| public | AddWeeks | ( DateTime time , Int32 weeks ) | DateTime |
| public | AddYears | ( DateTime time , Int32 years ) | DateTime |
| public | Clone | ( ) | Object |
| public | GetDayOfMonth | ( DateTime time ) | Int32 |
| public | GetDayOfWeek | ( DateTime time ) | DayOfWeek |
| public | GetDayOfYear | ( DateTime time ) | Int32 |
| public | GetDaysInMonth | ( Int32 year , Int32 month , Int32 era ) | Int32 |
| public | GetDaysInMonth | ( Int32 year , Int32 month ) | Int32 |
| public | GetDaysInYear | ( Int32 year ) | Int32 |
| public | GetDaysInYear | ( Int32 year , Int32 era ) | Int32 |
| public | GetEra | ( DateTime time ) | Int32 |
| public | GetHour | ( DateTime time ) | Int32 |
| public | GetLeapMonth | ( Int32 year , Int32 era ) | Int32 |
| public | GetLeapMonth | ( Int32 year ) | Int32 |
| public | GetMilliseconds | ( DateTime time ) | Double |
| public | GetMinute | ( DateTime time ) | Int32 |
| public | GetMonth | ( DateTime time ) | Int32 |
| public | GetMonthsInYear | ( Int32 year , Int32 era ) | Int32 |
| public | GetMonthsInYear | ( Int32 year ) | Int32 |
| public | GetSecond | ( DateTime time ) | Int32 |
| public | GetWeekOfYear | ( DateTime time , CalendarWeekRule rule , DayOfWeek firstDayOfWeek ) | Int32 |
| public | GetYear | ( DateTime time ) | Int32 |
| public | IsLeapDay | ( Int32 year , Int32 month , Int32 day , Int32 era ) | Boolean |
| public | IsLeapDay | ( Int32 year , Int32 month , Int32 day ) | Boolean |
| public | IsLeapMonth | ( Int32 year , Int32 month ) | Boolean |
| public | IsLeapMonth | ( Int32 year , Int32 month , Int32 era ) | Boolean |
| public | IsLeapYear | ( Int32 year ) | Boolean |
| public | IsLeapYear | ( Int32 year , Int32 era ) | Boolean |
| public static | ReadOnly | ( Calendar calendar ) | Calendar |
| public | ToDateTime | ( Int32 year , Int32 month , Int32 day , Int32 hour , Int32 minute , Int32 second , Int32 millisecond , Int32 era ) | DateTime |
| public | ToDateTime | ( Int32 year , Int32 month , Int32 day , Int32 hour , Int32 minute , Int32 second , Int32 millisecond ) | DateTime |
| public | ToFourDigitYear | ( Int32 year ) | Int32 |
Remarks
A calendar divides time into measures, such as weeks, months, and years. The number, length, and start of the divisions vary in each calendar.
Any moment in time can be represented as a set of numeric values using a particular calendar. For example, the last vernal equinox occurred at ( 0.0, 0, 46, 8, 20, 3, 1999 ) in the Gregorian calendar. An implementation of Calendar can map any DateTime value to a similar set of numeric values, and DateTime can map such sets of numeric values to a textual representation ( for example, "8:46 AM March 20th 1999 AD" for the English ( United States ) culture ) using DateTimeFormatInfo.
A Calendar implementation can define one or more eras. The Calendar class identifies the eras as enumerated integers where the current era ( CurrentEra ) has the value 0.
In order 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 than a standard calendar year. Each Calendar implementation defines leap years differently.
For consistency, the first unit in each interval ( for example, the first month ) is assigned the value 1.
The System.Globalization namespace includes the following Calendar implementations: GregorianCalendar, HebrewCalendar, HijriCalendar, JapaneseCalendar, JulianCalendar, KoreanCalendar, TaiwanCalendar, and ThaiBuddhistCalendar.
See Also
DateTime DateTimeFormatInfo GregorianCalendar HebrewCalendar HijriCalendar JapaneseCalendar JulianCalendar KoreanCalendar TaiwanCalendar ThaiBuddhistCalendar
