DateTimeOffset DateTimeOffset DateTimeOffset DateTimeOffset Struct

Définition

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).Represents a point in time, typically expressed as a date and time of day, relative to Coordinated Universal Time (UTC).

public value class DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IFormattable, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable
[System.Serializable]
public struct DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IFormattable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable
type DateTimeOffset = struct
    interface IFormattable
    interface ISerializable
    interface IDeserializationCallback
Public Structure DateTimeOffset
Implements IComparable, IComparable(Of DateTimeOffset), IDeserializationCallback, IEquatable(Of DateTimeOffset), IFormattable, ISerializable
Héritage
DateTimeOffsetDateTimeOffsetDateTimeOffsetDateTimeOffset
Attributs
Implémente

Remarques

Le DateTimeOffset structure inclut un DateTime valeur, avec un Offset propriété qui définit la différence entre le cours DateTimeOffset date / heure et temps universel coordonné (UTC) d’instance.The DateTimeOffset structure includes a DateTime value, together with an Offset property that defines the difference between the current DateTimeOffset instance's date and time and Coordinated Universal Time (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 est de la structure.Because it exactly defines a date and time relative to UTC, the DateTimeOffset structure does not include a Kind member, as the DateTime structure does. Il représente les dates et heures avec des valeurs dont UTC comprise entre 12:00:00 minuit le 1er janvier 0001 Anno onze heures (ère chrétienne), à 11:59:59 P.M., 31 décembre 9999 apr. J.C.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. (NOTRE ÈRE).(C.E.).

Important

Les ères des calendriers japonais sont basées sur le règne de l’empereur et sont donc amenées à changer.Eras in the Japanese calendars are based on the emperor's reign and are therefore expected to change. Par exemple, le 1 mai 2019 a marqué le début de l’ère Reiwa dans JapaneseCalendar et JapaneseLunisolarCalendar.For example, May 1, 2019 marked the beginning of the Reiwa era in the JapaneseCalendar and JapaneseLunisolarCalendar. Ce changement d’ère affecte toutes les applications qui utilisent ces calendriers.Such a change of era affects all applications that use these calendars. Pour plus d’informations et pour déterminer si vos applications sont affectées, consultez Handling a new era in the Japanese calendar in .NET.See Handling a new era in the Japanese calendar in .NET for more information and to determine whether your applications are affected. Pour plus d’informations sur le test de vos applications sur les systèmes Windows pour garantir leur préparation au changement d’ère, consultez Préparer votre application au changement de l’ère japonaise.See Prepare your application for the Japanese era change for information on testing your applications on Windows systems to ensure their readiness for the era change. Consultez Utilisation des ères pour connaître les fonctionnalités de .NET qui prennent en charge les calendriers avec plusieurs ères et les bonnes pratiques d’utilisation de ce type de calendrier.See Working with eras for features in .NET that support calendars with multiple eras and for best practices when working with calendars that support multiple eras.

Le composant heure 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.The time component of a 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. (NOTRE ÈRE) dans le GregorianCalendar calendrier.(C.E.) in the GregorianCalendar calendar. Un DateTimeOffset valeur est toujours exprimée dans le contexte d’un texte explicite ou le calendrier par défaut.A DateTimeOffset value is always expressed in the context of an explicit or default calendar. Les graduations sont attribuables aux secondes intercalaires ne sont pas incluses dans le nombre total de graduations.Ticks that are attributable to leap seconds are not included in the total number of ticks.

Bien qu’un DateTimeOffset valeur inclut un décalage, il n’est pas une structure de données entièrement fuseau horaire prenant en charge.Although a DateTimeOffset value includes an offset, it is not a fully time zone-aware data structure. Pendant un décalage UTC est une caractéristique d’un fuseau horaire, elle n’identifie pas clairement un fuseau horaire.While an offset from UTC is one characteristic of a time zone, it does not unambiguously identify a time zone. Non seulement plusieurs fuseaux horaires partagent le même décalage UTC, mais le décalage d’un fuseau horaire unique change si elle respecte l’heure d’été.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. Cela signifie que, dès qu’un DateTimeOffset valeur est dissociée de son fuseau horaire, il ne peut plus être clairement reliée à son fuseau horaire d’origine.This means that, as soon as a DateTimeOffset value is disassociated from its time zone, it can no longer be unambiguously linked back to its original time zone.

É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 de membre.Because DateTimeOffset is a structure, a DateTimeOffset object that has been declared but not otherwise initialized contains the default values for each of its member fields. Cela signifie que son DateTime propriété est définie sur DateTimeOffset.MinValue et son Offset propriété est définie sur TimeSpan.Zero.This means that its DateTime property is set to DateTimeOffset.MinValue and its Offset property is set to TimeSpan.Zero.

Vous pouvez créer un nouveau DateTimeOffset valeur en appelant une des surcharges de son constructeur, qui sont semblables aux constructeurs surchargés pour la DateTime structure.You can create a new DateTimeOffset value by calling any of the overloads of its constructor, which are similar to the overloaded constructors for the DateTime structure. Vous pouvez également créer un nouveau DateTimeOffset valeur en lui assignant un DateTime valeur.You can also create a new DateTimeOffset value by assigning it a DateTime value. 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).This is an implicit conversion; it does not require a casting operator (in C#) or call to a conversion method (in Visual Basic). Vous pouvez également initialiser un DateTimeOffset valeur à partir de la représentation sous forme de chaîne de date et heure en appelant un numéro de l’analyse de méthodes, qui incluent des chaînes statiques Parse, ParseExact, TryParse, et TryParseExact.You can also initialize a DateTimeOffset value from the string representation of a date and time by calling a number of static string parsing methods, which include Parse, ParseExact, TryParse, and TryParseExact.

Les membres de la DateTimeOffset structure fournissent des fonctionnalités dans les domaines suivants :The members of the DateTimeOffset structure provide functionality in the following areas:

  • Date et heure arithmétique.Date and time arithmetic.

    Vous pouvez ajouter ou soustraire des dates ou des intervalles de temps à partir d’un particulier DateTimeOffset valeur.You can add or subtract either dates or time intervals from a particular DateTimeOffset value. 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.Arithmetic operations with DateTimeOffset values, unlike those with DateTime values, adjust for differences in time offsets when returning a result. Par exemple, le code suivant utilise DateTime variables à soustraire l’heure locale actuelle à partir de l’heure UTC actuelle.For example, the following code uses DateTime variables to subtract the current local time from the current UTC time. Le code utilise ensuite DateTimeOffset variables pour effectuer la même opération.The code then uses DateTimeOffset variables to perform the same operation. 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.The subtraction with DateTime values returns the local time zone's difference from UTC, while the subtraction with DateTimeOffset values returns 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                        
       }
    }
    
    Module DateArithmetic
       Public Sub Main()
          Dim date1, date2 As Date
          Dim dateOffset1, dateOffset2 As DateTimeOffset
          Dim difference As TimeSpan
          
          ' Find difference between Date.Now and Date.UtcNow
          date1 = Date.Now
          date2 = Date.UtcNow
          difference = date1 - date2
          Console.WriteLine("{0} - {1} = {2}", date1, date2, difference)
          
          ' Find difference between Now and UtcNow using DateTimeOffset
          dateOffset1 = date.Now
          dateOffset2 = date.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                        
       End Sub
    End Module
    
  • Opérations de conversion de type.Type conversion operations.

    Vous pouvez convertir DateTimeOffset valeurs DateTime valeurs et vice versa.You can convert DateTimeOffset values to DateTime values and vice versa.

  • Opérations de manipulation et d’extraction des temps.Time manipulation and extraction operations.

    Vous pouvez extraire la date ou l’heure d’un DateTimeOffset valeur.You can extract either the date or the time of a DateTimeOffset value. Vous pouvez également récupérer la valeur d’un particulier DateTimeOffset composant, telles que son année ou son mois.You can also retrieve the value of a particular DateTimeOffset component, such as its year or its month.

Notes

Si vous travaillez avec une valeur de graduations 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.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 TimeSpan.TicksPerDay, TimeSpan.TicksPerHour, TimeSpan.TicksPerMinute, TimeSpan.TicksPerSecond, or TimeSpan.TicksPerMillisecond constant to perform the 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.For example, to add the number of seconds represented by a specified number of ticks to the Second component of a DateTimeOffset value, you can use the expression dateValue.Second + nTicks/Timespan.TicksPerSecond.

  • Conversion de date et d’heure.Date and time conversion.

    Vous pouvez convertir tout DateTimeOffset valeur vers une autre DateTimeOffset valeur qui représente le même point dans le temps dans un autre fuseau horaire.You can convert any DateTimeOffset value to another DateTimeOffset value that represents the same point in time in another time zone. Toutefois, les règles d’ajustement d’un fuseau horaire sont appliquées uniquement dans le cas de la ToLocalTime (méthode), qui convertit un DateTimeOffset valeur à la date et l’heure dans la zone du système local.However, a time zone's adjustment rules are applied only in the case of the ToLocalTime method, which converts a DateTimeOffset value to the date and time in the local system zone.

  • Comparaison de date et d’heure.Date and time comparison.

    Vous pouvez déterminer si une particulier DateTimeOffset valeur est antérieure, identique ou ultérieure à une autre DateTimeOffset valeur.You can determine whether any particular DateTimeOffset value is earlier than, the same as, or later than another DateTimeOffset value. Avant la comparaison est effectuée, toutes les valeurs sont converties au format UTC.Before the comparison is performed, all values are converted to UTC.

Constructeurs

DateTimeOffset(DateTime) DateTimeOffset(DateTime) DateTimeOffset(DateTime) DateTimeOffset(DateTime)

Initialise une nouvelle instance de la structure DateTimeOffset en utilisant la valeur DateTime spécifiée.Initializes a new instance of the DateTimeOffset structure using the specified DateTime value.

DateTimeOffset(DateTime, TimeSpan) DateTimeOffset(DateTime, TimeSpan) DateTimeOffset(DateTime, TimeSpan) DateTimeOffset(DateTime, TimeSpan)

Initialise une nouvelle instance de la structure DateTimeOffset en utilisant la valeur DateTime et le décalage spécifiés.Initializes a new instance of the DateTimeOffset structure using the specified DateTime value and offset.

DateTimeOffset(Int64, TimeSpan) DateTimeOffset(Int64, TimeSpan) DateTimeOffset(Int64, TimeSpan) DateTimeOffset(Int64, TimeSpan)

