DateTimeOffset.Subtract Metod

Definition

Namnområde:
System
Sammansättningar:
mscorlib.dll, System.Runtime.dll
Sammansättningar:
netstandard.dll, System.Runtime.dll
Sammansättning:
System.Runtime.dll
Sammansättning:
mscorlib.dll
Sammansättning:
netstandard.dll

Subtraherar en angiven tid eller varaktighet från det aktuella DateTimeOffset objektet.

Överlagringar

Name Description
Subtract(DateTimeOffset)

Subtraherar ett DateTimeOffset värde som representerar ett specifikt datum och en viss tid från det aktuella DateTimeOffset objektet.
Subtract(TimeSpan)

Subtraherar ett angivet tidsintervall från det aktuella DateTimeOffset objektet.

Subtract(DateTimeOffset)

Källa:
DateTimeOffset.cs
Källa:
DateTimeOffset.cs
Källa:
DateTimeOffset.cs
Källa:
DateTimeOffset.cs
Källa:
DateTimeOffset.cs

Subtraherar ett DateTimeOffset värde som representerar ett specifikt datum och en viss tid från det aktuella DateTimeOffset objektet.

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

Parametrar

value
DateTimeOffset

Ett objekt som representerar värdet som ska subtraheras.

Returer

TimeSpan

Ett objekt som anger intervallet mellan de två DateTimeOffset objekten.

Exempel

I följande exempel visas subtraktion som använder Subtract(DateTimeOffset) metoden.

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

Kommentarer

Den här metoden konverterar båda DateTimeOffset objekten till Coordinated Universal Time (UTC) innan du beräknar tidsintervallet som skiljer dem åt. Detta tar bort alla effekter som olika förskjutningar från UTC kan ha på jämförelsen.

Note

För språk som stöder anpassade operatorer kan du även utföra subtraktion av datum och tid med hjälp av subtraktionsoperatorn. Mer information finns i Subtraction metoden.

Eftersom varken det aktuella DateTimeOffset objektet eller parametern value representerar datum och tid i en specifik tidszon tar Subtract(DateTimeOffset) metoden inte hänsyn till en viss tidszons justeringsregler när den subtraherar datum och tider.

Se även

Gäller för

Subtract(TimeSpan)

Källa:
DateTimeOffset.cs
Källa:
DateTimeOffset.cs
Källa:
DateTimeOffset.cs
Källa:
DateTimeOffset.cs
Källa:
DateTimeOffset.cs

Subtraherar ett angivet tidsintervall från det aktuella DateTimeOffset objektet.

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

Parametrar

value
TimeSpan

Tidsintervallet som ska subtraheras.

Returer

DateTimeOffset

Ett objekt som är lika med det datum och den tid som representeras av det aktuella DateTimeOffset objektet, minus tidsintervallet som representeras av value.

Undantag

ArgumentOutOfRangeException

Det resulterande DateTimeOffset värdet är mindre än DateTimeOffset.MinValue.

-eller-

Det resulterande DateTimeOffset värdet är större än DateTimeOffset.MaxValue.

Exempel

I följande exempel visas subtraktion som använder Subtract metoden.

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

Kommentarer

Du kan använda Subtract metoden för att subtrahera mer än en typ av tidsintervall (dagar, timmar, minuter, sekunder eller millisekunder) i en enda åtgärd. Dess beteende är identiskt med Subtraction(DateTimeOffset, TimeSpan) metoden, som definierar subtraktionsoperatorn. Strukturen DateTimeOffset stöder också specialiserade tilläggsmetoder (till exempel , AddDaysoch AddHours) som AddMinutesgör att du kan utföra subtraktion genom att tilldela ett negativt värde till metodparametern.

Note

Den här metoden returnerar ett nytt DateTimeOffset objekt. Det ändrar inte värdet för det aktuella objektet genom att subtrahera value från dess datum och tid.

Metoden Subtract påverkar inte värdet för DateTimeOffset objektets Offset egenskap. Det returnerade DateTimeOffset objektet har samma förskjutning som det ursprungliga objektet.

Eftersom det aktuella DateTimeOffset objektet inte representerar datum och tid i en specifik tidszon tar Subtract(TimeSpan) metoden inte hänsyn till en viss tidszons justeringsregler när den utför subtraktionen.

Se även

Gäller för