DateTime.DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Calendar) Constructor
Assembly: mscorlib (in mscorlib.dll)
public: DateTime ( int year, int month, int day, int hour, int minute, int second, Calendar^ calendar )
public DateTime ( int year, int month, int day, int hour, int minute, int second, Calendar calendar )
public function DateTime ( year : int, month : int, day : int, hour : int, minute : int, second : int, calendar : Calendar )
Not applicable.
Parameters
- year
The year (1 through the number of years in calendar).
- month
The month (1 through the number of months in calendar).
- day
The day (1 through the number of days in month).
- hour
The hours (0 through 23).
- minute
The minutes (0 through 59).
- second
The seconds (0 through 59).
| Exception type | Condition |
|---|---|
| calendar is a null reference (Nothing in Visual Basic). | |
| year is not in the range supported by calendar. -or- month is less than 1 or greater than the number of months in calendar. -or- day is less than 1 or greater than the number of days in month. -or- hour is less than 0 or greater than 23 -or- minute is less than 0 or greater than 59. -or- second is less than 0 or greater than 59. | |
| Specified parameters evaluate to less than MinValue or more than MaxValue. |
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 code example demonstrates one of the DateTime constructors.
// Create a new instance of DateTime containing the date // 7/28/1979 at 10:35:05 PM using the en-US calendar. System::Globalization::CultureInfo^ info = gcnew System::Globalization::CultureInfo( "en-US",false ); System::Globalization::Calendar^ calendar = info->Calendar; System::DateTime dateTime = System::DateTime( 1979, // Year 07, // Month 28, // Day 22, // Hour 35, // Minute 5, // Second 15, // Millisecond calendar // Calendar ); // Write the DateTime as "Saturday, July 28, 1979 10:35:05 PM". System::Console::WriteLine( "{0:F}", dateTime );
// Create a new instance of DateTime containing the date
// 7/28/1979 at 10:35:05 PM using the en-US calendar.
System.Globalization.CultureInfo info = new System.Globalization.
CultureInfo("en-US", false);
System.Globalization.Calendar calendar = info.get_Calendar();
System.DateTime dateTime = new System.DateTime(
1979, // Year
07, // Month
28, // Day
22, // Hour
35, // Minute
5, // Second
15, // Millisecond
calendar // Calendar
);
// Write the DateTime as "Saturday, July 28, 1979 10:35:05 PM".
System.Console.WriteLine("{0:F}", dateTime);
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.