DateTimeOffset.Offset Property

Definition

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

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