Funkcia DatePart

Vráti hodnotu typu Variant (Integer) so zadanou časťou daného dátumu.

Upozornenie Vyskytol sa problém s používaním tejto funkcie. Posledný pondelok v niektorých kalendárnych rokoch sa môže vrátiť ako týždeň 53, pričom mal to byť týždeň 1. Ďalšie informácie a alternatívne riešenie nájdete v téme Funkcie Format alebo DatePart môžu vrátiť nesprávne číslo týždňa za posledný pondelok v roku.

Syntax

DatePart(interval; dátum [, prvý deň týždňa] [, prvý týždeň roka] )

Syntax funkcie DatePart má tieto argumenty:

Argument	Popis
interval	Povinný argument. Reťazcový výraz určujúci časový interval, ktorý chcete vrátiť.
dátum	Povinný argument. Hodnota typu Variant (Date), ktorú chcete vyhodnotiť.
prvýdeňtýždňa	Voliteľný argument. Konštanta, ktorá určuje prvý deň týždňa. Ak nie je zadaná, predpokladá sa, že je to nedeľa.
prvýtýždeňroka	Voliteľný argument. Konštanta, ktorá určuje prvý týždeň roka. Ak nie je zadaný, za prvý týždeň sa považuje týždeň, do ktorého spadá 1. január.

Nastavenia

Argument interval má tieto nastavenia:

Nastavenie	Popis
yyyy	Rok
q	Štvrťrok
m	Mesiac
y	Deň v roku
d	Deň
w	Deň v týždni
ww	Týždeň
h	Hodina
m	Minúta
s	Sekunda

Argument prvýdeňtýždňa má tieto nastavenia:

Konštanta	Hodnota	Popis
vbUseSystem	0	Použije sa nastavenie NLS API.
vbSunday	1	Nedeľa (predvolené)
vbMonday	2	Pondelok
vbTuesday	3	Utorok
vbWednesday	4	Streda
vbThursday	5	Štvrtok
vbFriday	6	Piatok
vbSaturday	7	Sobota

Argument prvýtýždeňrokroka má tieto nastavenia:

Konštanta	Hodnota	Popis
vbUseSystem	0	Použije sa nastavenie NLS API.
vbFirstJan1	1	Začína sa týždňom, do ktorého spadá 1. január (predvolená možnosť).
vbFirstFourDays	2	Začína sa prvým týždňom, v ktorom sa nachádzajú aspoň štyri dni nového roka.
vbFirstFullWeek	3	Začína sa prvým celým týždňom v roku.

Poznámky:

Funkciu DatePart môžete použiť na vyhodnotenie dátumu a vrátenie konkrétneho časového intervalu. Funkciu DatePart môžete napríklad použiť na výpočet dňa v týždni alebo aktuálnej hodiny.

Argument prvý deň týždňa ovplyvní výpočty, ktoré používajú intervalové symboly "w" a "ww".

Ak je dátum doslovný súbor dátumu, zadaný rok sa stane trvalou súčasťou daného dátumu. Ak je však hodnota argumentu dátum uzavretá v dvojitých úvodzovkách (" ") a vynecháte rok, pri každom vyhodnocovaní výrazu dátum sa do vášho kódu vloží aktuálny rok. Takto je možné písať kód, ktorý sa bude môcť používať v rôznych rokoch.

Vrátená časť s dátumom je v jednotkách časového obdobia aktuálneho arabského kalendára. Ak je napríklad aktuálny kalendár Hedžra a časť dátumu, ktorá sa vráti, je rok, hodnota roka je podľa kalendára Hedžra.

Príklady dotazov

Výraz	Výsledky
SELECT DatePart("yyyy";[DateofSale]) AS NewDate FROM ProductSales;	Vráti hodnotu Year z dátumových hodnôt poľa DateofSale.
SELECT DatePart("q";[DateofSale]) AS NewDate FROM ProductSales;	Vráti hodnotu Štvrťrok (na základe roka kalendára) hodnôt dátumu v poli DátumPredaja.
SELECT DatePart("y";[DateofSale]) AS NewDate FROM ProductSales;	Vráti hodnotu Deň v roku (1 až 365) hodnôt dátumu v poli DátumPredaja.
SELECT DatePart("d";[DateofSale]) AS NewDate FROM ProductSales;	Vráti hodnotu Deň z dátumových hodnôt poľa DátumPredaja.
SELECT DatePart("w";[DateofSale]) AS NewDate FROM ProductSales;	Vráti hodnotu Deň v týždni (od 1 do 7, kde 1 predstavuje nedeľu) hodnôt dátumu v poli DátumPredaja.
SELECT DatePart("ww";[DateofSale]) AS NewDate FROM ProductSales;	Vráti číslo týždňa (od 1 do 52) dátumových hodnôt v poli DátumPredaja.
SELECT DatePart("h";[DateTime]) AS NewDate FROM ProductSales;	Vráti hodnotu Hour hodnôt dátumu v poli DátumAČas.
SELECT DatePart("n";[DateTime]) AS NewDate FROM ProductSales;	Vráti minúty hodnôt dátumu poľa DátumAČas.
SELECT DatePart("s",[DateTime]) AS NewDate FROM ProductSales;	Vráti sekundy dátumových hodnôt poľa DátumAČas.

Príklad VBA

V tomto príklade sa pracuje s dátumom a pomocou funkcie DatePart sa zobrazí štvrťrok v roku, v ktorom sa tento dátum vyskytuje.

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

Výber správnej funkcie dátumu