DateTimeOffset Constructor (Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Initializes a new instance of the DateTimeOffset structure using the specified year, month, day, hour, minute, second, millisecond, and offset.
Assembly: mscorlib (in mscorlib.dll)
'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 _ )
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).
| 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. |
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.
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