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

 

Date de publication : novembre 2016

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 actuelles 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 actuelles 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 actuelles DateTimeOffset objet.

System_CAPS_pubpropertySystem_CAPS_staticUtcNow

Obtient un DateTimeOffset objet dont la date et heure sont définies 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 actuelles DateTimeOffset objet dans le 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 spécifié d’années à la valeur de cette instance.

System_CAPS_pubmethodSystem_CAPS_staticCompare(DateTimeOffset, DateTimeOffset)

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

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 une heure Unix exprimée en nombre de millisecondes qui se sont écoulées depuis 1970-01-01T00:00:00Z à un DateTimeOffset valeur.

System_CAPS_pubmethodSystem_CAPS_staticFromUnixTimeSeconds(Int64)

Convertit une heure Unix exprimée en 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 la 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 la 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) spécifié par un deuxième 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 de produit et n’est pas destinée à être utilisée directement depuis 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 de produit et n’est pas destinée à être utilisée directement depuis 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 de produit et n’est pas destinée à être utilisée directement depuis votre code. Remplit un SerializationInfo avec les données nécessaires pour sérialiser l’actuel DateTimeOffset objet.

The T:System.DateTimeOffset structure includes a T:System.DateTime value, together with an P:System.DateTimeOffset.Offset property that defines the difference between the current T:System.DateTimeOffset instance's date and time and Coordinated Universal Time (UTC). Because it exactly defines a date and time relative to UTC, the T:System.DateTimeOffset structure does not include a Kind member, as the T:System.DateTime structure does. It represents dates and times with values whose UTC ranges from 12:00:00 midnight, January 1, 0001 Anno Domini (Common Era), to 11:59:59 P.M., December 31, 9999 A.D. (C.E.).

The time component of a T:System.DateTimeOffset value is measured in 100-nanosecond units called ticks, and a particular date is the number of ticks since 12:00 midnight, January 1, 0001 A.D. (C.E.) in the T:System.Globalization.GregorianCalendar calendar. A T:System.DateTimeOffset value is always expressed in the context of an explicit or default calendar. Ticks that are attributable to leap seconds are not included in the total number of ticks.

System_CAPS_noteRemarque

   If you are working with a ticks value that you want to convert to some other time interval, such as minutes or seconds, you should use the F:System.TimeSpan.TicksPerDay, F:System.TimeSpan.TicksPerHour, F:System.TimeSpan.TicksPerMinute, F:System.TimeSpan.TicksPerSecond, or F:System.TimeSpan.TicksPerMillisecond constant to perform the conversion. For example, to add the number of seconds represented by a specified number of ticks to the P:System.DateTimeOffset.Second component of a T:System.DateTimeOffset value, you can use the expression dateValue.Second + nTicks/Timespan.TicksPerSecond.

Although a T:System.DateTimeOffset value includes an offset, it is not a fully time zone-aware data structure. While an offset from UTC is one characteristic of a time zone, it does not unambiguously identify a time zone. Not only do multiple time zones share the same offset from UTC, but the offset of a single time zone changes if it observes daylight saving time. This means that, as soon as a T:System.DateTimeOffset value is disassociated from its time zone, it can no longer be unambiguously linked back to its original time zone.

Because T:System.DateTimeOffset is a structure, a T:System.DateTimeOffset object that has been declared but not otherwise initialized contains the default values for each of its member fields. This means that its P:System.DateTimeOffset.DateTime property is set to F:System.DateTimeOffset.MinValue and its P:System.DateTimeOffset.Offset property is set to F:System.TimeSpan.Zero.

You can create a new T:System.DateTimeOffset value by calling any of the overloads of its constructor, which are similar to the overloaded constructors for the T:System.DateTime structure. You can also create a new T:System.DateTimeOffset value by assigning it a T:System.DateTime value. This is an implicit conversion; it does not require a casting operator (in C#) or call to a conversion method (in Visual Basic). You can also initialize a T:System.DateTimeOffset value from the string representation of a date and time by calling a number of static string parsing methods, which include Overload:System.DateTimeOffset.Parse, Overload:System.DateTimeOffset.ParseExact, Overload:System.DateTimeOffset.TryParse, and Overload:System.DateTimeOffset.TryParseExact.

The members of the T:System.DateTimeOffset structure provide functionality in the following areas:

  • Date and time arithmetic.

    You can add or subtract either dates or time intervals from a particular T:System.DateTimeOffset value. Arithmetic operations with T:System.DateTimeOffset values, unlike those with T:System.DateTime values, adjust for differences in time offsets when returning a result. For example, the following code uses T:System.DateTime variables to subtract the current local time from the current UTC time. The code then uses T:System.DateTimeOffset variables to perform the same operation. The subtraction with T:System.DateTime values returns the local time zone's difference from UTC, while the subtraction with T:System.DateTimeOffset values returns F:System.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                        
       }
    }
    
  • Type conversion operations.

    You can convert T:System.DateTimeOffset values to P:System.DateTimeOffset.DateTime values and vice versa.

  • Time manipulation and extraction operations.

    You can extract either the date or the time of a T:System.DateTimeOffset value. You can also retrieve the value of a particular T:System.DateTimeOffset component, such as its year or its month.

  • Date and time conversion.

    You can convert any T:System.DateTimeOffset value to another T:System.DateTimeOffset value that represents the same point in time in another time zone. However, a time zone's adjustment rules are applied only in the case of the M:System.DateTimeOffset.ToLocalTime method, which converts a T:System.DateTimeOffset value to the date and time in the local system zone.

  • Date and time comparison.

    You can determine whether any particular T:System.DateTimeOffset value is earlier than, the same as, or later than another T:System.DateTimeOffset value. Before the comparison is performed, all values are converted to UTC.

Plateforme Windows universelle
Disponible depuis 8
.NET Framework
Disponible depuis 2.0
Bibliothèque de classes portable
Pris en charge dans : plateformes .NET portables
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: