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ì in 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 di settimana errato per l'ultimo lunedì dell'anno.

Sintassi

DatePart(interval, date [, firstdayofweek] [, firstweekofyear] )

Gli argomenti della sintassi della funzione DatePart sono i seguenti:

Argomento	Descrizione
intervallo	Obbligatorio. Espressione stringa che rappresenta l'intervallo di tempo che si vuole restituire.
Data	Obbligatorio. Valore Variant (Date) che si desidera 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 include le impostazioni seguenti:

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 firstdayofweek include 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 firstweekofyear ha queste impostazioni:

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 firstdayofweek influisce sui calcoli che usano i simboli di intervallo "w" e "ww".

Se la data è un valore letterale di data, l'anno specificato diventa una parte permanente di tale data. Se invece 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 relativa alla data restituita è espressa 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("aaaa",[DateofSale]) AS NewDate FROM ProductSales;	Restituisce l'anno dei valori di data del campo "DateofSale".
SELECT DatePart("q",[DateofSale]) AS NewDate FROM ProductSales;	Restituisce il 'Trimestre' (in base all'anno di calendario) dei valori di data del campo "DateofSale".
SELECT DatePart("y",[DateofSale]) AS NewDate FROM ProductSales;	restituisce il '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 settimana' (da 1 a 52) dei valori di data del campo "DataVendita".
SELECT DatePart("h",[DateTime]) AS NewDate FROM ProductSales;	Restituisce l'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

In questo esempio viene usata una data e, usando la funzione DatePart , viene visualizzato 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