Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Método DateTimeOffset.Subtract (TimeSpan)

 

Subtrai um intervalo de tempo especificado do objeto DateTimeOffset atual.

Namespace:   System
Assembly:  mscorlib (em mscorlib.dll)

public DateTimeOffset Subtract(
	TimeSpan value
)

Parâmetros

value
Type: System.TimeSpan

O intervalo de tempo a ser subtraído.

Valor Retornado

Type: System.DateTimeOffset

Um objeto igual à data e hora representadas pelo objeto DateTimeOffset atual, menos o intervalo de tempo representado por value.

Exception Condition
ArgumentOutOfRangeException

O valor DateTimeOffset resultante é menor que MinValue.

-ou-

O valor DateTimeOffset resultante é maior que MaxValue.

You can use the M:System.DateTimeOffset.Subtract(System.TimeSpan) method to subtract more than one kind of time interval (days, hours, minutes, seconds, or milliseconds) in a single operation. Its behavior is identical to the M:System.DateTimeOffset.op_Subtraction(System.DateTimeOffset,System.TimeSpan) method, which defines the subtraction operator. The T:System.DateTimeOffset structure also supports specialized addition methods (such as M:System.DateTimeOffset.AddDays(System.Double), M:System.DateTimeOffset.AddHours(System.Double), and M:System.DateTimeOffset.AddMinutes(System.Double)) that allow you to perform subtraction by assigning a negative value to the method parameter.

System_CAPS_noteObservação

This method returns a new T:System.DateTimeOffset object. It does not modify the value of the current object by adding timeSpan to its date and time.

The M:System.DateTimeOffset.Subtract(System.TimeSpan) method does not affect the value of the T:System.DateTimeOffset object's P:System.DateTimeOffset.Offset property. The returned T:System.DateTimeOffset object has the same offset as the original object.

Because the current T:System.DateTimeOffset object does not represent the date and time in a specific time zone, the M:System.DateTimeOffset.Subtract(System.TimeSpan) method does not consider a particular time zone's adjustment rules when it performs the subtraction.

The following example illustrates subtraction that uses the M:System.DateTimeOffset.Subtract(System.TimeSpan) method.

DateTimeOffset offsetDate = new DateTimeOffset(2007, 12, 3, 11, 30, 0, 
                               new TimeSpan(-8, 0, 0)); 
TimeSpan duration = new TimeSpan(7, 18, 0, 0);
Console.WriteLine(offsetDate.Subtract(duration).ToString());  // Displays 11/25/2007 5:30:00 PM -08:00

Plataforma Universal do Windows
Disponível desde 8
.NET Framework
Disponível desde 2.0
Biblioteca de Classes Portátil
Com suporte no: plataformas portáteis do .NET
Silverlight
Disponível desde 2.0
Windows Phone Silverlight
Disponível desde 7.0
Windows Phone
Disponível desde 8.1
Retornar ao início
Mostrar: