DateTimeOffset Structure

Définition

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

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 value class DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IParsable<DateTimeOffset>, ISpanFormattable, ISpanParsable<DateTimeOffset>, IUtf8SpanFormattable, 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>, 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 readonly struct DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IParsable<DateTimeOffset>, ISpanFormattable, ISpanParsable<DateTimeOffset>, IUtf8SpanFormattable, 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 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

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

[<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), 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)

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

Héritage

Object

ValueType

DateTimeOffset

Attributs

SerializableAttribute

Implémente

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

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 le temps universel coordonné (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, comme la DateTime structure. Il représente les dates et les heures avec des valeurs dont la plage UTC est comprise entre 12 :00 :00 minuit, 1er janvier 0001 Anno Domini (Ère commune), et 11 :59 :59 p.M., le 31 décembre 9999 A.D. (C.E.).

Le composant de temps d’une DateTimeOffset valeur est mesuré en unités de 100 nanosecondes appelées ticks, 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 tiques attribuables à des secondes bissextiles ne sont pas incluses dans le nombre total de tiques.

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 à UTC soit l’une des caractéristiques d’un fuseau horaire, il n’identifie pas un fuseau horaire sans ambiguïté. Non seulement plusieurs fuseaux horaires partagent le même décalage par rapport à 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 une DateTimeOffset 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é a la DateTimeOffset.MinValue valeur et que sa Offset propriété a la TimeSpan.Zerovaleur .

Vous pouvez créer une valeur en appelant l’une DateTimeOffset 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 attribuant une DateTime valeur. Il s’agit d’une conversion implicite ; il ne nécessite pas d’opérateur de casting (en C#) ni d’appel à 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 statiques, notamment 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 . Les opérations arithmétiques avec DateTimeOffset des valeurs, contrairement à celles avec DateTime des valeurs, ajustent les différences dans les décalages de temps lors du retour d’un résultat. Par exemple, le code suivant utilise des DateTime variables pour soustraire l’heure locale actuelle de l’heure UTC actuelle. Le code utilise ensuite des DateTimeOffset variables pour effectuer la même opération. La soustraction avec DateTime des valeurs retourne la différence du fuseau horaire local par rapport à 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 valeurs en DateTimeOffsetDateTime 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 , comme son année ou son mois.

• 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, 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 d’effectuer la comparaison, toutes les valeurs sont converties en UTC.

Constructeurs

Champs

Propriétés

Méthodes

Opérateurs

Implémentations d’interfaces explicites

S’applique à

Voir aussi

• Choisir entre DateTime, DateTimeOffset, TimeSpan et TimeZoneInfo
• Exemple : utilitaire de mise en forme .NET Core WinForms (C#)
• Exemple : utilitaire de mise en forme .NET Core WinForms (Visual Basic)