Freigeben über

DateTimeOffset.Subtract Methode

Definition

Namespace:
System
Assemblys:
mscorlib.dll, System.Runtime.dll
Assemblys:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Subtrahiert eine angegebene Zeit oder Dauer vom aktuellen DateTimeOffset Objekt.

Überlädt

Name Beschreibung
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.

Subtract(DateTimeOffset)

Quelle:
DateTimeOffset.cs
Quelle:
DateTimeOffset.cs
Quelle:
DateTimeOffset.cs
Quelle:
DateTimeOffset.cs
Quelle:
DateTimeOffset.cs

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

public:
 TimeSpan Subtract(DateTimeOffset value);
public TimeSpan Subtract(DateTimeOffset value);
member this.Subtract : DateTimeOffset -> TimeSpan
Public Function Subtract (value As DateTimeOffset) As TimeSpan

Parameter

value
DateTimeOffset

Ein Objekt, das den zu subtrahierenden Wert darstellt.

Gibt zurück

TimeSpan

Ein Objekt, das das Intervall zwischen den beiden DateTimeOffset Objekten angibt.

Beispiele

Im folgenden Beispiel wird eine Subtraktion veranschaulicht, die die Subtract(DateTimeOffset) Methode verwendet.

DateTimeOffset firstDate = new DateTimeOffset(2018, 10, 25, 18, 0, 0,
                                              new TimeSpan(-7, 0, 0));
DateTimeOffset secondDate = new DateTimeOffset(2018, 10, 25, 18, 0, 0,
                                               new TimeSpan(-5, 0, 0));
DateTimeOffset thirdDate = new DateTimeOffset(2018, 9, 28, 9, 0, 0,
                                              new TimeSpan(-7, 0, 0));
TimeSpan difference;

difference = firstDate.Subtract(secondDate);
Console.WriteLine($"({firstDate}) - ({secondDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}");

difference = firstDate.Subtract(thirdDate);
Console.WriteLine($"({firstDate}) - ({thirdDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}");

// The example produces the following output:
//    (10/25/2018 6:00:00 PM -07:00) - (10/25/2018 6:00:00 PM -05:00): 0 days, 2:00
//    (10/25/2018 6:00:00 PM -07:00) - (9/28/2018 9:00:00 AM -07:00): 27 days, 9:00

let firstDate = DateTimeOffset(2018, 10, 25, 18, 0, 0, TimeSpan(-7, 0, 0))
let secondDate = DateTimeOffset(2018, 10, 25, 18, 0, 0, TimeSpan(-5, 0, 0))
let thirdDate = DateTimeOffset(2018, 9, 28, 9, 0, 0, TimeSpan(-7, 0, 0))

let difference = firstDate.Subtract secondDate
printfn $"({firstDate}) - ({secondDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}"

let difference = firstDate.Subtract thirdDate
printfn $"({firstDate}) - ({thirdDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}"

// The example produces the following output:
//    (10/25/2018 6:00:00 PM -07:00) - (10/25/2018 6:00:00 PM -05:00): 0 days, 2:00
//    (10/25/2018 6:00:00 PM -07:00) - (9/28/2018 9:00:00 AM -07:00): 27 days, 9:00

Dim firstDate As New DateTimeOffset(#10/25/2018 6:00PM#, _
                                    New TimeSpan(-7, 0, 0))
Dim secondDate As New DateTimeOffset(#10/25/2018 6:00PM#, _
                                     New TimeSpan(-5, 0, 0))
Dim thirdDate As New DateTimeOffset(#9/28/2018 9:00AM#, _
                                    New TimeSpan(-7, 0, 0))
Dim difference As TimeSpan

difference = firstDate.Subtract(secondDate)
Console.WriteLine($"({firstDate}) - ({secondDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}")

difference = firstDate.Subtract(thirdDate)
Console.WriteLine($"({firstDate}) - ({thirdDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}")

' The example produces the following output:
'    (10/25/2018 6:00:00 PM -07:00) - (10/25/2018 6:00:00 PM -05:00): 0 days, 2:00
'    (10/25/2018 6:00:00 PM -07:00) - (9/28/2018 9:00:00 AM -07:00): 27 days, 9:00

Hinweise

Diese Methode konvertiert beide DateTimeOffset Objekte in koordinierte Weltzeit (UTC), bevor das Zeitintervall berechnet wird, das sie trennt. Dadurch werden alle Auswirkungen entfernt, die unterschiedliche Offsets von UTC auf den Vergleich haben können.

