Conversion entre DateTime et DateTimeOffset

Article
08/21/2008

Mise à jour : novembre 2007

Même si la structure DateTimeOffset assure un niveau de prise en charge des fuseaux horaires supérieur à celui de la structure DateTime, les paramètres DateTime sont plus fréquemment utilisés dans les appels de méthode. La capacité à convertir des valeurs DateTimeOffset en valeurs DateTime et vice versa revêt de ce fait une importance particulière. Cette rubrique indique comment effectuer ces conversions de manière à conserver autant d'informations sur les fuseaux horaires que possible.

Remarque :
Les types DateTime et DateTimeOffset présentent des restrictions lors de la représentation d'heures dans des fuseaux horaires. Avec sa propriété Kind, DateTime ne peut indiquer que le temps universel coordonné (UTC, Coordinated Universal Time) et le fuseau horaire local du système. DateTimeOffset indique le décalage d'une heure par rapport à l'heure UTC, mais il n'indique pas le fuseau horaire dont ce décalage fait réellement partie. Pour plus d'informations sur les valeurs d'heure et la prise en charge des fuseaux horaires, consultez Choix entre DateTime, DateTimeOffset et TimeZoneInfo.

Les types DateTime et DateTimeOffset présentent des restrictions lors de la représentation d'heures dans des fuseaux horaires. Avec sa propriété Kind, DateTime ne peut indiquer que le temps universel coordonné (UTC, Coordinated Universal Time) et le fuseau horaire local du système. DateTimeOffset indique le décalage d'une heure par rapport à l'heure UTC, mais il n'indique pas le fuseau horaire dont ce décalage fait réellement partie. Pour plus d'informations sur les valeurs d'heure et la prise en charge des fuseaux horaires, consultez Choix entre DateTime, DateTimeOffset et TimeZoneInfo.

Conversions de DateTime en DateTimeOffset

La structure DateTimeOffset propose deux méthodes de conversion de DateTime en DateTimeOffset qui se prêtent à la plupart des conversions :

Le constructeur DateTimeOffset, qui crée un objet DateTimeOffset sur la base d'une valeur DateTime.
L'opérateur de conversion implicite, qui vous permet d'assigner une valeur DateTime à un objet DateTimeOffset.

Pour les valeurs DateTime locales et UTC, la propriété Offset de la valeur DateTimeOffset résultante indique le décalage par rapport à l'heure UTC ou au fuseau horaire local. Par exemple, le code suivant convertit une heure UTC dans sa valeur DateTimeOffset équivalente.

Dim utcTime1 As Date = Date.SpecifyKind(#06/19/2008 7:00AM#, _
                                        DateTimeKind.Utc)
Dim utcTime2 As DateTimeOffset = utcTime1
Console.WriteLine("Converted {0} {1} to a DateTimeOffset value of {2}", _
                  utcTime1, _
                  utcTime1.Kind.ToString(), _
                  utcTime2)
' This example displays the following output to the console:
'    Converted 6/19/2008 7:00:00 AM Utc to a DateTimeOffset value of 6/19/2008 7:00:00 AM +00:00

DateTime utcTime1 = new DateTime(2008, 6, 19, 7, 0, 0);
utcTime1 = DateTime.SpecifyKind(utcTime1, DateTimeKind.Utc);
DateTimeOffset utcTime2 = utcTime1;
Console.WriteLine("Converted {0} {1} to a DateTimeOffset value of {2}", 
                  utcTime1, 
                  utcTime1.Kind.ToString(), 
                  utcTime2);
// This example displays the following output to the console:
//    Converted 6/19/2008 7:00:00 AM Utc to a DateTimeOffset value of 6/19/2008 7:00:00 AM +00:00

Dans ce cas, le décalage de la variable utcTime2 est 00:00. De même, le code suivant convertit une heure locale dans sa valeur DateTimeOffset équivalente.

