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
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
© 2015 Microsoft