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

.NET Framework Class Library

DateTime Constructor (Int32, Int32, Int32)

Updated: July 2009

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

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

Syntax

Visual Basic (Declaration)

Public Sub New ( _
    year As Integer, _
    month As Integer, _
    day As Integer _
)

Visual Basic (Usage)

Dim year As Integer
Dim month As Integer
Dim day As Integer

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

public DateTime(
    int year,
    int month,
    int day
)

Visual C++

public:
DateTime(
    int year, 
    int month, 
    int day
)

JScript

public function DateTime(
    year : int, 
    month : int, 
    day : int
)

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

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.
ArgumentException	The specified parameters evaluate to less than DateTime..::.MinValue or more than DateTime..::.MaxValue.

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.

ArgumentException

The specified parameters evaluate to less than DateTime..::.MinValue or more than DateTime..::.MaxValue.

Remarks

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, Calendar) constructor.

The time of day for the resulting DateTime is midnight (00:00:00). The Kind property is initialized to DateTimeKind..::.Unspecified.

Examples

The following example uses the DateTime(Int32, Int32, Int32) constructor to instantiate a DateTime value. The example also illustrates that this overload creates a DateTime value whose time component equals midnight (or 0:00).

Visual Basic

Dim date1 As New Date(2010, 8, 18)
Console.WriteLine(date1.ToString())
' The example displays the following output:
'      8/18/2010 12:00:00 AM

DateTime date1 = new DateTime(2010, 8, 18);
Console.WriteLine(date1.ToString());
// The example displays the following output:
//      8/18/2010 12:00:00 AM

Platforms

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.

Version Information