DateTimeOffset Structure
TOC
Réduire la table des matières
Développer la table des matières
Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

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>

NomDescription
System_CAPS_pubmethodDateTimeOffset(DateTime)

Initialise une nouvelle instance de la structure DateTimeOffset en utilisant la valeur DateTime spécifiée.

System_CAPS_pubmethodDateTimeOffset(DateTime, TimeSpan)

Initialise une nouvelle instance de la structure DateTimeOffset en utilisant la valeur DateTime et le décalage spécifiés.

System_CAPS_pubmethodDateTimeOffset(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 le décalage (offset) spécifiés pour un calendrier spécifié.

System_CAPS_pubmethodDateTimeOffset(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 le décalage spécifiés.

System_CAPS_pubmethodDateTimeOffset(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 le décalage spécifiés.

System_CAPS_pubmethodDateTimeOffset(Int64, TimeSpan)

Initialise une nouvelle instance de la structure DateTimeOffset à l’aide de l’offset et du nombre de graduations spécifiés.

NomDescription
System_CAPS_pubpropertyDate

Obtient un DateTime valeur qui représente le composant « date » de l'utilisateur actuel DateTimeOffset objet.

System_CAPS_pubpropertyDateTime

Obtient une valeur DateTime représentant la date et l’heure de l’objet DateTimeOffset actuel.

System_CAPS_pubpropertyDay

Obtient le jour du mois représenté par les DateTimeOffset objet.

System_CAPS_pubpropertyDayOfWeek

Obtient le jour de la semaine représenté par les DateTimeOffset objet.

System_CAPS_pubpropertyDayOfYear

Obtient le jour de l'année représenté par les DateTimeOffset objet.

System_CAPS_pubpropertyHour

Obtient le composant « heure » de l'heure représentée par l'actuel DateTimeOffset objet.

System_CAPS_pubpropertyLocalDateTime

Obtient un DateTime valeur qui représente la date et heure locales de l'utilisateur actuel DateTimeOffset objet.

System_CAPS_pubpropertyMillisecond

Obtient le composant « millisecondes » de l'heure représentée par l'actuel DateTimeOffset objet.

System_CAPS_pubpropertyMinute

Obtient le composant « minutes » de l'heure représentée par l'actuel DateTimeOffset objet.

System_CAPS_pubpropertyMonth

Obtient le composant « mois » de la date représentée par le DateTimeOffset objet.

System_CAPS_pubpropertySystem_CAPS_staticNow

Obtient 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 par rapport au temps universel UTC.

System_CAPS_pubpropertyOffset

Obtient l'offset d'heure par rapport au temps universel coordonné (UTC).

System_CAPS_pubpropertySecond

Obtient le deuxième composant de l'horloge représentée par le DateTimeOffset objet.

System_CAPS_pubpropertyTicks

Obtient le nombre de graduations représentant la date et l’heure de l’utilisateur actuel DateTimeOffset objet de l’horloge.

System_CAPS_pubpropertyTimeOfDay

Obtient l’heure de la journée en cours DateTimeOffset objet.

System_CAPS_pubpropertyUtcDateTime

Obtient un DateTime valeur qui représente la date du temps universel coordonné (UTC) et l'heure de l'utilisateur actuel DateTimeOffset objet.

System_CAPS_pubpropertySystem_CAPS_staticUtcNow

Obtient un DateTimeOffset objet dont la date et heure sont définis pour la date du temps universel coordonné (UTC) et l'heure actuelle et dont l'offset est TimeSpan.Zero.

System_CAPS_pubpropertyUtcTicks

Obtient le nombre de graduations représentant la date et l'heure de l'utilisateur actuel DateTimeOffset objet en temps universel coordonné (UTC).

System_CAPS_pubpropertyYear

Obtient le composant « année » de la date représentée par le DateTimeOffset objet.

NomDescription
System_CAPS_pubmethodAdd(TimeSpan)

Retourne un nouvel objet DateTimeOffset qui ajoute un intervalle de temps spécifié à la valeur de cette instance.

System_CAPS_pubmethodAddDays(Double)

Retourne un nouveau DateTimeOffset objet qui ajoute un nombre spécifié de jours entiers et partiels à la valeur de cette instance.

System_CAPS_pubmethodAddHours(Double)

Retourne un nouvel objet DateTimeOffset qui ajoute un nombre spécifié d’heures entières et partielles à la valeur de cette instance.

System_CAPS_pubmethodAddMilliseconds(Double)

Retourne un nouvel objet DateTimeOffset qui ajoute un nombre de millisecondes spécifié à la valeur de cette instance.

System_CAPS_pubmethodAddMinutes(Double)

Retourne un nouvel objet DateTimeOffset qui ajoute un nombre spécifié de minutes entières et partielles à la valeur de cette instance.

System_CAPS_pubmethodAddMonths(Int32)

Retourne un nouveau DateTimeOffset objet qui ajoute un nombre de mois spécifié à la valeur de cette instance.

System_CAPS_pubmethodAddSeconds(Double)

Retourne un nouvel objet DateTimeOffset qui ajoute un nombre spécifié de secondes entières et partielles à la valeur de cette instance.

System_CAPS_pubmethodAddTicks(Int64)

Retourne un nouvel objet DateTimeOffset qui ajoute un nombre de graduations spécifié à la valeur de cette instance.

System_CAPS_pubmethodAddYears(Int32)

Retourne un nouveau DateTimeOffset objet qui ajoute un nombre d'années spécifié à la valeur de cette instance.

System_CAPS_pubmethodSystem_CAPS_staticCompare(DateTimeOffset, DateTimeOffset)

Compare deux DateTimeOffset objets et indique si la première est antérieure à la deuxième, égale à la seconde ou ultérieur au second.

System_CAPS_pubmethodCompareTo(DateTimeOffset)

Compare l'actuel DateTimeOffset objet spécifié DateTimeOffset de l'objet et indique si l'objet actuel est antérieure, identique ou ultérieure à la seconde DateTimeOffset objet.

System_CAPS_pubmethodEquals(DateTimeOffset)

Détermine si l'actuel DateTimeOffset objet représente le même instant précis qu'un DateTimeOffset objet.

System_CAPS_pubmethodSystem_CAPS_staticEquals(DateTimeOffset, DateTimeOffset)

Détermine si deux spécifiées DateTimeOffset objets représentent le même point dans le temps.

System_CAPS_pubmethodEquals(Object)

Détermine si un DateTimeOffset objet représente le même instant précis qu'un objet spécifié.(Remplace ValueType.Equals(Object).)

System_CAPS_pubmethodEqualsExact(DateTimeOffset)

Détermine si l'actuel DateTimeOffset objet représente la même heure et a le même offset comme spécifié DateTimeOffset objet.

System_CAPS_pubmethodSystem_CAPS_staticFromFileTime(Int64)

Convertit l'heure de fichier Windows spécifiée en heure locale équivalente.

System_CAPS_pubmethodSystem_CAPS_staticFromUnixTimeMilliseconds(Int64)

Convertit un temps Unix exprimé comme le nombre de millisecondes qui se sont écoulées depuis 1970-01-01T00:00:00Z à un DateTimeOffset valeur.

System_CAPS_pubmethodSystem_CAPS_staticFromUnixTimeSeconds(Int64)

Convertit un temps Unix exprimé comme le nombre de secondes qui se sont écoulées depuis 1970-01-01T00:00:00Z à un DateTimeOffset valeur.

System_CAPS_pubmethodGetHashCode()

Retourne le code de hachage pour l'actuel DateTimeOffset objet.(Remplace ValueType.GetHashCode().)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodSystem_CAPS_staticParse(String)

Convertit la représentation sous forme de chaîne spécifiée d’une date, d’une heure et d’un décalage en DateTimeOffset équivalent.

System_CAPS_pubmethodSystem_CAPS_staticParse(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.

System_CAPS_pubmethodSystem_CAPS_staticParse(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 de format propres à la culture et du style de mise en forme spécifiés.

System_CAPS_pubmethodSystem_CAPS_staticParseExact(String, String, IFormatProvider)

Convertit la représentation sous forme de chaîne spécifiée d'une date et d'une heure en son équivalent DateTimeOffset à 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é.

System_CAPS_pubmethodSystem_CAPS_staticParseExact(String, String, IFormatProvider, DateTimeStyles)

Convertit la représentation sous forme de chaîne spécifiée d'une date et d'une heure en son équivalent DateTimeOffset à 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é.

System_CAPS_pubmethodSystem_CAPS_staticParseExact(String, String[], IFormatProvider, DateTimeStyles)

Convertit la représentation sous forme de chaîne spécifiée d’une date et d’une heure dans son équivalent DateTimeOffset en utilisant le style, les informations de format propres à la culture et les 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.

System_CAPS_pubmethodSubtract(DateTimeOffset)

Soustrait une valeur DateTimeOffset qui représente une date et une heure spécifiques de l’objet DateTimeOffset actuel.

System_CAPS_pubmethodSubtract(TimeSpan)

Soustrait un intervalle de temps spécifié de l’objet DateTimeOffset actuel.

System_CAPS_pubmethodToFileTime()

Convertit la valeur de l'objet DateTimeOffset actuel en heure de fichier Windows.

System_CAPS_pubmethodToLocalTime()

Convertit en cours DateTimeOffset de l’objet à un DateTimeOffset objet qui représente l’heure locale.

System_CAPS_pubmethodToOffset(TimeSpan)

Convertit la valeur de l’utilisateur actuel DateTimeOffset objet à la date et l’heure spécifiées par une valeur de décalage.

System_CAPS_pubmethodToString()

Convertit la valeur de l'objet DateTimeOffset actuel en sa représentation équivalente sous forme de chaîne.(Remplace ValueType.ToString().)

System_CAPS_pubmethodToString(IFormatProvider)

Convertit la valeur de l’utilisateur actuel DateTimeOffset objet à sa représentation sous forme de chaîne équivalente en utilisant les informations de mise en forme propres à la culture spécifiées.

System_CAPS_pubmethodToString(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é.

System_CAPS_pubmethodToString(String, IFormatProvider)

Convertit la valeur de l'objet DateTimeOffset actuel 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.

System_CAPS_pubmethodToUniversalTime()

Convertit en cours DateTimeOffset de l’objet à un DateTimeOffset valeur qui représente le temps universel coordonné (UTC).

System_CAPS_pubmethodToUnixTimeMilliseconds()

Retourne le nombre de millisecondes qui se sont écoulées depuis 1970-01-01T00:00:00.000Z.

System_CAPS_pubmethodToUnixTimeSeconds()

Retourne le nombre de secondes écoulées depuis 1970-01-01T00:00:00Z.

System_CAPS_pubmethodSystem_CAPS_staticTryParse(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.

System_CAPS_pubmethodSystem_CAPS_staticTryParse(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 DateTimeOffset équivalent, et retourne une valeur indiquant si la conversion a réussi.

System_CAPS_pubmethodSystem_CAPS_staticTryParseExact(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 son équivalent DateTimeOffset à 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é.

System_CAPS_pubmethodSystem_CAPS_staticTryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTimeOffset)

Convertit la représentation sous forme de chaîne spécifiée d'une date et heure en son équivalent DateTimeOffset à 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.

NomDescription
System_CAPS_pubfieldSystem_CAPS_staticMaxValue

Représente la plus grande valeur possible de DateTimeOffset. Ce champ est en lecture seule.

System_CAPS_pubfieldSystem_CAPS_staticMinValue

Représente la plus proche possible DateTimeOffset valeur. Ce champ est en lecture seule.

NomDescription
System_CAPS_puboperatorSystem_CAPS_staticAddition(DateTimeOffset, TimeSpan)

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

System_CAPS_puboperatorSystem_CAPS_staticEquality(DateTimeOffset, DateTimeOffset)

Détermine si deux spécifiées DateTimeOffset objets représentent le même point dans le temps.

System_CAPS_puboperatorSystem_CAPS_staticGreaterThan(DateTimeOffset, DateTimeOffset)

Détermine si un spécifié DateTimeOffset objet est supérieur à (ou ultérieur) une seconde spécifié DateTimeOffset objet.

System_CAPS_puboperatorSystem_CAPS_staticGreaterThanOrEqual(DateTimeOffset, DateTimeOffset)

Détermine si un spécifié DateTimeOffset objet est supérieur ou égal au second spécifié DateTimeOffset objet.

System_CAPS_puboperatorSystem_CAPS_staticImplicit(DateTime to DateTimeOffset)

Définit une conversion implicite d'un DateTime de l'objet à un DateTimeOffset objet.

System_CAPS_puboperatorSystem_CAPS_staticInequality(DateTimeOffset, DateTimeOffset)

Détermine si deux spécifiées DateTimeOffset objets font référence à différents points dans le temps.

System_CAPS_puboperatorSystem_CAPS_staticLessThan(DateTimeOffset, DateTimeOffset)

Détermine si un spécifié DateTimeOffset est inférieur à une seconde spécifiée de l'objet DateTimeOffset objet.

System_CAPS_puboperatorSystem_CAPS_staticLessThanOrEqual(DateTimeOffset, DateTimeOffset)

Détermine si un spécifié DateTimeOffset est inférieur à une seconde spécifiée de l'objet DateTimeOffset objet.

System_CAPS_puboperatorSystem_CAPS_staticSubtraction(DateTimeOffset, DateTimeOffset)

Soustrait un objet DateTimeOffset d’un autre objet et produit un intervalle de temps.

System_CAPS_puboperatorSystem_CAPS_staticSubtraction(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.

NomDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethodIComparable.CompareTo(Object)

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Compare la valeur de l'utilisateur actuel DateTimeOffset objet avec un autre objet du même type.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDeserializationCallback.OnDeserialization(Object)

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. S'exécute quand la désérialisation d'un objet a été effectuée.

System_CAPS_pubinterfaceSystem_CAPS_privmethodISerializable.GetObjectData(SerializationInfo, StreamingContext)

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Remplit un SerializationInfo avec les données nécessaires pour sérialiser l'actuel DateTimeOffset objet.

Le DateTimeOffset structure inclut un DateTime valeur, avec un Offset propriété qui définit la différence entre l'objet actuel DateTimeOffset l'instance en date et heure et temps universel coordonné (UTC). Car elle définit précisément une date et une heure par rapport à l'heure UTC, le DateTimeOffset structure n'inclut pas un Kind membre, comme le DateTime structure est. Elle représente des dates et heures avec des valeurs dont UTC comprise entre 12:00:00 minuit le 1er janvier 0001 Anno onze heures (ère), à 11:59:59 P.M., le 31 décembre 9999 apr. J.C. (NOTRE ÈRE).

Le composant d'un DateTimeOffset valeur est mesurée en unités de 100 nanosecondes, appelées graduations, et une date particulière est le nombre de graduations depuis 12:00 minuit, le 1er janvier 0001 apr. J.C. (NOTRE ÈRE) dans la GregorianCalendar calendrier. Un DateTimeOffset valeur est toujours exprimée dans le contexte d'une liste explicite ou le calendrier par défaut. Cycles qui sont attribuables aux secondes intercalaires ne sont pas inclus dans le nombre total de graduations.

System_CAPS_noteRemarque

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

Bien qu'un DateTimeOffset valeur inclut un décalage, il n'est pas une structure de données entièrement en charge les fuseaux horaires. Un décalage UTC est une caractéristique d'un fuseau horaire, il n'identifie pas clairement un fuseau horaire. Non seulement faire plusieurs fuseaux horaires partagent le même offset d'UTC, mais le décalage d'un fuseau horaire unique change si elle respecte l'heure d'été. Cela signifie que, dès qu'un DateTimeOffset valeur est dissociée de son fuseau horaire, elle peut ne plus être reliée clairement à son fuseau horaire d'origine.

Étant donné que DateTimeOffset est une structure, un DateTimeOffset objet qui a été déclaré mais non initialisé contient les valeurs par défaut pour chacun de ses champs membre. Cela signifie que son DateTime est définie sur DateTimeOffset.MinValue et son Offset est définie sur TimeSpan.Zero.

Vous pouvez créer un nouveau DateTimeOffset valeur en appelant une des surcharges de son constructeur, qui sont similaires aux constructeurs surchargés pour la DateTime structure. Vous pouvez également créer un nouveau DateTimeOffset valeur en lui assignant un DateTime valeur. Il s'agit d'une conversion implicite ; Il ne pas exiger un opérateur de cast (en c#) ou l'appel à une méthode de conversion (en Visual Basic). Vous pouvez également initialiser un DateTimeOffset valeur à partir de la représentation sous forme de chaîne d'une date et une heure en appelant un numéro de chaîne statique, l'analyse des méthodes, telles que Parse, ParseExact, TryParse, et TryParseExact.

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

  • Date et heure.

    Vous pouvez ajouter ou soustraire des dates ou des intervalles de temps à partir d'un rôle particulier DateTimeOffset valeur. Opérations arithmétiques avec des DateTimeOffset valeurs, contrairement à celles avec DateTime valeurs, ajustent les différences des offsets d'heure en retournant un résultat. Par exemple, le code suivant utilise DateTime variables à soustraire l'heure locale actuelle à l'heure UTC actuelle. Le code utilise ensuite DateTimeOffset variables pour effectuer la même opération. La soustraction avec DateTime valeurs retourne la différence du fuseau horaire local à l'heure UTC, tandis que la soustraction avec DateTimeOffset retourne des valeurs 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                        
       }
    }
    
  • Tapez les opérations de conversion.

    Vous pouvez convertir DateTimeOffset valeurs DateTime valeurs et vice versa.

  • Opérations d'extraction et de manipulation de temps.

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

  • Conversion de date et d'heure.

    Vous pouvez convertir tout DateTimeOffset valeur à un autre DateTimeOffset valeur qui représente le même point dans le temps dans un autre fuseau horaire. Toutefois, les règles d'ajustement d'un fuseau horaire sont appliquées uniquement dans le cas de la ToLocalTime méthode, qui convertit une DateTimeOffset valeur à la date et l'heure dans la zone du système local.

  • Comparaison de date et d'heure.

    Vous pouvez déterminer si une particulier DateTimeOffset valeur est antérieure, identique ou ultérieure à une autre DateTimeOffset valeur. Avant que la comparaison est effectuée, toutes les valeurs sont converties au format UTC.

Universal Windows Platform
Disponible depuis 8
.NET Framework
Disponible depuis 2.0
Portable Class Library
Pris en charge dans : portable .NET platforms
Silverlight
Disponible depuis 2.0
Windows Phone Silverlight
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1

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

Retour au début
Afficher:
© 2016 Microsoft