Hinweis

Für Sprachen, die benutzerdefinierte Operatoren unterstützen, können Sie auch die Subtraktion von Datum und Uhrzeit mithilfe des Subtraktionsoperators ausführen. Ausführliche Informationen finden Sie in der Subtraction Methode.

Da weder das aktuelle DateTimeOffset Objekt noch der value Parameter das Datum und die Uhrzeit in einer bestimmten Zeitzone darstellen, berücksichtigt die Subtract(DateTimeOffset) Methode die Anpassungsregeln einer bestimmten Zeitzone nicht, wenn sie Datums- und Uhrzeitangaben subtrahiert.

Weitere Informationen

Gilt für:

Subtract(TimeSpan)

Quelle:
DateTimeOffset.cs
Quelle:
DateTimeOffset.cs
Quelle:
DateTimeOffset.cs
Quelle:
DateTimeOffset.cs
Quelle:
DateTimeOffset.cs

Subtrahiert ein angegebenes Zeitintervall vom aktuellen DateTimeOffset Objekt.

public:
 DateTimeOffset Subtract(TimeSpan value);
public DateTimeOffset Subtract(TimeSpan value);
member this.Subtract : TimeSpan -> DateTimeOffset
Public Function Subtract (value As TimeSpan) As DateTimeOffset

Parameter

value
TimeSpan

Das Zeitintervall, das subtrahiert werden soll.

Gibt zurück

DateTimeOffset

Ein Objekt, das dem Datum und der Uhrzeit entspricht, das durch das aktuelle DateTimeOffset Objekt dargestellt valuewird, abzüglich des durch .

Ausnahmen

ArgumentOutOfRangeException

Der resultierende DateTimeOffset Wert ist kleiner als DateTimeOffset.MinValue.

- oder -

Der resultierende DateTimeOffset Wert ist größer als DateTimeOffset.MaxValue.

Beispiele

Im folgenden Beispiel wird eine Subtraktion veranschaulicht, die die Subtract Methode verwendet.

DateTimeOffset offsetDate = new DateTimeOffset(2007, 12, 3, 11, 30, 0,
                               new TimeSpan(-8, 0, 0));
TimeSpan duration = new TimeSpan(7, 18, 0, 0);
Console.WriteLine(offsetDate.Subtract(duration).ToString());  // Displays 11/25/2007 5:30:00 PM -08:00

let offsetDate = DateTimeOffset(2007, 12, 3, 11, 30, 0, TimeSpan(-8, 0, 0))
let duration = TimeSpan(7, 18, 0, 0)
printfn $"{offsetDate.Subtract duration}"  // Displays 11/25/2007 5:30:00 PM -08:00

Dim offsetDate As New DateTimeOffset(#12/3/2007 11:30AM#, _
                               New TimeSpan(-8, 0, 0)) 
Dim duration As New TimeSpan(7, 18, 0, 0)
Console.WriteLine(offsetDate.Subtract(duration))    ' Displays 11/25/2007 5:30:00 PM -08:00

Hinweise

Mit der Subtract Methode können Sie mehrere Arten von Zeitintervallen (Tage, Stunden, Minuten, Sekunden oder Millisekunden) in einem einzelnen Vorgang subtrahieren. Das Verhalten ist identisch mit der Subtraction(DateTimeOffset, TimeSpan) Methode, die den Subtraktionsoperator definiert. Die DateTimeOffset Struktur unterstützt auch spezielle Additionsmethoden (z AddDays. B. , AddHoursund AddMinutes), mit denen Sie Subtraktion ausführen können, indem Sie dem Methodenparameter einen negativen Wert zuweisen.

Hinweis

Diese Methode gibt ein neues DateTimeOffset Objekt zurück. Der Wert des aktuellen Objekts wird nicht geändert, indem er das Datum und die Uhrzeit subtrahiert value .

Die Subtract Methode wirkt sich nicht auf den Wert der Eigenschaft des DateTimeOffset Objekts Offset aus. Das zurückgegebene DateTimeOffset Objekt weist den gleichen Offset wie das ursprüngliche Objekt auf.

Da das aktuelle DateTimeOffset Objekt das Datum und die Uhrzeit in einer bestimmten Zeitzone nicht darstellt, berücksichtigt die Subtract(TimeSpan) Methode nicht die Anpassungsregeln einer bestimmten Zeitzone, wenn sie die Subtraktion ausführt.

Weitere Informationen

Gilt für: