Export (0) Print
Expand All

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

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

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

public:
DateTime (
	int year, 
	int month, 
	int day, 
	int hour, 
	int minute, 
	int second, 
	int millisecond, 
	Calendar^ calendar
)
public DateTime (
	int year, 
	int month, 
	int day, 
	int hour, 
	int minute, 
	int second, 
	int millisecond, 
	Calendar calendar
)
public function DateTime (
	year : int, 
	month : int, 
	day : int, 
	hour : int, 
	minute : int, 
	second : int, 
	millisecond : 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).

millisecond

The milliseconds (0 through 999).

calendar

The Calendar that applies to this DateTime.

Exception typeCondition

ArgumentNullException

calendar is a null reference (Nothing in Visual Basic).

ArgumentOutOfRangeException

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.

-or-

millisecond is less than 0 or greater than 999.

ArgumentException

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.

For applications in which portability of date and time data or a limited degree of time zone awareness is important, you can use the corresponding DateTimeOffset constructor.

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.

.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:
© 2014 Microsoft