DateTimeOffset.Offset Propriedade

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Obtém o deslocamento de UTC (Tempo Universal Coordenado).

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

public TimeSpan Offset { get; }

member this.Offset : TimeSpan

Public ReadOnly Property Offset As TimeSpan

Valor da propriedade

TimeSpan

A diferença entre o valor temporal do objeto DateTimeOffset atual e o UTC (Tempo Universal Coordenado).

Exemplos

O exemplo a seguir usa a Offset propriedade para exibir a diferença da hora local em relação ao UTC (Tempo Universal Coordenado).

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.

Comentários

O valor da Hours propriedade do objeto retornado TimeSpan pode variar de -14 horas a 14 horas.

O valor da Offset propriedade é preciso para o minuto.