DateTime.Subtract Méthode

  • Référence

Définition

Espace de noms:
System
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Retourne la valeur qui résulte de la soustraction de l’heure ou de la durée spécifiée de la valeur de cette instance.

Surcharges

Subtract(TimeSpan)

Retourne un nouveau DateTime qui soustrait la durée spécifiée de la valeur de cette instance.
Subtract(DateTime)

Retourne un nouveau TimeSpan qui soustrait la date et l’heure spécifiées de la valeur de cette instance.

Subtract(TimeSpan)

Source:
DateTime.cs
Source:
DateTime.cs
Source:
DateTime.cs

Retourne un nouveau DateTime qui soustrait la durée spécifiée de la valeur de cette instance.

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

Paramètres

value
TimeSpan

Intervalle de temps à soustraire.

Retours

DateTime

Objet qui est égal à la date et à l'heure représentées par cette instance moins l'intervalle de temps représenté par value.

Exceptions

ArgumentOutOfRangeException

Le résultat est inférieur à DateTime.MinValue ou supérieur à DateTime.MaxValue.

Exemples

L’exemple suivant illustre la Subtract méthode et l’opérateur de soustraction.

System::DateTime date1 = System::DateTime( 1996, 6, 3, 22, 15, 0 );
System::DateTime date2 = System::DateTime( 1996, 12, 6, 13, 2, 0 );
System::DateTime date3 = System::DateTime( 1996, 10, 12, 8, 42, 0 );

// diff1 gets 185 days, 14 hours, and 47 minutes.
System::TimeSpan diff1 = date2.Subtract( date1 );

// date4 gets 4/9/1996 5:55:00 PM.
System::DateTime date4 = date3.Subtract( diff1 );

// diff2 gets 55 days 4 hours and 20 minutes.
System::TimeSpan diff2 = date2 - date3;

// date5 gets 4/9/1996 5:55:00 PM.
System::DateTime date5 = date1 - diff2;

open System

let date1 = DateTime(1996, 6, 3, 22, 15, 0)
let date2 = DateTime(1996, 12, 6, 13, 2, 0)
let date3 = DateTime(1996, 10, 12, 8, 42, 0)

// diff1 gets 185 days, 14 hours, and 47 minutes.
let diff1 = date2.Subtract date1

// date4 gets 4/9/1996 5:55:00 PM.
let date4 = date3.Subtract diff1

// diff2 gets 55 days 4 hours and 20 minutes.
let diff2 = date2 - date3

// date5 gets 4/9/1996 5:55:00 PM.
let date5 = date1 - diff2

System.DateTime date1 = new System.DateTime(1996, 6, 3, 22, 15, 0);
System.DateTime date2 = new System.DateTime(1996, 12, 6, 13, 2, 0);
System.DateTime date3 = new System.DateTime(1996, 10, 12, 8, 42, 0);

// diff1 gets 185 days, 14 hours, and 47 minutes.
System.TimeSpan diff1 = date2.Subtract(date1);

// date4 gets 4/9/1996 5:55:00 PM.
System.DateTime date4 = date3.Subtract(diff1);

// diff2 gets 55 days 4 hours and 20 minutes.
System.TimeSpan diff2 = date2 - date3;

// date5 gets 4/9/1996 5:55:00 PM.
System.DateTime date5 = date1 - diff2;

Dim date1 As New System.DateTime(1996, 6, 3, 22, 15, 0)
Dim date2 As New System.DateTime(1996, 12, 6, 13, 2, 0)
Dim date3 As New System.DateTime(1996, 10, 12, 8, 42, 0)

Dim diff1 As System.TimeSpan
' diff1 gets 185 days, 14 hours, and 47 minutes.
diff1 = date2.Subtract(date1)

Dim date4 As System.DateTime
' date4 gets 4/9/1996 5:55:00 PM.
date4 = date3.Subtract(diff1)

Dim diff2 As System.TimeSpan
' diff2 gets 55 days 4 hours and 20 minutes.
diff2 = System.DateTime.op_Subtraction(date2, date3)

Dim date5 As System.DateTime
' date5 gets 4/9/1996 5:55:00 PM.
date5 = System.DateTime.op_Subtraction(date1, diff2)

Remarques

La Subtract(TimeSpan) méthode retourne la date qui est une différence d’intervalle de temps spécifiée par rapport à la instance actuelle. Pour déterminer l’intervalle de temps entre deux dates, appelez la Subtract(DateTime) méthode . Pour soustraire un intervalle de temps particulier de la instance actuelle, appelez la méthode qui ajoute cet intervalle de temps à la date actuelle et fournissez une valeur négative en tant qu’argument de méthode. Par exemple, pour soustraire deux mois de la date actuelle, appelez la AddMonths(Int32) méthode avec la valeur -2.

Cette méthode ne modifie pas la valeur de ce DateTime. Au lieu de cela, il retourne un nouveau DateTime dont la valeur est le résultat de cette opération.

En règle générale, la DateTime.Subtract(TimeSpan) méthode soustrait un TimeSpan objet qui représente un intervalle de temps positif et retourne une DateTime valeur antérieure à la date et à l’heure de la instance actuelle. Toutefois, si l’objet TimeSpan représente un intervalle de temps négatif, la DateTime.Subtract(TimeSpan) méthode retourne une DateTime valeur postérieure à la date et à l’heure du instance actuel.

La DateTime.Subtract(TimeSpan) méthode vous permet de soustraire un intervalle de temps qui se compose de plusieurs unités de temps (par exemple, un nombre d’heures donné et un nombre de minutes donné). Pour soustraire une seule unité de temps (par exemple, des années, des mois ou des jours) de la DateTime instance, vous pouvez passer une valeur numérique négative en tant que paramètre à l’une des méthodes suivantes :

  • AddYears, pour soustraire un nombre d’années spécifique de la date et de l’heure actuelles instance.

  • AddMonths, pour soustraire un nombre spécifique de mois de la date et de l’heure actuelles instance.

  • AddDays, pour soustraire un nombre spécifique de jours de la date et de l’heure actuelles instance.

  • AddHours, pour soustraire un nombre d’heures spécifique de la date et de l’heure actuelles instance.

  • AddMinutes, pour soustraire un nombre spécifique de minutes de la date et de l’heure actuelles instance.

  • AddSeconds, pour soustraire un nombre spécifique de secondes de la date et de l’heure actuelles instance.

  • AddMilliseconds, pour soustraire un nombre spécifique de millisecondes de la date et de l’heure actuelles instance.

  • AddTicks, pour soustraire un nombre spécifique de graduations de la date et de l’heure actuelles instance.

Voir aussi

S’applique à

Subtract(DateTime)

Source:
DateTime.cs
Source:
DateTime.cs
Source:
DateTime.cs

Retourne un nouveau TimeSpan qui soustrait la date et l’heure spécifiées de la valeur de cette instance.

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

Paramètres

value
DateTime

Valeur de date et d'heure à soustraire.

Retours

TimeSpan

Intervalle de temps égal à la date et à l'heure représentées par cette instance moins la date et l'heure représentées par value.

Exceptions

ArgumentOutOfRangeException

Le résultat est inférieur à DateTime.MinValue ou supérieur à DateTime.MaxValue.

Exemples

L’exemple suivant illustre la Subtract méthode et l’opérateur de soustraction.

System::DateTime date1 = System::DateTime( 1996, 6, 3, 22, 15, 0 );
System::DateTime date2 = System::DateTime( 1996, 12, 6, 13, 2, 0 );
System::DateTime date3 = System::DateTime( 1996, 10, 12, 8, 42, 0 );

// diff1 gets 185 days, 14 hours, and 47 minutes.
System::TimeSpan diff1 = date2.Subtract( date1 );

// date4 gets 4/9/1996 5:55:00 PM.
System::DateTime date4 = date3.Subtract( diff1 );

// diff2 gets 55 days 4 hours and 20 minutes.
System::TimeSpan diff2 = date2 - date3;

// date5 gets 4/9/1996 5:55:00 PM.
System::DateTime date5 = date1 - diff2;

open System

let date1 = DateTime(1996, 6, 3, 22, 15, 0)
let date2 = DateTime(1996, 12, 6, 13, 2, 0)
let date3 = DateTime(1996, 10, 12, 8, 42, 0)

// diff1 gets 185 days, 14 hours, and 47 minutes.
let diff1 = date2.Subtract date1

// date4 gets 4/9/1996 5:55:00 PM.
let date4 = date3.Subtract diff1

// diff2 gets 55 days 4 hours and 20 minutes.
let diff2 = date2 - date3

// date5 gets 4/9/1996 5:55:00 PM.
let date5 = date1 - diff2

System.DateTime date1 = new System.DateTime(1996, 6, 3, 22, 15, 0);
System.DateTime date2 = new System.DateTime(1996, 12, 6, 13, 2, 0);
System.DateTime date3 = new System.DateTime(1996, 10, 12, 8, 42, 0);

// diff1 gets 185 days, 14 hours, and 47 minutes.
System.TimeSpan diff1 = date2.Subtract(date1);

// date4 gets 4/9/1996 5:55:00 PM.
System.DateTime date4 = date3.Subtract(diff1);

// diff2 gets 55 days 4 hours and 20 minutes.
System.TimeSpan diff2 = date2 - date3;

// date5 gets 4/9/1996 5:55:00 PM.
System.DateTime date5 = date1 - diff2;

Dim date1 As New System.DateTime(1996, 6, 3, 22, 15, 0)
Dim date2 As New System.DateTime(1996, 12, 6, 13, 2, 0)
Dim date3 As New System.DateTime(1996, 10, 12, 8, 42, 0)

Dim diff1 As System.TimeSpan
' diff1 gets 185 days, 14 hours, and 47 minutes.
diff1 = date2.Subtract(date1)

Dim date4 As System.DateTime
' date4 gets 4/9/1996 5:55:00 PM.
date4 = date3.Subtract(diff1)

Dim diff2 As System.TimeSpan
' diff2 gets 55 days 4 hours and 20 minutes.
diff2 = System.DateTime.op_Subtraction(date2, date3)

Dim date5 As System.DateTime
' date5 gets 4/9/1996 5:55:00 PM.
date5 = System.DateTime.op_Subtraction(date1, diff2)

Remarques

La Subtract(DateTime) méthode détermine la différence entre deux dates. Pour soustraire un intervalle de temps de la instance actuelle, appelez la Subtract(TimeSpan) méthode . Pour soustraire un intervalle de temps particulier de la instance actuelle, appelez la méthode qui ajoute cet intervalle de temps à la date actuelle et fournissez une valeur négative en tant qu’argument de méthode. Par exemple, pour soustraire deux mois de la date actuelle, appelez la AddMonths(Int32) méthode avec la valeur -2.

Si la date et l’heure du instance actuel sont antérieures valueà , la méthode retourne un TimeSpan objet qui représente un intervalle de temps négatif. Autrement dit, la valeur de toutes ses propriétés non nulles (telles que Days ou Ticks) est négative.

La Subtract(DateTime) méthode ne tient pas compte de la valeur de la Kind propriété des deux DateTime valeurs lors de l’exécution de la soustraction. Avant de soustraire des DateTime objets, assurez-vous que les objets représentent des heures dans le même fuseau horaire. Sinon, le résultat inclut la différence entre les fuseaux horaires.

Notes

La DateTimeOffset.Subtract(DateTimeOffset) méthode tient compte de la différence entre les fuseaux horaires lors de l’exécution de la soustraction.

Voir aussi

S’applique à