DateTimeOffset.Subtract Metoda

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Runtime.dll

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

Přetížení

Name	Description
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

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 těmito 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 efekty, které mohou mít různé posuny od standardu 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ředstavuje datum a čas v určitém časovém pásmu, Subtract(DateTimeOffset) metoda nebere v úvahu pravidla úpravy konkrétního časového pásma při odečítání kalendářních dat a časů.

Viz také

• Provádění aritmetických operací s daty a časy

Subtract(TimeSpan)

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ý se má odečíst.

Návraty

DateTimeOffset

Objekt, který je roven datu a času reprezentovaným aktuálním DateTimeOffset objektem, minus časový interval reprezentovaný 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

Metodu Subtract můžete použít k odečtení více než jednoho druhu časového intervalu (dny, hodiny, minuty, sekundy nebo milisekundy) v jedné operaci. Jeho chování je stejné jako Subtraction(DateTimeOffset, TimeSpan) metoda, 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 od data a času.

Metoda Subtract nemá vliv na hodnotu vlastnosti objektu DateTimeOffsetOffset . Vrácený DateTimeOffset 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í nepovažuje pravidla úpravy konkrétního časového pásma.

Viz také

• Provádění aritmetických operací s daty a časy