Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Método DateTimeOffset.AddHours

Adiciona um número especificado de hora inteiras e fracionários ao objeto atual de DateTimeOffset .

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

public DateTimeOffset AddHours(
	double hours
)

Parâmetros

hours
Tipo: System.Double
Um número de horas inteiras e fracionários. O número pode ser positivo ou negativo.

Valor de retorno

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

ExceçãoCondição
ArgumentOutOfRangeException

O valor DateTimeOffset resultante é menor que MinValue.

- ou -

O valor DateTimeOffset resultante é maior que MaxValue.

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

ObservaçãoObservação

Este método retorna um novo objeto DateTimeOffset. Não altera o valor do objeto atual adicionando hours a suas data e hora.

Como um objeto de DateTimeOffset não representa a data e a hora em um fuso horário específico, o método de AddHours não considera regras de ajuste de um fuso horário de detalhes quando executa a aritmética de data e hora.

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

O exemplo a seguir usa o método de AddHours para listar as horas de início do turno de trabalho por uma semana específica 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                 


.NET Framework

Com suporte em: 4.5.2, 4.5.1, 4.5, 4, 3.5 SP1, 3.0 SP1, 2.0 SP1

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Biblioteca de Classes Portátil

Com suporte em: Biblioteca de Classes Portátil

.NET para aplicativos da Windows Store

Com suporte em: Windows 8

.NET para aplicativos do Windows Phone

Com suporte em: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Contribuições da comunidade

ADICIONAR
A Microsoft está realizando uma pesquisa online para saber sua opinião sobre o site do MSDN. Se você optar por participar, a pesquisa online lhe será apresentada quando você sair do site do MSDN.

Deseja participar?
Mostrar:
© 2014 Microsoft