Condividi tramite


DateTimeOffset Struct

Definizione

Rappresenta un punto nel tempo, in genere espresso come data e ora del giorno, rispetto all'ora UTC (Coordinated Universal Time).

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)
Ereditarietà
DateTimeOffset
Attributi
Implementazioni

Commenti

La DateTimeOffset struttura include un DateTime valore, insieme a una Offset proprietà che definisce la differenza tra la data e l'ora dell'istanza corrente DateTimeOffset e l'ora UTC (Coordinated Universal Time). Poiché definisce esattamente una data e un'ora rispetto all'ora UTC, la DateTimeOffset struttura non include un Kind membro, come fa la DateTime struttura. Rappresenta date e ore con valori i cui intervalli UTC vanno dalle 12:00:00 mezzanotte, 1 gennaio 0001 Anno Domini (Common Era), alle 11:59:59:59, 31 dicembre 9999 A.D. (C.E.).

Importante

Le ere nei calendari giapponesi si basano sul regno dell'imperatore e quindi si prevede di cambiare. Ad esempio, il 1° maggio 2019 ha contrassegnato l'inizio dell'era Reiwa in JapaneseCalendar e JapaneseLunisolarCalendar. Tale cambiamento di era influisce su tutte le applicazioni che usano questi calendari. Per altre informazioni e per determinare se le applicazioni sono interessate, vedere Gestione di una nuova era nel calendario giapponese in .NET. Per informazioni sui test delle applicazioni nei sistemi Windows per garantire la conformità per il cambiamento dell'era, vedere Preparare l'applicazione per il cambiamento dell'era giapponese. Per le funzionalità di .NET che supportano calendari con più ere e per le procedure consigliate quando si usano calendari che supportano più ere, vedere Uso delle era.

Il componente temporale di un DateTimeOffset valore viene misurato in unità di 100 nanosecondi denominate tick e una data specifica è il numero di tick dalle 12:00 mezzanotte, 1 gennaio 0001 A.D. (C.E.) nel GregorianCalendar calendario. Un DateTimeOffset valore viene sempre espresso nel contesto di un calendario esplicito o predefinito. I tick attribuibili ai secondi intercalari non sono inclusi nel numero totale di tick.

Anche se un DateTimeOffset valore include un offset, non è una struttura di dati completamente compatibile con il fuso orario. Sebbene un offset dall'ora UTC sia una caratteristica di un fuso orario, non identifica in modo univoco un fuso orario. Non solo più fusi orari condividono lo stesso offset rispetto all'ora UTC, ma l'offset di un singolo fuso orario cambia se osserva l'ora legale. Ciò significa che, non appena un DateTimeOffset valore viene disassociato dal relativo fuso orario, non può più essere collegato in modo ambiguo al proprio fuso orario originale.

Poiché DateTimeOffset è una struttura, un DateTimeOffset oggetto dichiarato ma non inizializzato in altro modo contiene i valori predefiniti per ognuno dei relativi campi membro. Ciò significa che la proprietà DateTime è impostata su DateTimeOffset.MinValue e la relativa Offset proprietà è impostata su TimeSpan.Zero.

