DateTimeOffset.Subtract DateTimeOffset.Subtract DateTimeOffset.Subtract DateTimeOffset.Subtract Method

Definizione

Sottrae un intervallo di tempo o una durata specificata dall'oggetto DateTimeOffset corrente.Subtracts a specified time or duration from the current DateTimeOffset object.

Overload

Subtract(DateTimeOffset) Subtract(DateTimeOffset) Subtract(DateTimeOffset) Subtract(DateTimeOffset)

Sottrae un valore DateTimeOffset che rappresenta una data e un'ora specifiche dall'oggetto DateTimeOffset corrente.Subtracts a DateTimeOffset value that represents a specific date and time from the current DateTimeOffset object.

Subtract(TimeSpan) Subtract(TimeSpan) Subtract(TimeSpan) Subtract(TimeSpan)

Sottrae un intervallo di tempo specificato dall'oggetto DateTimeOffset corrente.Subtracts a specified time interval from the current DateTimeOffset object.

Subtract(DateTimeOffset) Subtract(DateTimeOffset) Subtract(DateTimeOffset) Subtract(DateTimeOffset)

Sottrae un valore DateTimeOffset che rappresenta una data e un'ora specifiche dall'oggetto DateTimeOffset corrente.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

Parametri

value
DateTimeOffset DateTimeOffset DateTimeOffset DateTimeOffset

Oggetto che rappresenta il valore da sottrarre.An object that represents the value to subtract.

Restituisce

Oggetto che specifica l'intervallo tra i due oggetti DateTimeOffset.An object that specifies the interval between the two DateTimeOffset objects.

Esempi

Nell'esempio seguente viene illustrata la sottrazione che Subtract(DateTimeOffset) usa il metodo.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

Commenti

Questo metodo converte entrambi DateTimeOffset gli oggetti in UTC (Coordinated Universal Time) prima di calcolare l'intervallo di tempo che li separa.This method converts both DateTimeOffset objects to Coordinated Universal Time (UTC) before calculating the time interval that separates them. Ciò consente di rimuovere qualsiasi effetto che i diversi offset dall'ora UTC possono avere sul confronto.This removes any effect that different offsets from UTC may have on the comparison.

Nota

Per i linguaggi che supportano gli operatori personalizzati, è anche possibile eseguire la sottrazione di data e ora usando l'operatore di sottrazione.For languages that support custom operators, you can also perform date and time subtraction by using the subtraction operator. Per informazioni dettagliate, vedere Subtraction il metodo.For details, see the Subtraction method.

Poiché né l'oggetto DateTimeOffset corrente né il value parametro rappresentano la data e l'ora in un fuso orario specifico, Subtract(DateTimeOffset) il metodo non prende in considerazione le regole di rettifica di un determinato fuso orario quando sottrae date e ore.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.

Vedi anche

Subtract(TimeSpan) Subtract(TimeSpan) Subtract(TimeSpan) Subtract(TimeSpan)

Sottrae un intervallo di tempo specificato dall'oggetto DateTimeOffset corrente.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

Parametri

value
TimeSpan TimeSpan TimeSpan TimeSpan

Intervallo di tempo da sottrarre.The time interval to subtract.

Restituisce

Oggetto che equivale alla data e all'ora rappresentate dall'oggetto DateTimeOffset corrente, meno l'intervallo di tempo rappresentato da value.An object that is equal to the date and time represented by the current DateTimeOffset object, minus the time interval represented by value.

Eccezioni

Il valore DateTimeOffset risultante è minore di MinValue.The resulting DateTimeOffset value is less than MinValue.

In alternativa-or- Il valore DateTimeOffset risultante è maggiore di MaxValue.The resulting DateTimeOffset value is greater than MaxValue.

Esempi

Nell'esempio seguente viene illustrata la sottrazione che Subtract usa il metodo.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

Commenti

È possibile utilizzare il Subtract metodo per sottrarre più di un tipo di intervallo di tempo (giorni, ore, minuti, secondi o millisecondi) in un'unica operazione.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. Il comportamento è identico al Subtraction(DateTimeOffset, TimeSpan) metodo, che definisce l'operatore di sottrazione.Its behavior is identical to the Subtraction(DateTimeOffset, TimeSpan) method, which defines the subtraction operator. La DateTimeOffset struttura supporta inoltre metodi di aggiunta specializzati AddDays, ad esempio AddHours, e AddMinutes, che consentono di eseguire la sottrazione assegnando un valore negativo al parametro del metodo.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.

Nota

Questo metodo restituisce un nuovo DateTimeOffset oggetto.This method returns a new DateTimeOffset object. Non modifica il valore dell'oggetto corrente aggiungendola timeSpan alla data e all'ora.It does not modify the value of the current object by adding timeSpan to its date and time.

Il Subtract metodo non influisce sul valore DateTimeOffset della Offset proprietà dell'oggetto.The Subtract method does not affect the value of the DateTimeOffset object's Offset property. L'oggetto DateTimeOffset restituito ha lo stesso offset dell'oggetto originale.The returned DateTimeOffset object has the same offset as the original object.

Poiché l'oggetto DateTimeOffset corrente non rappresenta la data e l'ora in un fuso orario specifico, il Subtract(TimeSpan) metodo non prende in considerazione le regole di rettifica di un determinato fuso orario quando esegue la sottrazione.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.

Vedi anche

Si applica a