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 per una soluzione alternativa, vedere le funzioni Format o DatePart possono restituire un numero di settimana errato per l'ultimo lunedì dell'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 che si desidera restituire.

date

Obbligatorio. ValoreVariant( Date ) che si desidera 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 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 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

Per il primo argomentosettimanaanno sono disponibili 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 è 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 l'espressione data viene valutata. Questo permette di scrivere codice da usare per anni diversi.

Nota: Per la data,se la proprietà Calendario è impostata su Gregoriano, la data specificata deve essere gregoriano. Se il calendario è Hijri, la data specificata deve essere basata sul calendario Hijri.

La parte data restituita è in 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 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 valore "Day" dei valori di data del campo "DateofSale".

SELECT DatePart("w",[DateofSale]) AS NewDate FROM ProductSales;

Restituisce il valore "Weekday" (da 1 a 7, dove 1 rappresenta la 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 l'ora dei valori di data del campo "DateTime".

SELECT DatePart("n",[DataTime]) 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

Scegliere la funzione data giusta

Serve aiuto?

Amplia le tue competenze
Esplora i corsi di formazione
Ottieni in anticipo le nuove caratteristiche
Partecipa a Microsoft Insider

Queste informazioni sono risultate utili?

Quanto ti soddisfa la qualità della traduzione?
Cosa ha influito sulla tua esperienza?

Grazie per il feedback!

×