DateTimeOffset, structure

La structure DateTimeOffset inclut une valeur DateTime, avec une propriété Offset définissant la différence entre les date et heure de l'instance DateTimeOffset en cours et le temps universel. Étant donné qu'elle définit précisément une date et une heure par rapport au temps universel, la structure DateTimeOffset n'inclut aucun membre Kind, contrairement à la structure DateTime. Elle représente des dates et des heures dont la valeur est comprise en temps universel entre 12:00:00 (minuit), le 1er janvier de l'année 0001 de notre ère et 11:59:59 (du soir), le 31 décembre de l'année 9999 (notre ère). (notre ère).

Le composant « heure » d'une valeur DateTimeOffset est mesuré en unités de 100 nanosecondes, appelées graduations, et une date spécifique correspond au nombre de graduations écoulées à compter du 1er janvier de l'année 0001 après J-C, 12:00 (minuit). (notre ère) dans le calendrier GregorianCalendar. Une valeur DateTimeOffset est toujours exprimée dans le contexte d'un calendrier explicite ou par défaut. Les cycles qui sont attribuables aux secondes intercalaires ne sont pas inclus dans le nombre total de cycles.

Remarque

Si vous utilisez une valeur de battements que vous souhaitez convertir en un autre intervalle de temps, tel que des minutes ou des secondes, vous devez utiliser la constante TimeSpan.TicksPerDay, TimeSpan.TicksPerHour, TimeSpan.TicksPerMinute, TimeSpan.TicksPerSecond ou TimeSpan.TicksPerMillisecond pour effectuer la conversion. Par exemple, pour ajouter le nombre de secondes représenté par un nombre spécifié de battements au composant Second d'une valeur DateTimeOffset, vous pouvez utiliser l'expression dateValue.Second + nTicks/Timespan.TicksPerSecond.

Même si une valeur DateTimeOffset inclut un offset, la structure de données ne prend pas en charge tous les fuseaux horaires. Même si un offset d'UTC est une caractéristique d'un fuseau horaire, il n'identifie pas clairement le fuseau horaire. Outre le fait que plusieurs fuseaux horaires partagent le même offset d'UTC, l'offset d'un fuseau horaire unique change si l'heure d'été est appliquée. Cela signifie que, dès qu'une valeur DateTimeOffset est dissociée de son fuseau horaire, elle ne peut plus être reliée clairement à son fuseau horaire d'origine.

Comme DateTimeOffset est une structure, un objet DateTimeOffset déclaré mais non initialisé contient les valeurs par défaut de chacun de ses champs membre. Cela signifie que sa propriété DateTime a la valeur DateTimeOffset.MinValue et que sa propriété Offset a la valeur TimeSpan.Zero.

Vous pouvez créer une valeur DateTimeOffset en appelant chacune des surcharges de son constructeur, qui sont similaires aux constructeurs surchargés pour la structure DateTime. Vous pouvez également créer une valeur DateTimeOffset en lui assignant une valeur DateTime. Il s'agit d'une conversion implicite ; aucun opérateur de casting (en C#) ou aucun appel à une méthode de conversion (en Visual Basic) n'est requis. Vous pouvez également initialiser une valeur DateTimeOffset à partir de la représentation sous forme de chaîne d'une date et d'une heure en appelant plusieurs méthodes d'analyse de chaîne statique, notamment Parse, ParseExact, TryParse et TryParseExact.

Les membres de la structure DateTimeOffset fournissent des fonctionnalités dans les domaines suivants :

• Arithmétique de date et d'heure.

  Vous pouvez ajouter ou soustraire des intervalles de dates ou d'heure à partir d'une valeur DateTimeOffset particulière. Les opérations arithmétiques avec des valeurs DateTimeOffset, contrairement à celles avec des valeurs DateTime, ajustent les différences des offsets d'heure en retournant un résultat. Par exemple, le code suivant utilise des variables DateTime pour soustraire l'heure locale actuelle à l'heure UTC actuelle. Le code utilise ensuite des variables DateTimeOffset pour exécuter la même opération. La soustraction avec les valeurs DateTime retourne la différence entre le fuseau horaire local et l'UTC, tandis que la soustraction avec les valeurs DateTimeOffset retourne TimeSpan.Zero.

  C#

  VB

  Copier

  
  using System;
  
  public class DateArithmetic
  {
     public static void Main()
     {
        DateTime date1, date2;
        DateTimeOffset dateOffset1, dateOffset2;
        TimeSpan difference;
  
        // Find difference between Date.Now and Date.UtcNow
        date1 = DateTime.Now;
        date2 = DateTime.UtcNow;
        difference = date1 - date2;
        Console.WriteLine("{0} - {1} = {2}", date1, date2, difference);
  
        // Find difference between Now and UtcNow using DateTimeOffset
        dateOffset1 = DateTimeOffset.Now;
        dateOffset2 = DateTimeOffset.UtcNow;
        difference = dateOffset1 - dateOffset2;
        Console.WriteLine("{0} - {1} = {2}", 
                          dateOffset1, dateOffset2, difference);
        // If run in the Pacific Standard time zone on 4/2/2007, the example
        // displays the following output to the console:
        //    4/2/2007 7:23:57 PM - 4/3/2007 2:23:57 AM = -07:00:00
        //    4/2/2007 7:23:57 PM -07:00 - 4/3/2007 2:23:57 AM +00:00 = 00:00:00                        
     }
  }
  
  
  

• Opérations de conversion de type.

  Vous pouvez convertir les valeurs DateTimeOffset en valeurs DateTime et inversement.

• Manipulation du temps et opérations d'extraction.

  Vous pouvez extraire la date ou l'heure d'une valeur DateTimeOffset. Vous pouvez également récupérer la valeur d'un composant DateTimeOffset particulier, telle que son année ou son mois.

• Conversion de la date et de l'heure.

  Vous pouvez convertir n'importe quelle valeur DateTimeOffset en une autre valeur DateTimeOffset représentant le même instant précis dans un autre fuseau horaire. Toutefois, les règles d'ajustement d'un fuseau horaire sont appliquées uniquement avec la méthode ToLocalTime, qui convertit une valeur DateTimeOffset en date et heure de la zone du système local.

• Comparaison de la date et de l'heure.

  Vous pouvez déterminer si une valeur DateTimeOffset particulière est antérieure, identique ou ultérieure à une autre valeur DateTimeOffset. Avant que la comparaison ne soit effectuée, toutes les valeurs sont converties en UTC.

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Référence

Autres ressources