DateTimeOffset.Subtraction Operador

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Subtrai um objeto DateTimeOffset ou TimeSpan especificado de um objeto DateTimeOffset.

Sobrecargas

Subtraction(DateTimeOffset, DateTimeOffset)	Subtrai um objeto DateTimeOffset do outro e produz um intervalo de tempo.
Subtraction(DateTimeOffset, TimeSpan)	Subtrai um intervalo de tempo especificado de uma data e hora especificada e gera uma nova data e hora.

Subtraction(DateTimeOffset, DateTimeOffset)

Origem:

DateTimeOffset.cs

Subtrai um objeto DateTimeOffset do outro e produz um intervalo de tempo.

public:
 static TimeSpan operator -(DateTimeOffset left, DateTimeOffset right);

public static TimeSpan operator - (DateTimeOffset left, DateTimeOffset right);

static member ( - ) : DateTimeOffset * DateTimeOffset -> TimeSpan

Public Shared Operator - (left As DateTimeOffset, right As DateTimeOffset) As TimeSpan

Parâmetros

left

DateTimeOffset

O minuendo.

right

DateTimeOffset

O subtraendo.

Retornos

TimeSpan

Um objeto que representa a diferença entre left e right.

Comentários

O Subtraction método define a operação de subtração para DateTimeOffset objetos . Ele permite que o código seja o seguinte:

DateTimeOffset firstDate = new DateTimeOffset(2008, 3, 25, 18, 0, 0,
                                              new TimeSpan(-7, 0, 0));
DateTimeOffset secondDate = new DateTimeOffset(2008, 3, 25, 18, 0, 0,
                                               new TimeSpan(-5, 0, 0));
DateTimeOffset thirdDate = new DateTimeOffset(2008, 2, 28, 9, 0, 0,
                                              new TimeSpan(-7, 0, 0));
TimeSpan difference;

difference = firstDate - secondDate;
Console.WriteLine("({0}) - ({1}): {2} days, {3}:{4:d2}",
                  firstDate.ToString(),
                  secondDate.ToString(),
                  difference.Days,
                  difference.Hours,
                  difference.Minutes);

difference = firstDate - thirdDate;
Console.WriteLine("({0}) - ({1}): {2} days, {3}:{4:d2}",
                  firstDate.ToString(),
                  secondDate.ToString(),
                  difference.Days,
                  difference.Hours,
                  difference.Minutes);
// The example produces the following output:
//    (3/25/2008 6:00:00 PM -07:00) - (3/25/2008 6:00:00 PM -05:00): 0 days, 2:00
//    (3/25/2008 6:00:00 PM -07:00) - (3/25/2008 6:00:00 PM -05:00): 26 days, 9:00

let firstDate =
    DateTimeOffset(2008, 3, 25, 18, 0, 0, TimeSpan(-7, 0, 0))

let secondDate =
    DateTimeOffset(2008, 3, 25, 18, 0, 0, TimeSpan(-5, 0, 0))

let thirdDate =
    DateTimeOffset(2008, 2, 28, 9, 0, 0, TimeSpan(-7, 0, 0))

let difference = firstDate - secondDate
printfn $"({firstDate}) - ({secondDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}"

let difference = firstDate - thirdDate
printfn $"({firstDate}) - ({secondDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}"
// The example produces the following output:
//    (3/25/2008 6:00:00 PM -07:00) - (3/25/2008 6:00:00 PM -05:00): 0 days, 2:00
//    (3/25/2008 6:00:00 PM -07:00) - (3/25/2008 6:00:00 PM -05:00): 26 days, 9:00

Dim firstDate As New DateTimeOffset(#3/25/2008 6:00PM#, _
                                    New TimeSpan(-7, 0, 0))
Dim secondDate As New DateTimeOffset(#3/25/2008 6:00PM#, _
                                     New TimeSpan(-5, 0, 0))
Dim thirdDate As New DateTimeOffset(#2/28/2008 9:00AM#, _
                                    New TimeSpan(-7, 0, 0))
Dim difference As TimeSpan

difference = firstDate - secondDate
Console.WriteLine("({0}) - ({1}): {2} days, {3}:{4:d2}", _
                  firstDate.ToString(), _
                  secondDate.ToString(), _
                  difference.Days, _
                  difference.Hours, _
                  difference.Minutes)      
difference = firstDate - thirdDate
Console.WriteLine("({0}) - ({1}): {2} days, {3}:{4:d2}", _
                  firstDate.ToString(), _
                  secondDate.ToString(), _
                  difference.Days, _
                  difference.Hours, _
                  difference.Minutes) 
' The example produces the following output:
'    (3/25/2008 6:00:00 PM -07:00) - (3/25/2008 6:00:00 PM -05:00): 0 days, 2:00
'    (3/25/2008 6:00:00 PM -07:00) - (3/25/2008 6:00:00 PM -05:00): 26 days, 9:00

Idiomas que não dão suporte a operadores personalizados e sobrecarga de operador podem chamar o DateTimeOffset.Subtract(DateTimeOffset) método.

O método equivalente para esse operador é DateTimeOffset.Subtract(TimeSpan).

Confira também

• Subtract(DateTimeOffset)
• Executando operações aritméticas com datas e horas

Subtraction(DateTimeOffset, TimeSpan)

Origem:

DateTimeOffset.cs

Subtrai um intervalo de tempo especificado de uma data e hora especificada e gera uma nova data e hora.

public:
 static DateTimeOffset operator -(DateTimeOffset dateTimeOffset, TimeSpan timeSpan);

public static DateTimeOffset operator - (DateTimeOffset dateTimeOffset, TimeSpan timeSpan);

static member ( - ) : DateTimeOffset * TimeSpan -> DateTimeOffset

Public Shared Operator - (dateTimeOffset As DateTimeOffset, timeSpan As TimeSpan) As DateTimeOffset

Parâmetros

dateTimeOffset

DateTimeOffset

O objeto de data e hora para subtração.

timeSpan

TimeSpan

O intervalo de tempo a ser subtraído.

Retornos

DateTimeOffset

Um objeto que é igual ao valor de dateTimeOffset menos timeSpan.

Exceções

ArgumentOutOfRangeException

O valor resultante DateTimeOffset é menor que DateTimeOffset.MinValue ou maior que DateTimeOffset.MaxValue.

Comentários

O Subtraction método define a operação de subtração para DateTimeOffset objetos . Ele permite que o código seja o seguinte:

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 - duration);  // Displays 11/25/2007 5:30:00 PM -08:00

let offsetDate =
    DateTimeOffset(2007, 12, 3, 11, 30, 0, TimeSpan(-8, 0, 0))

let duration = TimeSpan(7, 18, 0, 0)
printfn $"{offsetDate - duration}" // Displays 11/25/2007 5:30:00 PM -08:00

Dim offsetDate As New DateTimeOffset(#12/3/2007 11:30AM#, _
                               New TimeSpan(-8, 0, 0)) 
Dim duration As New TimeSpan(7, 18, 0, 0)
Console.WriteLine(offsetDate - duration)    ' Displays 11/25/2007 5:30:00 PM -08:00

Idiomas que não dão suporte a operadores personalizados e sobrecarga de operador podem chamar o DateTimeOffset.Subtract(TimeSpan) método.

O método equivalente para esse operador é DateTimeOffset.Subtract(TimeSpan).

Confira também

• Subtract(TimeSpan)
• Executando operações aritméticas com datas e horas