DateAndTime.TimeSerial(Int32, Int32, Int32) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 -> DateTimePublic Function TimeSerial (Hour As Integer, Minute As Integer, Second As Integer) As DateTimeParametri
- 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
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
L'argomento non è compreso nell'intervallo tra -2.147.483.648 e 2.147.483.647.
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)
