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


Type: System.DateTime
A date and time.
Type: System.TimeSpan
The time's offset from Coordinated Universal Time (UTC).


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


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


offset is not specified in whole minutes.


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


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:

Version Notes

XNA Framework

 When this constructor is used in the XNA Framework, it throws a NotSupportedException exception.

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,
outputBlock.Text += dateAndOffset + "\n";
// The code produces the following output:
//    7/12/2007 6:32:00 AM -07:00


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

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Community Additions