Freigeben über


DateTimeOffset Struktur

Definition

Stellt einen Punkt in der Zeit dar, der in der Regel als Datum und Uhrzeit im Verhältnis zur koordinierten Weltzeit (UTC) ausgedrückt wird.

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)
Vererbung
DateTimeOffset
Attribute
Implementiert

Hinweise

Die DateTimeOffset Struktur enthält einen DateTime Wert zusammen mit einer Offset Eigenschaft, die den Unterschied zwischen Datum und Uhrzeit der aktuellen DateTimeOffset Instanz und koordinierter Weltzeit (UTC) definiert. Da es genau ein Datum und eine Uhrzeit relativ zu UTC definiert, enthält Kind die DateTimeOffset Struktur kein Element, wie die DateTime Struktur. Es stellt Datums- und Uhrzeitangaben mit Werten dar, deren UTC-Werte von 12:00:00 Uhr, 1. Januar 0001 Anno Domini (Common Era), bis 11:59:59 Uhr, 31. Dezember 9999 A.D. (C.E.) liegen.

Von Bedeutung

Ären in den japanischen Kalendern basieren auf der Herrschaft des Kaisers und werden daher voraussichtlich wechseln. Beispielsweise markierte der 1. Mai 2019 den Anfang der Reiwa-Ära in der JapaneseCalendar und JapaneseLunisolarCalendar. Eine solche Änderung des Zeitalters wirkt sich auf alle Anwendungen aus, die diese Kalender verwenden. Unter Handling a new era in the Japanese calendar in .NET (Umgang mit einem neuen Zeitabschnitt im japanischen Kalender in .NET) finden Sie weitere Informationen und wie Sie bestimmen können, ob Ihre Anwendungen ebenfalls betroffen sind. Informationen zum Testen Ihrer Anwendungen auf Windows-Systemen, um ihre Bereitschaft für die Änderung der Ära sicherzustellen, finden Sie unter "Vorbereiten Ihrer Anwendung für die Änderung im japanischen Zeitalter". Features in .NET, die Kalender mit mehreren Epochen unterstützen und bewährte Methoden beim Arbeiten mit Kalendern, die mehrere Epochen unterstützen, finden Sie unter Arbeiten mit Eras.

Die Zeitkomponente eines DateTimeOffset Werts wird in 100-Nanosekundeneinheiten gemessen, die als Teilstriche bezeichnet werden, und ein bestimmtes Datum ist die Anzahl der Teilstriche seit 12:00 Mitternacht, dem 1. Januar 0001 A.D. (C.E.) im GregorianCalendar Kalender. Ein DateTimeOffset Wert wird immer im Kontext eines expliziten oder Standardkalenders ausgedrückt. Teilstriche, die auf Schaltsekunden zurückzuführen sind, sind nicht in der Gesamtzahl der Teilstriche enthalten.

Obwohl ein DateTimeOffset Wert einen Offset enthält, handelt es sich nicht um eine vollständige Zeitzonen-fähige Datenstruktur. Während ein Offset von UTC ein Merkmal einer Zeitzone ist, wird eine Zeitzone nicht eindeutig identifiziert. Nicht nur mehrere Zeitzonen teilen den gleichen Offset von UTC, sondern der Offset einer einzelnen Zeitzone ändert sich, wenn die Sommerzeit beobachtet wird. Dies bedeutet, dass ein Wert, sobald ein DateTimeOffset Wert von seiner Zeitzone getrennt ist, nicht mehr eindeutig mit seiner ursprünglichen Zeitzone verknüpft werden kann.

Da DateTimeOffset es sich um eine Struktur handelt, enthält ein DateTimeOffset Objekt, das deklariert, aber nicht anderweitig initialisiert wurde, die Standardwerte für jedes Elementfeld. Dies bedeutet, dass seine DateTime Eigenschaft auf DateTimeOffset.MinValue und seine Offset Eigenschaft auf TimeSpan.Zerofestgelegt ist.

