DateTimeOffset.AddHours(Double) Método

Definição

Espaço de Nomes:
System
Assemblagens:
mscorlib.dll, System.Runtime.dll
Assemblagens:
netstandard.dll, System.Runtime.dll
Assemblagem:
System.Runtime.dll
Assemblagem:
mscorlib.dll
Assemblagem:
netstandard.dll
Origem:
DateTimeOffset.cs
Origem:
DateTimeOffset.cs
Origem:
DateTimeOffset.cs
Origem:
DateTimeOffset.cs
Origem:
DateTimeOffset.cs

Devolve um novo DateTimeOffset objeto que adiciona um número especificado de horas inteiras e fracionárias ao valor desta instância.

public:
 DateTimeOffset AddHours(double hours);
public DateTimeOffset AddHours(double hours);
member this.AddHours : double -> DateTimeOffset
Public Function AddHours (hours As Double) As DateTimeOffset

Parâmetros

hours
Double

Um número de horas inteiras e fracionadas. O número pode ser negativo ou positivo.

Devoluções

DateTimeOffset

Um objeto cujo valor é a soma da data e hora representadas pelo objeto atual DateTimeOffset e o número de horas representado por hours.

Exceções

ArgumentOutOfRangeException

O valor resultante DateTimeOffset é inferior ao DateTimeOffset.MinValue.

-ou-

O valor resultante DateTimeOffset é superior ao DateTimeOffset.MaxValue.

Exemplos

O exemplo seguinte utiliza o AddHours método para listar os horários de início dos turnos de trabalho de uma determinada semana num escritório que tem dois turnos de oito horas por dia.

const int SHIFT_LENGTH = 8;

DateTimeOffset startTime = new DateTimeOffset(2007, 8, 6, 0, 0, 0,
                     DateTimeOffset.Now.Offset);
DateTimeOffset startOfShift = startTime.AddHours(SHIFT_LENGTH);

Console.WriteLine("Shifts for the week of {0:D}", startOfShift);
do
{
   // Exclude third shift
   if (startOfShift.Hour > 6)
      Console.WriteLine("   {0:d} at {0:T}", startOfShift);

   startOfShift = startOfShift.AddHours(SHIFT_LENGTH);
} while (startOfShift.DayOfWeek != DayOfWeek.Saturday &
           startOfShift.DayOfWeek != DayOfWeek.Sunday);
// The example produces the following output:
//
//    Shifts for the week of Monday, August 06, 2007
//       8/6/2007 at 8:00:00 AM
//       8/6/2007 at 4:00:00 PM
//       8/7/2007 at 8:00:00 AM
//       8/7/2007 at 4:00:00 PM
//       8/8/2007 at 8:00:00 AM
//       8/8/2007 at 4:00:00 PM
//       8/9/2007 at 8:00:00 AM
//       8/9/2007 at 4:00:00 PM
//       8/10/2007 at 8:00:00 AM
//       8/10/2007 at 4:00:00 PM

let shiftLength = 8

let startTime = DateTimeOffset(2007, 8, 6, 0, 0, 0, DateTimeOffset.Now.Offset)
let mutable startOfShift = startTime.AddHours shiftLength

printfn $"Shifts for the week of {startOfShift:D}"
while startOfShift.DayOfWeek <> DayOfWeek.Saturday &&
      startOfShift.DayOfWeek <> DayOfWeek.Sunday do
    // Exclude third shift
    if startOfShift.Hour > 6 then
        printfn $"   {startOfShift:d} at {startOfShift:T}"

    startOfShift <- startOfShift.AddHours shiftLength

// The example produces the following output:
//
//    Shifts for the week of Monday, August 06, 2007
//       8/6/2007 at 8:00:00 AM
//       8/6/2007 at 4:00:00 PM
//       8/7/2007 at 8:00:00 AM
//       8/7/2007 at 4:00:00 PM
//       8/8/2007 at 8:00:00 AM
//       8/8/2007 at 4:00:00 PM
//       8/9/2007 at 8:00:00 AM
//       8/9/2007 at 4:00:00 PM
//       8/10/2007 at 8:00:00 AM
//       8/10/2007 at 4:00:00 PM

Const SHIFT_LENGTH As Integer = 8

Dim startTime As New DateTimeOffset(#8/6/2007 12:00:00AM#, _
                     DateTimeOffset.Now.Offset)
Dim startOfShift As DateTimeOffset = startTime.AddHours(SHIFT_LENGTH)

Console.WriteLine("Shifts for the week of {0:D}", startOfShift)                           
Do 
   ' Exclude third shift
   If startOfShift.Hour > 6 Then _
      Console.WriteLine("   {0:d} at {0:T}", startOfShift)

   startOfShift = startOfShift.AddHours(SHIFT_LENGTH)
Loop While startOfShift.DayOfWeek <> DayOfWeek.Saturday And _
           startOfShift.DayOfWeek <> DayOfWeek.Sunday
          
' The example produces the following output:
'
'    Shifts for the week of Monday, August 06, 2007
'       8/6/2007 at 8:00:00 AM
'       8/6/2007 at 4:00:00 PM
'       8/7/2007 at 8:00:00 AM
'       8/7/2007 at 4:00:00 PM
'       8/8/2007 at 8:00:00 AM
'       8/8/2007 at 4:00:00 PM
'       8/9/2007 at 8:00:00 AM
'       8/9/2007 at 4:00:00 PM
'       8/10/2007 at 8:00:00 AM
'       8/10/2007 at 4:00:00 PM

Observações

A parte fracionária do hours parâmetro é a parte fracionária de uma hora. Por exemplo, 4,5 equivale a 4 horas, 30 minutos, 0 segundos, 0 milissegundos.

No .NET Framework, o parâmetro hours é arredondado para o milissegundo mais próximo. Nas versões .NET 7 e posteriores, é utilizada a precisão total Double do parâmetro hours. No entanto, devido à imprecisão inerente da matemática de ponto flutuante, a precisão resultante irá variar.

Note

Este método devolve um novo DateTimeOffset objeto. Não modifica o valor do objeto atual adicionando hours à sua data e hora.

Como um DateTimeOffset objeto não representa a data e a hora num fuso horário específico, o AddHours método não considera as regras de ajuste de um fuso horário específico ao realizar a aritmética de data e hora.

Converter intervalos de tempo inferiores a uma hora para uma fração pode implicar uma perda de precisão. (Por exemplo, um minuto equivale a 0,01666 de uma hora.) Se isto for problemático, pode usar o Add método, que permite especificar mais do que um tipo de intervalo de tempo numa única chamada de método e elimina a necessidade de converter intervalos de tempo em partes fracionárias de uma hora.

Aplica-se a

Ver também