Initialise une nouvelle instance de la structure DateTimeOffset à l’aide de l’offset et du nombre de graduations spécifiés.Initializes a new instance of the DateTimeOffset structure using the specified number of ticks and offset.

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) DateTimeOffset(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.Initializes a new instance of the DateTimeOffset structure using the specified year, month, day, hour, minute, second, and offset.

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) DateTimeOffset(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.Initializes a new instance of the DateTimeOffset structure using the specified year, month, day, hour, minute, second, millisecond, and offset.

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) DateTimeOffset(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é.Initializes a new instance of the DateTimeOffset structure using the specified year, month, day, hour, minute, second, millisecond, and offset of a specified calendar.

Champs

MaxValue MaxValue MaxValue MaxValue

Représente la plus grande valeur possible de DateTimeOffset.Represents the greatest possible value of DateTimeOffset. Ce champ est en lecture seule.This field is read-only.

MinValue MinValue MinValue MinValue

Représente la plus proche possible DateTimeOffset valeur.Represents the earliest possible DateTimeOffset value. Ce champ est en lecture seule.This field is read-only.

UnixEpoch UnixEpoch UnixEpoch UnixEpoch

Propriétés

Date Date Date Date

Obtient un DateTime valeur qui représente le composant date d’actuel DateTimeOffset objet.Gets a DateTime value that represents the date component of the current DateTimeOffset object.

DateTime DateTime DateTime DateTime

Obtient une valeur DateTime représentant la date et l’heure de l’objet DateTimeOffset actuel.Gets a DateTime value that represents the date and time of the current DateTimeOffset object.

Day Day Day Day

Obtient le jour du mois représenté par l’actuel DateTimeOffset objet.Gets the day of the month represented by the current DateTimeOffset object.

DayOfWeek DayOfWeek DayOfWeek DayOfWeek

Obtient le jour de la semaine représenté par l’actuel DateTimeOffset objet.Gets the day of the week represented by the current DateTimeOffset object.

DayOfYear DayOfYear DayOfYear DayOfYear

Obtient le jour de l’année représenté par l’actuel DateTimeOffset objet.Gets the day of the year represented by the current DateTimeOffset object.

Hour Hour Hour Hour

Obtient le composant « heure » de l’heure représentée par l’actuel DateTimeOffset objet.Gets the hour component of the time represented by the current DateTimeOffset object.

LocalDateTime LocalDateTime LocalDateTime LocalDateTime

Obtient un DateTime valeur qui représente la date et heure locales du courant DateTimeOffset objet.Gets a DateTime value that represents the local date and time of the current DateTimeOffset object.

Millisecond Millisecond Millisecond Millisecond

Obtient le composant « milliseconde » de l’heure représentée par l’actuel DateTimeOffset objet.Gets the millisecond component of the time represented by the current DateTimeOffset object.

Minute Minute Minute Minute

Obtient le composant "minute" de l’heure représentée par l’actuel DateTimeOffset objet.Gets the minute component of the time represented by the current DateTimeOffset object.

Month Month Month Month

Obtient le composant « mois » de la date représentée par l’actuel DateTimeOffset objet.Gets the month component of the date represented by the current DateTimeOffset object.

Now Now Now Now

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.Gets a DateTimeOffset object that is set to the current date and time on the current computer, with the offset set to the local time's offset from Coordinated Universal Time (UTC).

Offset Offset Offset Offset

Obtient l’offset d’heure par rapport au temps universel coordonné (UTC).Gets the time's offset from Coordinated Universal Time (UTC).

Second Second Second Second

Obtient le deuxième composant de l’heure représentée par l’actuel DateTimeOffset objet.Gets the second component of the clock time represented by the current DateTimeOffset object.

Ticks Ticks Ticks Ticks

Obtient le nombre de graduations représentant la date et l’heure de l’actuel DateTimeOffset objet de l’horloge.Gets the number of ticks that represents the date and time of the current DateTimeOffset object in clock time.

TimeOfDay TimeOfDay TimeOfDay TimeOfDay

Obtient l’heure de la journée en cours DateTimeOffset objet.Gets the time of day for the current DateTimeOffset object.

UtcDateTime UtcDateTime UtcDateTime UtcDateTime

Obtient un DateTime valeur qui représente la date du temps universel coordonné (UTC) et l’heure de l’actuel DateTimeOffset objet.Gets a DateTime value that represents the Coordinated Universal Time (UTC) date and time of the current DateTimeOffset object.

UtcNow UtcNow UtcNow UtcNow

Obtient un DateTimeOffset objet dont la date et heure sont définies à la date du temps universel coordonné (UTC) et l’heure actuelle et dont l’offset est Zero.Gets a DateTimeOffset object whose date and time are set to the current Coordinated Universal Time (UTC) date and time and whose offset is Zero.

UtcTicks UtcTicks UtcTicks UtcTicks

Obtient le nombre de graduations représentant la date et l’heure de l’actuel DateTimeOffset objet dans le temps universel coordonné (UTC).Gets the number of ticks that represents the date and time of the current DateTimeOffset object in Coordinated Universal Time (UTC).

Year Year Year Year

Obtient le composant « année » de la date représentée par l’actuel DateTimeOffset objet.Gets the year component of the date represented by the current DateTimeOffset object.

Méthodes

Add(TimeSpan) Add(TimeSpan) Add(TimeSpan) Add(TimeSpan)

Retourne un nouvel objet DateTimeOffset qui ajoute un intervalle de temps spécifié à la valeur de cette instance.Returns a new DateTimeOffset object that adds a specified time interval to the value of this instance.

AddDays(Double) AddDays(Double) AddDays(Double) AddDays(Double)

Retourne un nouvel objet DateTimeOffset qui ajoute un nombre spécifié de jours entiers et partiels à la valeur de cette instance.Returns a new DateTimeOffset object that adds a specified number of whole and fractional days to the value of this instance.

AddHours(Double) AddHours(Double) AddHours(Double) AddHours(Double)

Retourne un nouvel objet DateTimeOffset qui ajoute un nombre spécifié d’heures entières et partielles à la valeur de cette instance.Returns a new DateTimeOffset object that adds a specified number of whole and fractional hours to the value of this instance.

AddMilliseconds(Double) AddMilliseconds(Double) AddMilliseconds(Double) AddMilliseconds(Double)

Retourne un nouvel objet DateTimeOffset qui ajoute un nombre de millisecondes spécifié à la valeur de cette instance.Returns a new DateTimeOffset object that adds a specified number of milliseconds to the value of this instance.

AddMinutes(Double) AddMinutes(Double) AddMinutes(Double) AddMinutes(Double)

Retourne un nouvel objet DateTimeOffset qui ajoute un nombre spécifié de minutes entières et partielles à la valeur de cette instance.Returns a new DateTimeOffset object that adds a specified number of whole and fractional minutes to the value of this instance.

AddMonths(Int32) AddMonths(Int32) AddMonths(Int32) AddMonths(Int32)

Retourne un nouvel objet DateTimeOffset qui ajoute un nombre spécifié de mois à la valeur de cette instance.Returns a new DateTimeOffset object that adds a specified number of months to the value of this instance.

AddSeconds(Double) AddSeconds(Double) AddSeconds(Double) AddSeconds(Double)

Retourne un nouvel objet DateTimeOffset qui ajoute un nombre spécifié de secondes entières et partielles à la valeur de cette instance.Returns a new DateTimeOffset object that adds a specified number of whole and fractional seconds to the value of this instance.

AddTicks(Int64) AddTicks(Int64) AddTicks(Int64) AddTicks(Int64)

Retourne un nouvel objet DateTimeOffset qui ajoute un nombre de graduations spécifié à la valeur de cette instance.Returns a new DateTimeOffset object that adds a specified number of ticks to the value of this instance.

AddYears(Int32) AddYears(Int32) AddYears(Int32) AddYears(Int32)

Retourne un nouvel objet DateTimeOffset qui ajoute un nombre spécifié d’années à la valeur de cette instance.Returns a new DateTimeOffset object that adds a specified number of years to the value of this instance.

Compare(DateTimeOffset, DateTimeOffset) Compare(DateTimeOffset, DateTimeOffset) Compare(DateTimeOffset, DateTimeOffset) Compare(DateTimeOffset, DateTimeOffset)

Compare deux DateTimeOffset objets et indique si le premier est antérieur à la seconde, égale à la seconde ou ultérieur au second.Compares two DateTimeOffset objects and indicates whether the first is earlier than the second, equal to the second, or later than the second.

CompareTo(DateTimeOffset) CompareTo(DateTimeOffset) CompareTo(DateTimeOffset) CompareTo(DateTimeOffset)

Compare actuel DateTimeOffset objet à une certaine DateTimeOffset de l’objet et indique si l’objet actuel est antérieure, identique ou ultérieure à la seconde DateTimeOffset objet.Compares the current DateTimeOffset object to a specified DateTimeOffset object and indicates whether the current object is earlier than, the same as, or later than the second DateTimeOffset object.

Equals(DateTimeOffset) Equals(DateTimeOffset) Equals(DateTimeOffset) Equals(DateTimeOffset)

Détermine si l’actuel DateTimeOffset objet représente le même instant précis qu’une certaine DateTimeOffset objet.Determines whether the current DateTimeOffset object represents the same point in time as a specified DateTimeOffset object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si un DateTimeOffset objet représente le même instant précis qu’un objet spécifié.Determines whether a DateTimeOffset object represents the same point in time as a specified object.

Equals(DateTimeOffset, DateTimeOffset) Equals(DateTimeOffset, DateTimeOffset) Equals(DateTimeOffset, DateTimeOffset) Equals(DateTimeOffset, DateTimeOffset)

Détermine si deux spécifiées DateTimeOffset objets représentent le même point dans le temps.Determines whether two specified DateTimeOffset objects represent the same point in time.

EqualsExact(DateTimeOffset) EqualsExact(DateTimeOffset) EqualsExact(DateTimeOffset) EqualsExact(DateTimeOffset)

Détermine si l’actuel DateTimeOffset objet représente la même heure et a le même offset qu’une certaine DateTimeOffset objet.Determines whether the current DateTimeOffset object represents the same time and has the same offset as a specified DateTimeOffset object.

FromFileTime(Int64) FromFileTime(Int64) FromFileTime(Int64) FromFileTime(Int64)

Convertit l'heure de fichier Windows spécifiée en heure locale équivalente.Converts the specified Windows file time to an equivalent local time.

FromUnixTimeMilliseconds(Int64) FromUnixTimeMilliseconds(Int64) FromUnixTimeMilliseconds(Int64) FromUnixTimeMilliseconds(Int64)

Convertit un temps Unix exprimé comme le nombre de millisecondes qui se sont écoulées depuis 1970-01-01T00:00:00Z en valeur DateTimeOffset.Converts a Unix time expressed as the number of milliseconds that have elapsed since 1970-01-01T00:00:00Z to a DateTimeOffset value.

FromUnixTimeSeconds(Int64) FromUnixTimeSeconds(Int64) FromUnixTimeSeconds(Int64) FromUnixTimeSeconds(Int64)

Convertit un temps Unix exprimé comme le nombre de secondes qui se sont écoulées depuis 1970-01-01T00:00:00Z en valeur DateTimeOffset.Converts a Unix time expressed as the number of seconds that have elapsed since 1970-01-01T00:00:00Z to a DateTimeOffset value.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Retourne le code de hachage pour l'objet DateTimeOffset actuel.Returns the hash code for the current DateTimeOffset object.

Parse(String) Parse(String) Parse(String) Parse(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.Converts the specified string representation of a date, time, and offset to its DateTimeOffset equivalent.

Parse(String, IFormatProvider) Parse(String, IFormatProvider) Parse(String, IFormatProvider) Parse(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.Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified culture-specific format information.

Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles) Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles) Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles) Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)
Parse(String, IFormatProvider, DateTimeStyles) Parse(String, IFormatProvider, DateTimeStyles) Parse(String, IFormatProvider, DateTimeStyles) Parse(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.Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified culture-specific format information and formatting style.

ParseExact(String, String[], IFormatProvider, DateTimeStyles) ParseExact(String, String[], IFormatProvider, DateTimeStyles) ParseExact(String, String[], IFormatProvider, DateTimeStyles) ParseExact(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.Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified formats, culture-specific format information, and style. Le format de la représentation sous forme de chaîne doit correspondre exactement à l'un des formats spécifiés.The format of the string representation must match one of the specified formats exactly.

ParseExact(String, String, IFormatProvider, DateTimeStyles) ParseExact(String, String, IFormatProvider, DateTimeStyles) ParseExact(String, String, IFormatProvider, DateTimeStyles) ParseExact(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.Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified format, culture-specific format information, and style. Le format de la représentation sous forme de chaîne doit correspondre exactement au format spécifié.The format of the string representation must match the specified format exactly.

ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles) ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles) ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles) ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)

Convertit une étendue de caractères qui représente une date et une heure en DateTimeOffset équivalent à l’aide des informations et du style de format propres à la culture spécifiés.Converts a character span that represents a date and time to its DateTimeOffset equivalent using the specified format, culture-specific format information, and style. Le format de la représentation de la date et de l’heure doit correspondre exactement au format spécifié.The format of the date and time representation must match the specified format exactly.

ParseExact(String, String, IFormatProvider) ParseExact(String, String, IFormatProvider) ParseExact(String, String, IFormatProvider) ParseExact(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.Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified format and culture-specific format information. Le format de la représentation sous forme de chaîne doit correspondre exactement au format spécifié.The format of the string representation must match the specified format exactly.

ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles) ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles) ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles) ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles)

Convertit une étendue de caractères qui contient la représentation sous forme de chaîne d’une date et d’une heure en DateTimeOffset à l’aide du style, des informations de format propres à la culture et des formats spécifiés.Converts a character span that contains the string representation of a date and time to its DateTimeOffset equivalent using the specified formats, culture-specific format information, and style. Le format de la représentation de la date et de l’heure doit correspondre exactement à l'un des formats spécifiés.The format of the date and time representation must match one of the specified formats exactly.

Subtract(DateTimeOffset) Subtract(DateTimeOffset) Subtract(DateTimeOffset) Subtract(DateTimeOffset)

