Export (0) Print
Expand All

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
)

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

The specified date and time parameters evaluate to earlier than DateTime.MinValue or later than DateTime.MaxValue.

-or-

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


Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Community Additions

ADD
Show:
© 2014 Microsoft