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

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.

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      
C#
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

.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
See Also

Reference

Change History

Date

History

Reason

July 2009

Expanded the Remarks section and replaced the example.

Content bug fix.

Tags :


Page view tracker