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

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


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

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

public DateTime(
	int year,
	int month,
	int day,
	int hour,
	int minute,
	int second,
	int millisecond


Type: System.Int32

The year (1 through 9999).

Type: System.Int32

The month (1 through 12).

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.Int32

The milliseconds (0 through 999).

Exception Condition

year is less than 1 or greater than 9999.


month is less than 1 or greater than 12.


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.


millisecond is less than 0 or greater than 999.

This constructor interpretsyear, month, and day as a year, month, and day in the Gregorian calendar. To instantiate a DateTime value by using the year, month, and day in another calendar, call the DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar) constructor.

The Kind property is initialized to Unspecified.

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 following example uses the DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32) constructor to instantiate a DateTime value.

DateTime date1 = new DateTime(2010, 8, 18, 16, 32, 18, 500);
Console.WriteLine(date1.ToString("M/dd/yyyy h:mm:ss.fff tt"));
// The example displays the following output:
//      8/18/2010 4:32:18.500 PM

Universal Windows Platform
Available since 4.5
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
© 2015 Microsoft