Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

DateTimeOffset, structure

Représente un instant précis, généralement exprimé sous la forme d'une date et d'une heure, par rapport au temps universel (UTC, Universal Time Coordinated).

Espace de noms :  System
Assembly :  mscorlib (dans mscorlib.dll)

[SerializableAttribute]
public struct DateTimeOffset : IComparable, 
	IFormattable, ISerializable, IDeserializationCallback, IComparable<DateTimeOffset>, 
	IEquatable<DateTimeOffset>

Le type DateTimeOffset expose les membres suivants.

  NomDescription
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreDateTimeOffset(DateTime)Initialise une nouvelle instance de la structure DateTimeOffset à l'aide de la valeur DateTime spécifiée.
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreDateTimeOffset(DateTime, TimeSpan)Initialise une nouvelle instance de la structure DateTimeOffset à l'aide de l'offset et de la valeur DateTime spécifiés.
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreDateTimeOffset(Int64, TimeSpan)Initialise une nouvelle instance de la structure DateTimeOffset à l'aide de l'offset et du nombre de graduations spécifiés.
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreDateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)Initialise une nouvelle instance de la structure DateTimeOffset en utilisant l'année, le mois, le jour, l'heure, la minute, la seconde et l'offset spécifiés.
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreDateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)Initialise une nouvelle instance de la structure DateTimeOffset en utilisant l'année, le mois, le jour, l'heure, la minute, la seconde, la milliseconde et l'offset spécifiés.
Méthode publiqueDateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)Initialise une nouvelle instance de la structure DateTimeOffset en utilisant l'année, le mois, le jour, l'heure, la minute, la seconde, la milliseconde et l'offset spécifiés pour un calendrier spécifié.
Début

  NomDescription
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreDateObtient une valeur DateTime représentant le composant "date" de l'objet DateTimeOffset en cours.
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreDateTimeObtient une valeur DateTime représentant la date et l'heure de l'objet DateTimeOffset en cours.
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreDayObtient le jour du mois représenté par l'objet DateTimeOffset en cours.
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreDayOfWeekObtient le jour de la semaine représenté par l'objet DateTimeOffset en cours.
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreDayOfYearObtient le jour de l'année représenté par l'objet DateTimeOffset en cours.
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreHourObtient le composant "heure" de l'heure représentée par l'objet DateTimeOffset en cours.
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreLocalDateTimeObtient une valeur DateTime représentant la date et l'heure locales de l'objet DateTimeOffset en cours.
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreMillisecondObtient le composant « milliseconde » de l'heure représentée par l'objet DateTimeOffset en cours.
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreMinuteObtient le composant "minute" de l'heure représentée par l'objet DateTimeOffset en cours.
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreMonthObtient le composant "mois" de la date représentée par l'objet DateTimeOffset en cours.
Propriété publiqueMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreNowObtient un objet DateTimeOffset qui a pour valeur la date et l'heure actuelles de l'ordinateur actif, l'offset étant égal à l'offset de l'heure locale à partir du temps universel.
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreOffsetObtient l'offset d'heure à partir du temps universel.
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreSecondObtient le composant "seconde" de l'heure de l'horloge représentée par l'objet DateTimeOffset en cours.
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreTicksObtient le nombre de graduations représentant la date et l'heure de l'objet DateTimeOffset en cours en temps horloge.
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreTimeOfDayObtient l'heure pour l'objet DateTimeOffset en cours.
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreUtcDateTimeObtient une valeur DateTime représentant la date et l'heure en temps universel de l'objet DateTimeOffset en cours.
Propriété publiqueMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreUtcNowObtient un objet DateTimeOffset dont la date et l'heure ont la valeur de la date et de l'heure en temps universel actuel et dont l'offset a la valeur TimeSpan.Zero.
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreUtcTicksObtient le nombre de graduations représentant la date et l'heure de l'objet DateTimeOffset en cours en temps universel.
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreYearObtient le composant "année" de la date représentée par l'objet DateTimeOffset en cours.
Début

  NomDescription
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreAddAjoute un intervalle de temps spécifié à un objet DateTimeOffset.
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreAddDaysAjoute un nombre spécifié de jours entiers et partiels à l'objet DateTimeOffset en cours.
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreAddHoursAjoute un nombre spécifié d'heures entières et partielles à l'objet DateTimeOffset en cours.
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreAddMillisecondsAjoute un nombre de millisecondes spécifié à l'objet DateTimeOffset en cours.
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreAddMinutesAjoute un nombre spécifié de minutes entières et partielles à l'objet DateTimeOffset en cours.
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreAddMonthsAjoute un nombre de mois spécifié à l'objet DateTimeOffset en cours.
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreAddSecondsAjoute un nombre spécifié de secondes entières et partielles à l'objet DateTimeOffset en cours.
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreAddTicksAjoute un nombre de graduations spécifié à l'objet DateTimeOffset en cours.
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreAddYearsAjoute un nombre d'années spécifié à l'objet DateTimeOffset.
Méthode publiqueMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreCompareCompare deux objets DateTimeOffset et indique si le premier est antérieur, égal ou ultérieur au second.
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreCompareToCompare l'objet DateTimeOffset en cours à un objet DateTimeOffset spécifié et indique si l'objet en cours est antérieur, égal ou ultérieur au second objet DateTimeOffset.
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreEquals(DateTimeOffset)Détermine si l'objet DateTimeOffset en cours représente le même instant précis qu'un objet DateTimeOffset spécifié.
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreEquals(Object)Détermine si un objet DateTimeOffset représente le même instant précis qu'un objet spécifié. (Substitue ValueType.Equals(Object).)
Méthode publiqueMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreEquals(DateTimeOffset, DateTimeOffset)Détermine si deux objets DateTimeOffset spécifiés représentent le même instant précis.
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreEqualsExactDétermine si l'objet DateTimeOffset en cours représente la même heure et a le même offset qu'un objet DateTimeOffset spécifié.
Méthode publiqueMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreFromFileTimeConvertit l'heure de fichier Windows spécifiée en heure locale équivalente.
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreGetHashCodeRetourne le code de hachage pour l'objet DateTimeOffset en cours. (Substitue ValueType.GetHashCode().)
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreParse(String)Convertit la représentation sous forme de chaîne spécifiée d'une date, heure et offset en DateTimeOffset équivalent.
Méthode publiqueMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreParse(String, IFormatProvider)Convertit la représentation sous forme de chaîne spécifiée d'une date et d'une heure en DateTimeOffset équivalent à l'aide des informations de format propres à la culture spécifiées.
Méthode publiqueMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreParse(String, IFormatProvider, DateTimeStyles)Convertit la chaîne représentant une date et heure en DateTimeOffset équivalent à l'aide des informations et style de format propres à la culture spécifiés.
Méthode publiqueMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreParseExact(String, String, IFormatProvider)Convertit la représentation sous forme de chaîne spécifiée d'une date et d'une heure en DateTimeOffset équivalent à l'aide des informations de format propres à la culture et au format spécifiés. Le format de la chaîne doit correspondre exactement au format spécifié.
Méthode publiqueMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreParseExact(String, String, IFormatProvider, DateTimeStyles)Convertit la représentation sous forme de chaîne spécifiée d'une date et d'une heure en DateTimeOffset équivalent à l'aide des informations et du style de format propres à la culture spécifiés. Le format de la chaîne doit correspondre exactement au format spécifié.
Méthode publiqueMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreParseExact(String, String[], IFormatProvider, DateTimeStyles)Convertit la représentation sous forme de chaîne spécifiée d'une date et d'une heure en DateTimeOffset équivalent à l'aide du style, des informations de format propres à la culture et des formats spécifiés. Le format de la représentation sous forme de chaîne doit correspondre exactement à l'un des formats spécifiés.
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreSubtract(DateTimeOffset)Soustrait une valeur DateTimeOffset représentant une date et une heure spécifiques de l'objet DateTimeOffset en cours.
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreSubtract(TimeSpan)Soustrait un intervalle de temps spécifié de l'objet DateTimeOffset en cours.
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreToFileTimeConvertit la valeur de l'objet DateTimeOffset en cours en heure de fichier Windows.
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreToLocalTimeConvertit l'objet DateTimeOffset en cours en objet DateTimeOffset représentant l'heure locale.
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreToOffsetConvertit la valeur de l'objet DateTimeOffset en cours en date et heure spécifiées par une valeur d'offset.
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreToString()Convertit la valeur de l'objet DateTimeOffset en cours en sa représentation équivalente sous forme de chaîne. (Substitue ValueType.ToString().)
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreToString(IFormatProvider)Convertit la valeur de l'objet DateTimeOffset en cours en représentation sous forme de chaîne équivalente à l'aide des informations de format propres à la culture spécifiées.
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreToString(String)Convertit la valeur de l'objet DateTimeOffset actuel en sa représentation sous forme de chaîne équivalente en utilisant le format spécifié.
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreToString(String, IFormatProvider)Convertit la valeur de l'objet DateTimeOffset actif en sa représentation sous forme de chaîne équivalente à l'aide du format et des informations de format spécifiques à la culture spécifiés.
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreToUniversalTimeConvertit l'objet DateTimeOffset en cours en valeur DateTimeOffset représentant le temps universel.
Méthode publiqueMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreTryParse(String, DateTimeOffset)Essaie de convertir une représentation sous forme de chaîne spécifiée d'une date et d'une heure en son équivalent DateTimeOffset et retourne une valeur indiquant si la conversion a réussi.
Méthode publiqueMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreTryParse(String, IFormatProvider, DateTimeStyles, DateTimeOffset)Essaie de convertir une représentation sous forme de chaîne spécifiée d'une date et d'une heure en son équivalent DateTimeOffset et retourne une valeur indiquant si la conversion a réussi.
Méthode publiqueMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreTryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTimeOffset)Convertit la représentation sous forme de chaîne spécifiée d'une date et d'une heure en DateTimeOffset équivalent à l'aide des informations et du style de format propres à la culture spécifiés. Le format de la chaîne doit correspondre exactement au format spécifié.
Méthode publiqueMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreTryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTimeOffset)Convertit la représentation sous forme de chaîne spécifiée d'une date et heure en DateTimeOffset équivalent à l'aide du tableau de formats, des informations et du style de format propres à la culture spécifiés. Le format de la représentation sous forme de chaîne doit correspondre exactement à l'un des formats spécifiés.
Début

  NomDescription
