Restituisce un valore Variant (Date) che contiene l'orario per l'ora, il minuto e il secondo specificati.
Sintassi
TimeSerial ( ora; minuto; secondo )
Avviso Verificare che gli argomenti si trovino nell'intervallo di valori corretto. Un argomento non valido può generare un risultato non corretto.
Gli argomenti della sintassi della funzione TimeSerial sono i seguenti:
Argomento |
Descrizione |
ora |
Obbligatorio. Variant (Integer). Numero compreso tra 0 (12:00) e 23 (23:00), inclusi, o un espressione numerica. |
minuto |
Obbligatorio. Variant (Integer). Qualsiasi espressione numerica. |
Secondo |
Obbligatorio. Variant (Integer). Qualsiasi espressione numerica. |
Osservazioni
Per specificare un'ora, ad esempio 11:59:59, l'intervallo di numeri per ogni argomento TimeSerial deve essere nell'intervallo normale per l'unità. ovvero 0-23 per le ore e 0-59 per minuti e secondi. Tuttavia, è anche possibile specificare le ore relative per ogni argomento usando qualsiasi espressione numerica che rappresenta un certo numero di ore, minuti o secondi prima o dopo un determinato periodo di tempo. Nell'esempio seguente vengono utilizzate espressioni anziché numeri di ora assoluti. La funzione TimeSerial restituisce un tempo di 15 minuti prima di (-15) sei ore prima di mezzogiorno (12 - 6) o delle 5:45:00.
TimeSerial(12 - 6, -15, 0)
Quando qualsiasi argomento supera l'intervallo normale per tale argomento, viene incrementato all'unità successiva più grande nel modo appropriato. Ad esempio, se si specificano 75 minuti, la valutazione viene valutate come un'ora e 15 minuti. Se un singolo argomento non è compreso nell'intervallo -32.768-32.767, si verifica un errore. Se l'ora specificata dai tre argomenti fa sì che la data non rientri nell'intervallo di date accettabile, si verifica un errore.
Esempio di query
Espressione |
Risultati |
SELECT TimeSerial(18,12,10) AS NewTime FROM ProductSales GROUP BY TimeSerial(18,12,10); |
Restituisce il valore "Time" costituito da un'ora, un minuto e un secondo specificati immessi negli argomenti della funzione e visualizzati nella colonna NewTime. Risultato: "18:12:10". |
Esempio di VBA
Nota: Gli esempi seguenti illustrano l'uso di questa funzione in un modulo di Visual Basic, Applications Edition (VBA). Per altre informazioni sull'uso di VBA, selezionare Riferimenti per sviluppatori nell'elenco a discesa accanto a Cerca e immettere uno o più termini nella casella di ricerca.
Questo esempio usa la funzione TimeSerial per restituire un'ora, un minuto e un secondo specificati.
Dim MyTime
MyTime = TimeSerial(16, 35, 17) ' MyTime contains serial representation of 4:35:17 PM.