DateTime.Subtract Método

Definición

Devuelve un nuevo objeto DateTime que resta la hora o duración especificada del valor de esta instancia.Returns a new DateTime that subtracts the specified time or duration from the value of this instance.

Sobrecargas

Subtract(DateTime)

Devuelve un nuevo objeto DateTime que resta la fecha y hora especificadas del valor de esta instancia.Returns a new DateTime that subtracts the specified date and time from the value of this instance.

Subtract(TimeSpan)

Devuelve un nuevo objeto DateTime que resta la duración especificada del valor de esta instancia.Returns a new DateTime that subtracts the specified duration from the value of this instance.

Subtract(DateTime)

Devuelve un nuevo objeto DateTime que resta la fecha y hora especificadas del valor de esta instancia.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

Parámetros

value
DateTime

Valor de fecha y hora que se va a restar.The date and time value to subtract.

Devoluciones

Intervalo que es igual a la fecha y hora representadas por esta instancia menos la fecha y hora representadas por value.A time interval that is equal to the date and time represented by this instance minus the date and time represented by value.

Excepciones

El resultado es menor que MinValue o mayor que MaxValue.The result is less than MinValue or greater than MaxValue.

Ejemplos

En el ejemplo siguiente se muestra el método Subtract y el operador de resta.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)

Comentarios

El método Subtract(DateTime) determina la diferencia entre dos fechas.The Subtract(DateTime) method determines the difference between two dates. Para restar un intervalo de tiempo de la instancia actual, llame al método Subtract(TimeSpan).To subtract a time interval from the current instance, call the Subtract(TimeSpan) method. Para restar un intervalo de tiempo determinado de la instancia actual, llame al método que agrega ese intervalo de tiempo a la fecha actual y proporcione un valor negativo como argumento del método.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. Por ejemplo, para restar dos meses a partir de la fecha actual, llame al método AddMonths(Int32) con un valor de-2.For example, to subtract two months from the current date, call the AddMonths(Int32) method with a value of -2.

Si la fecha y hora de la instancia actual es anterior a value, el método devuelve un TimeSpan objeto que representa un intervalo de tiempo negativo.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. Es decir, el valor de todas sus propiedades distintas de cero (como Days o Ticks) es negativo.That is, the value of all of its non-zero properties (such as Days or Ticks) is negative.

El método Subtract(DateTime) no tiene en cuenta el valor de la propiedad Kind de los dos valores DateTime al realizar la resta.The Subtract(DateTime) method does not consider the value of the Kind property of the two DateTime values when performing the subtraction. Antes de restar DateTime objetos, asegúrese de que los objetos representan las horas de la misma zona horaria.Before subtracting DateTime objects, ensure that the objects represent times in the same time zone. De lo contrario, el resultado incluirá la diferencia entre las zonas horarias.Otherwise, the result will include the difference between time zones.

Nota

El método DateTimeOffset.Subtract(DateTimeOffset) considera la diferencia entre las zonas horarias al realizar la resta.The DateTimeOffset.Subtract(DateTimeOffset) method does consider the difference between time zones when performing the subtraction.

Consulte también:

Subtract(TimeSpan)

Devuelve un nuevo objeto DateTime que resta la duración especificada del valor de esta instancia.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

Parámetros

value
TimeSpan

Intervalo de hora que se van a restar.The time interval to subtract.

Devoluciones

Objeto que es igual a la fecha y hora representadas por esta instancia menos el intervalo de hora representados por value.An object that is equal to the date and time represented by this instance minus the time interval represented by value.

Excepciones

El resultado es menor que MinValue o mayor que MaxValue.The result is less than MinValue or greater than MaxValue.

Ejemplos

En el ejemplo siguiente se muestra el método Subtract y el operador de resta.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)

Comentarios

El método Subtract(TimeSpan) devuelve la fecha que es una diferencia de intervalo de tiempo especificado de la instancia actual.The Subtract(TimeSpan) method returns the date that is a specified time interval difference from the current instance. Para determinar el intervalo de tiempo entre dos fechas, llame al método Subtract(DateTime).To determine the time interval between two dates, call the Subtract(DateTime) method. Para restar un intervalo de tiempo determinado de la instancia actual, llame al método que agrega ese intervalo de tiempo a la fecha actual y proporcione un valor negativo como argumento del método.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. Por ejemplo, para restar dos meses a partir de la fecha actual, llame al método AddMonths(Int32) con un valor de-2.For example, to subtract two months from the current date, call the AddMonths(Int32) method with a value of -2.

Este método no cambia el valor de esta DateTime.This method does not change the value of this DateTime. En su lugar, devuelve una nueva DateTime cuyo valor es el resultado de esta operación.Instead, it returns a new DateTime whose value is the result of this operation.

Normalmente, el método DateTime.Subtract(TimeSpan) resta un objeto TimeSpan que representa un intervalo de tiempo positivo y devuelve un valor de DateTime anterior a la fecha y hora de la instancia actual.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. Sin embargo, si el objeto TimeSpan representa un intervalo de tiempo negativo, el método DateTime.Subtract(TimeSpan) devuelve un valor DateTime posterior a la fecha y hora de la instancia actual.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.

El método DateTime.Subtract(TimeSpan) permite restar un intervalo de tiempo que consta de más de una unidad de tiempo (por ejemplo, un número determinado de horas y un número determinado de minutos).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). Para restar una sola unidad de tiempo (como años, meses o días) de la instancia de DateTime, puede pasar un valor numérico negativo como parámetro a cualquiera de los métodos siguientes: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, para restar un número específico de años de la instancia de fecha y hora actual.AddYears, to subtract a specific number of years from the current date and time instance.

  • AddMonths, para restar un número específico de meses a partir de la instancia de fecha y hora actual.AddMonths, to subtract a specific number of months from the current date and time instance.

  • AddDays, para restar un número específico de días a partir de la instancia de fecha y hora actual.AddDays, to subtract a specific number of days from the current date and time instance.

  • AddHours, para restar un número específico de horas de la instancia de fecha y hora actual.AddHours, to subtract a specific number of hours from the current date and time instance.

  • AddMinutes, para restar un número específico de minutos de la instancia de fecha y hora actual.AddMinutes, to subtract a specific number of minutes from the current date and time instance.

  • AddSeconds, para restar un número específico de segundos de la instancia de fecha y hora actual.AddSeconds, to subtract a specific number of seconds from the current date and time instance.

  • AddMilliseconds, para restar un número específico de milisegundos de la instancia de fecha y hora actual.AddMilliseconds, to subtract a specific number of milliseconds from the current date and time instance.

  • AddTicks, para restar un número específico de TICs de la instancia de fecha y hora actual.AddTicks, to subtract a specific number of ticks from the current date and time instance.

Consulte también:

Se aplica a