Funkcia DatePart

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

Upozornenie Vyskytol sa problém s použitím tejto funkcie. Posledný pondelok v niektorých kalendárnych rokoch sa môže vrátiť ako týždeň 53, kedy by mal 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ň v týždni. 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ý, prvý týždeň sa považuje za týždeň, v ktorom nastane 1. január.

Nastavenia

Argument intervalu 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 firstweekofyear 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 firstdayofweek ovplyvňuje výpočty, ktoré používajú symboly intervalu "w" a "ww".

Ak je dátumom literál dátumu, zadaný rok sa stane trvalou súčasťou tohto 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 dotazu

Výraz	Výsledky
SELECT DatePart("yyyy";[DateofSale]) AS NewDate FROM ProductSales;	Vráti hodnotu Year hodnôt dátumu poľa DateofSale.
SELECT DatePart("q",[DateofSale]) AS NewDate FROM ProductSales;	Vráti hodnotu Štvrťrok (na základe kalendárneho roka) dátumových hodnôt poľa DateofSale.
SELECT DatePart("y";[DateofSale]) AS NewDate FROM ProductSales;	Vráti hodnotu Day of Year (1 až 365) dátumových hodnôt poľa DateofSale.
SELECT DatePart("d";[DateofSale]) AS NewDate FROM ProductSales;	Vráti hodnotu "Day" dátumových hodnôt poľa DateofSale.
SELECT DatePart("w";[DateofSale]) AS NewDate FROM ProductSales;	Vráti hodnotu Weekday (od 1 do 7, kde 1 predstavuje nedeľu) dátumových hodnôt poľa DateofSale.
SELECT DatePart("ww",[DateofSale]) AS NewDate FROM ProductSales;	Vráti hodnotu týždňa (od 1 do 52) dátumových hodnôt poľa DateofSale.
SELECT DatePart("h",[DateTime]) AS NewDate FROM ProductSales;	Vráti hodnotu Hour dátumových hodnôt poľa DateTime.
SELECT DatePart("n";[DateTime]) AS NewDate FROM ProductSales;	Vráti hodnotu Minutes dátumových hodnôt poľa DateTime.
SELECT DatePart("s",[DateTime]) AS NewDate FROM ProductSales;	Vráti sekundy dátumových hodnôt poľa DateTime.

Príklad jazyka 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