Sie können einen neuen DateTimeOffset Wert erstellen, indem Sie eine der Überladungen des Konstruktors aufrufen, die den überladenen Konstruktoren für die DateTime Struktur ähneln. Sie können auch einen neuen DateTimeOffset Wert erstellen, indem Sie ihm einen DateTime Wert zuweisen. Dies ist eine implizite Konvertierung; Es ist kein Umwandlungsoperator (in C#) oder ein Aufruf einer Konvertierungsmethode (in Visual Basic) erforderlich. Sie können einen DateTimeOffset Wert auch aus der Zeichenfolgendarstellung eines Datums und einer Uhrzeit initialisieren, indem Sie eine Reihe statischer Zeichenfolgenparsingmethoden aufrufen, einschließlich Parse, , ParseExact, TryParseund TryParseExact.

Die Elemente der DateTimeOffset Struktur bieten Funktionen in den folgenden Bereichen:

  • Datums- und Uhrzeitarithmetik.

    Sie können datums- oder zeitintervalle von einem bestimmten DateTimeOffset Wert addieren oder subtrahieren. Arithmetische Vorgänge mit DateTimeOffset Werten passen im Gegensatz zu DateTime Werten bei unterschiedlichen Zeitversatzen beim Zurückgeben eines Ergebnisses an. Der folgende Code verwendet DateTime beispielsweise Variablen, um die aktuelle Ortszeit von der aktuellen UTC-Zeit zu subtrahieren. Der Code verwendet DateTimeOffset dann Variablen, um denselben Vorgang auszuführen. Die Subtraktion mit DateTime Werten gibt den Unterschied der lokalen Zeitzone von UTC zurück, während die Subtraktion mit DateTimeOffset Werten zurückgegeben wird 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
    
  • Typkonvertierungsvorgänge.

    Sie können Werte in DateTime Werte konvertieren DateTimeOffset und umgekehrt.

  • Zeitmanipulations- und Extraktionsvorgänge.

    Sie können entweder das Datum oder die Uhrzeit eines DateTimeOffset Werts extrahieren. Sie können auch den Wert einer bestimmten DateTimeOffset Komponente abrufen, z. B. das Jahr oder den Monat.

    Hinweis

    Wenn Sie mit einem Teilstrichwert arbeiten, den Sie in ein anderes Zeitintervall konvertieren möchten, z. B. Minuten oder Sekunden, sollten Sie zum Ausführen der Konvertierung die TimeSpan.TicksPerDayKonvertierung verwenden. TimeSpan.TicksPerHourTimeSpan.TicksPerMinuteTimeSpan.TicksPerSecondTimeSpan.TicksPerMillisecond Wenn Sie beispielsweise der Second Komponente eines DateTimeOffset Werts die Anzahl von Sekunden hinzufügen möchten, die durch eine bestimmte Anzahl von Ticks dargestellt werden, können Sie den Ausdruck dateValue.Second + nTicks/Timespan.TicksPerSecond verwenden.

  • Datums- und Uhrzeitkonvertierung.

    Sie können einen beliebigen DateTimeOffset Wert in einen anderen DateTimeOffset Wert konvertieren, der denselben Zeitpunkt in einer anderen Zeitzone darstellt. Die Anpassungsregeln einer Zeitzone werden jedoch nur bei der ToLocalTime Methode angewendet, die einen DateTimeOffset Wert in das Datum und die Uhrzeit in der lokalen Systemzone konvertiert.

  • Datums- und Uhrzeitvergleich.

    Sie können bestimmen, ob ein bestimmter DateTimeOffset Wert früher als, identisch mit oder höher als einem anderen DateTimeOffset Wert ist. Bevor der Vergleich ausgeführt wird, werden alle Werte in UTC konvertiert.

Konstruktoren

Name Beschreibung
DateTimeOffset(DateOnly, TimeOnly, TimeSpan)

Initialisiert eine neue Instanz der Struktur mithilfe des DateTimeOffset angegebenen date, , timeund offset.

DateTimeOffset(DateTime, TimeSpan)

Initialisiert eine neue Instanz der DateTimeOffset Struktur mit dem angegebenen DateTime Wert und offset.

DateTimeOffset(DateTime)

Initialisiert eine neue Instanz der DateTimeOffset Struktur mithilfe des angegebenen DateTime Werts.

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

Initialisiert eine neue Instanz der Struktur mithilfe der angegebenen , , month, , day, hour, minute, secondmillisecond, , und offsetcalendar.yearDateTimeOffset

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

Initialisiert eine neue Instanz der Struktur mithilfe der DateTimeOffset angegebenen , , month, , day, hour, minute, second, millisecondcalendarmicrosecondund offset.year

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

Initialisiert eine neue Instanz der Struktur mithilfe der angegebenen , , month, , day, hour, minute, secondmillisecond, , und offsetmicrosecond.yearDateTimeOffset

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

Initialisiert eine neue Instanz der Struktur mithilfe der angegebenen , , month, , day, hour, minute, second, , , und . millisecondoffsetyearDateTimeOffset

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

Initialisiert eine neue Instanz der Struktur mithilfe der DateTimeOffset angegebenen , , month, , day, hour, minute, , , secondund offsetyear.

DateTimeOffset(Int64, TimeSpan)

Initialisiert eine neue Instanz der DateTimeOffset Struktur mithilfe der angegebenen Anzahl von ticks und offset.

Felder

Name Beschreibung
MaxValue

Stellt den größtmöglichen Wert von DateTimeOffset. Dieses Feld ist schreibgeschützt.

MinValue

Stellt den frühesten möglichen DateTimeOffset Wert dar. Dieses Feld ist schreibgeschützt.

UnixEpoch

Der Wert dieser Konstante entspricht 00:00:00.00.00000 UTC, dem 1. Januar 1970, im gregorianischen Kalender. UnixEpoch definiert den Zeitpunkt, zu dem Unix-Zeit gleich 0 ist.

Eigenschaften

Name Beschreibung
Date

Ruft einen DateTime Wert ab, der die Datumskomponente des aktuellen DateTimeOffset Objekts darstellt.

DateTime

Ruft einen DateTime Wert ab, der das Datum und die Uhrzeit des aktuellen DateTimeOffset Objekts darstellt.

Day

Ruft den Tag des Monats ab, der durch das aktuelle DateTimeOffset Objekt dargestellt wird.

DayOfWeek

Ruft den Wochentag ab, der durch das aktuelle DateTimeOffset Objekt dargestellt wird.

DayOfYear

Ruft den Tag des Jahres ab, der durch das aktuelle DateTimeOffset Objekt dargestellt wird.

Hour

Ruft die Stundenkomponente der Zeit ab, die durch das aktuelle DateTimeOffset Objekt dargestellt wird.

LocalDateTime

Ruft einen DateTime Wert ab, der das lokale Datum und die Uhrzeit des aktuellen DateTimeOffset Objekts darstellt.

Microsecond

Ruft die Mikrosekundenkomponente der Zeit ab, die durch das aktuelle DateTimeOffset Objekt dargestellt wird.

Millisecond

Ruft die Millisekundenkomponente der Zeit ab, die durch das aktuelle DateTimeOffset Objekt dargestellt wird.

Minute

Ruft die Minutenkomponente der Zeit ab, die durch das aktuelle DateTimeOffset Objekt dargestellt wird.

Month

Ruft die Monatskomponente des durch das aktuelle DateTimeOffset Objekt dargestellten Datums ab.

Nanosecond

Ruft die Nanosekundenkomponente der Zeit ab, die durch das aktuelle DateTimeOffset Objekt dargestellt wird.

Now

Ruft ein DateTimeOffset Objekt ab, das auf das aktuelle Datum und die aktuelle Uhrzeit auf dem aktuellen Computer festgelegt ist, wobei der Offset auf den Offset der Ortszeit von koordinierter Weltzeit (UTC) festgelegt ist.

Offset

Ruft den Zeitversatz von koordinierter Weltzeit (UTC) ab.

Second

Ruft die zweite Komponente der Uhrzeit, dargestellt durch das aktuelle DateTimeOffset Objekt.

Ticks

Ruft die Anzahl der Teilstriche ab, die das Datum und die Uhrzeit des aktuellen DateTimeOffset Objekts in der Uhrzeit darstellt.

TimeOfDay

Ruft die Tageszeit für das aktuelle DateTimeOffset Objekt ab.

TotalOffsetMinutes

Ruft den Zeitversatz von koordinierter Weltzeit (UTC) in Minuten ab.

UtcDateTime

Ruft einen DateTime Wert ab, der das Datum und die Uhrzeit der koordinierten Weltzeit (Coordinated Universal Time, UTC) des aktuellen DateTimeOffset Objekts darstellt.

UtcNow

Ruft ein DateTimeOffset Objekt ab, dessen Datum und Uhrzeit auf das aktuelle Koordinierte Weltzeitdatum (UTC) und dessen Offset festgelegt sind Zero.

UtcTicks

Ruft die Anzahl der Teilstriche ab, die das Datum und die Uhrzeit des aktuellen DateTimeOffset Objekts in koordinierter Weltzeit (UTC) darstellt.

Year

Ruft die Jahreskomponente des durch das aktuelle DateTimeOffset Objekt dargestellten Datums ab.

Methoden

Name Beschreibung
Add(TimeSpan)

Gibt ein neues DateTimeOffset Objekt zurück, das dem Wert dieser Instanz ein angegebenes Zeitintervall hinzufügt.

AddDays(Double)

Gibt ein neues DateTimeOffset Objekt zurück, das dem Wert dieser Instanz eine angegebene Anzahl von ganzen und Bruchtagen hinzufügt.

AddHours(Double)

Gibt ein neues DateTimeOffset Objekt zurück, das dem Wert dieser Instanz eine angegebene Anzahl von ganzen und Bruchstunden hinzufügt.

AddMicroseconds(Double)

Gibt ein neues DateTimeOffset Objekt zurück, das dem Wert dieser Instanz eine angegebene Anzahl von Mikrosekunden hinzufügt.

AddMilliseconds(Double)

Gibt ein neues DateTimeOffset Objekt zurück, das dem Wert dieser Instanz eine angegebene Anzahl von Millisekunden hinzufügt.

AddMinutes(Double)

Gibt ein neues DateTimeOffset Objekt zurück, das dem Wert dieser Instanz eine angegebene Anzahl von ganzen und Bruchminuten hinzufügt.

AddMonths(Int32)

Gibt ein neues DateTimeOffset Objekt zurück, das dem Wert dieser Instanz eine angegebene Anzahl von Monaten hinzufügt.

AddSeconds(Double)

Gibt ein neues DateTimeOffset Objekt zurück, das dem Wert dieser Instanz eine angegebene Anzahl von ganzen und bruchzahlenden Sekunden hinzufügt.

AddTicks(Int64)

Gibt ein neues DateTimeOffset Objekt zurück, das dem Wert dieser Instanz eine angegebene Anzahl von Teilstrichen hinzufügt.

AddYears(Int32)

Gibt ein neues DateTimeOffset Objekt zurück, das dem Wert dieser Instanz eine angegebene Anzahl von Jahren hinzufügt.

Compare(DateTimeOffset, DateTimeOffset)

Vergleicht zwei DateTimeOffset Objekte und gibt an, ob die erste älter als die zweite ist, gleich der zweiten oder später als die zweite.

CompareTo(DateTimeOffset)

Vergleicht das aktuelle DateTimeOffset Objekt mit einem angegebenen DateTimeOffset Objekt und gibt an, ob das aktuelle Objekt früher als, identisch mit oder höher als das zweite DateTimeOffset Objekt ist.

Deconstruct(DateOnly, TimeOnly, TimeSpan)

Deconstructs this DateTimeOffset instance by DateOnly, TimeOnly, , und TimeSpan.

Equals(DateTimeOffset, DateTimeOffset)

Bestimmt, ob zwei angegebene DateTimeOffset Objekte denselben Zeitpunkt darstellen.

Equals(DateTimeOffset)

Bestimmt, ob das aktuelle DateTimeOffset Objekt denselben Zeitpunkt wie ein angegebenes DateTimeOffset Objekt darstellt.

Equals(Object)

Bestimmt, ob ein DateTimeOffset Objekt denselben Zeitpunkt wie ein angegebenes Objekt darstellt.

EqualsExact(DateTimeOffset)

Bestimmt, ob das aktuelle DateTimeOffset Objekt dieselbe Zeit darstellt und denselben Offset wie ein angegebenes DateTimeOffset Objekt aufweist.

FromFileTime(Int64)

Konvertiert die angegebene Windows-Dateizeit in eine entsprechende lokale Uhrzeit.

FromUnixTimeMilliseconds(Int64)

Wandelt eine Unix-Zeit, ausgedrückt als die Anzahl von Millisekunden, die seit 1970-01-01T00:00:00Z verstrichen sind, in einen DateTimeOffset Wert um.

FromUnixTimeSeconds(Int64)

Wandelt eine Unix-Zeit, ausgedrückt als die Anzahl der Sekunden, die seit 1970-01-01T00:00:00Z verstrichen sind, in einen DateTimeOffset Wert um.

GetHashCode()

Gibt den Hashcode für das aktuelle DateTimeOffset Objekt zurück.

Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)

