TimeZoneInfo.BaseUtcOffset Propriedade

  • Referência

Definição

Namespace:
System
Assembly:
System.Runtime.dll
Assembly:
System.Core.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

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

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

Valor da propriedade

TimeSpan

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

Exemplos

O exemplo a seguir usa a BaseUtcOffset propriedade para exibir a diferença entre a hora local e o UTC (Tempo Universal Coordenado).

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"))

Comentários

O período de tempo retornado pela BaseUtcOffset propriedade pode variar de 14 horas (para um fuso horário que esteja 14 horas à frente do UTC (Tempo Universal Coordenado)) a -14 horas (para um fuso horário que esteja 14 horas atrás de UTC). Os fusos horários à frente do UTC têm um deslocamento positivo; fusos horários que estão por trás de UTC têm um deslocamento negativo.

O BaseUtcOffset valor é representado como um número inteiro de minutos. Ele não pode incluir um número fracionário de minutos.

Observação

Como BaseUtcOffset é uma propriedade do TimeZoneInfo objeto em vez do TimeZoneInfo.AdjustmentRule objeto, a TimeZoneInfo classe aplica um único deslocamento de UTC a todos os ajustes de um fuso horário. Para refletir um fuso horário que modificou seu deslocamento de UTC, você deve criar um novo fuso horário usando o CreateCustomTimeZone método.

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

  • A BaseUtcOffset propriedade retorna a diferença entre UTC e o horário padrão do fuso horário; o GetUtcOffset método retorna a diferença entre UTC e a hora do fuso horário em um determinado ponto no tempo.

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

Aplica-se a

Confira também