DateTime.Subtract Método

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

Devoluções

Um intervalo de tempo igual à data e hora representadas por esta instância menos a data e hora representadas por value.

Exceções

Exemplos

O exemplo seguinte demonstra o Subtract método e o operador de subtração.

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)

Observações

O Subtract(DateTime) método determina a diferença entre duas datas. Para subtrair um intervalo de tempo da instância atual, chama o Subtract(TimeSpan) método. Para subtrair um determinado intervalo de tempo da instância atual, chama-se o método que soma esse intervalo de tempo à data atual, e forneça um valor negativo como argumento do método. Por exemplo, para subtrair dois meses da data atual, chame o AddMonths(Int32) método com valor de -2.

Se a data e hora da instância atual forem anteriores a value, o método devolve um TimeSpan objeto que representa um período temporal negativo. Ou seja, o valor de todas as suas propriedades não nulas (como Days ou Ticks) é negativo.

O Subtract(DateTime) método não considera o valor da Kind propriedade dos dois DateTime valores ao realizar a subtração. Antes de subtrair DateTime objetos, certifique-se de que os objetos representam horários no mesmo fuso horário. Caso contrário, o resultado incluirá a diferença entre fusos horários.

Ver também

• Realização de Operações Aritméticas com Datas e Horas

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

Devoluções

Um objeto que é igual à data e hora representadas por esta instância menos o intervalo de tempo representado por value.

Exceções

Exemplos

O exemplo seguinte demonstra o Subtract método e o operador de subtração.

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)

Observações

O Subtract(TimeSpan) método devolve a data que é uma diferença de intervalo de tempo especificada em relação à instância atual. Para determinar o intervalo de tempo entre duas datas, chame o Subtract(DateTime) método. Para subtrair um determinado intervalo de tempo da instância atual, chama-se o método que soma esse intervalo de tempo à data atual, e forneça um valor negativo como argumento do método. Por exemplo, para subtrair dois meses da data atual, chame o AddMonths(Int32) método com valor de -2.

Este método não altera o valor deste DateTime. Em vez disso, devolve um novo DateTime cujo valor é o resultado desta operação.

Normalmente, o DateTime.Subtract(TimeSpan) método subtrai um TimeSpan objeto que representa um período de tempo positivo e devolve um DateTime valor anterior à data e hora da instância atual. No entanto, se o TimeSpan objeto representar um intervalo temporal negativo, o DateTime.Subtract(TimeSpan) método devolve um DateTime valor posterior à data e hora da instância atual.

O DateTime.Subtract(TimeSpan) método permite-lhe subtrair um intervalo de tempo que consiste em mais do que uma unidade de tempo (como um dado número de horas e um dado número de minutos). Para subtrair uma única unidade de tempo (como anos, meses ou dias) da DateTime instância, pode passar um valor numérico negativo como parâmetro a qualquer um dos seguintes métodos:

• AddYears, para subtrair um número específico de anos da instância atual de data e hora.

• AddMonths, para subtrair um número específico de meses da instância atual de data e hora.

• AddDays, para subtrair um número específico de dias da instância atual de data e hora.

• AddHours, para subtrair um número específico de horas da instância atual de data e hora.

• AddMinutes, para subtrair um número específico de minutos da instância atual de data e hora.

• AddSeconds, para subtrair um número específico de segundos da instância atual de data e hora.

• AddMilliseconds, para subtrair um número específico de milissegundos da instância atual de data e hora.

• AddTicks, para subtrair um número específico de ticks da instância atual de data e hora.

Ver também

• TimeSpan
• Realização de Operações Aritméticas com Datas e Horas