DateTime.Subtract Método

  • Referência

Definição

Namespace:
System
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Retorna o valor resultante da subtração do tempo especificado ou da duração do valor dessa instância.

Sobrecargas

Subtract(TimeSpan)

Retorna um novo DateTime que subtrai a duração especificada do valor dessa instância.
Subtract(DateTime)

Retorna um novo TimeSpan que subtrai a data e hora especificados do valor dessa instância.

Subtract(TimeSpan)

Origem:
DateTime.cs
Origem:
DateTime.cs
Origem:
DateTime.cs

Retorna um novo DateTime que subtrai a duração especificada do valor dessa instância.

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

O intervalo de tempo a ser subtraído.

Retornos

DateTime

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

Exceções

ArgumentOutOfRangeException

O resultado é menor que DateTime.MinValue ou maior que DateTime.MaxValue.

Exemplos

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

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)

Comentários

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

Este método não altera o valor desse DateTime. Em vez disso, ele retorna um novo DateTime cujo valor é o resultado dessa operação.

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

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

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

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

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

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

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

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

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

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

Confira também

Aplica-se a

Subtract(DateTime)

Origem:
DateTime.cs
Origem:
DateTime.cs
Origem:
DateTime.cs

Retorna um novo TimeSpan que subtrai a data e hora especificados do valor dessa instância.

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

O valor de data e hora a ser subtraído.

Retornos

TimeSpan

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

Exceções

ArgumentOutOfRangeException

O resultado é menor que DateTime.MinValue ou maior que DateTime.MaxValue.

Exemplos

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

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)

Comentários

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

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

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

Observação

O DateTimeOffset.Subtract(DateTimeOffset) método considera a diferença entre fusos horários ao executar a subtração.

Confira também

Aplica-se a