TimeZone.GetUtcOffset(DateTime) Método

Definición

Devuelve el desplazamiento de la hora universal coordinada (UTC) con respecto a la hora local especificada.

public:
 abstract TimeSpan GetUtcOffset(DateTime time);
public abstract TimeSpan GetUtcOffset (DateTime time);
abstract member GetUtcOffset : DateTime -> TimeSpan
Public MustOverride Function GetUtcOffset (time As DateTime) As TimeSpan

Parámetros

time
DateTime

Valor de fecha y hora.

Devoluciones

El desplazamiento de hora universal coordinada (hora UTC) en time.

Comentarios

Este método devuelve el desplazamiento, o diferencia, entre el parámetro y la time hora universal coordinada (UTC). Es decir:

time = UTC + desplazamiento

El método interpreta la zona horaria de time según su Kind propiedad . Si el valor de la Kind propiedad es DateTimeKind.Local o DateTimeKind.Unspecified, el método devuelve el desplazamiento de la zona horaria local. Si el valor de la Kind propiedad es DateTimeKind.Utc, el método devuelve un desplazamiento igual a TimeSpan.Zero.

Si la zona horaria local observa el horario de verano, GetUtcOffset aplica la regla de ajuste actual a time al determinar el desplazamiento de la zona horaria local. Es decir, el desplazamiento devuelto por GetUtcOffset refleja si time se encuentra en la hora estándar de la zona horaria o en su horario de verano.

Nota

El GetUtcOffset método reconoce solo la regla de ajuste del horario de verano actual para la zona horaria local. Como resultado, se garantiza que devuelva con precisión el desplazamiento UTC de una hora local solo durante el período en el que está vigente la regla de ajuste más reciente. Puede devolver resultados inexactos si time es un valor histórico de fecha y hora sujeto a una regla de ajuste anterior.

El GetUtcOffset método corresponde al TimeZoneInfo.GetUtcOffset método . Siempre que sea posible, use el TimeZoneInfo.GetUtcOffset método .

Dado que el valor de fecha y hora representado por time y el desplazamiento de este valor de UTC no están estrechamente acoplados, un valor de fecha y hora local o no especificado puede devolver un valor de desplazamiento diferente cuando se ejecuta en equipos diferentes o cuando se ejecuta en el mismo equipo en zonas horarias diferentes. Si este comportamiento no es deseable, use un DateTimeOffset valor en su lugar. El DateTimeOffset tipo de datos acopla estrechamente un valor de fecha y hora con su desplazamiento desde UTC.

Se aplica a

Consulte también