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


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

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

Public Sub New (
	year As Integer,
	month As Integer,
	day As Integer,
	hour As Integer,
	minute As Integer,
	second As Integer,
	millisecond As Integer,
	kind As DateTimeKind


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

Type: System.DateTimeKind

One of the enumeration values that indicates whether year, month, day, hour, minute, second, and millisecond 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.


millisecond is less than 0 or greater than 999.


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

Dim date1 As New Date(2010, 8, 18, 16, 32, 18, 500, DateTimeKind.Local)
Console.WriteLine("{0:M/dd/yyyy h:mm:ss.fff tt} {1}", date1, date1.Kind)
' The example displays the following output:
'      8/18/2010 4:32:18.500 PM Local

Universal Windows Platform
Available since 8
.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