Opérateur publicMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreAdditionAjoute un intervalle de temps spécifié à un objet DateTimeOffset présentant une date et une heure spécifiées et produit un objet DateTimeOffset présentant une nouvelle date et une nouvelle heure.
Opérateur publicMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreEqualityDétermine si deux objets DateTimeOffset spécifiés représentent le même instant précis.
Opérateur publicMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreGreaterThanDétermine si un objet DateTimeOffset spécifié est supérieur (ou ultérieur) au second objet DateTimeOffset spécifié.
Opérateur publicMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreGreaterThanOrEqualDétermine si un objet DateTimeOffset spécifié est supérieur ou égal au second objet DateTimeOffset spécifié.
Opérateur publicMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreImplicit(DateTime to DateTimeOffset)Définit une conversion implicite d'un objet DateTime en objet DateTimeOffset.
Opérateur publicMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreInequalityDétermine si deux objets DateTimeOffset spécifiés font référence à des moments différents.
Opérateur publicMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreLessThanDétermine si un objet DateTimeOffset spécifié est inférieur à un deuxième objet DateTimeOffset spécifié.
Opérateur publicMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreLessThanOrEqualDétermine si un objet DateTimeOffset spécifié est inférieur à un deuxième objet DateTimeOffset spécifié.
Opérateur publicMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreSubtraction(DateTimeOffset, DateTimeOffset)Soustrait un objet DateTimeOffset d'un autre objet et produit un intervalle de temps.
Opérateur publicMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreSubtraction(DateTimeOffset, TimeSpan)Soustrait un intervalle de temps spécifié d'une date et d'une heure spécifiées et produit une nouvelle date et heure.
Début

  NomDescription