Soustrait une valeur DateTimeOffset qui représente une date et une heure spécifiques de l’objet DateTimeOffset actuel.Subtracts a DateTimeOffset value that represents a specific date and time from the current DateTimeOffset object.

Subtract(TimeSpan) Subtract(TimeSpan) Subtract(TimeSpan) Subtract(TimeSpan)

Soustrait un intervalle de temps spécifié de l’objet DateTimeOffset actuel.Subtracts a specified time interval from the current DateTimeOffset object.

ToFileTime() ToFileTime() ToFileTime() ToFileTime()

Convertit la valeur de l'objet DateTimeOffset actuel en heure de fichier Windows.Converts the value of the current DateTimeOffset object to a Windows file time.

ToLocalTime() ToLocalTime() ToLocalTime() ToLocalTime()

Convertit en cours DateTimeOffset de l’objet à un DateTimeOffset objet qui représente l’heure locale.Converts the current DateTimeOffset object to a DateTimeOffset object that represents the local time.

ToOffset(TimeSpan) ToOffset(TimeSpan) ToOffset(TimeSpan) ToOffset(TimeSpan)

Convertit la valeur de cours DateTimeOffset objet à la date et l’heure spécifiée par une valeur de décalage.Converts the value of the current DateTimeOffset object to the date and time specified by an offset value.

ToString() ToString() ToString() ToString()

Convertit la valeur de l'objet DateTimeOffset actif en sa représentation équivalente sous forme de chaîne.Converts the value of the current DateTimeOffset object to its equivalent string representation.

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

Convertit la valeur de cours 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.Converts the value of the current DateTimeOffset object to its equivalent string representation using the specified culture-specific formatting information.

ToString(String) ToString(String) ToString(String) ToString(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é.Converts the value of the current DateTimeOffset object to its equivalent string representation using the specified format.

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(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.Converts the value of the current DateTimeOffset object to its equivalent string representation using the specified format and culture-specific format information.

ToUniversalTime() ToUniversalTime() ToUniversalTime() ToUniversalTime()

Convertit en cours DateTimeOffset de l’objet à un DateTimeOffset valeur qui représente le temps universel coordonné (UTC).Converts the current DateTimeOffset object to a DateTimeOffset value that represents the Coordinated Universal Time (UTC).

ToUnixTimeMilliseconds() ToUnixTimeMilliseconds() ToUnixTimeMilliseconds() ToUnixTimeMilliseconds()

Retourne le nombre de millisecondes qui se sont écoulées depuis 1970-01-01T00:00:00.000Z.Returns the number of milliseconds that have elapsed since 1970-01-01T00:00:00.000Z.

ToUnixTimeSeconds() ToUnixTimeSeconds() ToUnixTimeSeconds() ToUnixTimeSeconds()

Retourne le nombre de secondes qui se sont écoulées depuis 1970-01-01T00:00:00Z.Returns the number of seconds that have elapsed since 1970-01-01T00:00:00Z.

TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider) TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider) TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider) TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)
TryParse(String, IFormatProvider, DateTimeStyles, DateTimeOffset) TryParse(String, IFormatProvider, DateTimeStyles, DateTimeOffset) TryParse(String, IFormatProvider, DateTimeStyles, DateTimeOffset) TryParse(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.Tries to convert a specified string representation of a date and time to its DateTimeOffset equivalent, and returns a value that indicates whether the conversion succeeded.

TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTimeOffset) TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTimeOffset) TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTimeOffset) TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTimeOffset)
TryParse(String, DateTimeOffset) TryParse(String, DateTimeOffset) TryParse(String, DateTimeOffset) TryParse(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.Tries to converts a specified string representation of a date and time to its DateTimeOffset equivalent, and returns a value that indicates whether the conversion succeeded.

TryParse(ReadOnlySpan<Char>, DateTimeOffset) TryParse(ReadOnlySpan<Char>, DateTimeOffset) TryParse(ReadOnlySpan<Char>, DateTimeOffset) TryParse(ReadOnlySpan<Char>, DateTimeOffset)
TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTimeOffset) TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTimeOffset) TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTimeOffset) TryParseExact(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.Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified array of formats, culture-specific format information, and style. Le format de la représentation sous forme de chaîne doit correspondre exactement à l'un des formats spécifiés.The format of the string representation must match one of the specified formats exactly.

TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTimeOffset) TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTimeOffset) TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTimeOffset) TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTimeOffset)

Convertit la représentation d’une date et d’une heure dans une étendue de caractères en DateTimeOffset équivalent à l’aide des informations et du style de format propres à la culture spécifiés.Converts the representation of a date and time in a character span to its DateTimeOffset equivalent using the specified format, culture-specific format information, and style. Le format de la représentation de la date et de l’heure doit correspondre exactement au format spécifié.The format of the date and time representation must match the specified format exactly.

TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateTimeOffset) TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateTimeOffset) TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateTimeOffset) TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateTimeOffset)
TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTimeOffset) TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTimeOffset) TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTimeOffset) TryParseExact(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.Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified format, culture-specific format information, and style. Le format de la représentation sous forme de chaîne doit correspondre exactement au format spécifié.The format of the string representation must match the specified format exactly.

Opérateurs

Addition(DateTimeOffset, TimeSpan) Addition(DateTimeOffset, TimeSpan) Addition(DateTimeOffset, TimeSpan) Addition(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.Adds a specified time interval to a DateTimeOffset object that has a specified date and time, and yields a DateTimeOffset object that has new a date and time.

Equality(DateTimeOffset, DateTimeOffset) Equality(DateTimeOffset, DateTimeOffset) Equality(DateTimeOffset, DateTimeOffset) Equality(DateTimeOffset, DateTimeOffset)

Détermine si deux spécifiées DateTimeOffset objets représentent le même point dans le temps.Determines whether two specified DateTimeOffset objects represent the same point in time.

GreaterThan(DateTimeOffset, DateTimeOffset) GreaterThan(DateTimeOffset, DateTimeOffset) GreaterThan(DateTimeOffset, DateTimeOffset) GreaterThan(DateTimeOffset, DateTimeOffset)

Détermine si un spécifié DateTimeOffset objet est supérieur à (ou ultérieur) un deuxième DateTimeOffset objet.Determines whether one specified DateTimeOffset object is greater than (or later than) a second specified DateTimeOffset object.

GreaterThanOrEqual(DateTimeOffset, DateTimeOffset) GreaterThanOrEqual(DateTimeOffset, DateTimeOffset) GreaterThanOrEqual(DateTimeOffset, DateTimeOffset) GreaterThanOrEqual(DateTimeOffset, DateTimeOffset)

Détermine si un spécifié DateTimeOffset objet est supérieur ou égal au second spécifié DateTimeOffset objet.Determines whether one specified DateTimeOffset object is greater than or equal to a second specified DateTimeOffset object.

Implicit(DateTime to DateTimeOffset) Implicit(DateTime to DateTimeOffset) Implicit(DateTime to DateTimeOffset) Implicit(DateTime to DateTimeOffset)

Définit une conversion implicite d’un DateTime de l’objet à un DateTimeOffset objet.Defines an implicit conversion of a DateTime object to a DateTimeOffset object.

Inequality(DateTimeOffset, DateTimeOffset) Inequality(DateTimeOffset, DateTimeOffset) Inequality(DateTimeOffset, DateTimeOffset) Inequality(DateTimeOffset, DateTimeOffset)

Détermine si deux spécifiées DateTimeOffset objets font référence à des moments différents dans le temps.Determines whether two specified DateTimeOffset objects refer to different points in time.

LessThan(DateTimeOffset, DateTimeOffset) LessThan(DateTimeOffset, DateTimeOffset) LessThan(DateTimeOffset, DateTimeOffset) LessThan(DateTimeOffset, DateTimeOffset)

Détermine si un spécifié DateTimeOffset de l’objet est inférieur à une seconde spécifiée DateTimeOffset objet.Determines whether one specified DateTimeOffset object is less than a second specified DateTimeOffset object.

LessThanOrEqual(DateTimeOffset, DateTimeOffset) LessThanOrEqual(DateTimeOffset, DateTimeOffset) LessThanOrEqual(DateTimeOffset, DateTimeOffset) LessThanOrEqual(DateTimeOffset, DateTimeOffset)

Détermine si un spécifié DateTimeOffset de l’objet est inférieur à une seconde spécifiée DateTimeOffset objet.Determines whether one specified DateTimeOffset object is less than a second specified DateTimeOffset object.

Subtraction(DateTimeOffset, DateTimeOffset) Subtraction(DateTimeOffset, DateTimeOffset) Subtraction(DateTimeOffset, DateTimeOffset) Subtraction(DateTimeOffset, DateTimeOffset)

Soustrait un objet DateTimeOffset d’un autre objet et produit un intervalle de temps.Subtracts one DateTimeOffset object from another and yields a time interval.

Subtraction(DateTimeOffset, TimeSpan) Subtraction(DateTimeOffset, TimeSpan) Subtraction(DateTimeOffset, TimeSpan) Subtraction(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.Subtracts a specified time interval from a specified date and time, and yields a new date and time.

Implémentations d’interfaces explicites

IComparable.CompareTo(Object) IComparable.CompareTo(Object) IComparable.CompareTo(Object) IComparable.CompareTo(Object)

Compare la valeur de cours DateTimeOffset objet avec un autre objet du même type.Compares the value of the current DateTimeOffset object with another object of the same type.

IDeserializationCallback.OnDeserialization(Object) IDeserializationCallback.OnDeserialization(Object) IDeserializationCallback.OnDeserialization(Object) IDeserializationCallback.OnDeserialization(Object)

S'exécute quand la désérialisation d'un objet a été effectuée.Runs when the deserialization of an object has been completed.

ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Remplit un SerializationInfo objet avec les données nécessaires pour sérialiser actuel DateTimeOffset objet.Populates a SerializationInfo object with the data required to serialize the current DateTimeOffset object.

S’applique à

Voir aussi