Metodo DateTimeOffset.AddHours

La parte frazionaria del parametro hours è la parte frazionaria di un'ora. Ad esempio, 4,5 equivale a 4 ore, 30 minuti, 0 secondi e 0 millisecondi. Il parametro hours viene arrotondato al millisecondo più vicino.

Nota
Questo metodo restituisce un nuovo oggetto DateTimeOffset. Non modifica il valore dell'oggetto corrente aggiungendo l'oggetto hours alla data e all'ora.

Poiché un oggetto DateTimeOffset non rappresenta la data e l'ora in un fuso orario specifico, il metodo AddHours non prende in considerazione le regole di rettifica di un particolare fuso orario quando esegue operazioni aritmetiche con date e ore.

La conversione in frazione di intervalli di tempo inferiori a un'ora può comportare una perdita di precisione. Ad esempio, un minuto equivale a 0,01666 ore. Se tale situazione è problematica, è possibile utilizzare il metodo Add, che consente di specificare più tipi di intervalli di tempo in una sola chiamata di metodo ed elimina l'esigenza di convertire intervalli di tempo in parti frazionarie di un'ora.

Nell'esempio seguente viene utilizzato il metodo AddHours per elencare gli orari di inizio dei turni di lavoro per una particolare settimana in un ufficio nel quale si svolgono due turni di otto ore al giorno.

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

.NET Framework Client Profile

Libreria di classi portabile

.NET per applicazioni Windows Store

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

Riferimenti

Altre risorse