DateTimeOffset Structure

Définition

public value class DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IFormattable

public value class DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IParsable<DateTimeOffset>, ISpanFormattable, ISpanParsable<DateTimeOffset>, IUtf8SpanFormattable, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable

public value class DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IFormattable, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable

public value class DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, ISpanFormattable, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable

public value class DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IParsable<DateTimeOffset>, ISpanFormattable, ISpanParsable<DateTimeOffset>, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable

public struct DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IFormattable

public readonly struct DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IParsable<DateTimeOffset>, ISpanFormattable, ISpanParsable<DateTimeOffset>, IUtf8SpanFormattable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable

public readonly struct DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IFormattable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable

public readonly struct DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, ISpanFormattable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable

public readonly struct DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IParsable<DateTimeOffset>, ISpanFormattable, ISpanParsable<DateTimeOffset>, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable

public struct 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

type DateTimeOffset = struct
    interface IFormattable
    interface IParsable<DateTimeOffset>
    interface ISpanFormattable
    interface ISpanParsable<DateTimeOffset>
    interface IUtf8SpanFormattable
    interface IDeserializationCallback
    interface ISerializable

type DateTimeOffset = struct
    interface IFormattable
    interface IDeserializationCallback
    interface ISerializable

type DateTimeOffset = struct
    interface ISpanFormattable
    interface IFormattable
    interface IDeserializationCallback
    interface ISerializable

type DateTimeOffset = struct
    interface IFormattable
    interface IParsable<DateTimeOffset>
    interface ISpanFormattable
    interface ISpanParsable<DateTimeOffset>
    interface IDeserializationCallback
    interface ISerializable

type DateTimeOffset = struct
    interface IFormattable
    interface IParsable<DateTimeOffset>
    interface ISpanFormattable
    interface ISpanParsable<DateTimeOffset>
    interface IDeserializationCallback
    interface ISerializable
    interface IUtf8SpanFormattable

[<System.Serializable>]
type DateTimeOffset = struct
    interface IFormattable
    interface ISerializable
    interface IDeserializationCallback

Public Structure DateTimeOffset
Implements IComparable, IComparable(Of DateTimeOffset), IEquatable(Of DateTimeOffset), IFormattable

Public Structure DateTimeOffset
Implements IComparable, IComparable(Of DateTimeOffset), IDeserializationCallback, IEquatable(Of DateTimeOffset), IParsable(Of DateTimeOffset), ISerializable, ISpanFormattable, ISpanParsable(Of DateTimeOffset), IUtf8SpanFormattable

Public Structure DateTimeOffset
Implements IComparable, IComparable(Of DateTimeOffset), IDeserializationCallback, IEquatable(Of DateTimeOffset), IFormattable, ISerializable

Public Structure DateTimeOffset
Implements IComparable, IComparable(Of DateTimeOffset), IDeserializationCallback, IEquatable(Of DateTimeOffset), ISerializable, ISpanFormattable

Public Structure DateTimeOffset
Implements IComparable, IComparable(Of DateTimeOffset), IDeserializationCallback, IEquatable(Of DateTimeOffset), IParsable(Of DateTimeOffset), ISerializable, ISpanFormattable, ISpanParsable(Of DateTimeOffset)

Héritage

Object

ValueType

DateTimeOffset

Attributs

SerializableAttribute

Implémente

IComparable IComparable<DateTimeOffset> IEquatable<DateTimeOffset> IFormattable IParsable<DateTimeOffset> IParsable<TSelf> ISpanFormattable ISpanParsable<DateTimeOffset> IUtf8SpanFormattable IDeserializationCallback ISerializable

Remarques

La DateTimeOffset structure inclut une DateTime valeur, ainsi qu’une Offset propriété qui définit la différence entre la date et l’heure de l’instance actuelle DateTimeOffset et l’heure universelle coordonnée (UTC). Étant donné qu’elle définit exactement une date et une heure par rapport à UTC, la DateTimeOffset structure n’inclut pas de Kind membre, car la structure le DateTime fait. Il représente des dates et des heures avec des valeurs dont l’heure UTC est comprise entre 12:00:00 minuit, le 1er janvier 0001 Anno Domini (Ère commune), à 11:59:59:59 P.M., 31 décembre 9999 A.D. (C.E.).

Le composant d’heure d’une DateTimeOffset valeur est mesuré 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 A.D. (C.E.) dans le GregorianCalendar calendrier. Une DateTimeOffset valeur est toujours exprimée dans le contexte d’un calendrier explicite ou par défaut. Les cycles attribuables aux secondes de saut ne sont pas inclus dans le nombre total de graduations.

Bien qu’une DateTimeOffset valeur inclut un décalage, il ne s’agit pas d’une structure de données entièrement prenant en charge les fuseaux horaires. Bien qu’un décalage par rapport à l’heure UTC soit une caractéristique d’un fuseau horaire, il n’identifie pas sans ambiguïté un fuseau horaire. Non seulement plusieurs fuseaux horaires partagent le même décalage par rapport à l’heure UTC, mais le décalage d’un fuseau horaire unique change s’il observe l’heure d’été. Cela signifie que, dès qu’une DateTimeOffset valeur est dissociée de son fuseau horaire, elle ne peut plus être liée sans ambiguïté à son fuseau horaire d’origine.

Étant donné qu’il DateTimeOffset s’agit d’une structure, un DateTimeOffset objet qui a été déclaré mais qui n’a pas été initialisé contient les valeurs par défaut pour chacun de ses champs membres. Cela signifie que sa DateTime propriété est définie DateTimeOffset.MinValue sur et que sa Offset propriété est définie sur TimeSpan.Zero.

Vous pouvez créer une valeur DateTimeOffset en appelant l’une des surcharges de son constructeur, qui sont similaires aux constructeurs surchargés pour la DateTime structure. Vous pouvez également créer une DateTimeOffset valeur en lui affectant une DateTime valeur. Il s’agit d’une conversion implicite ; il ne nécessite pas d’opérateur de cast (en C#) ou d’appeler une méthode de conversion (en Visual Basic). Vous pouvez également initialiser une DateTimeOffset valeur à partir de la représentation sous forme de chaîne d’une date et d’une heure en appelant un certain nombre de méthodes d’analyse de chaîne statique, qui incluent Parse, ParseExact, TryParseet TryParseExact.

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

• Arithmétique de date et d’heure.

  Vous pouvez ajouter ou soustraire des dates ou des intervalles de temps à partir d’une valeur particulière DateTimeOffset . Opérations arithmétiques avec DateTimeOffset des valeurs, contrairement aux DateTime valeurs, ajustez les différences dans les décalages de temps lors du retour d’un résultat. Par exemple, le code suivant utilise DateTime des variables pour soustraire l’heure locale actuelle de l’heure UTC actuelle. Le code utilise DateTimeOffset ensuite des variables pour effectuer la même opération. La soustraction avec DateTime des valeurs retourne la différence du fuseau horaire local par rapport à l’heure UTC, tandis que la soustraction avec DateTimeOffset les valeurs retourne TimeSpan.Zero.

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

  open System
  
  // Find difference between Date.Now and Date.UtcNow
  let date1 = DateTime.Now
  let date2 = DateTime.UtcNow
  let difference1 = date1 - date2
  printfn $"{date1} - {date2} = {difference1}"
  
  // Find difference between Now and UtcNow using DateTimeOffset
  let dateOffset1 = DateTimeOffset.Now
  let dateOffset2 = DateTimeOffset.UtcNow
  let difference2 = dateOffset1 - dateOffset2
  printfn $"{dateOffset1} - {dateOffset2} = {difference2}"
                   
  // If run in the Pacific Standard time zone on 1/7/2022, the example
  // displays the following output to the console:
  //    1/7/2022 6:45:10 PM - 1/8/2022 2:45:10 AM = -08:00:00.0072573
  //    1/7/2022 6:45:10 PM -08:00 - 1/8/2022 2:45:10 AM +00:00 = -00:00:00.0000278
  

  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.

  Vous pouvez convertir des DateTimeOffset valeurs en DateTime valeurs et vice versa.

• Opérations de manipulation et d’extraction du temps.

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

  Note

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

• Conversion de date et d’heure.

  Vous pouvez convertir n’importe quelle DateTimeOffset valeur en une 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, ce qui convertit une DateTimeOffset valeur en date et heure dans la zone système locale.

• Comparaison de date et d’heure.

  Vous pouvez déterminer si une valeur particulière DateTimeOffset est antérieure à, identique ou ultérieure à une autre DateTimeOffset valeur. Avant l’exécution de la comparaison, toutes les valeurs sont converties en UTC.

Voir aussi

• Choix entre DateTime, DateTimeOffset, TimeSpan et TimeZoneInfo
• exemple : Utilitaire de mise en forme WinForms .NET Core (C#)
• exemple : Utilitaire de mise en forme WinForms .NET Core (Visual Basic)