DateTime.Subtract Méthode

Définition

Retourne un nouveau DateTime qui soustrait l’heure ou la durée spécifiée de la valeur de cette instance.Returns a new DateTime that subtracts the specified time or duration from the value of this instance.

Surcharges

Subtract(DateTime)

Retourne un nouveau DateTime qui soustrait la date et l’heure spécifiées de la valeur de cette instance.Returns a new DateTime that subtracts the specified date and time from the value of this instance.

Subtract(TimeSpan)

Retourne un nouveau DateTime qui soustrait la durée spécifiée de la valeur de cette instance.Returns a new DateTime that subtracts the specified duration from the value of this instance.

Subtract(DateTime)

Retourne un nouveau DateTime qui soustrait la date et l’heure spécifiées de la valeur de cette instance.Returns a new DateTime that subtracts the specified date and time from the value of this 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.The date and time value to subtract.

Retours

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.A time interval that is equal to the date and time represented by this instance minus the date and time represented by value.

Exceptions

Le résultat est inférieur à MinValue ou supérieur à MaxValue.The result is less than MinValue or greater than MaxValue.

Exemples

L’exemple suivant illustre la méthode Subtract et l’opérateur de soustraction.The following example demonstrates the Subtract method and the subtraction operator.

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;
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 méthode Subtract(DateTime) détermine la différence entre deux dates.The Subtract(DateTime) method determines the difference between two dates. Pour soustraire un intervalle de temps de l’instance actuelle, appelez la méthode Subtract(TimeSpan).To subtract a time interval from the current instance, call the Subtract(TimeSpan) method. Pour soustraire un intervalle de temps particulier de l’instance actuelle, appelez la méthode qui ajoute cet intervalle de temps à la date actuelle et fournissez une valeur négative comme argument de la méthode.To subtract a particular time interval from the current instance, call the method that adds that time interval to the current date, and supply a negative value as the method argument. Par exemple, pour soustraire deux mois de la date actuelle, appelez la méthode AddMonths(Int32) avec une valeur de-2.For example, to subtract two months from the current date, call the AddMonths(Int32) method with a value of -2.

Si la date et l’heure de l’instance actuelle sont antérieures à value, la méthode retourne un objet TimeSpan qui représente un intervalle de temps négatif.If the date and time of the current instance is earlier than value, the method returns a TimeSpan object that represents a negative time span. Autrement dit, la valeur de toutes ses propriétés non nulles (par exemple, Days ou Ticks) est négative.That is, the value of all of its non-zero properties (such as Days or Ticks) is negative.

La méthode Subtract(DateTime) ne prend pas en compte la valeur de la propriété Kind des deux valeurs DateTime lors de l’exécution de la soustraction.The Subtract(DateTime) method does not consider the value of the Kind property of the two DateTime values when performing the subtraction. Avant de soustraire des objets DateTime, assurez-vous que les objets représentent des heures dans le même fuseau horaire.Before subtracting DateTime objects, ensure that the objects represent times in the same time zone. Dans le cas contraire, le résultat inclura la différence entre les fuseaux horaires.Otherwise, the result will include the difference between time zones.

Notes

La méthode DateTimeOffset.Subtract(DateTimeOffset) prend en compte la différence entre les fuseaux horaires lors de l’exécution de la soustraction.The DateTimeOffset.Subtract(DateTimeOffset) method does consider the difference between time zones when performing the subtraction.

Voir aussi

Subtract(TimeSpan)

Retourne un nouveau DateTime qui soustrait la durée spécifiée de la valeur de cette instance.Returns a new DateTime that subtracts the specified duration from the value of this 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.The time interval to subtract.

Retours

Objet qui est égal à la date et à l'heure représentées par cette instance moins l'intervalle de temps représenté par value.An object that is equal to the date and time represented by this instance minus the time interval represented by value.

Exceptions

Le résultat est inférieur à MinValue ou supérieur à MaxValue.The result is less than MinValue or greater than MaxValue.

Exemples

