TimeZoneInfo.BaseUtcOffset Propriedade

Definição

Espaço de Nomes:
System
Assemblagens:
mscorlib.dll, System.Runtime.dll
Assemblagem:
System.Core.dll
Assemblagem:
mscorlib.dll
Assemblagem:
System.Runtime.dll
Assemblagem:
netstandard.dll

Obtém a diferença horária entre o horário padrão do fuso horário atual e o Horário Universal Coordenado (UTC).

public:
 property TimeSpan BaseUtcOffset { TimeSpan get(); };
public TimeSpan BaseUtcOffset { get; }
member this.BaseUtcOffset : TimeSpan
Public ReadOnly Property BaseUtcOffset As TimeSpan

Valor de Propriedade

TimeSpan

Um objeto que indica a diferença horária entre o horário padrão do fuso horário atual e o Tempo Universal Coordenado (UTC).

Exemplos

O exemplo seguinte utiliza a BaseUtcOffset propriedade para mostrar a diferença entre a hora local e o Tempo Universal Coordenado (UTC).

TimeZoneInfo localZone = TimeZoneInfo.Local;
Console.WriteLine("The {0} time zone is {1}:{2} {3} than Coordinated Universal Time.",  
                  localZone.DisplayName, 
                  Math.Abs(localZone.BaseUtcOffset.Hours), 
                  Math.Abs(localZone.BaseUtcOffset.Minutes), 
                  (localZone.BaseUtcOffset >= TimeSpan.Zero) ? "later" : "earlier");

let localZone = TimeZoneInfo.Local
printfn $"""The {localZone.DisplayName} time zone is {abs localZone.BaseUtcOffset.Hours}:{abs localZone.BaseUtcOffset.Minutes} {if localZone.BaseUtcOffset >= TimeSpan.Zero then "later" else "earlier"} than Coordinated Universal Time."""

Dim localZone As TimeZoneInfo = TimeZoneInfo.Local
Console.WriteLine("The {0} time zone is {1}:{2} {3} than Coordinated Universal Time.", _ 
                  localZone.StandardName, _
                  Math.Abs(localZone.BaseUtcOffset.Hours), _
                  Math.Abs(localZone.BaseUtcOffset.Minutes), _
                  IIf(localZone.BaseUtcOffset >= TimeSpan.Zero, "later", "earlier"))

Observações

O intervalo temporal devolvido pela BaseUtcOffset propriedade pode variar de 14 horas (para um fuso horário 14 horas à frente do Tempo Universal Coordenado (UTC)) até -14 horas (para um fuso horário que está 14 horas atrás do UTC). Os fusos horários que estão à frente do UTC têm um deslocamento positivo; os fusos horários que estão atrás do UTC têm um offset negativo.

O BaseUtcOffset valor é representado como um número inteiro de minutos. Não pode incluir um número fracionado de minutos.

Note

Como BaseUtcOffset é uma propriedade do TimeZoneInfo objeto e não do próprio TimeZoneInfo.AdjustmentRule objeto, a TimeZoneInfo classe aplica um único deslocamento em relação ao UTC a todos os ajustes de um fuso horário. Para refletir um fuso horário que tenha modificado o seu deslocamento em relação ao UTC, deve criar um novo fuso horário usando o CreateCustomTimeZone método.

A BaseUtcOffset propriedade difere do GetUtcOffset método das seguintes formas:

  • A BaseUtcOffset propriedade devolve a diferença entre UTC e a hora padrão do fuso horário; o GetUtcOffset método devolve a diferença entre UTC e a hora do fuso horário num determinado momento.

  • O GetUtcOffset método reflete a aplicação de quaisquer regras de ajuste ao fuso horário; a BaseUtcOffset propriedade não.

Aplica-se a

Ver também