Funzione DatePart

Restituisce un valore Variant (Integer) contenente la parte specificata di una determinata data.

Avviso Si è verificato un problema con l'uso di questa funzione. L'ultimo lunedì di alcuni anni di calendario può essere restituito come settimana 53 quando dovrebbe essere la settimana 1. Per altre informazioni e una soluzione alternativa, vedere Le funzioni Format o DatePart possono restituire un numero errato della settimana per il lunedì scorso in anno.

Sintassi

DatePart(intervallo, data [, primogiornosettimana] [, primasettimanaanno] )

Gli argomenti della sintassi della funzione DatePart sono i seguenti:

Argomento	Descrizione
intervallo	Obbligatorio. Espressione stringa che rappresenta l'intervallo di tempo da restituire.
Data	Obbligatorio. Valore Variant (Date) da valutare.
primogiornosett	Facoltativo. Costante che specifica il primo giorno della settimana. Se non è specificato, viene usato il valore Sunday.
primasettanno	Facoltativo. Costante che specifica la prima settimana dell'anno. Se non è specificato, verrà considerata come prima settimana quella in cui cade l'1 gennaio.

Impostazioni

L'argomento intervallo ha queste impostazioni:

Impostazione	Descrizione
yyyy	Anno
q	Trimestre
m	Mese
y	Giorno dell'anno
d	Giorno
w	Giorno della settimana
ww	Settimana
h	Ora
n	Minuto
s	Secondo

L'argomento primogiornosettimana ha le impostazioni seguenti:

Costante	valore	Descrizione
vbUseSystem	0	Viene usata l'impostazione di NLS API.
vbSunday	1	Domenica (impostazione predefinita)
vbMonday	2	Lunedì
vbTuesday	3	Martedì
vbWednesday	4	Mercoledì
vbThursday	5	Giovedì
vbFriday	6	Venerdì
vbSaturday	7	Sabato

L'argomento primasettimanaanno ha le impostazioni seguenti:

Costante	valore	Descrizione
vbUseSystem	0	Viene usata l'impostazione di NLS API.
vbFirstJan1	1	La prima settimana è quella in cui cade l'1 gennaio (impostazione predefinita).
vbFirstFourDays	2	La prima settimana corrisponde alla prima che contiene almeno quattro giorni nel nuovo anno.
vbFirstFullWeek	3	La prima settimana corrisponde alla prima settimana completa dell'anno.

Osservazioni

È possibile usare la funzione DatePart per valutare una data e restituire un intervallo di tempo specifico. Ad esempio, è possibile usare DatePart per calcolare il giorno della settimana o l'ora corrente.

L'argomento primogiornosettimana influisce sui calcoli che usano i simboli di intervallo "w" e "ww".

Se data è un valore letterale di data, l'anno specificato diventa una parte permanente di tale data. Tuttavia, se la data è racchiusa tra virgolette doppie (" ") e si omette l'anno, l'anno corrente viene inserito nel codice ogni volta che viene valutata l'espressione di data . Questo permette di scrivere codice da usare per anni diversi.

La parte data restituita si trova nelle unità del periodo di tempo del calendario arabo corrente. Ad esempio, se il calendario corrente è Hijri e la parte di data da restituire è l'anno, il valore dell'anno è un anno Hijri.

Esempi di query

Espressione	Risultati
SELECT DatePart("yyyy",[DateofSale]) AS NewDate FROM ProductSales;	Restituisce 'Anno' dei valori di data del campo "DateofSale".
SELECT DatePart("q",[DateofSale]) AS NewDate FROM ProductSales;	Restituisce il 'Trimestre' (in base all'anno del calendario) dei valori di data del campo "DateofSale".
SELECT DatePart("y",[DateofSale]) AS NewDate FROM ProductSales;	Restituisce il valore 'Giorno dell'anno' (da 1 a 365) dei valori di data del campo "DateofSale".
SELECT DatePart("d",[DateofSale]) AS NewDate FROM ProductSales;	Restituisce il 'Giorno' dei valori di data del campo "DateofSale".
SELECT DatePart("w",[DateofSale]) AS NewDate FROM ProductSales;	Restituisce il 'giorno feriale' (da 1 a 7, dove 1 rappresenta domenica) dei valori di data del campo "DateofSale".
SELECT DatePart("ww",[DateofSale]) AS NewDate FROM ProductSales;	Restituisce il numero della settimana (da 1 a 52) dei valori di data del campo "DateofSale".
SELECT DatePart("h",[DateTime]) AS NewDate FROM ProductSales;	Restituisce 'Ora' dei valori di data del campo "DateTime".
SELECT DatePart("n",[DateTime]) AS NewDate FROM ProductSales;	Restituisce i 'Minuti' dei valori di data del campo "DateTime".
SELECT DatePart("s",[DateTime]) AS NewDate FROM ProductSales;	Restituisce i 'secondi' dei valori di data del campo "DateTime".

Esempio di VBA

Questo esempio accetta una data e, usando la funzione DatePart , visualizza il trimestre dell'anno in cui si verifica.

Dim TheDate As Date    ' Declare variables.
Dim Msg    
TheDate = InputBox("Enter a date:")
Msg = "Quarter: " & DatePart("q", TheDate)
MsgBox Msg

Scegliere la funzione di data corretta