L’exemple suivant illustre la méthode Subtract et l’opérateur de soustraction.The following example demonstrates the Subtract method and the subtraction operator.

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;
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 méthode Subtract(TimeSpan) retourne la date qui correspond à une différence d’intervalle de temps spécifiée par rapport à l’instance actuelle.The Subtract(TimeSpan) method returns the date that is a specified time interval difference from the current instance. Pour déterminer l’intervalle de temps entre deux dates, appelez la méthode Subtract(DateTime).To determine the time interval between two dates, call the Subtract(DateTime) method. Pour soustraire un intervalle de temps particulier de l’instance actuelle, appelez la méthode qui ajoute cet intervalle de temps à la date actuelle et fournissez une valeur négative comme argument de la méthode.To subtract a particular time interval from the current instance, call the method that adds that time interval to the current date, and supply a negative value as the method argument. Par exemple, pour soustraire deux mois de la date actuelle, appelez la méthode AddMonths(Int32) avec une valeur de-2.For example, to subtract two months from the current date, call the AddMonths(Int32) method with a value of -2.

Cette méthode ne modifie pas la valeur de ce DateTime.This method does not change the value of this DateTime. Au lieu de cela, elle retourne un nouvel DateTime dont la valeur est le résultat de cette opération.Instead, it returns a new DateTime whose value is the result of this operation.

En règle générale, la méthode DateTime.Subtract(TimeSpan) soustrait un objet TimeSpan qui représente un intervalle de temps positif et retourne une valeur DateTime antérieure à la date et l’heure de l’instance actuelle.Ordinarily, the DateTime.Subtract(TimeSpan) method subtracts a TimeSpan object that represents a positive time span and returns a DateTime value that is earlier than the date and time of the current instance. Toutefois, si l’objet TimeSpan représente un intervalle de temps négatif, la méthode DateTime.Subtract(TimeSpan) retourne une valeur DateTime qui est ultérieure à la date et l’heure de l’instance actuelle.However, if the TimeSpan object represents a negative time span, the DateTime.Subtract(TimeSpan) method returns a DateTime value that is later than the date and time of the current instance.

La méthode DateTime.Subtract(TimeSpan) vous permet de soustraire un intervalle de temps qui se compose de plus d’une unité de temps (par exemple, un nombre donné d’heures et d’un nombre de minutes donné).The DateTime.Subtract(TimeSpan) method allows you to subtract a time interval that consists of more than one unit of time (such as a given number of hours and a given number of minutes). Pour soustraire une seule unité de temps (par exemple, les années, les mois ou les jours) de l’instance DateTime, vous pouvez passer une valeur numérique négative en tant que paramètre à l’une des méthodes suivantes :To subtract a single unit of time (such as years, months, or days) from the DateTime instance, you can pass a negative numeric value as a parameter to any of the following methods:

  • AddYears, pour soustraire un nombre spécifique d’années de l’instance de date et d’heure actuelle.AddYears, to subtract a specific number of years from the current date and time instance.

  • AddMonths, pour soustraire un nombre spécifique de mois de l’instance de date et d’heure actuelle.AddMonths, to subtract a specific number of months from the current date and time instance.

  • AddDays, pour soustraire un nombre spécifique de jours de l’instance de date et d’heure actuelle.AddDays, to subtract a specific number of days from the current date and time instance.

  • AddHours, pour soustraire un nombre spécifique d’heures de l’instance de date et d’heure actuelle.AddHours, to subtract a specific number of hours from the current date and time instance.

  • AddMinutes, pour soustraire un nombre spécifique de minutes de l’instance de date et d’heure actuelle.AddMinutes, to subtract a specific number of minutes from the current date and time instance.

  • AddSeconds, pour soustraire un nombre spécifique de secondes de l’instance de date et d’heure actuelle.AddSeconds, to subtract a specific number of seconds from the current date and time instance.

  • AddMilliseconds, pour soustraire un nombre spécifique de millisecondes de l’instance de date et d’heure actuelle.AddMilliseconds, to subtract a specific number of milliseconds from the current date and time instance.

  • AddTicks, pour soustraire un nombre spécifique de graduations de l’instance de date et d’heure actuelle.AddTicks, to subtract a specific number of ticks from the current date and time instance.

Voir aussi

S’applique à