DateTimeOffset Constructor (Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)

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.

Namespace:  System
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).

ExceptionCondition
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      


Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

Show:
© 2017 Microsoft