TimeZone.GetUtcOffset(DateTime) TimeZone.GetUtcOffset(DateTime) TimeZone.GetUtcOffset(DateTime) TimeZone.GetUtcOffset(DateTime) Method

Definición

Devuelve el desplazamiento de la hora universal coordinada (UTC) con respecto a la hora local especificada.Returns the Coordinated Universal Time (UTC) offset for the specified local time.

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 DateTime DateTime DateTime

Valor de fecha y hora.A date and time value.

Devoluciones

El desplazamiento de hora universal coordinada (hora UTC) en time.The Coordinated Universal Time (UTC) offset from time.

Comentarios

Este método devuelve el desplazamiento, o diferencia, entre el time parámetro y la hora universal coordinada (UTC).This method returns the offset, or difference, between the time parameter and Coordinated Universal Time (UTC). Es decir:That is:

time= UTC + desplazamientotime = UTC + offset

El método interpreta la zona horaria de time basándose en su Kind propiedad.The method interprets the time zone of time based on its Kind property. Si el valor de la Kind propiedad es DateTimeKind.Local o DateTimeKind.Unspecified, el método devuelve el desplazamiento de la zona horaria local.If the value of the Kind property is DateTimeKind.Local or DateTimeKind.Unspecified, the method returns the offset of the local time zone. Si el valor de la Kind propiedad es DateTimeKind.Utc, el método devuelve un desplazamiento igual a TimeSpan.Zero.If the value of the Kind property is DateTimeKind.Utc, the method returns an offset equal to TimeSpan.Zero.

Si la zona horaria local observa el horario de verano, GetUtcOffset aplica la regla de ajuste actual time a a la hora de determinar el desplazamiento de la zona horaria local.If the local time zone observes daylight saving time, GetUtcOffset applies the current adjustment rule to time when determining the offset of the local time zone. Es decir, el desplazamiento devuelto GetUtcOffset por refleja time si cae en la hora estándar de la zona horaria o en el horario de verano.That is, the offset returned by GetUtcOffset reflects whether time falls in the time zone's standard time or its daylight saving time.

Nota

El GetUtcOffset método solo reconoce la regla de ajuste del horario de verano actual para la zona horaria local.The GetUtcOffset method recognizes only the current daylight saving time adjustment rule for the local time zone. Como resultado, se garantiza que solo se devuelvan con precisión el desplazamiento de UTC de una hora local durante el período en el que la regla de ajuste más reciente esté en vigor.As a result, it is guaranteed to accurately return the UTC offset of a local time only during the period in which the latest adjustment rule is in effect. Puede devolver resultados inexactos si time es un valor de fecha y hora histórico que estaba sujeto a una regla de ajuste anterior.It may return inaccurate results if time is a historic date and time value that was subject to a previous adjustment rule.

El GetUtcOffset método se corresponde con TimeZoneInfo.GetUtcOffset el método.The GetUtcOffset method corresponds to the TimeZoneInfo.GetUtcOffset method. Siempre que sea posible, TimeZoneInfo.GetUtcOffset use el método.Whenever possible, use the TimeZoneInfo.GetUtcOffset method.

Dado que el valor de fecha y hora time representado por y el desplazamiento de este valor con respecto a la hora 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.Because the date and time value represented by time and this value's offset from UTC are not tightly coupled, a local or unspecified date and time value can return a different offset value when run on different computers or when run on the same computer under different time zones. Si no desea este comportamiento, use un DateTimeOffset valor en su lugar.If this behavior is undesirable, use a DateTimeOffset value instead. El DateTimeOffset tipo de datos acopla estrechamente un valor de fecha y hora con su diferencia horaria con respecto a la hora UTC.The DateTimeOffset data type tightly couples a date and time value with its offset from UTC.

Se aplica a

Consulte también: