DateTime Constructor (Int32, Int32, Int32)

May 11, 2014

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
)

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

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.

This constructor interprets the year, month, and day parameters 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);
outputBlock.Text += date1.ToString() + "\n";
// The example displays the following output:
//      8/18/2010 12:00:00 AM      


Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

Show:
© 2014 Microsoft