DateAndTime.TimeSerial(Int32, Int32, Int32) Metodo

Definizione

Spazio dei nomi:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Source:

DateAndTime.vb

Restituisce un valore Date che rappresenta l'ora, i minuti e i secondi specificati, con le informazioni sulla data impostate rispetto all'1 gennaio dell'anno 1.

public:
 static DateTime TimeSerial(int Hour, int Minute, int Second);

public static DateTime TimeSerial (int Hour, int Minute, int Second);

static member TimeSerial : int * int * int -> DateTime

Public Function TimeSerial (Hour As Integer, Minute As Integer, Second As Integer) As DateTime

Parametri

Hour

Int32

Obbligatorio. Espressione Integer compresa tra 0 e 23. Vengono tuttavia accettati anche valori non compresi in questo intervallo.

Minute

Int32

Obbligatorio. Espressione Integer compresa tra 0 e 59. Vengono tuttavia accettati anche valori non compresi in questo intervallo. Il valore di Minute viene aggiunto all'ora calcolata, quindi un valore negativo specifica i minuti prima di tale ora.

Second

Int32

Obbligatorio. Espressione Integer compresa tra 0 e 59. Vengono tuttavia accettati anche valori non compresi in questo intervallo. Il valore di Second viene aggiunto al minuto calcolato, quindi un valore negativo specifica i secondi prima di tale minuto.

Restituisce

DateTime

Valore Date che rappresenta l'ora, i minuti e i secondi specificati, con le informazioni sulla data impostate rispetto all'1 gennaio dell'anno 1.

Eccezioni

ArgumentException

L'argomento non è compreso nell'intervallo tra -2.147.483.648 e 2.147.483.647.

ArgumentOutOfRangeException

L'ora calcolata è minore dei numeri negativi corrispondenti a 24 ore.

Esempio

Nell'esempio seguente viene utilizzata la TimeSerial funzione per restituire un'ora per l'ora, il minuto e il secondo specificati.

Dim thisTime As Date
thisTime = TimeSerial(16, 35, 17)

Commenti

Nell'esempio seguente vengono illustrati i valori degli argomenti negativi, zero e positivi. La TimeSerial funzione restituisce un'ora che rappresenta 15 minuti prima di tre ore prima di mezzogiorno o 8:45:00.

Dim alarmTime As Date = TimeSerial(12 - 3, -15, 0)  

Se uno Minute o Second supera il relativo intervallo normale, viene applicato all'unità più grande successiva in base alle esigenze. Ad esempio, se si specificano 75 minuti, viene valutato come un'ora e 15 minuti.

TimeSerial riduce il numero totale di secondi modulo 86.400, ovvero il numero di secondi in un giorno. Pertanto, il tempo restituito è sempre compreso tra 00:00:00 e 23:59:59.

Il Date tipo di dati include i componenti di data. TimeSerial imposta tutti questi valori su 1, quindi il valore restituito rappresenta il primo giorno dell'anno 1. Tuttavia, se i valori degli argomenti determinano il superamento del tempo calcolato di 24 ore, il giorno viene incrementato in base alle esigenze. Nell'esempio seguente i valori di Hour e Minute generano un tempo combinato di più di 24 ore.

MsgBox(TimeSerial(23, 75, 0))   
' The preceding statement displays "1/2/0001 12:15:00 AM".  

Se i valori degli argomenti comportano un'ora calcolata negativa, le informazioni sulla data vengono impostate su 1/1/0001 e le informazioni sull'ora vengono modificate in modo che siano comprese tra 00:00:00 e 23:59:59. Tuttavia, se il tempo calcolato è inferiore a 24 ore negative, si verifica un ArgumentOutOfRangeException errore.

Poiché ogni Date valore è supportato da una System.DateTime struttura, i relativi metodi offrono opzioni aggiuntive per assemblare un Date valore. Ad esempio, è possibile usare uno dei costruttori di DateTime overload per popolare una Date variabile usando la combinazione desiderata di componenti. L'esempio seguente imposta newDateTime su 6 maggio 1978 un decimo di secondo prima delle 8:30 del mattino:

Dim newDateTime As Date = New Date(1978, 5, 6, 8, 29, 59, 900)  

Vedi anche

• DateSerial(Int32, Int32, Int32)
• DateValue(String)
• Hour(DateTime)
• Minute(DateTime)
• Now
• Second(DateTime)
• TimeValue(String)