Funcția DatePart

Returnează o valoare variant (număr întreg) care conține porțiunea specificată dintr-o anumită dată.

Avertisment Există o problemă cu utilizarea acestei funcții. Ultima zi de luni din unii ani calendaristici poate fi returnată ca săptămâna 53, când ar trebui să fie săptămâna 1. Pentru mai multe informații și o soluție de evitare, consultați Format sau DatePart Funcțiile pot returna un număr de săptămână greșit pentru ultima zi de luni din an.

Sintaxă

DatePart(interval, dată [, prima zi a săptămânii] [, primasăptămânădinan] )

Sintaxa funcției DatePart are următoarele argumente:

Argument	Descriere
interval	Obligatoriu. Expresie șir care este intervalul de timp care doriți să fie returnat.
dată	Obligatoriu. Valoarea variant (dată) pe care doriți să o evaluați.
prima zi a săptămânii	Opțional. O constantă care specifică prima zi a săptămânii. Dacă nu se specifică, se presupune că este Duminică.
primasăptămânădinan	Opțional. Este o constantă care specifică prima săptămână a anului. Dacă nu se specifică, prima săptămână se presupune a fi săptămâna în care pică 1 ianuarie.

Setări

Argumentul interval are aceste setări:

Setare	Descriere
yyyy	An
q	Trimestru
m	Lună
y	Zi din an
d	Zi
w	Weekday
ww	Săptămână
h	Oră
n	Minut
s	Secundă

Argumentul prima zi a săptămânii are aceste setări:

Constantă	Valoare	Descriere
vbUseSystem	0	Utilizați setarea API NLS.
vbSunday	1	Duminică (implicit)
vbMonday	2	Luni
vbTuesday	3	Marți
miercuri vb	4	Miercuri
vbThursday	5	Joi
vbFriday	6	Vineri
vbSaturday	7	Sâmbătă

Argumentul primăsăptămânădinan are aceste setări:

Constantă	Valoare	Descriere
vbUseSystem	0	Utilizați setarea API NLS.
vbFirstJan1	1	Începeți cu săptămâna în care pică 1 ianuarie (implicit).
vbFirstFourDays	2	Începeți cu prima săptămână care are cel puțin patru zile în noul an.
vbFirstFullWeek	3	Începeți cu prima săptămână completă a anului.

Observații

Puteți utiliza funcția DatePart pentru a evalua o dată și a returna un anumit interval de timp. De exemplu, puteți utiliza DatePart pentru a calcula ziua săptămânii sau ora curentă.

Argumentul prima zi a săptămânii afectează calculele care utilizează simbolurile de interval "w" și "ww".

Dacă data este un literal de dată, anul specificat devine o parte permanentă a acelei date. Cu toate acestea, dacă data este încadrată în ghilimele duble ("") și omiteți anul, anul curent este inserat în cod de fiecare dată când se evaluează expresia de dată . Acest lucru face posibilă scrierea codului care poate fi utilizat în ani diferiți.

Partea de dată returnată este în unitățile de perioadă de timp din calendarul arab curent. De exemplu, dacă calendarul curent este Hijri și partea de dată de returnat este anul, valoarea anului este un an Hijri.

Exemple de interogare

expresie	Rezultatele
SELECT DatePart("yyyy",[DateofSale]) AS NewDate FROM ProductSales;	Returnează valoarea de "An" a valorilor de dată din câmpul "DataDeVânzare".
SELECT DatePart("q",[DateofSale]) AS NewDate FROM ProductSales;	Returnează "Trimestru" (pe baza anului calendaristic) pentru valorile dată din câmpul "DataDeVânzare".
SELECT DatePart("y",[DateofSale]) AS NewDate FROM ProductSales;	Returnează "Ziua anului" (de la 1 la 365) a valorilor dată din câmpul "DataDevânzare".
SELECT DatePart("d",[DateofSale]) AS NewDate FROM ProductSales;	Returnează "Ziua" valorilor dată din câmpul "DataDeVânzare".
SELECT DatePart("w",[DateofSale]) AS NewDate FROM ProductSales;	Returnează "Ziua săptămânii" (de la 1 la 7, unde 1 reprezintă Duminica) a valorilor de dată din câmpul "DataDeVânzare".
SELECT DatePart("ww",[DateofSale]) AS NewDate FROM ProductSales;	Returnează "Numărul săptămânii" (de la 1 la 52) a valorilor dată din câmpul "DataDevânzare".
SELECT DatePart("h",[DateTime]) AS NewDate FROM ProductSales;	Returnează "ora" valorilor de dată din câmpul "DatăOră".
SELECT DatePart("n",[DateTime]) AS NewDate FROM ProductSales;	Returnează "minutele" valorilor de dată din câmpul "DatăOră".
SELECT DatePart("s",[DateTime]) AS NewDate FROM ProductSales;	Returnează "secundele" valorilor de dată din câmpul "DatăOră".

Exemplu VBA

Acest exemplu preia o dată și, utilizând funcția DatePart , afișează trimestrul anului în care apare.

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

Alegerea funcției de dată potrivite