Wandelt die angegebene Spannweitendarstellung eines Datums und einer Uhrzeit mithilfe der angegebenen kulturspezifischen Formatinformationen und Formatierungsformatvorlage in das DateTimeOffset entsprechende Format um.

Parse(ReadOnlySpan<Char>, IFormatProvider)

Analysiert eine Spanne von Zeichen in einen Wert.

Parse(String, IFormatProvider, DateTimeStyles)

Wandelt die angegebene Zeichenfolgendarstellung eines Datums und einer Uhrzeit mithilfe der angegebenen kulturspezifischen Formatinformationen und Formatierungsformatvorlage in das DateTimeOffset entsprechende Format um.

Parse(String, IFormatProvider)

Wandelt die angegebene Zeichenfolgendarstellung eines Datums und einer Uhrzeit mithilfe der angegebenen kulturspezifischen Formatinformationen in das DateTimeOffset entsprechende Format um.

Parse(String)

Konvertiert die angegebene Zeichenfolgendarstellung eines Datums, einer Uhrzeit und eines Offsets in die DateTimeOffset entsprechende Zeichenfolge.

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

Konvertiert einen Zeichenbereich, der ein Datum und eine Uhrzeit darstellt, in das DateTimeOffset entsprechende Format mit den angegebenen Formatinformationen, kulturspezifischen Formatinformationen und Formatvorlagen. Das Format der Datums- und Uhrzeitdarstellung muss exakt mit dem angegebenen Format übereinstimmen.

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