Dim localTime1 As Date = Date.SpecifyKind(#06/19/2008 7:00AM#, DateTimeKind.Local)
Dim localTime2 As DateTimeOffset = localTime1
Console.WriteLine("Converted {0} {1} to a DateTimeOffset value of {2}", _
                  localTime1, _
                  localTime1.Kind.ToString(), _
                  localTime2)
' This example displays the following output to the console:
'    Converted 6/19/2008 7:00:00 AM Local to a DateTimeOffset value of 6/19/2008 7:00:00 AM -07:00

DateTime localTime1 = new DateTime(2008, 6, 19, 7, 0, 0);
localTime1 = DateTime.SpecifyKind(localTime1, DateTimeKind.Local);
DateTimeOffset localTime2 = localTime1;
Console.WriteLine("Converted {0} {1} to a DateTimeOffset value of {2}", 
                  localTime1, 
                  localTime1.Kind.ToString(), 
                  localTime2);
// This example displays the following output to the console:
//    Converted 6/19/2008 7:00:00 AM Local to a DateTimeOffset value of 6/19/2008 7:00:00 AM -07:00

Pour les valeurs DateTime dont la propriété Kind a la valeur DateTimeKind.Unspecified, ces deux méthodes de conversion génèrent toutefois une valeur DateTimeOffset dont le décalage correspond au fuseau horaire local. Cet aspect est illustré dans l'exemple suivant, qui est exécuté dans le fuseau horaire de l'heure normale du Pacifique (États-Unis).

Dim time1 As Date = #06/19/2008 7:00AM#      ' Kind is DateTimeKind.Unspecified
Dim time2 As DateTimeOffset = time1
Console.WriteLine("Converted {0} {1} to a DateTimeOffset value of {2}", _
                  time1, _
                  time1.Kind.ToString(), _
                  time2)
' This example displays the following output to the console:
'    Converted 6/19/2008 7:00:00 AM Unspecified to a DateTimeOffset value of 6/19/2008 7:00:00 AM -07:00

DateTime time1 = new DateTime(2008, 6, 19, 7, 0, 0);  // Kind is DateTimeKind.Unspecified
DateTimeOffset time2 = time1;
Console.WriteLine("Converted {0} {1} to a DateTimeOffset value of {2}", 
                  time1, 
                  time1.Kind.ToString(), 
                  time2);
// This example displays the following output to the console:
//    Converted 6/19/2008 7:00:00 AM Unspecified to a DateTimeOffset value of 6/19/2008 7:00:00 AM -07:00

Si la valeur DateTime indique la date et l'heure dans autre chose que le fuseau horaire local ou l'heure UTC, vous pouvez la convertir en valeur DateTimeOffset et conserver ses informations sur les fuseaux horaires en appelant le constructeur DateTimeOffset surchargé. L'exemple suivant instancie un objet DateTimeOffset qui indique l'heure du Centre (des États-Unis).

Dim time1 As Date = #06/19/2008 7:00AM#      ' Kind is DateTimeKind.Unspecified
Try
   Dim time2 As New DateTimeOffset(time1, _
                    TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time").GetUtcOffset(time1)) 
   Console.WriteLine("Converted {0} {1} to a DateTime value of {2}", _
                     time1, _
                     time1.Kind.ToString(), _
                     time2)
' Handle exception if time zone is not defined in registry
Catch e As TimeZoneNotFoundException
   Console.WriteLine("Unable to identify target time zone for conversion.")
End Try
' This example displays the following output to the console:
'    Converted 6/19/2008 7:00:00 AM Unspecified to a DateTime value of 6/19/2008 7:00:00 AM -05:00

DateTime time1 = new DateTime(2008, 6, 19, 7, 0, 0);     // Kind is DateTimeKind.Unspecified
try
{
   DateTimeOffset time2 = new DateTimeOffset(time1, 
                  TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time").GetUtcOffset(time1)); 
   Console.WriteLine("Converted {0} {1} to a DateTime value of {2}", 
                     time1, 
                     time1.Kind.ToString(), 
                     time2);
}
// Handle exception if time zone is not defined in registry
catch (TimeZoneNotFoundException)
{
   Console.WriteLine("Unable to identify target time zone for conversion.");
}
// This example displays the following output to the console:
//    Converted 6/19/2008 7:00:00 AM Unspecified to a DateTime value of 6/19/2008 7:00:00 AM -05:00

Le deuxième paramètre passé à cette surcharge de constructeur, un objet TimeSpan qui représente le décalage de l'heure par rapport à l'heure UTC, doit être récupéré en appelant la méthode TimeZoneInfo.GetUtcOffset(DateTime) du fuseau horaire correspondant à l'heure. Le seul paramètre de la méthode a la valeur DateTime qui représente la date et l'heure à convertir. Si le fuseau horaire prend en charge l'heure d'été, ce paramètre permet alors à la méthode de déterminer le décalage correspondant à la date et à l'heure données.

Conversions de DateTimeOffset en DateTime

La propriété DateTime permet le plus souvent de convertir DateTimeOffset en DateTime. Elle retourne toutefois une valeur DateTime dont la propriété Kind a la valeur Unspecified, comme illustré dans l'exemple suivant.

Const baseTime As Date = #06/19/2008 7:00AM#
Dim sourceTime As DateTimeOffset
Dim targetTime As Date

' Convert UTC to DateTime value
sourceTime = New DateTimeOffset(baseTime, TimeSpan.Zero)
targetTime = sourceTime.DateTime
Console.WriteLine("{0} converts to {1} {2}", _
                  sourceTime, _
                  targetTime, _
                  targetTime.Kind.ToString())

' Convert local time to DateTime value
sourceTime = New DateTimeOffset(baseTime, _
                                TimeZoneInfo.Local.GetUtcOffset(baseTime))
targetTime = sourceTime.DateTime
Console.WriteLine("{0} converts to {1} {2}", _
                  sourceTime, _
                  targetTime, _
                  targetTime.Kind.ToString())

' Convert Central Standard Time to a DateTime value
Try
   Dim offset As TimeSpan = TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time").GetUtcOffset(baseTime)
   sourceTime = New DateTimeOffset(baseTime, offset)
   targetTime = sourceTime.DateTime
Console.WriteLine("{0} converts to {1} {2}", _
                  sourceTime, _
                  targetTime, _
                  targetTime.Kind.ToString())
Catch e As TimeZoneNotFoundException
   Console.WriteLine("Unable to create DateTimeOffset based on U.S. Central Standard Time.")
End Try 
' This example displays the following output to the console:
'    6/19/2008 7:00:00 AM +00:00 converts to 6/19/2008 7:00:00 AM Unspecified
'    6/19/2008 7:00:00 AM -07:00 converts to 6/19/2008 7:00:00 AM Unspecified
'    6/19/2008 7:00:00 AM -05:00 converts to 6/19/2008 7:00:00 AM Unspecified

DateTime baseTime = new DateTime(2008, 6, 19, 7, 0, 0);
DateTimeOffset sourceTime;
DateTime targetTime;

// Convert UTC to DateTime value
sourceTime = new DateTimeOffset(baseTime, TimeSpan.Zero);
targetTime = sourceTime.DateTime;
Console.WriteLine("{0} converts to {1} {2}", 
                  sourceTime, 
                  targetTime, 
                  targetTime.Kind.ToString());

// Convert local time to DateTime value
sourceTime = new DateTimeOffset(baseTime, 
                                TimeZoneInfo.Local.GetUtcOffset(baseTime));
targetTime = sourceTime.DateTime;
Console.WriteLine("{0} converts to {1} {2}", 
                  sourceTime, 
                  targetTime, 
                  targetTime.Kind.ToString());

// Convert Central Standard Time to a DateTime value
try
{
   TimeSpan offset = TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time").GetUtcOffset(baseTime);
   sourceTime = new DateTimeOffset(baseTime, offset);
   targetTime = sourceTime.DateTime;
   Console.WriteLine("{0} converts to {1} {2}", 
                     sourceTime, 
                     targetTime, 
                     targetTime.Kind.ToString());
}
catch (TimeZoneNotFoundException)
{
   Console.WriteLine("Unable to create DateTimeOffset based on U.S. Central Standard Time.");
} 
// This example displays the following output to the console:
//    6/19/2008 7:00:00 AM +00:00 converts to 6/19/2008 7:00:00 AM Unspecified
//    6/19/2008 7:00:00 AM -07:00 converts to 6/19/2008 7:00:00 AM Unspecified
//    6/19/2008 7:00:00 AM -05:00 converts to 6/19/2008 7:00:00 AM Unspecified

En d'autres termes, toutes les informations sur la relation de la valeur DateTimeOffset par rapport à l'heure UTC sont perdues lors de la conversion lorsque la propriété DateTime est utilisée. Cela influe sur les valeurs DateTimeOffset qui correspondent à l'heure UTC ou à l'heure locale du système, car la structure DateTime n'indique que les deux fuseaux horaires de sa propriété Kind.

Pour conserver autant d'informations sur les fuseaux horaires que possible lorsque vous convertissez une valeur DateTimeOffset en valeur DateTime, vous pouvez utiliser les propriétés DateTimeOffset.UtcDateTime et DateTimeOffset.LocalDateTime.

Conversion d'une heure UTC

Pour indiquer qu'une valeur DateTime convertie est l'heure UTC, vous pouvez récupérer la valeur à partir de la propriété DateTimeOffset.UtcDateTime. Elle diffère de la propriété DateTime de deux façons :

Elle retourne une valeur DateTime dont la propriété Kind a la valeur Utc.
Si la propriété Offset n'a pas la valeur Zero(), elle convertit l'heure en heure UTC.

Remarque :
Si votre application exige que les valeurs DateTime converties identifient de manière univoque un point unique dans le temps, vous devez alors envisager d'utiliser la propriété DateTimeOffset.UtcDateTime pour gérer toutes les conversions de DateTimeOffset en DateTime.

Le code suivant utilise la propriété UtcDateTime pour convertir une valeur DateTimeOffset dont le décalage équivaut à Zero() en valeur DateTime.

Dim utcTime1 As New DateTimeOffset(#06/19/2008 7:00AM#, TimeSpan.Zero)
Dim utcTime2 As Date = utcTime1.UtcDateTime
Console.WriteLine("{0} converted to {1} {2}", _
                  utcTime1, _
                  utcTime2, _
                  utcTime2.Kind.ToString())
' The example displays the following output to the console:
'   6/19/2008 7:00:00 AM +00:00 converted to 6/19/2008 7:00:00 AM Utc

DateTimeOffset utcTime1 = new DateTimeOffset(2008, 6, 19, 7, 0, 0, TimeSpan.Zero);
DateTime utcTime2 = utcTime1.UtcDateTime;
Console.WriteLine("{0} converted to {1} {2}", 
                  utcTime1, 
                  utcTime2, 
                  utcTime2.Kind.ToString());
// The example displays the following output to the console:
//   6/19/2008 7:00:00 AM +00:00 converted to 6/19/2008 7:00:00 AM Utc

Le code suivant utilise la propriété UtcDateTime pour effectuer une conversion de fuseau horaire et une conversion de type sur une valeur DateTimeOffset.

Dim originalTime As New DateTimeOffset(#6/19/2008 7:00AM#, _
                                       New TimeSpan(5, 0, 0))
Dim utcTime As Date = originalTime.UtcDateTime
Console.WriteLine("{0} converted to {1} {2}", _ 
                  originalTime, _
                  utcTime, _
                  utcTime.Kind.ToString())
' The example displays the following output to the console:
'       6/19/2008 7:00:00 AM +05:00 converted to 6/19/2008 2:00:00 AM Utc

DateTimeOffset originalTime = new DateTimeOffset(2008, 6, 19, 7, 0, 0, new TimeSpan(5, 0, 0));
DateTime utcTime = originalTime.UtcDateTime;
Console.WriteLine("{0} converted to {1} {2}", 
                  originalTime, 
                  utcTime, 
                  utcTime.Kind.ToString());
// The example displays the following output to the console:
//       6/19/2008 7:00:00 AM +05:00 converted to 6/19/2008 2:00:00 AM Utc

Conversion d'une heure locale

Pour indiquer qu'une valeur DateTimeOffset représente l'heure locale, vous pouvez passer la valeur DateTime retournée par la propriété DateTimeOffset.DateTime à la méthode SpecifyKind()static (Shared dans Visual Basic). La méthode retourne la date et l'heure qui lui ont été passées par son premier paramètre, mais elle affecte la valeur spécifiée par son deuxième paramètre à la propriété Kind. Le code suivant utilise la méthode SpecifyKind() lors de la conversion d'une valeur DateTimeOffset dont le décalage correspond à celui du fuseau horaire local.

Dim sourceDate As Date = #06/19/2008 7:00AM#
Dim utcTime1 As New DateTimeOffset(sourceDate, _
                                   TimeZoneInfo.Local.GetUtcOffset(sourceDate))
Dim utcTime2 As Date = utcTime1.DateTime
If utcTime1.Offset.Equals(TimeZoneInfo.Local.GetUtcOffset(utcTime1.DateTime)) Then
   utcTime2 = DateTime.SpecifyKind(utcTime2, DateTimeKind.Local)
End If   
Console.WriteLine("{0} converted to {1} {2}", _
                  utcTime1, _
                  utcTime2, _
                  utcTime2.Kind.ToString())
' The example displays the following output to the console:
'   6/19/2008 7:00:00 AM -07:00 converted to 6/19/2008 7:00:00 AM Local

DateTime sourceDate = new DateTime(2008, 6, 19, 7, 0, 0);
DateTimeOffset utcTime1 = new DateTimeOffset(sourceDate, 
                          TimeZoneInfo.Local.GetUtcOffset(sourceDate));
DateTime utcTime2 = utcTime1.DateTime;
if (utcTime1.Offset.Equals(TimeZoneInfo.Local.GetUtcOffset(utcTime1.DateTime))) 
   utcTime2 = DateTime.SpecifyKind(utcTime2, DateTimeKind.Local);

Console.WriteLine("{0} converted to {1} {2}", 
                  utcTime1, 
                  utcTime2, 
                  utcTime2.Kind.ToString());
// The example displays the following output to the console:
//   6/19/2008 7:00:00 AM -07:00 converted to 6/19/2008 7:00:00 AM Local

Vous pouvez également utiliser la propriété DateTimeOffset.LocalDateTime pour convertir une valeur DateTimeOffset en valeur DateTime locale. La propriété Kind de la valeur DateTime retournée à la valeur Local. Le code suivant utilise la propriété DateTimeOffset.LocalDateTime lors de la conversion d'une valeur DateTimeOffset dont le décalage correspond à celui du fuseau horaire local.

Dim sourceDate As Date = #06/19/2008 7:00AM#
Dim localTime1 As New DateTimeOffset(sourceDate, _
                                   TimeZoneInfo.Local.GetUtcOffset(sourceDate))
Dim localTime2 As Date = localTime1.LocalDateTime
Console.WriteLine("{0} converted to {1} {2}", _
                  localTime1, _
                  localTime2, _
                  localTime2.Kind.ToString())
' The example displays the following output to the console:
'   6/19/2008 7:00:00 AM -07:00 converted to 6/19/2008 7:00:00 AM Local

DateTime sourceDate = new DateTime(2008, 6, 19, 7, 0, 0);
DateTimeOffset localTime1 = new DateTimeOffset(sourceDate, 
                          TimeZoneInfo.Local.GetUtcOffset(sourceDate));
DateTime localTime2 = localTime1.LocalDateTime;

Console.WriteLine("{0} converted to {1} {2}", 
                  localTime1, 
                  localTime2, 
                  localTime2.Kind.ToString());
// The example displays the following output to the console:
//   6/19/2008 7:00:00 AM -07:00 converted to 6/19/2008 7:00:00 AM Local

Lorsque vous récupérez une valeur DateTime à l'aide de la propriété DateTimeOffset.LocalDateTime, l'accesseur get de la propriété convertit d'abord la valeur DateTimeOffset en heure UTC, puis il la convertit en heure locale en appelant la méthode ToLocalTime. En d'autres termes, vous pouvez récupérer une valeur à partir de la propriété DateTimeOffset.LocalDateTime pour effectuer simultanément une conversion de fuseau horaire et une conversion de type. Cela signifie également que les règles d'ajustement du fuseau horaire local sont appliquées lors de la conversion. Le code suivant illustre l'utilisation de la propriété DateTimeOffset.LocalDateTime pour effectuer une conversion de fuseau horaire et une conversion de type.

Dim originalDate As DateTimeOffset
Dim localDate As Date

' Convert time originating in a different time zone
originalDate = New DateTimeOffset(#06/19/2008 7:00AM#, _
                                  New TimeSpan(-5, 0, 0))
localDate = originalDate.LocalDateTime
Console.WriteLine("{0} converted to {1} {2}", _
                  originalDate, _
                  localDate, _
                  localDate.Kind.ToString())
' Convert time originating in a different time zone 
' so local time zone's adjustment rules are applied
originalDate = New DateTimeOffset(#11/04/2007 4:00AM#, _
                                  New TimeSpan(-5, 0, 0))
localDate = originalDate.LocalDateTime
Console.WriteLine("{0} converted to {1} {2}", _
                  originalDate, _
                  localDate, _
                  localDate.Kind.ToString())
' The example displays the following output to the console:
'       6/19/2008 7:00:00 AM -05:00 converted to 6/19/2008 5:00:00 AM Local
'       11/4/2007 4:00:00 AM -05:00 converted to 11/4/2007 1:00:00 AM Local

DateTimeOffset originalDate;
DateTime localDate;

// Convert time originating in a different time zone
originalDate = new DateTimeOffset(2008, 6, 18, 7, 0, 0, 
                                  new TimeSpan(-5, 0, 0));
localDate = originalDate.LocalDateTime;
Console.WriteLine("{0} converted to {1} {2}", 
                  originalDate, 
                  localDate, 
                  localDate.Kind.ToString());
// Convert time originating in a different time zone 
// so local time zone's adjustment rules are applied
originalDate = new DateTimeOffset(2007, 11, 4, 4, 0, 0, 
                                  new TimeSpan(-5, 0, 0));
localDate = originalDate.LocalDateTime;
Console.WriteLine("{0} converted to {1} {2}", 
                  originalDate, 
                  localDate, 
                  localDate.Kind.ToString());
// The example displays the following output to the console:
//       6/19/2008 7:00:00 AM -05:00 converted to 6/19/2008 5:00:00 AM Local
//       11/4/2007 4:00:00 AM -05:00 converted to 11/4/2007 1:00:00 AM Local

Méthode de conversion à usage général

L'exemple suivant définit une méthode nommée ConvertFromDateTimeOffset qui convertit des valeurs DateTimeOffset en valeurs DateTime. En fonction de son décalage, elle détermine si la valeur DateTimeOffset est une heure UTC, une heure locale ou toute autre heure et elle définit en conséquence la propriété Kind de la valeur de date et d'heure retournée.

Function ConvertFromDateTimeOffset(dateTime As DateTimeOffset) As Date
   If dateTime.Offset.Equals(TimeSpan.Zero) Then
      Return dateTime.UtcDateTime
   ElseIf dateTime.Offset.Equals(TimeZoneInfo.Local.GetUtcOffset(dateTime.DateTime))
      Return Date.SpecifyKind(dateTime.DateTime, DateTimeKind.Local)
   Else
      Return dateTime.DateTime   
   End If
End Function

static DateTime ConvertFromDateTimeOffset(DateTimeOffset dateTime)
{
   if (dateTime.Offset.Equals(TimeSpan.Zero))
      return dateTime.UtcDateTime;
   else if (dateTime.Offset.Equals(TimeZoneInfo.Local.GetUtcOffset(dateTime.DateTime)))
      return DateTime.SpecifyKind(dateTime.DateTime, DateTimeKind.Local);
   else
      return dateTime.DateTime;   
}

L'exemple suivant appelle la méthode ConvertFromDateTimeOffset pour convertir des valeurs DateTimeOffset qui représentent une heure UTC, une heure locale et une heure dans le fuseau horaire de l'heure du Centre (des États-Unis).

Dim timeComponent As Date = #06/19/2008 7:00AM#
Dim returnedDate As Date 

' Convert UTC time
Dim utcTime As New DateTimeOffset(timeComponent, TimeSpan.Zero)
returnedDate = ConvertFromDateTimeOffset(utcTime) 
Console.WriteLine("{0} converted to {1} {2}", _
                  utcTime, _
                  returnedDate, _
                  returnedDate.Kind.ToString())

' Convert local time
Dim localTime As New DateTimeOffset(timeComponent, _
                                    TimeZoneInfo.Local.GetUtcOffset(timeComponent)) 
returnedDate = ConvertFromDateTimeOffset(localTime)                                                                  
Console.WriteLine("{0} converted to {1} {2}", _
                  localTime, _
                  returnedDate, _
                  returnedDate.Kind.ToString())

' Convert Central Standard Time
Dim cstTime As New DateTimeOffset(timeComponent, _
               TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time").GetUtcOffset(timeComponent))
returnedDate = ConvertFromDateTimeOffset(cstTime)                                                                  
Console.WriteLine("{0} converted to {1} {2}", _
                  cstTime, _
                  returnedDate, _
                  returnedDate.Kind.ToString())
' The example displays the following output to the console:
'    6/19/2008 7:00:00 AM +00:00 converted to 6/19/2008 7:00:00 AM Utc
'    6/19/2008 7:00:00 AM -07:00 converted to 6/19/2008 7:00:00 AM Local
'    6/19/2008 7:00:00 AM -05:00 converted to 6/19/2008 7:00:00 AM Unspecified

DateTime timeComponent = new DateTime(2008, 6, 19, 7, 0, 0);
DateTime returnedDate; 

// Convert UTC time
DateTimeOffset utcTime = new DateTimeOffset(timeComponent, TimeSpan.Zero);
returnedDate = ConvertFromDateTimeOffset(utcTime); 
Console.WriteLine("{0} converted to {1} {2}", 
                  utcTime, 
                  returnedDate, 
                  returnedDate.Kind.ToString());

// Convert local time
DateTimeOffset localTime = new DateTimeOffset(timeComponent, 
                           TimeZoneInfo.Local.GetUtcOffset(timeComponent)); 
returnedDate = ConvertFromDateTimeOffset(localTime);                                          
Console.WriteLine("{0} converted to {1} {2}", 
                  localTime, 
                  returnedDate, 
                  returnedDate.Kind.ToString());

// Convert Central Standard Time
DateTimeOffset cstTime = new DateTimeOffset(timeComponent, 
               TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time").GetUtcOffset(timeComponent));
returnedDate = ConvertFromDateTimeOffset(cstTime);
Console.WriteLine("{0} converted to {1} {2}", 
                  cstTime, 
                  returnedDate, 
                  returnedDate.Kind.ToString());
// The example displays the following output to the console:
//    6/19/2008 7:00:00 AM +00:00 converted to 6/19/2008 7:00:00 AM Utc
//    6/19/2008 7:00:00 AM -07:00 converted to 6/19/2008 7:00:00 AM Local
//    6/19/2008 7:00:00 AM -05:00 converted to 6/19/2008 7:00:00 AM Unspecified

Notez que ce code part de deux hypothèses qui, selon l'application et la source de ses valeurs de date et d'heure, risquent de ne pas toujours être valides :

Il part du principe qu'une valeur de date et d'heure dont le décalage a la valeur Zero représente l'heure UTC. En fait, l'heure UTC n'est pas une heure dans un fuseau horaire donné, mais l'heure par rapport à laquelle les heures des fuseaux horaires dans le monde sont normalisées. Les fuseaux horaires peuvent également avoir un décalage de Zero.
Il part du principe qu'une date et une heure dont le décalage équivaut à celui du fuseau horaire local représente le fuseau horaire local. Comme les valeurs de date et d'heure sont dissociées de leur fuseau horaire d'origine, cela peut ne pas être le cas ; la date et l'heure peuvent provenir d'un autre fuseau horaire ayant le même décalage.

Voir aussi

Autres ressources

Heures et fuseaux horaires

Partager via