Champ publicMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreMaxValueReprésente la plus grande valeur possible de DateTimeOffset. Ce champ est en lecture seule.
Champ publicMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreMinValueReprésente la première valeur possible de DateTimeOffset. Ce champ est en lecture seule.
Début

  NomDescription
Implémentation d'interface expliciteMéthode privéePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreIComparable.CompareToInfrastructure. Compare la valeur de l'objet DateTimeOffset en cours à un objet du même type.
Implémentation d'interface expliciteMéthode privéeIDeserializationCallback.OnDeserializationInfrastructure. S'exécute lorsque la désérialisation d'un objet a été effectuée.
Implémentation d'interface expliciteMéthode privéeISerializable.GetObjectDataInfrastructure. Remplit un objet SerializationInfo avec les données nécessaires pour sérialiser l'objet DateTimeOffset en cours.
Début

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 d'heure d'une valeur DateTimeOffset est mesurée en unités de 100 nanosecondes, appelées graduations, et une date spécifique correspond au nombre de graduations écoulées à compter de 00:00 (minuit), le 1er janvier de l'année 0001 après J.C. (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.

RemarqueRemarque

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 graduations 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.

    
    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

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5 SP1, 3.0 SP1, 2.0 SP1

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Bibliothèque de classes portable

Pris en charge dans : Bibliothèque de classes portable

.NET pour les applications du Windows Store

Pris en charge dans : Windows 8

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft