AddHours Método (Double)
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.AddHours (Double)

 

Retorna um novo DateTimeOffset objeto que adiciona um número especificado de horas total e parcial para o valor desta instância.

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

public DateTimeOffset AddHours(
	double hours
)

Parâmetros

hours

Um número de horas de total e parcial.O número pode ser positivo ou negativo.

Valor de retorno

Type: System.DateTimeOffset

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

Exception Condition
ArgumentOutOfRangeException

Resultante DateTimeOffset valor é menor que MinValue.

- ou -

Resultante DateTimeOffset valor é maior que MaxValue.

A parte fracionária do hours parâmetro é a parte fracionária de uma hora.Por exemplo, 4.5 é equivalente a 4 horas, 30 minutos, 0 segundos, 0 milissegundos.O hours parâmetro será arredondado para o milissegundo mais próximo.

System_CAPS_noteObservação

Esse método retorna um novo DateTimeOffset objeto.Ele não modifica o valor do objeto atual adicionando hours data e hora.

Porque um DateTimeOffset objeto não representa a data e hora em um fuso horário específico, o AddHours método não considera as regras de ajuste de um determinado fuso horário quando ele executa data e hora.

Conversão de intervalos de tempo de menos de uma hora como uma fração pode envolver uma perda de precisão.(Por exemplo, um minuto é 0,01666 de uma hora). Se isso é problemático, você pode usar o Add método, que permite especificar mais de um tipo de intervalo de tempo em uma única chamada de método e elimina a necessidade de converter os intervalos de tempo em partes fracionárias de uma hora.

O exemplo a seguir usa o AddHours método para listar as horas de início do trabalho muda para uma determinada semana em um 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                 

Universal Windows Platform
Disponível desde 4.5
.NET Framework
Disponível desde 2.0
Portable Class Library
Com suporte em: portable .NET platforms
Silverlight
Disponível desde 2.0
Windows Phone Silverlight
Disponível desde 7.0
Windows Phone
Disponível desde 8.1
Retornar ao topo
Mostrar:
© 2016 Microsoft