DatePart
Restituisce la parte specificata di una data data.
Struttura
DatePart(intervallo, data[, primo giorno della settimana[, prima settimana dell'anno]])
Parametri
intervallo - obbligatorio. Espressione stringa che rappresenta l'intervallo di tempo che si desidera restituire. Per i valori, consultare la sezione Impostazioni.
data - obbligatorio. Espressione dataria che si desidera valutare.
primo giorno della settimana - facoltativo. Costante che indica il giorno della settimana. Se non diversamente specificato, si presume che sia domenica. Per i valori, consultare la sezione Impostazioni.
prima settimana dell'anno - facoltativo. Costante che indica la prima settimana dell'anno. Se non diversamente specificato, si presume che la prima settimana sia quella in cui cade il 1° gennaio.
Valori dei parametri
L'argomento «intervallo» può assumere i seguenti valori:
Descrizione dell'impostazione
aaaa Anno
q Trimestre
m Mese
Giorno dell'anno
Il giorno D
w Giorni feriali
Settimana dell'anno
h Ora
n minuti
il secondo
L'argomento firstdayofweek può assumere i seguenti valori:
Descrizione del valore costante
vbUseSystemDayOfWeek 0 Impostazione dell'API NLS (National Language Support).
vbDomenica 1 Domenica (impostazione predefinita)
vbLunedì 2 Lunedì
vbMartedì 3 martedì
Mercoledì 4
vbGiovedì 5 Giovedì
vbVenerdì 6 Venerdì
sabato 7
L'argomento "firstweekofyear" può assumere i seguenti valori:
Descrizione del valore costante
vbUseSystem 0 Impostazione per l'utilizzo dell'API NLS (National Language Support).
vbFirstJan1 1 Inizia dalla settimana in cui cade il 1° gennaio (impostazione predefinita).
vbFirstFourDays 2 Inizia con la settimana che conta almeno quattro giorni nel nuovo anno.
vbFirstFullWeek 3 Inizia con la prima settimana completa del nuovo anno.
Descrizione
È possibile utilizzare la funzione DatePart per analizzare una data e restituire un intervallo di tempo specifico. Ad esempio, potresti usare DatePart per calcolare il giorno della settimana o l'ora corrente.
L'argomento "firstdayofweek" influisce sui calcoli che utilizzano i simboli di intervallo "w" e "ww".
Se «date» è un valore letterale di data, l'anno specificato diventa parte integrante di tale data. Tuttavia, se la data è racchiusa tra virgolette (' ') e si omette l'anno, ogni volta che l'espressione della data viene valutata nel codice viene inserito l'anno corrente. Ciò consente di scrivere codice che può essere riutilizzato negli anni successivi.
Esempio
Questo esempio prende una data e, utilizzando la funzione DatePart, visualizza il trimestre dell'anno in cui essa ricade.
Funzione GetQuarter(TheDate)
GetQuarter = DatePart("q", TheDate)
End Function. |