Restituisce un valore Variant (Date) che contiene l'orario per l'ora, il minuto e il secondo specificati.
Sintassi
TimeSerial(ora, minuti, secondi)
Avviso Verificare che gli argomenti siano compresi nell'intervallo di valori corretto. Un argomento non valido può restituire un risultato errato.
Gli argomenti della sintassi della funzione TimeSerial sono i seguenti:
| Argomento | Descrizione |
|---|---|
| ora | Obbligatorio. Variante (numero intero). Numero compreso tra 0 (12:00) e 23 (23:00) incluso o un'espressione numerica. |
| minuto | Obbligatorio. Variante (numero intero). Qualsiasi espressione numerica. |
| secondo | Obbligatorio. Variante (numero intero). 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 i minuti e i secondi. È tuttavia possibile anche specificare tempi relativi per ogni argomento usando qualsiasi espressione numerica che rappresenti un certo numero di ore, minuti o secondi prima o dopo un determinato periodo di tempo. Nell'esempio seguente vengono utilizzate le espressioni anziché i numeri temporali assoluti. La funzione TimeSerial restituisce un tempo di 15 minuti prima (-15) sei ore prima di mezzogiorno (12 - 6), o 5:45:00 A.M.
TimeSerial(12 - 6, -15, 0)
Quando un argomento supera l'intervallo normale per tale argomento, viene incrementato fino all'unità successiva più grande in base alle esigenze. Ad esempio, se si specifica 75 minuti, viene valutato 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 l'"ora" costituita da ore, minuti e secondi specificati immessi negli argomenti della funzione e viene visualizzato nella colonna NewTime. Risultato: "6:12:10 PM". |
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.
In questo esempio viene usata la funzione TimeSerial per restituire un'ora per l'ora, i minuti e i secondi specificati.
Dim MyTime
MyTime = TimeSerial(16, 35, 17)
' MyTime contains serial representation of 4:35:17 PM.