• Article

DateTimeOffset.Offset Property

Microsoft Silverlight will reach end of support after October 2021. Learn more.

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

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

Syntax

'Declaration
Public ReadOnly Property Offset As TimeSpan

public TimeSpan Offset { get; }

Property Value

Type: System.TimeSpan
An object that represents the difference between the current DateTimeOffset object's time value and Coordinated Universal Time (UTC).

Remarks

The value of the Hours property of the returned TimeSpan object can range from -14 hours to 14 hours.

The value of the Offset property is precise to the minute.

Examples

The following example uses the Offset property to display the local time's difference from Coordinated Universal Time (UTC).

Dim localTime As DateTimeOffset = DateTimeOffset.Now
outputBlock.Text &= String.Format("The local time zone is {0} hours and {1} minutes {2} than UTC.", _
                  Math.Abs(localTime.Offset.Hours), _
                  localTime.Offset.Minutes, _
                  IIf(localTime.Offset.Hours < 0, "earlier", "later")) & vbCrLf

DateTimeOffset localTime = DateTimeOffset.Now;
outputBlock.Text += String.Format("The local time zone is {0} hours and {1} minutes {2} than UTC.",
                  Math.Abs(localTime.Offset.Hours),
                  localTime.Offset.Minutes,
                  localTime.Offset.Hours < 0 ? "earlier" : "later") + "\n";

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.