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)

Syntax

'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 _
)
public DateTime(
    int year,
    int month,
    int day,
    int hour,
    int minute,
    int second,
    DateTimeKind kind
)

Parameters

  • day
    Type: System.Int32
    The day (1 through the number of days in month).
  • 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.

Exceptions

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

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.

Remarks

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.

Examples

The following example uses the DateTime(Int32, Int32, Int32, Int32, Int32, Int32, DateTimeKind) constructor to instantiate a DateTime value.

Dim date1 As New Date(2010, 8, 18, 16, 32, 0, DateTimeKind.Local)
outputBlock.Text += String.Format("{0} {1}", date1, date1.Kind) & vbCrLf
' The example displays the following output:
'      8/18/2010 4:32:00 PM Local
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

Version Information

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

Platforms

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