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 câțiva ani calendaristici poate fi returnată ca săptămână 53 atunci când ar trebui să fie săptămâna 1. Pentru mai multe informații și o soluție de evitare, consultați funcțiile format sau datepart pot returna numărul săptămânii nepotrivite pentru ultima zi de luni din an. |
Sintaxă
Datepart ( interval, dată [, primazidinsăptămână] [, primasăptă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ăptămână |
Opțional. O constantă care specifică prima zi a săptămânii. Dacă nu se specifică, se presupune duminică. |
primasăptămânădinan |
Opțional. O constantă care specifică prima săptămână a anului. Dacă nu se specifică, se presupune că prima săptămână este săptămâna în care apare 1 ianuarie. |
Setări
Argumentul Interval are următoarele setări:
Setare | Descriere |
---|---|
yyyy |
An |
q |
Trimestru |
m |
Lună |
y |
Ziua anului |
d |
Zi |
w |
Weekday |
ww |
Săptămână |
h |
Oră |
n |
Minut |
s |
Secundă |
Argumentul primazidinsăptămână are următoarele setări:
Constantă | valoare | Descriere |
---|---|---|
vbUseSystem |
0 |
Utilizați setarea API NLS. |
vbSunday |
1 |
Duminică (implicit) |
vbMonday |
2 |
Luni |
vbTuesday |
3 |
Marți |
vbWednesday |
4 |
Miercuri |
vbThursday |
5 |
Joi |
vbFriday |
6 |
Vineri |
vbSaturday |
7 |
Sâmbătă |
Argumentul primasăptămânădinan are următoarele setări:
Constantă | valoare | Descriere |
---|---|---|
vbUseSystem |
0 |
Utilizați setarea API NLS. |
vbFirstJan1 |
1 |
Începeți cu săptămâna în care apare 1 ianuarie (implicit). |
vbFirstFourDays |
2 |
Începeți cu prima săptămână care are cel puțin patru zile în anul nou. |
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, este posibil să utilizați datepart pentru a calcula ziua săptămânii sau ora curentă.
Argumentul primazidinsăptămână afectează calculele care utilizează simbolurile de interval "w" și "ww".
Dacă Date este unliteral de tip dată, anul specificat devine parte permanentă din acea dată. 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 este evaluată expresia dată . Acest lucru vă permite să scrieți cod care poate fi utilizat în ani diferiți.
Notă: Pentru dată, dacă setarea de proprietate a calendarului este Gregoriană, data furnizată trebuie să fie Gregoriană. Dacă calendarul este Hijri, data furnizată trebuie să fie Hijri.
Partea dată returnată se află în unitățile din perioada de timp a calendarului Arabic curent. De exemplu, dacă calendarul curent este Hijri și partea dată de returnat este anul, valoarea Year este un an Hijri.
Exemple de interogare
Expresie | Rezultatele |
---|---|
Selectați DatePart ("YYYY", [DateofSale]) ca NewDate din ProductSales; |
Returnează "anul" valorilor de dată ale câmpului "DateofSale". |
Selectați DatePart ("q", [DateofSale]) ca NewDate din ProductSales; |
Returnează ' trimestrul ' (Bazat pe anul calendaristic) al valorilor de dată ale câmpului "DateofSale". |
Selectați DatePart ("y", [DateofSale]) ca NewDate din ProductSales; |
Returnează "ziua anului" (de la 1 la 365) a valorilor de dată ale câmpului "DateofSale". |
Selectați DatePart ("d", [DateofSale]) ca NewDate din ProductSales; |
Returnează "ziua" valorilor de dată ale câmpului "DateofSale". |
Selectați DatePart ("w", [DateofSale]) ca NewDate din ProductSales; |
Returnează "zi lucrătoare" (de la 1 la 7, unde 1 reprezintă duminica) a valorilor de dată ale câmpului "DateofSale". |
Selectați DatePart ("ww", [DateofSale]) ca NewDate din ProductSales; |
Returnează "numărul săptămânii" (de la 1 la 52) din valorile de dată ale câmpului "DateofSale". |
Selectați DatePart ("h", [DateTime]) ca NewDate din ProductSales; |
Returnează "ora" valorilor de dată ale câmpului "DateTime". |
Selectați DatePart ("n", [DateTime]) ca NewDate din ProductSales; |
Returnează "minutele" valorilor de dată ale câmpului "DateTime". |
Selectați DatePart ("s", [DateTime]) ca NewDate din ProductSales; |
Returnează "secunde" din valorile de dată ale câmpului "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 are o dată și, utilizând funcția datepart , afișează trimestrul anului în care are loc.
Dim TheDate As Date ' Declare variables.
Dim Msg
TheDate = InputBox("Enter a date:")
Msg = "Quarter: " & DatePart("q", TheDate)
MsgBox Msg