Funkce Weekday

Vrátí hodnotu typu Variant (Integer), která obsahuje celé číslo vyjadřující den v týdnu.

Syntaxe

Weekday(datum [, první_den_v_týdnu ] )

Syntaxe funkce Weekday obsahuje tyto argumenty:

Argument	Popis
Datum	Povinný argument. Varianta, číselný nebo řetězcový výraz nebo jakákoli jejich kombinace, která představuje datum. Pokud datum obsahuje hodnotu Null, vrátí se hodnota Null .
první_den_v_týdnu	Nepovinný argument. Konstanta, která určuje první den v týdnu. Pokud není zadán, předpokládá se, že je použita vbSunday .

Nastavení

Argument první_den_v_týdnu má následující nastavení:

Konstanta	Hodnota	Popis
vbUseSystem	0	Použijte nastavení rozhraní API služby NLS.
vbneděle	1	Neděle (výchozí)
vbMonday	2	Pondělí
vbTuesday	3	Úterý
vbWednesday	4	Středa
vbčtvrtek	5	Čtvrtek
vbFriday	6	Pátek
vbsobota	7	Sobota

Vrácené hodnoty

Funkce Weekday může vrátit libovolnou z těchto hodnot:

Konstanta	Hodnota	Popis
vbneděle	1	Neděle
vbMonday	2	Pondělí
vbTuesday	3	Úterý
vbWednesday	4	Středa
vbčtvrtek	5	Čtvrtek
vbFriday	6	Pátek
vbsobota	7	Sobota

Poznámky

Pokud je vlastnost Calendar nastavena na gregoriánský kalendář, vrátí se celé číslo, které představuje gregoriánský den v týdnu pro argument data. Pokud je kalendář Hidžra, vrácené celé číslo představuje pro argument datum den v týdnu v kalendáři Hidžra. U kalendářních dat hidžra je číslem argumentu libovolný číselný výraz, který může představovat datum a čas od 1. 1. 100 (gregoriánský srpen 2 718) do 4. 3. 9666 (gregoriánský prosinec 31 9999).

Příklady dotazů

Výraz	Výsledky:
SELECT DateofSale, Weekday([DateofSale]) AS Expr1 FROM ProductSales;	Vrátí hodnoty z pole DateofSale a číslo představující den v týdnu těchto hodnot kalendářních dat. (Ve výchozím nastavení je za první den týdne považovaná neděle; 1).
SELECT DateofSale, Weekday([DateofSale],2) AS NewWeekDay FROM ProductSales;	Vrátí hodnoty z pole DateofSale a číslo představující den v týdnu těchto hodnot kalendářních dat. (Za první den týdne se považuje pondělí).

Příklad jazyka VBA

V tomto příkladu se funkce Weekday používá k získání dne v týdnu od zadaného data.

Dim MyDate, MyWeekDay
MyDate = #February 12, 1969#    ' Assign a date.
MyWeekDay = Weekday(MyDate)    
' MyWeekDay contains 4 because 
' MyDate represents a Wednesday.

Volba správné datové funkce