TimeZone.ToUniversalTime(DateTime) Método

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Source:

TimeZone.cs

Devuelve la hora universal coordinada (UTC) correspondiente a una hora local especificada.

public:
 virtual DateTime ToUniversalTime(DateTime time);

public virtual DateTime ToUniversalTime (DateTime time);

abstract member ToUniversalTime : DateTime -> DateTime
override this.ToUniversalTime : DateTime -> DateTime

Public Overridable Function ToUniversalTime (time As DateTime) As DateTime

Parámetros

time

DateTime

Fecha y hora.

Devoluciones

DateTime

Un objeto DateTime cuyo valor es la hora universal coordinada (UTC) que corresponde a time.

Comentarios

Si la zona horaria local observa el horario de verano, ToUniversalTime aplica la regla de ajuste actual al time parámetro al realizar la conversión.

Nota:

El ToUniversalTime 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 la hora universal coordinada (UTC) correspondiente a una hora local determinada 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.

Si el time parámetro es una hora ambigua, el método supone que es una hora estándar. (Una hora ambigua es una que puede asignarse a una hora estándar o a un horario de verano en la zona horaria local). Si time es una hora no válida, el método simplemente resta la hora local del desplazamiento UTC de la zona horaria local para devolver utc. (Una hora no válida es una que no existe debido a la aplicación de reglas de ajuste del horario de verano).

Dado time que se interpreta en relación con la zona horaria actual del sistema actual, la fecha y hora devuelta por este método puede diferir si una aplicación se ejecuta en equipos diferentes o en el mismo equipo con zonas horarias diferentes. En los casos en los que un valor de fecha y hora debe representar un único punto inequívoco en el tiempo, use un DateTimeOffset valor para representar la hora local.

El ToUniversalTime método corresponde a la sobrecarga del TimeZoneInfo.ConvertTimeToUtc(DateTime) método con un DateTime parámetro cuya Kind propiedad no es igual a DateTimeKind.Utc. Siempre que sea posible, use la sobrecarga del TimeZoneInfo.ConvertTimeToUtc(DateTime) método .

Consulte también

• ConvertTimeToUtc(DateTime)