DateAndTime.TimeSerial(Int32, Int32, Int32) Metodo

Definizione

Spazio dei nomi:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

Restituisce un Date valore che rappresenta un'ora, un minuto e un secondo specificati, con le informazioni sulla data impostate relative 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

Required. Espressione integer da 0 a 23. Tuttavia, vengono accettati anche valori esterni a questo intervallo.

Minute
Int32

Required. Espressione integer da 0 a 59. Tuttavia, vengono accettati anche valori esterni a questo intervallo. Il valore di viene aggiunto all'ora calcolata, quindi un valore negativo specifica i minuti prima di Minute tale ora.

Second
Int32

Required. Espressione integer da 0 a 59. Tuttavia, vengono accettati anche valori esterni a questo intervallo. Il valore di viene aggiunto al minuto calcolato, quindi un valore negativo specifica i secondi prima di Second quel minuto.

Valori restituiti

DateTime

Valore Date che rappresenta un'ora, un minuto e un secondo specificati, con le informazioni sulla data impostate rispetto all'1 gennaio dell'anno 1.

Eccezioni

ArgumentException

Un argomento non rientra nell'intervallo compreso tra -2.147.483.648 e 2.147.483.647

ArgumentOutOfRangeException

Il tempo calcolato è inferiore a 24 ore negative.

Esempio

Nell'esempio seguente viene usata 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 negativi, zero e positivi degli argomenti. La TimeSerial funzione restituisce un'ora che rappresenta 15 minuti prima di tre ore prima di mezzogiorno o 8:45:00 AM.

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

Se o MinuteSecond supera l'intervallo normale, viene applicato all'unità più grande successiva in base alle esigenze. Ad esempio, se si specificano 75 minuti, la valutazione viene valutate 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 le 00:00:00 e le 23:59:59.

Il Date tipo di dati include componenti data. TimeSerial imposta tutti questi valori su 1, pertanto il valore restituito rappresenta il primo giorno dell'anno 1. Tuttavia, se i valori degli argomenti causano 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 comportano 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 è minore di 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 overload DateTime 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)

Si applica a

Vedi anche