Konvertiert einen Zeichenbereich, der die Zeichenfolgendarstellung eines Datums und einer Uhrzeit enthält, in dessen DateTimeOffset Äquivalent die angegebenen Formate, kulturspezifischen Formatinformationen und Formatvorlagen verwendet werden. Das Format der Datums- und Uhrzeitdarstellung muss genau mit einem der angegebenen Formate übereinstimmen.

ParseExact(String, String, IFormatProvider, DateTimeStyles)

Wandelt die angegebene Zeichenfolgendarstellung eines Datums und einer Uhrzeit mithilfe des angegebenen Formats, der kulturspezifischen Formatinformationen und der Formatvorlage in das DateTimeOffset entsprechende Format um. Das Format der Zeichenfolgendarstellung muss exakt mit dem angegebenen Format übereinstimmen.

ParseExact(String, String, IFormatProvider)

Wandelt die angegebene Zeichenfolgendarstellung eines Datums und einer Uhrzeit mithilfe der angegebenen Format- und kulturspezifischen Formatinformationen in das DateTimeOffset entsprechende Format um. Das Format der Zeichenfolgendarstellung muss exakt mit dem angegebenen Format übereinstimmen.

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

Konvertiert die angegebene Zeichenfolgendarstellung eines Datums und einer Uhrzeit in seine DateTimeOffset Entsprechung mithilfe der angegebenen Formate, kulturspezifischen Formatinformationen und Formatvorlagen. Das Format der Zeichenfolgendarstellung muss genau mit einem der angegebenen Formate übereinstimmen.

