Sdílet prostřednictvím

DateTimeOffset.Subtract Metoda

  • Reference

Definice

Obor názvů:
System
Sestavení:
System.Runtime.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll

Odečte zadaný čas nebo dobu trvání od aktuálního DateTimeOffset objektu.

Přetížení

Subtract(DateTimeOffset)

Odečte DateTimeOffset hodnotu, která představuje konkrétní datum a čas od aktuálního DateTimeOffset objektu.
Subtract(TimeSpan)

Odečte zadaný časový interval od aktuálního DateTimeOffset objektu.

Subtract(DateTimeOffset)

Zdroj:
DateTimeOffset.cs
Zdroj:
DateTimeOffset.cs
Zdroj:
DateTimeOffset.cs

Odečte DateTimeOffset hodnotu, která představuje konkrétní datum a čas od aktuálního DateTimeOffset objektu.

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

Parametry

value
DateTimeOffset

Objekt, který představuje hodnotu, která se má odečíst.

Návraty

TimeSpan

Objekt, který určuje interval mezi dvěma DateTimeOffset objekty.

Příklady

Následující příklad ukazuje odčítání, které používá metodu Subtract(DateTimeOffset) .

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

Poznámky

Tato metoda převede oba DateTimeOffset objekty na koordinovaný univerzální čas (UTC) před výpočtem časového intervalu, který je odděluje. Tím se odeberou všechny vlivy, které mohou mít různé posuny oproti UTC na porovnání.

Poznámka

U jazyků, které podporují vlastní operátory, můžete také provést odčítání data a času pomocí operátoru odčítání. Podrobnosti najdete v Subtraction metodě .

Vzhledem k tomu, že aktuální DateTimeOffset objekt ani value parametr nepředstavují datum a čas v určitém časovém pásmu, Subtract(DateTimeOffset) metoda při odečítání kalendářních dat a časů nebere v úvahu pravidla úprav určitého časového pásma.

Viz také

Platí pro

Subtract(TimeSpan)

Zdroj:
DateTimeOffset.cs
Zdroj:
DateTimeOffset.cs
Zdroj:
DateTimeOffset.cs

Odečte zadaný časový interval od aktuálního DateTimeOffset objektu.

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

Parametry

value
TimeSpan

Časový interval, který chcete odečíst.

Návraty

DateTimeOffset

Objekt, který se rovná datu a času představovaným aktuálním DateTimeOffset objektem, minus časový interval reprezentovaný objektem value.

Výjimky

ArgumentOutOfRangeException

Výsledná DateTimeOffset hodnota je menší než DateTimeOffset.MinValue.

-nebo-

Výsledná DateTimeOffset hodnota je větší než DateTimeOffset.MaxValue.

Příklady

Následující příklad ukazuje odčítání, které používá metodu Subtract .

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

Poznámky

Pomocí metody můžete Subtract odečíst více než jeden druh časového intervalu (dny, hodiny, minuty, sekundy nebo milisekundy) v jedné operaci. Jeho chování je identické s metodou Subtraction(DateTimeOffset, TimeSpan) , která definuje operátor odčítání. Struktura DateTimeOffset také podporuje specializované metody sčítání (například AddDays, AddHoursa AddMinutes), které umožňují provádět odčítání přiřazením záporné hodnoty k parametru metody.

Poznámka

Tato metoda vrátí nový DateTimeOffset objekt. Neupravuje hodnotu aktuálního objektu odečtením value data a času.

Metoda Subtract nemá vliv na hodnotu vlastnosti objektu DateTimeOffsetOffset . DateTimeOffset Vrácený objekt má stejný posun jako původní objekt.

Vzhledem k tomu, že aktuální DateTimeOffset objekt nepředstavuje datum a čas v určitém časovém pásmu, Subtract(TimeSpan) metoda při provádění odčítání nebere v úvahu pravidla úprav určitého časového pásma.

Viz také

Platí pro