DateTime.Subtract Método

Definición

Devuelve el valor que es el resultado de restar el tiempo o la duración especificados del valor de esta instancia.

Sobrecargas

Subtract(DateTime)

Devuelve un nuevo objeto TimeSpan que resta la fecha y hora especificadas del valor de esta instancia.

Subtract(TimeSpan)

Devuelve un nuevo objeto DateTime que resta la duración especificada del valor de esta instancia.

Subtract(DateTime)

Devuelve un nuevo objeto TimeSpan que resta la fecha y hora especificadas del valor de esta instancia.

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.

Devoluciones

TimeSpan

Intervalo que es igual a la fecha y hora representadas por esta instancia menos la fecha y hora representadas por value.

Excepciones

El resultado es menor que DateTime.MinValue o mayor que DateTime.MaxValue.

Ejemplos

En el ejemplo siguiente se muestra el Subtract método y el operador de resta.

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)

Comentarios

El Subtract(DateTime) método determina la diferencia entre dos fechas. Para restar un intervalo de tiempo de la instancia actual, llame al Subtract(TimeSpan) método . 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 de método. Por ejemplo, para restar dos meses de la fecha actual, llame al AddMonths(Int32) método con un valor de -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. Es decir, el valor de todas sus propiedades que no son cero (como Days o Ticks) es negativo.

El Subtract(DateTime) método no tiene en cuenta el valor de la Kind propiedad de los dos DateTime valores al realizar la resta. Antes de restar DateTime objetos, asegúrese de que los objetos representan horas en la misma zona horaria. De lo contrario, el resultado incluirá la diferencia entre las zonas horarias.

Nota

El DateTimeOffset.Subtract(DateTimeOffset) método tiene en cuenta la diferencia entre las zonas horarias al realizar la resta.

Consulte también

Se aplica a

Subtract(TimeSpan)

Devuelve un nuevo objeto DateTime que resta la duración especificada del valor de esta instancia.

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.

Devoluciones

DateTime

Objeto que es igual a la fecha y hora representadas por esta instancia menos el intervalo de hora representados por value.

Excepciones

El resultado es menor que DateTime.MinValue o mayor que DateTime.MaxValue.

Ejemplos

En el ejemplo siguiente se muestra el Subtract método y el operador de resta.

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)

Comentarios

El Subtract(TimeSpan) método devuelve la fecha que es una diferencia de intervalo de tiempo especificada de la instancia actual. Para determinar el intervalo de tiempo entre dos fechas, llame al Subtract(DateTime) método . 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. Por ejemplo, para restar dos meses de la fecha actual, llame al AddMonths(Int32) método con un valor de -2.

Este método no cambia el valor de .DateTime En su lugar, devuelve un nuevo DateTime cuyo valor es el resultado de esta operación.

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

El DateTime.Subtract(TimeSpan) método 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). Para restar una sola unidad de tiempo (como años, meses o días) de la DateTime instancia, puede pasar un valor numérico negativo como parámetro a cualquiera de los métodos siguientes:

  • AddYears, para restar un número específico de años de la instancia de fecha y hora actual.

  • AddMonths, para restar un número específico de meses de la instancia de fecha y hora actual.

  • AddDays, para restar un número específico de días de la instancia de fecha y hora actual.

  • AddHours, para restar un número específico de horas de la instancia de fecha y hora actual.

  • AddMinutes, para restar un número específico de minutos de la instancia de fecha y hora actual.

  • AddSeconds, para restar un número específico de segundos de la instancia de fecha y hora actual.

  • AddMilliseconds, para restar un número específico de milisegundos de la instancia de fecha y hora actual.

  • AddTicks, para restar un número específico de tics de la instancia de fecha y hora actual.

Consulte también

Se aplica a