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

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


Initializes a new instance of the DateTime structure to the specified year, month, day, hour, minute, second, and Coordinated Universal Time (UTC) or local time.

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

public DateTime(
	int year,
	int month,
	int day,
	int hour,
	int minute,
	int second,
	DateTimeKind kind


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

One of the enumeration values that indicates whether year, month, day, hour, minute and second specify a local time, Coordinated Universal Time (UTC), or neither.

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.


kind is not one of the DateTimeKind values.

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, DateTimeKind) constructor.

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, DateTimeKind) constructor to instantiate a DateTime value.

DateTime date1 = new DateTime(2010, 8, 18, 16, 32, 0, DateTimeKind.Local);
Console.WriteLine("{0} {1}", date1, date1.Kind);
// The example displays the following output:
//      8/18/2010 4:32:00 PM Local

Universal Windows Platform
Available since 4.5
.NET Framework
Available since 2.0
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