Export (0) Print
Expand All

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

Updated: March 2012

Initializes a new instance of the DateTime structure to the specified year, month, day, hour, minute, and second.

Namespace:  System
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 _
)
'Usage
Dim year As Integer 
Dim month As Integer 
Dim day As Integer 
Dim hour As Integer 
Dim minute As Integer 
Dim second As Integer 

Dim instance As New DateTime(year, month, _
	day, hour, minute, second)

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

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.

The Kind property is initialized to DateTimeKind.Unspecified.

This constructor interprets year, 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, Calendar) 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) constructor to instantiate a DateTime value.

Dim date1 As New Date(2010, 8, 18, 16, 32, 0)
Console.WriteLine(date1.ToString())
' The example displays the following output: 
'      8/18/2010 4:32:00 PM

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360, Zune

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0

XNA Framework

Supported in: 3.0, 2.0, 1.0

Date

History

Reason

March 2012

Updated exception information.

Content bug fix.

July 2009

Expanded the Remarks section and replaced the example.

Content bug fix.

Community Additions

ADD
Show:
© 2014 Microsoft