È possibile creare un nuovo DateTimeOffset valore chiamando uno degli overload del relativo costruttore, che sono simili ai costruttori di overload per la DateTime struttura. È anche possibile creare un nuovo DateTimeOffset valore assegnandolo a un DateTime valore. Si tratta di una conversione implicita; non richiede un operatore di cast (in C#) o una chiamata a un metodo di conversione (in Visual Basic). È anche possibile inizializzare un DateTimeOffset valore dalla rappresentazione di stringa di una data e dell'ora chiamando un numero di metodi di analisi di stringhe statici, che includono Parse, ParseExact, TryParsee TryParseExact.

I membri della DateTimeOffset struttura forniscono funzionalità nelle aree seguenti:

  • Aritmetica di data e ora.

    È possibile aggiungere o sottrarre date o intervalli di tempo da un determinato DateTimeOffset valore. Operazioni aritmetiche con DateTimeOffset valori, a differenza di quelle con DateTime valori, modificare le differenze negli offset temporali quando restituisce un risultato. Ad esempio, il codice seguente usa variabili DateTime per sottrarre l'ora locale corrente dall'ora UTC corrente. Il codice usa quindi le DateTimeOffset variabili per eseguire la stessa operazione. La sottrazione con DateTime valori restituisce la differenza del fuso orario locale rispetto all'ora UTC, mentre la sottrazione con DateTimeOffset valori restituisce 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
    
  • Operazioni di conversione dei tipi.

    È possibile convertire DateTimeOffset i valori in DateTime valori e viceversa.

  • Operazioni di manipolazione e estrazione del tempo.

    È possibile estrarre la data o l'ora di un DateTimeOffset valore. È anche possibile recuperare il valore di un particolare DateTimeOffset componente, ad esempio l'anno o il relativo mese.

    Annotazioni

    Se si utilizza un valore di tick da convertire in un altro intervallo di tempo, ad esempio minuti o secondi, è necessario usare la TimeSpan.TicksPerDaycostante , TimeSpan.TicksPerHour, TimeSpan.TicksPerMinute, TimeSpan.TicksPerSecond, o TimeSpan.TicksPerMillisecond per eseguire la conversione. Ad esempio, per aggiungere il numero di secondi rappresentato da un numero specificato di tick al Second componente di un DateTimeOffset valore, è possibile usare l'espressione dateValue.Second + nTicks/Timespan.TicksPerSecond.

  • Conversione di data e ora.

    È possibile convertire qualsiasi DateTimeOffset valore in un altro DateTimeOffset valore che rappresenta lo stesso punto nel tempo in un altro fuso orario. Tuttavia, le regole di regolazione di un fuso orario vengono applicate solo nel caso del ToLocalTime metodo , che converte un DateTimeOffset valore nella data e nell'ora nel fuso orario del sistema locale.

  • Confronto tra data e ora.

    È possibile determinare se un valore specifico DateTimeOffset è precedente, uguale o successivo a un altro DateTimeOffset valore. Prima di eseguire il confronto, tutti i valori vengono convertiti in formato UTC.

Costruttori

Nome Descrizione
DateTimeOffset(DateOnly, TimeOnly, TimeSpan)

Inizializza una nuova istanza della DateTimeOffset struttura utilizzando l'oggetto , timee offsetspecificatidate.

DateTimeOffset(DateTime, TimeSpan)

Inizializza una nuova istanza della DateTimeOffset struttura utilizzando il valore specificato DateTime e offset.

DateTimeOffset(DateTime)

Inizializza una nuova istanza della DateTimeOffset struttura utilizzando il valore specificato DateTime .

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)

Inizializza una nuova istanza della DateTimeOffset struttura utilizzando l'oggetto yearspecificato , month, day, hourmillisecondcalendarminuteseconde .offset

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)

Inizializza una nuova istanza della DateTimeOffset struttura utilizzando l'oggetto year, , monthday, hour, millisecondsecondmicrosecondminutecalendare .offset

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)

Inizializza una nuova istanza della DateTimeOffset struttura utilizzando l'oggetto yearspecificato , month, day, hourmillisecondmicrosecondminuteseconde .offset

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)

Inizializza una nuova istanza della DateTimeOffset struttura utilizzando l'oggetto yearspecificato , month, day, hourmillisecondminuteseconde .offset

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)

Inizializza una nuova istanza della DateTimeOffset struttura utilizzando l'oggetto , , monthday, hourminute, second, e offsetspecificatoyear.

DateTimeOffset(Int64, TimeSpan)

Inizializza una nuova istanza della DateTimeOffset struttura utilizzando il numero specificato di ticks e offset.

Campi

Nome Descrizione
MaxValue

Rappresenta il valore massimo possibile di DateTimeOffset. Il campo è di sola lettura.

MinValue

Rappresenta il primo valore possibile DateTimeOffset . Il campo è di sola lettura.

UnixEpoch

Il valore di questa costante equivale a 00:00:00.00.000000 UTC, 1 gennaio 1970, nel calendario gregoriano. UnixEpoch definisce il punto nel tempo in cui l'ora Unix è uguale a 0.

Proprietà

Nome Descrizione
Date

Ottiene un DateTime valore che rappresenta il componente data dell'oggetto corrente DateTimeOffset .

DateTime

Ottiene un DateTime valore che rappresenta la data e l'ora dell'oggetto corrente DateTimeOffset .

Day

Ottiene il giorno del mese rappresentato dall'oggetto corrente DateTimeOffset .

DayOfWeek

Ottiene il giorno della settimana rappresentato dall'oggetto corrente DateTimeOffset .

DayOfYear

Ottiene il giorno dell'anno rappresentato dall'oggetto corrente DateTimeOffset .

Hour

Ottiene il componente dell'ora dell'ora rappresentata dall'oggetto corrente DateTimeOffset .

LocalDateTime

Ottiene un DateTime valore che rappresenta la data e l'ora locali dell'oggetto corrente DateTimeOffset .

Microsecond

Ottiene il componente microsecondo dell'ora rappresentata dall'oggetto corrente DateTimeOffset .

Millisecond

Ottiene il componente millisecondo dell'ora rappresentata dall'oggetto corrente DateTimeOffset .

Minute

Ottiene il componente minuto dell'ora rappresentata dall'oggetto corrente DateTimeOffset .

Month

Ottiene il componente month della data rappresentata dall'oggetto corrente DateTimeOffset .

Nanosecond

Ottiene il componente nanosecondo dell'ora rappresentata dall'oggetto corrente DateTimeOffset .

Now

Ottiene un DateTimeOffset oggetto impostato sulla data e l'ora correnti nel computer corrente, con l'offset impostato sull'offset dell'ora locale rispetto all'ora UTC (Coordinated Universal Time).

Offset

Ottiene l'offset dell'ora rispetto all'ora UTC (Coordinated Universal Time).

Second

Ottiene il secondo componente dell'ora di clock rappresentata dall'oggetto corrente DateTimeOffset .

Ticks

Ottiene il numero di tick che rappresenta la data e l'ora dell'oggetto corrente DateTimeOffset nell'ora di clock.

TimeOfDay

Ottiene l'ora del giorno per l'oggetto corrente DateTimeOffset .

TotalOffsetMinutes

Ottiene l'offset dell'ora rispetto all'ora UTC (Coordinated Universal Time) in minuti.

UtcDateTime

Ottiene un DateTime valore che rappresenta la data e l'ora UTC (Coordinated Universal Time) dell'oggetto corrente DateTimeOffset .

UtcNow

Ottiene un DateTimeOffset oggetto la cui data e ora sono impostate sulla data e l'ora UTC (Coordinated Universal Time) corrente e il cui offset è Zero.

UtcTicks

Ottiene il numero di tick che rappresenta la data e l'ora dell'oggetto corrente DateTimeOffset nell'ora UTC (Coordinated Universal Time).

Year

Ottiene il componente year della data rappresentata dall'oggetto corrente DateTimeOffset .

Metodi

Nome Descrizione
Add(TimeSpan)

Restituisce un nuovo DateTimeOffset oggetto che aggiunge un intervallo di tempo specificato al valore di questa istanza.

AddDays(Double)

Restituisce un nuovo DateTimeOffset oggetto che aggiunge un numero specificato di giorni interi e frazionari al valore di questa istanza.

AddHours(Double)

Restituisce un nuovo DateTimeOffset oggetto che aggiunge un numero specificato di ore intere e frazionarie al valore di questa istanza.

AddMicroseconds(Double)

Restituisce un nuovo DateTimeOffset oggetto che aggiunge un numero specificato di microsecondi al valore di questa istanza.

AddMilliseconds(Double)

Restituisce un nuovo DateTimeOffset oggetto che aggiunge un numero specificato di millisecondi al valore di questa istanza.

AddMinutes(Double)

Restituisce un nuovo DateTimeOffset oggetto che aggiunge un numero specificato di minuti interi e frazionari al valore di questa istanza.

AddMonths(Int32)

Restituisce un nuovo DateTimeOffset oggetto che aggiunge un numero specificato di mesi al valore di questa istanza.

AddSeconds(Double)

Restituisce un nuovo DateTimeOffset oggetto che aggiunge un numero specificato di secondi interi e frazionari al valore di questa istanza.

AddTicks(Int64)

Restituisce un nuovo DateTimeOffset oggetto che aggiunge un numero specificato di tick al valore di questa istanza.

AddYears(Int32)

Restituisce un nuovo DateTimeOffset oggetto che aggiunge un numero specificato di anni al valore di questa istanza.

Compare(DateTimeOffset, DateTimeOffset)

Confronta due DateTimeOffset oggetti e indica se il primo è precedente al secondo, uguale al secondo o successivo al secondo.

CompareTo(DateTimeOffset)

Confronta l'oggetto corrente DateTimeOffset con un oggetto specificato DateTimeOffset e indica se l'oggetto corrente è precedente, uguale o successivo al secondo DateTimeOffset oggetto.

Deconstruct(DateOnly, TimeOnly, TimeSpan)

Decostruisce questa DateTimeOffset istanza in base a DateOnly, TimeOnlye TimeSpan.

Equals(DateTimeOffset, DateTimeOffset)

Determina se due oggetti specificati DateTimeOffset rappresentano lo stesso punto nel tempo.

Equals(DateTimeOffset)

Determina se l'oggetto corrente DateTimeOffset rappresenta lo stesso punto nel tempo di un oggetto specificato DateTimeOffset .

Equals(Object)

Determina se un DateTimeOffset oggetto rappresenta lo stesso punto nel tempo di un oggetto specificato.

EqualsExact(DateTimeOffset)

Determina se l'oggetto corrente DateTimeOffset rappresenta la stessa ora e ha lo stesso offset di un oggetto specificato DateTimeOffset .

FromFileTime(Int64)

Converte l'ora del file di Windows specificata in un'ora locale equivalente.

FromUnixTimeMilliseconds(Int64)

Converte un tempo Unix espresso come numero di millisecondi trascorsi dal 1970-01-01T00:00:00:00Z in un DateTimeOffset valore.

FromUnixTimeSeconds(Int64)

Converte un tempo Unix espresso come numero di secondi trascorsi dal 1970-01-01T00:00:00:00Z in un DateTimeOffset valore.

GetHashCode()

Restituisce il codice hash per l'oggetto corrente DateTimeOffset .

Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)

Converte la rappresentazione di intervallo specificata di una data e un'ora nell'equivalente DateTimeOffset utilizzando le informazioni sul formato e lo stile di formattazione specifici delle impostazioni cultura specificati.

Parse(ReadOnlySpan<Char>, IFormatProvider)

Analizza un intervallo di caratteri in un valore.

Parse(String, IFormatProvider, DateTimeStyles)

Converte la rappresentazione di stringa specificata di una data e un'ora nell'equivalente DateTimeOffset utilizzando le informazioni sul formato e lo stile di formattazione specifici delle impostazioni cultura specificati.

Parse(String, IFormatProvider)

Converte la rappresentazione di stringa specificata di una data e ora nell'equivalente DateTimeOffset utilizzando le informazioni sul formato specifiche delle impostazioni cultura specificate.

Parse(String)

Converte la rappresentazione di stringa specificata di una data, un'ora e un offset nell'equivalente DateTimeOffset .

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

Converte un intervallo di caratteri che rappresenta una data e un'ora nell'equivalente DateTimeOffset utilizzando il formato, le informazioni sul formato specifiche delle impostazioni cultura e lo stile specificati. Il formato della rappresentazione di data e ora deve corrispondere esattamente al formato specificato.

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

Converte un intervallo di caratteri che contiene la rappresentazione di stringa di una data e dell'ora nell'equivalente DateTimeOffset utilizzando i formati, le informazioni sul formato specifiche delle impostazioni cultura e lo stile specificati. Il formato della rappresentazione di data e ora deve corrispondere esattamente a uno dei formati specificati.

