TimeZone.GetUtcOffset(DateTime) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> TimeSpanPublic MustOverride Function GetUtcOffset (time As DateTime) As TimeSpanPará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.
