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 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

Consultați și

Alegerea funcției de dată potrivite

Extindeți-vă competențele Office
Explorați instruirea
Fiți primul care obține noile caracteristici
Alăturați-vă utilizatorilor Office Insider