DateTime Constructor (Int32, Int32, Int32)

DateTime Constructor (Int32, Int32, Int32)


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

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

public DateTime(
	int year,
	int month,
	int day


Type: System.Int32

The year (1 through 9999).

Type: System.Int32

The month (1 through 12).

Type: System.Int32

The day (1 through the number of days in month).

Exception Condition

year is less than 1 or greater than 9999.


month is less than 1 or greater than 12.


day is less than 1 or greater than the number of days in month.

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.

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

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

Universal Windows Platform
Available since 4.5
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
© 2015 Microsoft