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. |
|
date |
Obbligatorio. Valore Variant (Date) da valutare. |
|
primogiornosett |
Facoltativo. Una 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 primogiornosett ha queste impostazioni:
|
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 primogiornosett influisce sui calcoli che usano i simboli di intervallo "w" e "ww".
Se date è un valore letterale 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.
Nota: Per data, se l'impostazione della proprietà Calendario è Gregoriano, la data fornita deve essere gregoriana. Se il calendario è Hijri, la data specificata deve essere basata sul calendario Hijri.
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
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 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
