DateTime Constructor (Int32, Int32, Int32, Int32, Int32, Int32, DateTimeKind)
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
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.
Assembly: mscorlib (in mscorlib.dll)
'Declaration Public Sub New ( _ year As Integer, _ month As Integer, _ day As Integer, _ hour As Integer, _ minute As Integer, _ second As Integer, _ kind As DateTimeKind _ )
Parameters
- year
- Type: System.Int32
The year (1 through 9999).
- month
- Type: System.Int32
The month (1 through 12).
- day
- Type: System.Int32
The day (1 through the number of days in month).
- hour
- Type: System.Int32
The hours (0 through 23).
- minute
- Type: System.Int32
The minutes (0 through 59).
- second
- Type: System.Int32
The seconds (0 through 59).
- kind
- 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 |
|---|---|
| ArgumentOutOfRangeException | year is less than 1 or greater than 9999. -or- month is less than 1 or greater than 12. -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. |
| ArgumentException | kind is not one of the DateTimeKind values. |
This constructor interprets the year, month, and day parameters 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 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.