Export (0) Print
Expand All

DateTimeOffset Constructor (DateTime, TimeSpan)

Initializes a new instance of the DateTimeOffset structure using the specified DateTime value and offset.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

public DateTimeOffset(
	DateTime dateTime,
	TimeSpan offset
)

Parameters

dateTime
Type: System.DateTime

A date and time.

offset
Type: System.TimeSpan

The time's offset from Coordinated Universal Time (UTC).

ExceptionCondition
ArgumentException

dateTime.Kind equals Utc and offset does not equal zero.

-or-

dateTime.Kind equals Local and offset does not equal the offset of the system's local time zone.

-or-

offset is not specified in whole minutes.

ArgumentOutOfRangeException

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

-or-

UtcDateTime is less than MinValue or greater than MaxValue.

This constructor's behavior depends in part on the value of the Kind property of the dateTime parameter:

The following example shows how to initialize a DateTimeOffset object with a date and time and the offset of the local time zone when that time zone is not known in advance.

DateTime localTime = new DateTime(2007, 07, 12, 06, 32, 00); 
DateTimeOffset dateAndOffset = new DateTimeOffset(localTime, 
                         TimeZoneInfo.Local.GetUtcOffset(localTime));
Console.WriteLine(dateAndOffset);
// The code produces the following output: 
//    7/12/2007 6:32:00 AM -07:00

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5 SP1, 3.0 SP1, 2.0 SP1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Show:
© 2015 Microsoft