DateTime Constructor (Int32, Int32, Int32, Int32, Int32, Int32, Calendar)

DateTime Constructor (Int32, Int32, Int32, Int32, Int32, Int32, Calendar)


Initializes a new instance of the DateTime structure to the specified year, month, day, hour, minute, and second for the specified calendar.

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

new : 
        year:int *
        month:int *
        day:int *
        hour:int *
        minute:int *
        second:int *
        calendar:Calendar -> DateTime


Type: System.Int32

The year (1 through the number of years in calendar).

Type: System.Int32

The month (1 through the number of months in calendar).

Type: System.Int32

The day (1 through the number of days in month).

Type: System.Int32

The hours (0 through 23).

Type: System.Int32

The minutes (0 through 59).

Type: System.Int32

The seconds (0 through 59).

Type: System.Globalization.Calendar

The calendar that is used to interpret year, month, and day.

Exception Condition

calendar is null.


year is not in the range supported by calendar.


month is less than 1 or greater than the number of months in calendar.


day is less than 1 or greater than the number of days in month.


hour is less than 0 or greater than 23


minute is less than 0 or greater than 59.


second is less than 0 or greater than 59.

The Kind property is initialized to Unspecified.

The allowable values for year, month, and day depend on calendar. An exception is thrown if the specified date and time cannot be expressed using calendar.

The System.Globalization namespace provides several calendars including GregorianCalendar and JulianCalendar.

The following example calls the DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Calendar) constructor twice to instantiate two DateTime values. The first call instantiates a DateTime value by using a PersianCalendar object. Because the Persian calendar cannot be designated as the default calendar for a culture, displaying a date in the Persian calendar requires individual calls to its PersianCalendar.GetMonth, PersianCalendar.GetDayOfMonth, and PersianCalendar.GetYear methods. The second call to the constructor instantiates a DateTime value by using a HijriCalendar object. The example changes the current culture to Arabic (Syria) and changes the current culture's default calendar to the Hijri calendar. Because Hijri is the current culture's default calendar, the Console.WriteLine method uses it to format the date. When the previous current culture (which is English (United States) in this case) is restored, the Console.WriteLine method uses the current culture's default Gregorian calendar to format the date.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 1.1
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Return to top
© 2015 Microsoft