DateTimeOffset.Offset Property

Reference

Definition

Namespace:: System

Assemblies:: mscorlib.dll, System.Runtime.dll

Assemblies:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

public:
 property TimeSpan Offset { TimeSpan get(); };

public TimeSpan Offset { get; }

member this.Offset : TimeSpan

Public ReadOnly Property Offset As TimeSpan

Property Value

TimeSpan

The difference between the current DateTimeOffset object's time value and Coordinated Universal Time (UTC).

Examples

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

DateTimeOffset localTime = DateTimeOffset.Now;
Console.WriteLine("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");
// The example displays output similar to the following for a system in the
// U.S. Pacific Standard Time zone:
//       The local time zone is 8 hours and 0 minutes earlier than UTC.

let localTime = DateTimeOffset.Now        
printfn $"""The local time zone is {abs localTime.Offset.Hours} hours and {localTime.Offset.Minutes} minutes {if localTime.Offset.Hours < 0 then "earlier" else "later"} than UTC."""

// The example displays output similar to the following for a system in the
// U.S. Pacific Standard Time zone:
//       The local time zone is 8 hours and 0 minutes earlier than UTC.

Dim localTime As DateTimeOffset = DateTimeOffset.Now
Console.WriteLine("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"))
' If run on a system whose local time zone is U.S. Pacific Standard Time,
' the example displays output similar to the following:
'       The local time zone is 8 hours and 0 minutes earlier than 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.

Applies to

Product	Versions
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Share via