DateTimeOffset.Subtract Methode

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Subtrahiert eine angegebene Zeit oder eine Dauer vom aktuellen DateTimeOffset-Objekt.

Überlädt

Subtract(DateTimeOffset)	Subtrahiert einen DateTimeOffset-Wert, der eine bestimmte Datums- und Uhrzeitangabe darstellt, vom aktuellen DateTimeOffset-Objekt.
Subtract(TimeSpan)	Subtrahiert ein angegebenes Zeitintervall vom aktuellen DateTimeOffset-Objekt.

Subtract(DateTimeOffset)

Subtrahiert einen DateTimeOffset-Wert, der eine bestimmte Datums- und Uhrzeitangabe darstellt, vom aktuellen DateTimeOffset-Objekt.

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 zwei DateTimeOffset-Objekten angibt.

Beispiele

Das folgende Beispiel veranschaulicht die Subtraktion, 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 verschiedene Offsets von UTC auf den Vergleich haben können.

Hinweis

Für Sprachen, die benutzerdefinierte Operatoren unterstützen, können Sie auch die Datums- und Uhrzeitsubtraktion mithilfe des Subtraktionsoperators durchführen. Weitere 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 Methode beim Subtrahieren von Datums- und Uhrzeitangaben nicht die Subtract(DateTimeOffset) Anpassungsregeln einer bestimmten Zeitzone.

Weitere Informationen

• Ausführen arithmetischer Operationen mit Datums- und Uhrzeitangaben

Subtract(TimeSpan)

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 gleich der vom aktuellen DateTimeOffset-Objekt dargestellten Datums- und Uhrzeitangabe minus dem durch value dargestellten Zeitintervall ist.

Ausnahmen

ArgumentOutOfRangeException

Der resultierende DateTimeOffset Wert ist kleiner als DateTimeOffset.MinValue.

Oder

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

Beispiele

Das folgende Beispiel veranschaulicht die Subtraktion, 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

Sie können die Subtract -Methode verwenden, um mehr als eine Art von Zeitintervall (Tage, Stunden, Minuten, Sekunden oder Millisekunden) in einem einzelnen Vorgang zu subtrahieren. Sein Verhalten ist identisch mit der Subtraction(DateTimeOffset, TimeSpan) -Methode, die den Subtraktionsoperator definiert. Die DateTimeOffset -Struktur unterstützt auch spezialisierte Additionsmethoden (z AddDays. B. , AddHoursund AddMinutes), mit denen Sie eine Subtraktion durchfü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 durch Subtrahieren value von Datum und Uhrzeit geändert.

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

Da das aktuelle DateTimeOffset Objekt das Datum und die Uhrzeit in einer bestimmten Zeitzone nicht darstellt, berücksichtigt die Subtract(TimeSpan) Methode beim Ausführen der Subtraktion nicht die Anpassungsregeln einer bestimmten Zeitzone.

Weitere Informationen

• Ausführen arithmetischer Operationen mit Datums- und Uhrzeitangaben