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 lune 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, consultați Funcțiile Format sau DatePart pot returna numărul săptămânii greșite pentru ultima zi de luni din an. |
Sintaxă
DatePart ( interval, dată [, primazidinsămână] [, primasămânădinan] )
Sintaxa funcției DatePart are următoarele argumente:
|
Argument |
Descriere |
|
interval |
Obligatoriu. Expresie șir care este intervalul de timp pe care doriți să-l returnați. |
|
date |
Obligatoriu. Valoare variant (Dată) pe care doriți să o evaluați. |
|
primazidinsămână |
Opțional. Un constantă care specifică prima zi a săptămânii. Dacă nu se specifică, duminică se presupune. |
|
primasămânădinan |
Opțional. O constantă care specifică prima săptămână a anului. Dacă nu se specifică, prima săptămână se consideră a fi săptămâna în care are loc 1 ianuarie. |
Setări
Argumentul interval are aceste setări:
|
Setare |
Descriere |
|
yyyy |
An |
|
q |
Trimestru |
|
m |
Lună |
|
y |
Ziua din an |
|
d |
Zi |
|
w |
Weekday |
|
ww |
Săptămână |
|
h |
Oră |
|
n |
Minut |
|
s |
Secundă |
Argumentul firstdayofweek are aceste setări:
|
Constantă |
Valoare |
Descriere |
|
vbUseSystem |
0 |
Utilizați setarea NLS API. |
|
vbSunday |
1 |
Duminică (implicit) |
|
vbMonday |
2 |
Luni |
|
zi vbTuesday |
3 |
Marți |
|
zi vbWednesday |
4 |
Miercuri |
|
zi vbThursday |
5 |
Joi |
|
vbFriday |
6 |
Vineri |
|
vbSaturday |
7 |
Sâmbătă |
Argumentul firstweekofyear are următoarele setări:
|
Constantă |
Valoare |
Descriere |
|
vbUseSystem |
0 |
Utilizați setarea NLS API. |
|
vbFirstJan1 |
1 |
Începeți cu săptămâna în care are loc 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ă date este un literal de tip dată, anul specificat devine o parte permanentă a acelei date. Cu toate acestea, dacă data este încadrată între ghilimele duble (" ") și omiteți anul, anul curent este inserat în cod de fiecare dată când se evaluează expresia dată . Acest lucru face posibilă scrierea de cod care poate fi utilizat în ani diferiți.
Notă: Pentru dată, dacă setarea proprietății Calendar este gregorian, data furnizată trebuie să fie gregorian. Dacă calendarul este Hijri, data furnizată trebuie să fie Hijri.
Partea de dată returnată se află în unitățile perioadei de timp din calendarul curent arab. De exemplu, dacă calendarul curent este Hijri și partea de dată de returnat este anul, valoarea de an este un an Hijri.
Exemple de interogare
|
Expresie |
Rezultatele |
|
SELECT DatePart("yyyy",[DateofSale]) AS NewDate FROM ProductSales; |
Returnează "Anul" valorilor dată ale câmpului "DateofSale". |
|
SELECT DatePart("q";[DateofSale]) AS NewDate FROM ProductSales; |
Returnează 'Trimestru' (pe baza anului calendaristic) al valorilor de date ale câmpului "DateofSale". |
|
SELECT DatePart("y",[DateofSale]) AS NewDate FROM ProductSales; |
Returnează "Ziua anului" (de la 1 la 365) a valorilor de dată ale câmpului "DateofSale". |
|
SELECT DatePart("d",[DateofSale]) AS NewDate FROM ProductSales; |
Returnează "Ziua" valorilor dată ale câmpului "DateofSale". |
|
SELECT DatePart("w",[DateofSale]) AS NewDate FROM ProductSales; |
Returnează "zi din săptămână" (de la 1 la 7, unde 1 reprezintă duminică) a valorilor de dată ale câmpului "DatăofSale". |
|
SELECT DatePart("ww",[DateofSale]) AS NewDate FROM ProductSales; |
Returnează "numărul săptămânii" (de la 1 la 52) al valorilor de dată ale câmpului "DatădinSale". |
|
SELECT DatePart("h",[DateTime]) AS NewDate FROM ProductSales; |
Returnează 'Hour' pentru valorile dată ale câmpului "DateTime". |
|
SELECT DatePart("n",[DatăTime]) AS NewDate FROM ProductSales; |
Returnează "Minute" ale valorilor dată ale câmpului "DateTime". |
|
SELECT DatePart("s",[DateTime]) AS NewDate FROM ProductSales; |
Returnează "secunde" ale valorilor dată din câmpul "DateTime". |
Exemplu VBA
Notă: Exemplele care urmează demonstrează utilizarea acestei funcții într-un modul Visual Basic for Applications (VBA). Pentru mai multe informații despre lucrul cu VBA, selectați Referințe pentru dezvoltatori în lista verticală de lângă Căutare și introduceți unul sau mai mulți termeni în caseta de căutare.
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
