DateTimeOffset.Subtract Metodo

Origine:

DateTimeOffset.cs

Origine:

DateTimeOffset.cs

Origine:

DateTimeOffset.cs

public:
 TimeSpan Subtract(DateTimeOffset value);

public TimeSpan Subtract (DateTimeOffset value);

member this.Subtract : DateTimeOffset -> TimeSpan

Public Function Subtract (value As DateTimeOffset) As TimeSpan

Parametri

Restituisce

Oggetto che specifica l'intervallo tra i due oggetti DateTimeOffset.

Esempio

Nell'esempio seguente viene illustrata la sottrazione che usa il Subtract(DateTimeOffset) metodo .

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

Commenti

Questo metodo converte entrambi gli DateTimeOffset oggetti in Utc (Coordinated Universal Time) prima di calcolare l'intervallo di tempo che li separa. In questo modo viene rimosso qualsiasi effetto che le diverse offset da UTC potrebbero avere nel confronto.

Poiché né l'oggetto corrente DateTimeOffset né il value parametro rappresentano la data e l'ora in un fuso orario specifico, il Subtract(DateTimeOffset) metodo non considera le regole di regolazione di un determinato fuso orario quando sottrae date e ore.

Vedi anche

• Esecuzione di operazioni aritmetiche con date e ore

Origine:

DateTimeOffset.cs

Origine:

DateTimeOffset.cs

Origine:

DateTimeOffset.cs

public:
 DateTimeOffset Subtract(TimeSpan value);

public DateTimeOffset Subtract (TimeSpan value);

member this.Subtract : TimeSpan -> DateTimeOffset

Public Function Subtract (value As TimeSpan) As DateTimeOffset

Parametri

Restituisce

Oggetto che equivale alla data e all'ora rappresentate dall'oggetto DateTimeOffset corrente, meno l'intervallo di tempo rappresentato da value.

Eccezioni

Esempio

Nell'esempio seguente viene illustrata la sottrazione che usa il Subtract metodo .

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

Commenti

È possibile usare il Subtract metodo per sottrarre più tipi di intervallo di tempo (giorni, ore, minuti, secondi o millisecondi) in una singola operazione. Il suo comportamento è identico al metodo, che definisce l'operatore Subtraction(DateTimeOffset, TimeSpan) di sottrazione. La DateTimeOffset struttura supporta anche metodi di addizione specializzati (ad esempio AddDays, AddHourse ) AddMinutesche consentono di eseguire la sottrazione assegnando un valore negativo al parametro del metodo.

Il Subtract metodo non influisce sul valore della DateTimeOffset proprietà dell'oggetto Offset . L'oggetto restituito DateTimeOffset ha lo stesso offset dell'oggetto originale.

Poiché l'oggetto corrente DateTimeOffset non rappresenta la data e l'ora in un fuso orario specifico, il Subtract(TimeSpan) metodo non considera le regole di regolazione di un determinato fuso orario quando esegue la sottrazione.

Vedi anche

• Esecuzione di operazioni aritmetiche con date e ore