Subtract(DateTimeOffset)

Subtrahiert einen DateTimeOffset Wert, der ein bestimmtes Datum und eine bestimmte Uhrzeit vom aktuellen DateTimeOffset Objekt darstellt.

Subtract(TimeSpan)

Subtrahiert ein angegebenes Zeitintervall vom aktuellen DateTimeOffset Objekt.

ToFileTime()

Konvertiert den Wert des aktuellen DateTimeOffset Objekts in eine Windows-Dateizeit.

ToLocalTime()

Konvertiert das aktuelle DateTimeOffset Objekt in ein DateTimeOffset Objekt, das die lokale Uhrzeit darstellt.

ToOffset(TimeSpan)

Wandelt den Wert des aktuellen DateTimeOffset Objekts in das Datum und die Uhrzeit um, das durch einen Offsetwert angegeben wird.

ToString()

Konvertiert den Wert des aktuellen DateTimeOffset Objekts in die entsprechende Zeichenfolgendarstellung.

ToString(IFormatProvider)

Konvertiert den Wert des aktuellen DateTimeOffset Objekts in die entsprechende Zeichenfolgendarstellung mithilfe der angegebenen kulturspezifischen Formatierungsinformationen.

ToString(String, IFormatProvider)

Konvertiert den Wert des aktuellen DateTimeOffset Objekts in die entsprechende Zeichenfolgendarstellung mithilfe der angegebenen Format- und kulturspezifischen Formatinformationen.