ParseExact(String, String, IFormatProvider, DateTimeStyles)

Converte la rappresentazione di stringa specificata di una data e un'ora nell'equivalente DateTimeOffset utilizzando il formato, le informazioni sul formato specifiche delle impostazioni cultura e lo stile specificati. Il formato della rappresentazione di stringa deve corrispondere esattamente al formato specificato.

ParseExact(String, String, IFormatProvider)

Converte la rappresentazione di stringa specificata di una data e un'ora nell'equivalente DateTimeOffset utilizzando il formato specificato e le informazioni sul formato specifiche delle impostazioni cultura. Il formato della rappresentazione di stringa deve corrispondere esattamente al formato specificato.

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

Converte la rappresentazione di stringa specificata di una data e un'ora nell'equivalente DateTimeOffset utilizzando i formati, le informazioni sul formato specifiche delle impostazioni cultura e lo stile specificati. Il formato della rappresentazione di stringa deve corrispondere esattamente a uno dei formati specificati.

Subtract(DateTimeOffset)

Sottrae un DateTimeOffset valore che rappresenta una data e un'ora specifiche dall'oggetto corrente DateTimeOffset .

Subtract(TimeSpan)

Sottrae un intervallo di tempo specificato dall'oggetto corrente DateTimeOffset .

ToFileTime()

Converte il valore dell'oggetto corrente DateTimeOffset in un'ora di file di Windows.

ToLocalTime()

Converte l'oggetto corrente DateTimeOffset in un DateTimeOffset oggetto che rappresenta l'ora locale.

ToOffset(TimeSpan)

Converte il valore dell'oggetto corrente DateTimeOffset nella data e nell'ora specificate da un valore di offset.

ToString()

Converte il valore dell'oggetto corrente DateTimeOffset nella rappresentazione di stringa equivalente.

ToString(IFormatProvider)

Converte il valore dell'oggetto corrente DateTimeOffset nella rappresentazione di stringa equivalente utilizzando le informazioni di formattazione specifiche delle impostazioni cultura specificate.

ToString(String, IFormatProvider)

Converte il valore dell'oggetto corrente DateTimeOffset nella rappresentazione di stringa equivalente utilizzando il formato specificato e le informazioni sul formato specifiche delle impostazioni cultura.

ToString(String)

Converte il valore dell'oggetto corrente DateTimeOffset nella rappresentazione di stringa equivalente utilizzando il formato specificato.

ToUniversalTime()

Converte l'oggetto corrente DateTimeOffset in un DateTimeOffset valore che rappresenta l'ora UTC (Coordinated Universal Time).

ToUnixTimeMilliseconds()

Restituisce il numero di millisecondi trascorsi dal 1970-01-01T00:00:00.000Z.

ToUnixTimeSeconds()

Restituisce il numero di secondi trascorsi dal 1970-01-01T00:00:00Z.

TryFormat(Span<Byte>, Int32, ReadOnlySpan<Char>, IFormatProvider)

Prova a formattare il valore dell'istanza corrente come UTF-8 nell'intervallo di byte specificato.

TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)

Tenta di formattare il valore dell'istanza di offset datetime corrente nell'intervallo di caratteri specificato.

TryParse(ReadOnlySpan<Char>, DateTimeOffset)

Tenta di convertire una rappresentazione di intervallo specificata di una data e di un'ora nell'equivalente DateTimeOffset e restituisce un valore che indica se la conversione ha avuto esito positivo.

TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeOffset)

Tenta di analizzare un intervallo di caratteri in un valore.

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

Tenta di convertire una rappresentazione di intervallo specificata di una data e di un'ora nell'equivalente DateTimeOffset e restituisce un valore che indica se la conversione ha avuto esito positivo.

TryParse(String, DateTimeOffset)

Tenta di convertire una rappresentazione di stringa specificata di una data e di un'ora nell'equivalente DateTimeOffset e restituisce un valore che indica se la conversione ha avuto esito positivo.

