Partager via


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

  • day
    Type: System.Int32
    The day (1 through the number of days in month).
  • 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.