ToString(String)

Konvertiert den Wert des aktuellen DateTimeOffset Objekts in die entsprechende Zeichenfolgendarstellung mithilfe des angegebenen Formats.

ToUniversalTime()

Konvertiert das aktuelle DateTimeOffset Objekt in einen DateTimeOffset Wert, der die koordinierte Weltzeit (COORDINATED Universal Time, UTC) darstellt.

ToUnixTimeMilliseconds()

Gibt die Anzahl der Millisekunden zurück, die seit 1970-01-01T00:00:00.000Z verstrichen sind.

ToUnixTimeSeconds()

Gibt die Anzahl der Sekunden zurück, die seit 1970-01-01T00:00:00Z verstrichen sind.

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

Versucht, den Wert der aktuellen Instanz als UTF-8 in die bereitgestellte Bytespanne zu formatieren.

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

Versucht, den Wert der aktuellen Datetime-Offsetinstanz in den angegebenen Bereich von Zeichen zu formatieren.

TryParse(ReadOnlySpan<Char>, DateTimeOffset)

Es wird versucht, eine angegebene Span-Darstellung eines Datums und einer Uhrzeit in die DateTimeOffset entsprechende Darstellung zu konvertieren, und gibt einen Wert zurück, der angibt, ob die Konvertierung erfolgreich war.

TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeOffset)

Versucht, einen Bereich von Zeichen in einen Wert zu analysieren.

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

Es wird versucht, eine angegebene Span-Darstellung eines Datums und einer Uhrzeit in die DateTimeOffset entsprechende Darstellung zu konvertieren, und gibt einen Wert zurück, der angibt, ob die Konvertierung erfolgreich war.

TryParse(String, DateTimeOffset)

Versucht, eine angegebene Zeichenfolgendarstellung eines Datums und einer Uhrzeit in seine DateTimeOffset Entsprechung zu konvertieren, und gibt einen Wert zurück, der angibt, ob die Konvertierung erfolgreich war.

TryParse(String, IFormatProvider, DateTimeOffset)

Versucht, eine Zeichenfolge in einen Wert zu analysieren.

TryParse(String, IFormatProvider, DateTimeStyles, DateTimeOffset)

Versucht, eine angegebene Zeichenfolgendarstellung eines Datums und einer Uhrzeit in seine DateTimeOffset Entsprechung zu konvertieren, und gibt einen Wert zurück, der angibt, ob die Konvertierung erfolgreich war.

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

