DateTime Constructor (Int32, Int32, Int32)
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Initializes a new instance of the DateTime structure to the specified year, month, and day.
Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
Public Sub New ( _
year As Integer, _
month As Integer, _
day As Integer _
)
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).
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 earlier than DateTime.MinValue or later than DateTime.MaxValue. |
Remarks
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.
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).
Dim date1 As New Date(2010, 8, 18)
outputBlock.Text &= date1.ToString() & vbCrLf
' The example displays the following output:
' 8/18/2010 12:00:00 AM
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
Version Information
Silverlight
Supported in: 5, 4, 3
Silverlight for Windows Phone
Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0
XNA Framework
Supported in: Xbox 360, Windows Phone OS 7.0
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.