DateTimeOffset Constructor (Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Updated: August 2009
Initializes a new instance of the DateTimeOffset structure using the specified year, month, day, hour, minute, second, millisecond, and offset.
Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
Public Sub New ( _
year As Integer, _
month As Integer, _
day As Integer, _
hour As Integer, _
minute As Integer, _
second As Integer, _
millisecond As Integer, _
offset As TimeSpan _
)
public DateTimeOffset(
int year,
int month,
int day,
int hour,
int minute,
int second,
int millisecond,
TimeSpan offset
)
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).
- hour
Type: System.Int32
The hours (0 through 23).
- minute
Type: System.Int32
The minutes (0 through 59).
- second
Type: System.Int32
The seconds (0 through 59).
- millisecond
Type: System.Int32
The milliseconds (0 through 999).
- offset
Type: System.TimeSpan
The time's offset from Coordinated Universal Time (UTC).
Exceptions
| Exception | Condition |
|---|---|
| ArgumentException | offset does not represent whole minutes. |
| ArgumentOutOfRangeException | year is less than one or greater than 9999. -or- month is less than one or greater than 12. -or- day is less than one or greater than the number of days in month. -or- hour is less than zero or greater than 23. -or- minute is less than 0 or greater than 59. -or- second is less than 0 or greater than 59. -or- millisecond is less than 0 or greater than 999. -or- offset is less than -14 or greater than 14. -or- The UtcDateTime property is earlier than MinValue or later than MaxValue. |
Remarks
This constructor interprets year, month, and day as a year, month, and day in the Gregorian calendar. To instantiate a DateTimeOffset value by using the year, month, and day in another calendar, call the DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) constructor.
Examples
The following example instantiates a DateTimeOffset object by using the DateTimeOffset.DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) constructor overload.
Dim fmt As String = "dd MMM yyyy HH:mm:ss"
Dim thisDate As DateTime = New Date(2007, 6, 12, 19, 0, 14, 16)
Dim offsetDate As New DateTimeOffset(thisDate.Year, _
thisDate.Month, _
thisDate.Day, _
thisDate.Hour, _
thisDate.Minute, _
thisDate.Second, _
thisDate.Millisecond, _
New TimeSpan(2, 0, 0))
outputBlock.Text &= String.Format("Current time: {0}:{1}", offsetDate.ToString(fmt) & vbCrLf, _
offsetDate.Millisecond)
' The code produces the following output:
' Current time: 12 Jun 2007 19:00:14:16
string fmt = "dd MMM yyyy HH:mm:ss";
DateTime thisDate = new DateTime(2007, 06, 12, 19, 00, 14, 16);
DateTimeOffset offsetDate = new DateTimeOffset(thisDate.Year,
thisDate.Month,
thisDate.Day,
thisDate.Hour,
thisDate.Minute,
thisDate.Second,
thisDate.Millisecond,
new TimeSpan(2, 0, 0));
outputBlock.Text += String.Format("Current time: {0}:{1}", offsetDate.ToString(fmt), offsetDate.Millisecond) + "\n";
// The code produces the following output:
// Current time: 12 Jun 2007 19:00:14:16
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.
Change History
Date |
History |
Reason |
|---|---|---|
August 2009 |
Added the Remarks section. |
Content bug fix. |