Třída BirtDateTime poskytuje funkce pro stanovení času mezi dvěma daty nebo časovými údaji pro přičtení nebo odečtení časových úseků a získání částí dat. Protože datové intervaly jsou pouze čísla, aplikace u nich může používat normální matematiku: Násobení, dělení, sčítání, odečítání atd. Tato třída je statická. Aplikace nemůže vytvořit instance této třídy.
Tato funkce vrací nové datum, které vznikne přičtením daného počtu dnů k danému datu. Počet dnů, který se přičítá, může být záporný. V tomto případě je výsledek takový, jako by toto číslo bylo odečteno od daného data.
Syntaxe
Parametry
datum
Objekt typu Date. Objekt typu Date, který představuje datum zahájení.
n
Objekt typu Number. Počet dnů, který se má přičíst k datu. Desetinná čísla jsou zpracovávána jako celá čísla, zaokrouhlená dolů na nejbližší celé číslo.
Vrací
Objekt typu Date. Datum, které je výsledkem přičtení určeného počtu dnů k datu zahájení.
Příklady
V následujícím příkladě jsou ke specifickému datu přičteny další dny:
V následujícím příkladě je přičteno 15 dnů ke každé hodnotě typu Date v poli Datum fakturace (InvoiceDate):
Tato funkce vrací nové datum, které je výsledkem přičtení daného počtu hodin k danému datu. Počet hodin, který se přičítá, může být záporný. V tomto případě je výsledek takový, jako by toto číslo bylo odečteno od daného data.
Syntaxe
Parametry
datum
Objekt typu Date, který představuje datum zahájení. Pokud datum zahájení nemá hodnotu času, tato funkce předpokládá, že se jedná o půlnoc (čas 00:00:00).
n
Objekt typu Number. Počet hodin, který se má přičíst k datu.
Vrací
Objekt typu Date. Datum, které je výsledkem přičtení určeného počtu hodin k datu zahájení.
Příklady
V následujícím příkladě je ke specifickému datu a času přičten určitý počet hodin:
V následujícím příkladě je přičteno 36 hodin ke každé hodnotě data v poli Čas zahájení:
Tato funkce vrací nové datum, které je výsledkem přičtení daného počtu minut k danému datu. Počet minut, který se přičítá, může být záporný. V tomto případě je výsledek takový, jako by toto číslo bylo odečteno od daného data.
Syntaxe
Parametry
datum
Objekt typu Date, který představuje datum zahájení. Pokud datum zahájení nemá hodnotu času, tato funkce předpokládá, že se jedná o půlnoc (čas 00:00:00).
n
Objekt typu Number. Počet minut, který se má přičíst k datu.
Vrací
Objekt typu Date. Datum, které je výsledkem přičtení určeného počtu minut k datu zahájení.
Příklady
V následujícím příkladě je ke specifickému datu a času přičten určitý počet minut:
V následujícím příkladě je přičteno 15 minut ke každé hodnotě data v poli Čas zahájení:
Tato funkce vrací nové datum, které je výsledkem přičtení daného počtu měsíců k danému datu. Počet měsíců, který se přičítá, může být záporný. V tomto případě je výsledek takový, jako by toto číslo bylo odečteno od daného data.
Tato funkce vždy vrací platné datum. V případě potřeby se údaje o dnech ve výsledném datu upraví na nižší počet na poslední den výsledného měsíce ve výsledném roce. Například pokud přičtete 1 měsíc k datu 31.ledna 2008, vrátí addMonth( ) hodnotu 29.úno 2008 (2008 je přestupný rok), nikoli 31.úno 2008.
Syntaxe
Parametry
datum
Objekt typu Date. Objekt typu Date, který představuje datum zahájení.
n
Objekt typu Number. Počet měsíců, který se má přičíst k datu. Desetinná čísla jsou zpracovávána jako celá čísla, zaokrouhlená dolů.
Vrací
Objekt typu Date. Datum, které je výsledkem přičtení určeného počtu měsíců k datu zahájení.
Příklady
V následujícím příkladě jsou ke specifickému datu přičteny další měsíce:
V následujícím příkladě je přičteno 10 měsíců ke každé hodnotě data v poli Datum fakturace (InvoiceDate).
Tato funkce vrací nové datum, které je výsledkem přičtení daného počtu čtvrtletí k danému datu. Čtvrtletí odpovídá třem měsícům. Například pokud přičtete 2 čtvrtletí k datu 10.zář 2008, vrátí tato funkce datum 10. březen 2009. Počet čtvrtletí, který se přičítá, může být záporný. V tomto případě je výsledek takový, jako by toto číslo bylo odečteno od daného data.
Syntaxe
Parametry
datum
Objekt typu Date, který představuje datum zahájení.
n
Objekt typu Number. Počet čtvrtletí, který se má přičíst k danému datu.
Vrací
Objekt typu Date. Datum, které je výsledkem přičtení určeného počtu čtvrtletí k datu zahájení.
Příklady
V následujícím příkladě jsou ke specifickému datu přičtena čtvrtletí:
V následujícím příkladě jsou přičtena 2 čtvrtletí ke každé hodnotě data v poli ForecastClosing:
Tato funkce vrací nové datum, které je výsledkem přičtení daného počtu sekund k danému datu. Počet sekund, který se přičítá, může být záporný. V tomto případě je výsledek takový, jako by toto číslo bylo odečteno od daného data.
Syntaxe
Parametry
datum
Objekt typu Date, který představuje datum zahájení. Pokud datum zahájení nemá hodnotu času, tato funkce předpokládá, že se jedná o půlnoc (čas 00:00:00).
n
Objekt typu Number. Počet sekund, který se má přičíst k datu.
Vrací
Objekt typu Date. Výsledek přičtení určeného počtu sekund k datu zahájení.
Příklady
V následujícím příkladě je ke specifickému datu a času přičten určitý počet sekund:
V následujícím příkladě je přičteno 6000 sekund ke každé hodnotě data v poli Čas zahájení:
Tato funkce vrací nové datum, které je výsledkem přičtení daného počtu týdnů k danému datu. Počet týdnů, který se přičítá, může být záporný. V tomto případě je výsledek takový, jako by toto číslo bylo odečteno od daného data.
Syntaxe
Parametry
datum
Objekt typu Date, který představuje datum zahájení.
n
Objekt typu Number. Počet týdnů, který se má přičíst k danému datu.
Vrací
Objekt typu Date. Datum, které je výsledkem přičtení určeného počtu týdnů k datu zahájení.
Příklady
V následujícím příkladě jsou ke specifickému datu přičteny další týdny:
V následujícím příkladě jsou přičteny 2 týdny ke každé hodnotě typu Date v poli Datum fakturace (InvoiceDate) :
Tato funkce vrací nové datum, které vznikne přičtením daného počtu roků k danému datu. Počet roků, který se přičítá, může být záporný. V tomto případě je výsledek takový, jako by toto číslo bylo odečteno od daného data.
Syntaxe
Parametry
datum
Objekt typu Date, který představuje datum zahájení.
n
Počet roků, který se má přičíst k datu. Desetinná čísla jsou zpracovávána jako celá čísla, zaokrouhlená dolů.
Vrací
Datum, které je výsledkem přičtení určeného počtu roků k datu zahájení.
Příklady
V následujícím příkladě jsou ke specifickému datu přičteny roky:
V následujícím příkladě je přičteno 5 roků ke každé hodnotě data v poli Datum pronájmu (HireDate):
Tato funkce vrací číslo od 1 do 31, které představuje den v měsíci pro dané datum. Například u data 19.1.2009 tato funkce vrací číslo 19.
Syntaxe
Parametr
datum
Objekt typu Date. Objekt typu Date, ze kterého se má získat den.
Vrací
Celé číslo, které představuje den v měsíci pro dané datum.
Příklady
Následující příklad vrací den v měsíci pro každou hodnotu v poli Datum expedice(ShipDate):
V následujícím příkladě je vrácen den v měsíci pro aktuální datum:
Tato funkce vrací počet dnů mezi dvěma daty. Údaj o dni se vypočítá odečtením hodnoty dne v prvním datu od hodnoty dne ve druhém datu. Například pokud je první datum 30.12.2008 23:59:59 a druhé datum je 31.12.2008 00:00:00, vrací tato funkce výsledek 1 den, i když tato dvě data odděluje jediná sekunda.
Syntaxe
Parametry
date1
Objekt typu Date, který představuje začátek časového úseku.
date2
Objekt typu Date, který představuje konec časového úseku.
Vrací
Hodnota typu Integer. Počet dnů mezi dvěma daty.
Příklady
V následujícím příkladě je vrácen počet dnů mezi specifickými daty:
V následujícím příkladě je vrácen počet dnů od aktuálního data do konce roku 2009:
V následujícím příkladě je vrácen počet dnů mezi hodnotami v polích Datum fakturace (InvoiceDate) a Datum platby (PaymentDate):
Tato funkce vrací počet hodin mezi dvěma daty. Údaj o hodinách se vypočítá odečtením hodnoty hodiny v prvním datu od hodnoty hodiny ve druhém datu. Například pokud je první datum 31.1.2009 1:30:00 a druhé datum je 31.1.2009 2:00:00, vrací tato funkce výsledek 1 hodina, i když tato dvě data odděluje pouze 30 minut. Pokud datum nemá hodnotu času, tato funkce předpokládá, že se jedná o půlnoc (čas 00:00:00).
Syntaxe
Parametry
date1
Objekt typu Date, který představuje začátek časového úseku.
date2
Objekt typu Date, který představuje konec časového úseku.
Vrací
Hodnota typu Integer. Počet hodin mezi dvěma daty.
Příklady
V následujícím příkladě je vrácen počet hodin mezi specifickými daty:
V následujícím příkladě je vrácen počet hodin od aktuálního data a času do konce roku 2009:
V následujícím příkladě je vrácen počet hodin mezi hodnotami v polích Čas zahájení (StartTime) a Čas dokončení (FinishTime):
Tato funkce vrací počet minut mezi dvěma daty. Údaj o minutách se vypočítá odečtením hodnoty minuty v prvním datu od hodnoty minuty ve druhém datu. Například pokud je první datum 31.1.2009 1:30:59 a druhé datum je 31.1.2009 1:31:00, vrací tato funkce výsledek 1 minuta, i když tato dvě data odděluje jediná sekunda. Pokud datum nemá hodnotu času, tato funkce předpokládá, že se jedná o půlnoc (čas 00:00:00).
Syntaxe
Parametry
date1
Objekt typu Date, který představuje začátek časového úseku.
date2
Objekt typu Date, který představuje konec časového úseku.
Vrací
Hodnota typu Integer. Počet minut mezi dvěma daty.
Příklady
V následujícím příkladě je vrácen počet minut mezi specifickými daty:
V následujícím příkladě je vrácen počet minut od aktuálního data a času do začátku roku 2010:
V následujícím příkladě je vrácen počet minut mezi hodnotami v polích Čas zahájení (StartTime) a Čas dokončení (FinishTime):
Tato funkce vrací počet měsíců mezi dvěma daty. Údaj o měsících se vypočítá odečtením hodnoty měsíce v prvním datu od hodnoty měsíce ve druhém datu. Například pokud je první datum 31.1.2009 a druhé datum je 1.2.2009, vrací tato funkce výsledek 1 měsíc, i když tato dvě data odděluje jediný den.
Syntaxe
Parametry
date1
Objekt typu Date, který představuje začátek časového úseku.
date2
Objekt typu Date, který představuje konec časového úseku.
Vrací
Hodnota typu Integer. Počet měsíců mezi dvěma daty.
Příklady
V následujícím příkladě je vrácen počet měsíců mezi specifickými daty:
V následujícím příkladě je vrácen počet měsíců od aktuálního data do začátku roku 2010:
V následujícím příkladě je vrácen počet měsíců mezi hodnotami v polích Zahájení projektu(ProjectStart) a Dokončení projektu (ProjectComplete):
Tato funkce vrací počet čtvrtletí mezi dvěma daty. Údaj o čtvrtletí se vypočítá odečtením hodnoty měsíce v prvním datu od hodnoty měsíce ve druhém datu. Rozdíl 3 měsíců se rovná 1 čtvrtletí. Například pokud je první datum 31.1.2009 a druhé datum je 1.7.2009, tato funkce vrací hodnotu 2. Pokud je první datum 1.1.2009 a druhé datum je 30.9.2009, funkce také vrací hodnotu 2.
Syntaxe
Parametry
date1
Objekt typu Date, který představuje začátek časového úseku.
date2
Objekt typu Date, který představuje konec časového úseku.
Vrací
Hodnota typu Integer. Počet čtvrtletí mezi dvěma daty.
Příklady
V následujícím příkladě je vrácen počet čtvrtletí mezi specifickými daty:
V následujícím příkladě je vrácen počet čtvrtletí od aktuálního data do začátku roku 2010:
V následujícím příkladě je vrácen počet čtvrtletí mezi hodnotami v polích Zahájení projektu(ProjectStart) a Dokončení projektu (ProjectComplete):
Tato funkce vrací počet sekund mezi dvěma daty. Pokud datum nemá hodnotu času, tato funkce předpokládá, že se jedná o půlnoc (čas 00:00:00).
Syntaxe
Parametry
date1
Objekt typu Date, který představuje začátek časového úseku.
date2
Objekt typu Date, který představuje konec časového úseku.
Vrací
Hodnota typu Integer. Počet sekund mezi dvěma daty.
Příklady
V následujícím příkladě je vrácen počet sekund mezi specifickými daty:
V následujícím příkladě je vrácen počet sekund od aktuálního data a čas do začátku roku 2010:
V následujícím příkladě je vrácen počet sekund mezi hodnotami v polích Čas zahájení (StartTime) a Čas dokončení (FinishTime):
Tato funkce vrací počet týdnů mezi dvěma daty. Údaj o týdnu se vypočítá odečtením čísla týdne prvního data od čísla týdne druhého data. Například pokud je první datum 2.1.2009 (1. týden v roce) a druhé datum je 5.1.2009 (2. týden v roce), vrací tato funkce výsledek 1 týden, i když tato dvě data oddělují pouze tři dny.
Syntaxe
Parametry
date1
Objekt typu Date, který představuje začátek časového úseku.
date2
Objekt typu Date, který představuje konec časového úseku.
Vrací
Hodnota typu Integer. Počet týdnů mezi dvěma daty.
Příklady
V následujícím příkladě je vrácen počet týdnů mezi specifickými daty:
V následujícím příkladě je vrácen počet týdnů od aktuálního data do začátku roku 2010:
V následujícím příkladě je vrácen počet týdnů mezi hodnotami v polích Zahájení projektu (ProjectStart) a Dokončení projektu (ProjectComplete):
Tato funkce vrací počet roků mezi dvěma daty. Údaj o roce se vypočítá odečtením hodnoty roku v prvním datu od hodnoty roku ve druhém datu. Například pokud je první datum 1.1.2009 a druhé datum je 31.12.2009, vrací tato funkce hodnotu 0. Pokud je první datum 15.11.2008 a druhé datum 15.1.2009, funkce vrací hodnotu 1.
Syntaxe
Parametry
date1
Objekt typu Date, který představuje začátek časového úseku.
date2
Objekt typu Date, který představuje konec časového úseku.
Vrací
Hodnota typu Integer. Počet roků mezi dvěma daty.
Příklady
V následujícím příkladě je vrácen počet roků mezi specifickými daty:
V následujícím příkladě je vrácen počet roků mezi každou hodnotou v poli Datum pronájmu (HireDate) a aktuálním datem:
Tato funkce vrací počet roků mezi dvěma daty. Údaj o roce se vypočítá odečtením hodnoty roku v prvním datu od hodnoty roku ve druhém datu. Například pokud je první datum 1.1.2009 a druhé datum je 31.12.2009, vrací tato funkce hodnotu 0. Pokud je první datum 15.11.2008 a druhé datum 15.1.2009, funkce vrací hodnotu 1.
Syntaxe
Parametry
date1
Objekt typu Date, který představuje začátek časového úseku.
date2
Objekt typu Date, který představuje konec časového úseku.
Vrací
Hodnota typu Integer. Počet roků mezi dvěma daty.
Příklady
V následujícím příkladě je vrácen počet roků mezi specifickými daty:
V následujícím příkladě je vrácen počet roků mezi každou hodnotou v poli Datum pronájmu (HireDate) a aktuálním datem:
Tato funkce vrací datum pro první den v měsíci, ve kterém se nezdařilo datum vstupu.
Syntaxe
Parametry
datum
Objekt typu Date, ze kterého se má získat měsíc.
Vrací
Objekt typu Date. První den v měsíci pro dané datum.
Příklady
Následující příklad ukazuje hodnoty měsíce vrácené pro specifické datum:
Tato funkce vrací datum pro první den ve čtvrtletí, ve kterém se nezdařilo datum vstupu.
Syntaxe
Parametry
datum
Objekt typu Date, ze kterého se má získat čtvrtletí.
Vrací
Objekt typu Date. První den ve čtvrtletí pro dané datum.
Příklady
Následující příklad ukazuje hodnoty čtvrtletí vrácené pro specifické datum:
Tato funkce vrací datum pro první den v týdnu, ve kterém se nezdařilo datum vstupu, které je vždy neděle.
Syntaxe
Parametry
datum
Objekt typu Date, ze kterého se má získat týden.
Vrací
Objekt typu Date. První den v týdnu pro dané datum.
Příklady
Následující příklad ukazuje hodnoty týdne vrácené pro specifické datum:
Tato funkce vrací datum pro první den v týdnu, ve kterém se nezdařilo datum vstupu.
Syntaxe
Parametry
datum
Objekt typu Date, ze kterého se má získat rok.
Vrací
Objekt typu Date. První den v roce pro dané datum.
Příklady
Následující příklad ukazuje hodnoty roku vrácené pro specifické datum:
Tato funkce vrací hodnotu měsíce pro dané datum. V závislosti na možnosti, kterou určíte, tato funkce vrací údaj o měsíci jako číslo, celý název měsíce nebo zkrácený název měsíce. Název měsíce odpovídá národnímu prostředí.
Syntaxe
Parametry
datum
Objekt typu Date, ze kterého se má získat měsíc.
option
Hodnota typu Integer. Volitelné. Číslo představující formát měsíce, který má být vrácen. Použijte jednu z následujících hodnot:
Vynecháte-li tento argument, tato funkce vrátí údaj o měsíci jako číslo.
Vrací
Hodnota typu String. Měsíc pro dané datum.
Příklady
Následující příklad ukazuje hodnoty měsíce vrácené pro specifické datum:
V následujícím příkladě je vrácen měsíc pro aktuální datum:
Tato funkce vrací aktuální datum a čas, například 2.úno 2009 14:05.
Syntaxe
Vrací
Objekt typu Date. Aktuální datum a čas.
Příklad
V následujícím příkladě je vrácen počet hodin od aktuálního data a času do Vánoc:
Tato funkce vrací číslo od 1 do 4 představující čtvrtletí, do kterého dané datum spadá. První čtvrtletí začíná 1. ledna.
Syntaxe
Parametr
datum
Objekt typu Date, ze kterého se má získat číslo čtvrtletí.
Vrací
Hodnota typu Integer. Číslo čtvrtletí pro dané datum.
Příklady
Následující příklad ukazuje čísla čtvrtletí, která jsou vrácena pro specifická data:
V následujícím příkladě je vráceno číslo čtvrtletí pro každou hodnotu v poli Datum uzavření (CloseDate):
V následujícím příkladě je vráceno číslo čtvrtletí pro aktuální datum:
Tato funkce vrací aktuální datum, které obsahuje časovou hodnotu půlnoci, např. 2.úno 2009 00:00.
Syntaxe
Vrací
Objekt typu Date. Aktuální datum s časovou hodnotou půlnoci.
Příklady
V následujícím příkladě je vrácen počet dnů od aktuálního data do Vánoc:
Následující příklad vypočítává počet roků od každé hodnoty v datovém poli Datum pronájmu (HireDate) do aktuálního data.
Tato funkce vrací číslo od 1 do 52, které představuje číslo týdne pro dané datum.
Syntaxe
Parametr
datum
Objekt typu Date, ze kterého se má získat číslo týdne.
Vrací
Hodnota typu Integer. Číslo týdne pro dané datum.
Příklady
Následující příklad ukazuje čísla týdne, která jsou vrácena pro specifická data:
V následujícím příkladě je vráceno číslo týdne pro každou hodnotu v poli Datum uzavření (CloseDate):
V následujícím příkladě je vráceno číslo týdne pro aktuální datum:
Tato funkce vrací údaj o dni v týdnu pro dané datum. V závislosti na možnosti, kterou určíte, tato funkce vrací údaj o dni v týdnu jako číslo, celé jméno dne nebo zkrácené jméno dne. Název dne v týdnu odpovídá národnímu prostředí.
Syntaxe
Parametry
datum
Objekt typu Date, ze kterého se má získat den v týdnu.
option
Hodnota typu Integer. Volitelné. Číslo představující formát, který má být vrácen. Použijte jednu z následujících hodnot:
Vynecháte-li tento argument, funkce předpokládá volbu 1.
Vrací
Hodnota typu String. Den v týdnu pro dané datum.
Příklady
Následující příklad ukazuje hodnoty dne v týdnu vrácené pro specifické datum:
V následujícím příkladě je vrácen den v týdnu pro aktuální datum:
Tato funkce vrací čtyřčíselný údaj o roku pro dané datum. Například u data 19.1.2009, tato funkce vrací údaj 2009.
Syntaxe
Parametr
datum
Objekt typu Date, ze kterého se má získat rok.
Vrací
Hodnota typu Integer. Čtyřčíselný údaj o roku pro dané datum.
Příklady
V následujícím příkladě je vrácen údaj o roku pro každou hodnotu v poli Datum pronájmu (HireDate):
V následujícím příkladě je vrácen rok pro aktuální datum: