TimeZoneInfo.GetUtcOffset Método

Definición

Espacio de nombres:

System

Ensamblados:

netstandard.dll, System.Runtime.dll

Calcula el desplazamiento o diferencia entre la hora de esta zona horaria y la hora universal coordinada (UTC) para una fecha y hora determinadas.

Sobrecargas

GetUtcOffset(DateTime)	Calcula el desplazamiento o diferencia entre la hora de esta zona horaria y la hora universal coordinada (UTC) para una fecha y hora determinadas.
GetUtcOffset(DateTimeOffset)	Calcula el desplazamiento o diferencia entre la hora de esta zona horaria y la hora universal coordinada (UTC) para una fecha y hora determinadas.

GetUtcOffset(DateTime)

Source:

TimeZoneInfo.cs

Calcula el desplazamiento o diferencia entre la hora de esta zona horaria y la hora universal coordinada (UTC) para una fecha y hora determinadas.

C#

public TimeSpan GetUtcOffset(DateTime dateTime);

Parámetros

dateTime

DateTime

Fecha y hora para las que se va a determinar el desplazamiento.

Devoluciones

TimeSpan

Objeto que indica la diferencia horaria entre las dos zonas horarias.

Ejemplos

En el ejemplo siguiente se muestra el uso del GetUtcOffset(DateTime) método con diferentes zonas horarias y con valores de fecha que tienen valores de propiedad diferentes Kind .

C#

using System;

[assembly:CLSCompliant(true)]
namespace TimeZoneInfoCode
{
   public class TimeOffsets
   {
      public static void Main()
      {
         TimeOffsets timeoff = new TimeOffsets();
         TimeZoneInfo cst = TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time");
   
         timeoff.ShowOffset(new DateTime(2006, 6, 12, 11, 0, 0), TimeZoneInfo.Local);
         timeoff.ShowOffset(new DateTime(2007, 11, 4, 1, 0, 0), TimeZoneInfo.Local);
         timeoff.ShowOffset(new DateTime(2006, 12, 10, 15, 0, 0), TimeZoneInfo.Local);
         timeoff.ShowOffset(new DateTime(2007, 3, 11, 2, 30, 0), TimeZoneInfo.Local);
         timeoff.ShowOffset(DateTime.UtcNow, TimeZoneInfo.Local);
         timeoff.ShowOffset(new DateTime(2006, 6, 12, 11, 0, 0), TimeZoneInfo.Utc);
         timeoff.ShowOffset(new DateTime(2007, 11, 4, 1, 0, 0), TimeZoneInfo.Utc);
         timeoff.ShowOffset(new DateTime(2006, 12, 10, 3, 0, 0), TimeZoneInfo.Utc);
         timeoff.ShowOffset(new DateTime(2007, 3, 11, 2, 30, 0), TimeZoneInfo.Utc);
         timeoff.ShowOffset(DateTime.Now, TimeZoneInfo.Utc);
         timeoff.ShowOffset(new DateTime(2006, 6, 12, 11, 0, 0), cst);
         timeoff.ShowOffset(new DateTime(2007, 11, 4, 1, 0, 0), cst);
         timeoff.ShowOffset(new DateTime(2006, 12, 10, 15, 0, 0), cst);
         timeoff.ShowOffset(new DateTime(2007, 3, 11, 2, 30, 0, 0), cst);
         timeoff.ShowOffset(new DateTime(2007, 11, 14, 00, 00, 00, DateTimeKind.Local), cst);
      }
      
      private void ShowOffset(DateTime time, TimeZoneInfo timeZone)
      {
         DateTime convertedTime = time;  
         TimeSpan offset;
         
         if (time.Kind == DateTimeKind.Local && ! timeZone.Equals(TimeZoneInfo.Local)) 
            convertedTime = TimeZoneInfo.ConvertTime(time, TimeZoneInfo.Local, timeZone);
         else if (time.Kind == DateTimeKind.Utc && ! timeZone.Equals(TimeZoneInfo.Utc)) 
            convertedTime = TimeZoneInfo.ConvertTime(time, TimeZoneInfo.Utc, timeZone);         
   
         offset = timeZone.GetUtcOffset(time);
         if (time == convertedTime)
         {
            Console.WriteLine("{0} {1} ", time, 
                              timeZone.IsDaylightSavingTime(time) ? timeZone.DaylightName : timeZone.StandardName);
            Console.WriteLine("   It differs from UTC by {0} hours, {1} minutes.", 
                               offset.Hours, 
                               offset.Minutes);
         }
         else
         {
            Console.WriteLine("{0} {1} ", time, 
                              time.Kind == DateTimeKind.Utc ? "UTC" :  TimeZoneInfo.Local.Id);       
            Console.WriteLine("   converts to {0} {1}.", 
                              convertedTime, 
                              timeZone.Id);
            Console.WriteLine("   It differs from UTC by {0} hours, {1} minutes.", 
                              offset.Hours, offset.Minutes);  
         }
         Console.WriteLine();                                             
      }
   }
}
// The example produces the following output:
//
//       6/12/2006 11:00:00 AM Pacific Daylight Time 
//          It differs from UTC by -7 hours, 0 minutes.
//       
//       11/4/2007 1:00:00 AM Pacific Standard Time 
//          It differs from UTC by -8 hours, 0 minutes.
//       
//       12/10/2006 3:00:00 PM Pacific Standard Time 
//          It differs from UTC by -8 hours, 0 minutes.
//       
//       3/11/2007 2:30:00 AM Pacific Standard Time 
//          It differs from UTC by -8 hours, 0 minutes.
//       
//       2/2/2007 8:35:46 PM UTC 
//          converts to 2/2/2007 12:35:46 PM Pacific Standard Time.
//          It differs from UTC by -8 hours, 0 minutes.
//       
//       6/12/2006 11:00:00 AM UTC 
//          It differs from UTC by 0 hours, 0 minutes.
//       
//       11/4/2007 1:00:00 AM UTC 
//          It differs from UTC by 0 hours, 0 minutes.
//       
//       12/10/2006 3:00:00 AM UTC 
//          It differs from UTC by 0 hours, 0 minutes.
//       
//       3/11/2007 2:30:00 AM UTC 
//          It differs from UTC by 0 hours, 0 minutes.
//       
//       2/2/2007 12:35:46 PM Pacific Standard Time 
//          converts to 2/2/2007 8:35:46 PM UTC.
//          It differs from UTC by 0 hours, 0 minutes.
//       
//       6/12/2006 11:00:00 AM Central Daylight Time 
//          It differs from UTC by -5 hours, 0 minutes.
//       
//       11/4/2007 1:00:00 AM Central Standard Time 
//          It differs from UTC by -6 hours, 0 minutes.
//       
//       12/10/2006 3:00:00 PM Central Standard Time 
//          It differs from UTC by -6 hours, 0 minutes.
//       
//       3/11/2007 2:30:00 AM Central Standard Time 
//          It differs from UTC by -6 hours, 0 minutes.
//       
//       11/14/2007 12:00:00 AM Pacific Standard Time 
//          converts to 11/14/2007 2:00:00 AM Central Standard Time.
//          It differs from UTC by -6 hours, 0 minutes.

Comentarios

El intervalo de tiempo devuelto incluye cualquier diferencia debido a la aplicación de reglas de ajuste a la zona horaria actual. Difiere de la BaseUtcOffset propiedad , que devuelve la diferencia entre la hora universal coordinada (UTC) y la hora estándar de la zona horaria y, por lo tanto, no tiene en cuenta las reglas de ajuste.

Si la dateTime propiedad del Kind parámetro no corresponde al objeto de zona horaria, este método realiza la conversión necesaria antes de devolver un resultado. Por ejemplo, esto puede ocurrir si la Kind propiedad es DateTimeKind.Local pero el objeto de zona horaria no es la zona horaria local. Si dateTime es ambiguo o si la hora convertida es ambigua, este método interpreta la hora ambigua como una hora estándar. Si dateTime no es válido, este método devuelve un TimeSpan objeto que refleja la diferencia entre utc y la hora estándar de la zona horaria.

El TimeZoneInfo.GetUtcOffset(DateTime) método es similar en funcionamiento al GetUtcOffset método de la TimeZone clase .

Consulte también

• BaseUtcOffset

GetUtcOffset(DateTimeOffset)

Source:

TimeZoneInfo.cs

Calcula el desplazamiento o diferencia entre la hora de esta zona horaria y la hora universal coordinada (UTC) para una fecha y hora determinadas.

C#

public TimeSpan GetUtcOffset(DateTimeOffset dateTimeOffset);

Parámetros

dateTimeOffset

DateTimeOffset

Fecha y hora para las que se va a determinar el desplazamiento.

Devoluciones

TimeSpan

Objeto que indica la diferencia horaria entre la hora universal coordinada (UTC) y la zona horaria actual.

Comentarios

El intervalo de tiempo devuelto incluye cualquier diferencia debido a la aplicación de reglas de ajuste a la zona horaria actual. Difiere de la BaseUtcOffset propiedad , que devuelve la diferencia entre la hora universal coordinada (UTC) y la hora estándar de la zona horaria y, por lo tanto, no tiene en cuenta las reglas de ajuste.