Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo DateTimeOffset.AddHours (Double)

 

Data di pubblicazione: ottobre 2016

Restituisce un nuovo oggetto DateTimeOffset che aggiunge un numero specificato di ore intere e frazionarie al valore dell'istanza.

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

public DateTimeOffset AddHours(
	double hours
)

Parametri

hours
Type: System.Double

Un numero di ore intere e frazionarie. Il numero può essere positivo o negativo.

Valore restituito

Type: 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.

Exception Condition
ArgumentOutOfRangeException

Il valore DateTimeOffset risultante è minore di MinValue.

-oppure-

Il valore DateTimeOffset risultante è maggiore di MaxValue.

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

System_CAPS_noteNota

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

Poiché un DateTimeOffset oggetto non rappresenta la data e l'ora in un fuso orario specifico, il AddHours metodo non prende in considerazione le regole di rettifica del fuso orario specifico durante l'esecuzione di data e ora aritmetico.

La conversione di intervalli di tempo minore di un'ora in una frazione, può comportare una perdita di precisione. (Ad esempio, un minuto è 0,01666 ore) Se si verificano problemi, è possibile utilizzare il Add metodo, che consente di specificare più di un tipo di intervallo di tempo in una singola chiamata al metodo ed elimina la necessità di convertire gli intervalli di tempo in parti frazionarie di un'ora.

L'esempio seguente usa il AddHours sposta di metodo per elencare gli orari di inizio del lavoro per una determinata settimana in un ufficio con 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                 

Universal Windows Platform
Disponibile da 8
.NET Framework
Disponibile da 2.0
Libreria di classi portabile
Supportato in: piattaforme .NET portabili
Silverlight
Disponibile da 2.0
Windows Phone Silverlight
Disponibile da 7.0
Windows Phone
Disponibile da 8.1
Torna all'inizio
Mostra: