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

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.

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

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

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.

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


DateTime date1 = new DateTime(2010, 8, 18, 16, 32, 0, DateTimeKind.Local);
outputBlock.Text += String.Format("{0} {1}", date1, date1.Kind) + "\n";
// The example displays the following output:
//      8/18/2010 4:32:00 PM Local


Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

Show:
© 2016 Microsoft