TryParse(String, IFormatProvider, DateTimeOffset)

Tenta di analizzare una stringa in un valore.

TryParse(String, IFormatProvider, DateTimeStyles, DateTimeOffset)

Tenta di convertire una rappresentazione di stringa specificata di una data e di un'ora nell'equivalente DateTimeOffset e restituisce un valore che indica se la conversione ha avuto esito positivo.

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

Converte la rappresentazione di una data e di un'ora in un intervallo DateTimeOffset di caratteri nell'equivalente utilizzando il formato specificato, le informazioni sul formato specifico delle impostazioni cultura e lo stile specificati. Il formato della rappresentazione di data e ora deve corrispondere esattamente al formato specificato.

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

Converte la rappresentazione di una data e di un'ora in un intervallo DateTimeOffset di caratteri nell'equivalente utilizzando i formati specificati, le informazioni sul formato specifiche delle impostazioni cultura e lo stile. Il formato della rappresentazione di data e ora deve corrispondere esattamente a uno dei formati specificati.

TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTimeOffset)

Converte la rappresentazione di stringa specificata di una data e un'ora nell'equivalente DateTimeOffset utilizzando il formato, le informazioni sul formato specifiche delle impostazioni cultura e lo stile specificati. Il formato della rappresentazione di stringa deve corrispondere esattamente al formato specificato.

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

Converte la rappresentazione di stringa specificata di una data e un'ora nell'equivalente DateTimeOffset utilizzando la matrice di formati, le informazioni sul formato specifiche delle impostazioni cultura e lo stile specificati. Il formato della rappresentazione di stringa deve corrispondere esattamente a uno dei formati specificati.

Operatori

Nome Descrizione
Addition(DateTimeOffset, TimeSpan)

Aggiunge un intervallo di tempo specificato a un DateTimeOffset oggetto con una data e un'ora specificati e restituisce un DateTimeOffset oggetto con una nuova data e ora.

Equality(DateTimeOffset, DateTimeOffset)

Determina se due oggetti specificati DateTimeOffset rappresentano lo stesso punto nel tempo.

GreaterThan(DateTimeOffset, DateTimeOffset)

Determina se un oggetto specificato DateTimeOffset è maggiore o successivo a un secondo oggetto specificato DateTimeOffset .

GreaterThanOrEqual(DateTimeOffset, DateTimeOffset)

Determina se un oggetto specificato DateTimeOffset è maggiore o uguale a un secondo oggetto specificato DateTimeOffset .

Implicit(DateTime to DateTimeOffset)

Definisce una conversione implicita di un DateTime oggetto in un DateTimeOffset oggetto .

Inequality(DateTimeOffset, DateTimeOffset)

Determina se due oggetti specificati DateTimeOffset fanno riferimento a punti diversi nel tempo.

LessThan(DateTimeOffset, DateTimeOffset)

Determina se un oggetto specificato DateTimeOffset è minore di un secondo oggetto specificato DateTimeOffset .

LessThanOrEqual(DateTimeOffset, DateTimeOffset)

Determina se un oggetto specificato DateTimeOffset è minore di un secondo oggetto specificato DateTimeOffset .

Subtraction(DateTimeOffset, DateTimeOffset)

Sottrae un DateTimeOffset oggetto da un altro e restituisce un intervallo di tempo.

Subtraction(DateTimeOffset, TimeSpan)

Sottrae un intervallo di tempo specificato da una data e un'ora specificati e restituisce una nuova data e ora.

Implementazioni dell'interfaccia esplicita

Nome Descrizione
IComparable.CompareTo(Object)

Confronta il valore dell'oggetto corrente DateTimeOffset con un altro oggetto dello stesso tipo.

IDeserializationCallback.OnDeserialization(Object)

Viene eseguito quando la deserializzazione di un oggetto è stata completata.

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Popola un SerializationInfo oggetto con i dati necessari per serializzare l'oggetto corrente DateTimeOffset .

Si applica a

Vedi anche