Wandelt die Darstellung eines Datums und einer Uhrzeit in einer Zeichenspanne mithilfe des angegebenen Formats, der kulturspezifischen Formatinformationen und der Formatvorlage in das DateTimeOffset entsprechende Format um. Das Format der Datums- und Uhrzeitdarstellung muss exakt mit dem angegebenen Format übereinstimmen.

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

Wandelt die Darstellung eines Datums und einer Uhrzeit in einer Zeichenspanne DateTimeOffset mithilfe der angegebenen Formate, kulturspezifischen Formatinformationen und formatspezifischen Formatinformationen in Äquivalent um. Das Format der Datums- und Uhrzeitdarstellung muss genau mit einem der angegebenen Formate übereinstimmen.

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

Wandelt die angegebene Zeichenfolgendarstellung eines Datums und einer Uhrzeit mithilfe des angegebenen Formats, der kulturspezifischen Formatinformationen und der Formatvorlage in das DateTimeOffset entsprechende Format um. Das Format der Zeichenfolgendarstellung muss exakt mit dem angegebenen Format übereinstimmen.

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

Konvertiert die angegebene Zeichenfolgendarstellung eines Datums und einer Uhrzeit in seine DateTimeOffset Entsprechung mithilfe des angegebenen Arrays von Formaten, kulturspezifischen Formatinformationen und Formatvorlagen. Das Format der Zeichenfolgendarstellung muss genau mit einem der angegebenen Formate übereinstimmen.

Operatoren

Name Beschreibung
Addition(DateTimeOffset, TimeSpan)

Fügt ein angegebenes Zeitintervall zu einem DateTimeOffset Objekt hinzu, das ein angegebenes Datum und eine angegebene Uhrzeit enthält, und gibt ein DateTimeOffset Objekt mit einem neuen Datum und einer neuen Uhrzeit zurück.

Equality(DateTimeOffset, DateTimeOffset)

Bestimmt, ob zwei angegebene DateTimeOffset Objekte denselben Zeitpunkt darstellen.

GreaterThan(DateTimeOffset, DateTimeOffset)

Bestimmt, ob ein angegebenes Objekt größer (oder höher als) ein zweites angegebenes DateTimeOffsetDateTimeOffset Objekt ist.

GreaterThanOrEqual(DateTimeOffset, DateTimeOffset)

Bestimmt, ob ein angegebenes Objekt größer oder gleich einem zweiten angegebenen DateTimeOffsetDateTimeOffset Objekt ist.

Implicit(DateTime to DateTimeOffset)

Definiert eine implizite Konvertierung eines DateTime Objekts in ein DateTimeOffset Objekt.

Inequality(DateTimeOffset, DateTimeOffset)

Bestimmt, ob zwei angegebene DateTimeOffset Objekte auf unterschiedliche Zeitpunkte verweisen.

LessThan(DateTimeOffset, DateTimeOffset)

Bestimmt, ob ein angegebenes Objekt kleiner als ein zweites angegebenes DateTimeOffsetDateTimeOffset Objekt ist.

LessThanOrEqual(DateTimeOffset, DateTimeOffset)

Bestimmt, ob ein angegebenes Objekt kleiner als ein zweites angegebenes DateTimeOffsetDateTimeOffset Objekt ist.

Subtraction(DateTimeOffset, DateTimeOffset)

Subtrahiert ein Objekt von einem DateTimeOffset anderen und gibt ein Zeitintervall zurück.

Subtraction(DateTimeOffset, TimeSpan)

Subtrahiert ein angegebenes Zeitintervall von einem angegebenen Datum und einer angegebenen Uhrzeit und gibt ein neues Datum und eine neue Uhrzeit zurück.

Explizite Schnittstellenimplementierungen

Name Beschreibung
IComparable.CompareTo(Object)

Vergleicht den Wert des aktuellen DateTimeOffset Objekts mit einem anderen Objekt desselben Typs.

IDeserializationCallback.OnDeserialization(Object)

Wird ausgeführt, wenn die Deserialisierung eines Objekts abgeschlossen wurde.

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Füllt ein SerializationInfo Objekt mit den daten auf, die zum Serialisieren des aktuellen DateTimeOffset Objekts erforderlich sind.

Gilt für:

Weitere Informationen