DateTimeOffset.Subtract Methode

Definition

Subtrahiert eine angegebene Zeit oder eine Dauer vom aktuellen DateTimeOffset-Objekt.Subtracts a specified time or duration from the current DateTimeOffset object.

Überlädt

Subtract(DateTimeOffset)

Subtrahiert einen DateTimeOffset-Wert, der eine bestimmte Datums- und Uhrzeitangabe darstellt, vom aktuellen DateTimeOffset-Objekt.Subtracts a DateTimeOffset value that represents a specific date and time from the current DateTimeOffset object.

Subtract(TimeSpan)

Subtrahiert ein angegebenes Zeitintervall vom aktuellen DateTimeOffset-Objekt.Subtracts a specified time interval from the current DateTimeOffset object.

Subtract(DateTimeOffset)

Subtrahiert einen DateTimeOffset-Wert, der eine bestimmte Datums- und Uhrzeitangabe darstellt, vom aktuellen DateTimeOffset-Objekt.Subtracts a DateTimeOffset value that represents a specific date and time from the current DateTimeOffset object.

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.An object that represents the value to subtract.

Gibt zurück

Ein Objekt, das das Intervall zwischen den zwei DateTimeOffset-Objekten angibt.An object that specifies the interval between the two DateTimeOffset objects.

Beispiele

Im folgenden Beispiel wird die Subtraktion veranschaulicht, die die Subtract(DateTimeOffset)-Methode verwendet.The following example illustrates subtraction that uses the Subtract(DateTimeOffset) method.

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
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, das Sie trennt, berechnet wird.This method converts both DateTimeOffset objects to Coordinated Universal Time (UTC) before calculating the time interval that separates them. Dadurch werden alle Effekte, die unterschiedliche Offsets von UTC aufweisen können, auf den Vergleich entfernt.This removes any effect that different offsets from UTC may have on the comparison.

Hinweis

Für Sprachen, die benutzerdefinierte Operatoren unterstützen, können Sie auch die Datums-und Uhrzeitsubtraktion mithilfe des Subtraktions Operators ausführen.For languages that support custom operators, you can also perform date and time subtraction by using the subtraction operator. Weitere Informationen finden Sie in der Subtraction-Methode.For details, see the Subtraction method.

Da weder das aktuelle DateTimeOffset-Objekt noch der value-Parameter das Datum und die Uhrzeit in einer bestimmten Zeitzone darstellt, berücksichtigt die Subtract(DateTimeOffset)-Methode nicht die Anpassungsregeln einer bestimmten Zeitzone, wenn Sie Datumsangaben und Uhrzeiten subtrahiert.Because neither the current DateTimeOffset object nor the value parameter represent the date and time in a specific time zone, the Subtract(DateTimeOffset) method does not consider a particular time zone's adjustment rules when it subtracts dates and times.

Siehe auch

Subtract(TimeSpan)

Subtrahiert ein angegebenes Zeitintervall vom aktuellen DateTimeOffset-Objekt.Subtracts a specified time interval from the current DateTimeOffset object.

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.The time interval to subtract.

Gibt zurück

Ein Objekt, das gleich der vom aktuellen DateTimeOffset-Objekt dargestellten Datums- und Uhrzeitangabe minus dem durch value dargestellten Zeitintervall ist.An object that is equal to the date and time represented by the current DateTimeOffset object, minus the time interval represented by value.

Ausnahmen

Der resultierende DateTimeOffset-Wert ist kleiner als MinValue.The resulting DateTimeOffset value is less than MinValue.

- oder --or- Der resultierende DateTimeOffset-Wert ist größer als MaxValue.The resulting DateTimeOffset value is greater than MaxValue.

Beispiele

Im folgenden Beispiel wird die Subtraktion veranschaulicht, die die Subtract-Methode verwendet.The following example illustrates subtraction that uses the Subtract method.

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
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 Zeitintervall (Tage, Stunden, Minuten, Sekunden oder Millisekunden) in einem einzelnen Vorgang zu subtrahieren.You can use the Subtract method to subtract more than one kind of time interval (days, hours, minutes, seconds, or milliseconds) in a single operation. Das Verhalten ist identisch mit der Subtraction(DateTimeOffset, TimeSpan)-Methode, die den Subtraktions Operator definiert.Its behavior is identical to the Subtraction(DateTimeOffset, TimeSpan) method, which defines the subtraction operator. Die DateTimeOffset Struktur unterstützt auch spezialisierte Additions Methoden (z. b. AddDays, AddHoursund AddMinutes), mit denen Sie die Subtraktion durch Zuweisen eines negativen Werts zum Methoden Parameter durchführen können.The DateTimeOffset structure also supports specialized addition methods (such as AddDays, AddHours, and AddMinutes) that allow you to perform subtraction by assigning a negative value to the method parameter.

Hinweis

Diese Methode gibt ein neues DateTimeOffset-Objekt zurück.This method returns a new DateTimeOffset object. Der Wert des aktuellen-Objekts wird nicht geändert, indem dem Datum und der Uhrzeit timeSpan hinzugefügt wird.It does not modify the value of the current object by adding timeSpan to its date and time.

Die Subtract-Methode wirkt sich nicht auf den Wert der Offset-Eigenschaft des DateTimeOffset Objekts aus.The Subtract method does not affect the value of the DateTimeOffset object's Offset property. Das zurückgegebene DateTimeOffset-Objekt hat denselben Offset wie das ursprüngliche-Objekt.The returned DateTimeOffset object has the same offset as the original object.

Da das aktuelle DateTimeOffset Objekt das Datum und die Uhrzeit in einer bestimmten Zeitzone nicht darstellt, berücksichtigt die Subtract(TimeSpan)-Methode die Anpassungsregeln einer bestimmten Zeitzone nicht, wenn Sie die Subtraktion ausführt.Because the current DateTimeOffset object does not represent the date and time in a specific time zone, the Subtract(TimeSpan) method does not consider a particular time zone's adjustment rules when it performs the subtraction.

Siehe auch

Gilt für: