Esporta (0) Stampa
Espandi tutto
Il presente articolo è stato tradotto automaticamente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale. Ulteriori informazioni.
Traduzione
Originale

Metodo DateTimeOffset.AddHours

Aggiunge un numero specificato di ore intere e frazionarie all'oggetto DateTimeOffset corrente.

Spazio dei nomi:  System
Assembly:  mscorlib (in mscorlib.dll)

public DateTimeOffset AddHours(
	double hours
)

Parametri

hours
Tipo: System.Double
Numero di ore intere e frazionarie. Il numero può essere positivo o negativo.

Valore restituito

Tipo: System.DateTimeOffset
Oggetto il cui valore è la somma della data e dell'ora rappresentate dall'oggetto DateTimeOffset corrente e del numero di ore rappresentato da hours.

EccezioneCondizione
ArgumentOutOfRangeException

Il valore DateTimeOffset risultante è minore di MinValue.

- oppure -

Il valore DateTimeOffset risultante è maggiore di MaxValue.

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.

NotaNota

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

Supportato in: 4.5.2, 4.5.1, 4.5, 4, 3.5 SP1, 3.0 SP1, 2.0 SP1

.NET Framework Client Profile

Supportato in: 4, 3.5 SP1

Libreria di classi portabile

Supportato in: Libreria di classi portabile

.NET per applicazioni Windows Store

Supportato in: Windows 8

.NET per applicazioni Windows Phone

Supportato in: 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 (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)

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Aggiunte alla community

AGGIUNGI
Microsoft sta conducendo un sondaggio in linea per comprendere l'opinione degli utenti in merito al sito Web di MSDN. Se si sceglie di partecipare, quando si lascia il sito Web di MSDN verrà visualizzato il sondaggio in linea.

Si desidera partecipare?
Mostra:
© 2014 Microsoft