Share via


DateTimeOffset Constructor (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, 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, _
    offset As TimeSpan _
)
public DateTimeOffset(
    int year,
    int month,
    int day,
    int hour,
    int minute,
    int second,
    TimeSpan offset
)

Parameters

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

offset is less than -14 hours or greater than 14 hours.

-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, TimeSpan) constructor overload.

Dim specificDate As Date = #5/1/2008 6:32:00 AM#
Dim offsetDate As New DateTimeOffset(specificDate.Year, _
                                     specificDate.Month, _
                                     specificDate.Day, _
                                     specificDate.Hour, _
                                     specificDate.Minute, _
                                     specificDate.Second, _
                                     New TimeSpan(-5, 0, 0))
outputBlock.Text &= String.Format("Current time: {0}", offsetDate) & vbCrLf
outputBlock.Text &= String.Format("Corresponding UTC time: {0}", offsetDate.UtcDateTime) & vbCrLf
' The code produces the following output:
'    Current time: 5/1/2008 6:32:00 AM -05:00
'    Corresponding UTC time: 5/1/2008 11:32:00 AM      
DateTime specificDate = new DateTime(2008, 5, 1, 06, 32, 00);
DateTimeOffset offsetDate = new DateTimeOffset(specificDate.Year,
                                specificDate.Month,
                                specificDate.Day,
                                specificDate.Hour,
                                specificDate.Minute,
                                specificDate.Second,
                                new TimeSpan(-5, 0, 0));
outputBlock.Text += String.Format("Current time: {0}", offsetDate) + "\n";
outputBlock.Text += String.Format("Corresponding UTC time: {0}", offsetDate.UtcDateTime) + "\n";
// The code produces the following output:
//    Current time: 5/1/2008 6:32:00 AM -05:00
//    Corresponding UTC time: 5/1/2008 11:32: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.

Change History

Date

History

Reason

August 2009

Added the Remarks section.

Content bug fix.