Restituisce un valore Variant (Date) per un anno, un mese e un giorno specificati.
Sintassi
DateSerial ( anno, mese, giorno )
Avviso Verificare che gli argomenti si trovino nell'intervallo di valori corretto. Un argomento non valido può generare un risultato non corretto.
La sintassi della funzione DateSerial ha gli argomenti seguenti:
|
Argomento |
Descrizione |
|
anno |
Obbligatorio. Integer. Numero compreso tra 100 e 9999 inclusi oppure espressione numerica. |
|
mese |
Obbligatorio. Integer. Qualsiasi espressione numerica. |
|
giorno |
Obbligatorio. Integer. Qualsiasi espressione numerica. |
Osservazioni
Per specificare una data, ad esempio il 31 dicembre 1991, l'intervallo di numeri per ogni argomento di DateSerial deve essere incluso nell'intervallo accettato per l'unità, ovvero 1-31 per i giorni e 1-12 per i mesi. Tuttavia, è anche possibile specificare date relative per ogni argomento usando qualsiasi espressione numerica che rappresenta un certo numero di giorni, mesi o anni prima o dopo una data specifica.
L'esempio seguente usa espressioni numeriche invece di numeri di data assoluti. Qui la funzione DateSerial restituisce una data che corrisponde al giorno prima del primo giorno (1 - 1), due mesi prima di agosto (8 - 2) e 10 anni prima del 1990 (1990 - 10), ovvero il 31 maggio 1980.
DateSerial(1990 - 10, 8 - 2, 1 - 1)
Gli anni a due cifre per l'argomento anno vengono interpretati in base alle impostazioni del computer definite dall'utente. Per impostazione predefinita, i valori compresi tra 0 e 29 inclusi vengono interpretati come gli anni 2000-2029. I valori predefiniti compresi tra 30 e 99 vengono interpretati come gli anni 1930-1999. Per tutti gli altri valori dell'argomento anno, usare un anno a quattro cifre, ad esempio 1800.
Le versioni di Windows precedenti a Windows 2000 interpretano gli anni a due cifre in base alle impostazioni predefinite descritte sopra. Per assicurarsi che la funzione restituisca il valore corretto, usare un anno a quattro cifre.
Quando qualsiasi argomento supera l'intervallo accettato per l'argomento, il valore viene incrementato alla successiva unità maggiore nel modo appropriato. Specificando, ad esempio, 35 giorni, il valore restituisce un mese e un certo numero di giorni, a seconda del momento dell'anno in cui viene applicato. Se un singolo argomento non è compreso nell'intervallo -32.768-32.767, si verifica un errore. Se la data specificata dai tre argomenti non è compresa nell'intervallo accettabile di date, si verifica un errore.
Nota: Se per anno, mesee giorno la proprietà Calendario è impostata su Gregoriano, si presuppone che il valore specificato sia basato sul calendario gregoriano. Se la proprietà Calendario è impostata su Hijri, si presuppone che il valore specificato sia basato sul calendario Hijri.
La parte di data restituita corrisponde alle unità del periodo di tempo del calendario di Visual Basic corrente. Ad esempio, se il calendario corrente è Hijri e la parte di data da restituire è l'anno, il valore dell'anno è un anno Hijri. Per l'argomento anno, i valori compresi tra 0 e 99 inclusi vengono interpretati come gli anni 1400-1499. Per tutti gli altri valori dell'argomento anno, usare l'anno a quattro cifre completo, ad esempio 1520.
Esempio di query
|
Espressione |
Risultati |
|
SELECT Dateserial(2018,12,13) AS NewDate FROM ProductSales; |
Restituisce la "data" per l'anno, il mese e il giorno specificati immessi negli argomenti della funzione e viene visualizzata nella colonna "NewDate". Risultato: "12/13/2018". |
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 DateSerial per restituire la data per l'anno, il mese e il giorno specifici.
Dim MyDate ' MyDate contains the date for February 12, 1969. MyDate = DateSerial(1969, 2, 12) ' Return a date.
