Předchozí Další

Třída BirtDateTime

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.

BirtDateTime.addDay

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

Date BirtDateTime.addDay( Date date, Number n )

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:

var startDate = "31.12.2008";
var endDate;
endDate = BirtDateTime.addDay( startDate, 1 ); // vrací 1.led 2009
endDate = BirtDateTime.addDay( startDate, -1 ); // vrací 30.pro 2008

V následujícím příkladě je přičteno 15 dnů ke každé hodnotě typu Date v poli Datum fakturace (InvoiceDate):

BirtDateTime.addDay( row["Datum fakturace"], 15 )

BirtDateTime.addHour

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

Date BirtDateTime.addHour( Date date, Number n )

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:

var startDate = "2008-12-31 15:00:00";
var endDate;
endDate = BirtDateTime.addHour( startDate, 8 ); // vrací 31.led 2008 23:00
endDate = BirtDateTime.addHour( startDate, -8 ); // vrací 31.led 2008 7:00

V následujícím příkladě je přičteno 36 hodin ke každé hodnotě data v poli Čas zahájení:

BirtDateTime.addHour( row["Čas zahájení"], 36 )

BirtDateTime.addMinute

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

Date BirtDateTime.addMinute( Date date, Number n )

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:

var startDate = "2008-12-31 10:30:00";
var endDate;
endDate = BirtDateTime.addMinute( startDate, 45 );
// vrací 31.led 2008 11:15
endDate = BirtDateTime.addMinute( startDate, -30 );
// vrací 31.led 2008 10:00

V následujícím příkladě je přičteno 15 minut ke každé hodnotě data v poli Čas zahájení:

BirtDateTime.addMinute( row["Čas zahájení"], 15 )

BirtDateTime.addMonth

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

Date BirtDateTime.addMonth( Date date, Number n )

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:

var startDate = "31.12.2008";
var endDate;
endDate = BirtDateTime.addMonth( startDate, 1 ); // vrací 31.led 2009
endDate = BirtDateTime.addMonth( startDate, -1 ); // vrací 30.led 2008
endDate = BirtDateTime.addMonth( startDate, 2 ); // vrací 28.úno 2009

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

BirtDateTime.addMonth( row["Datum fakturace"], 10 )

BirtDateTime.addQuarter

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

Date BirtDateTime.addQuarter( Date date, Number n )

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

var startDate = "2008-12-15";
var endDate;
endDate = BirtDateTime.addQuarter( startDate, 1 ); //vrací 15.bře 2009
endDate = BirtDateTime.addQuarter( startDate, -2 ); //vrací 15.črv 2008

V následujícím příkladě jsou přičtena 2 čtvrtletí ke každé hodnotě data v poli ForecastClosing:

BirtDateTime.addQuarter( row["ForecastClosing"], 2 )

BirtDateTime.addSecond

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

Date BirtDateTime.addSecond( Date date, Number n )

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:

var startDate = "2008-12-31 10:30:00";
var endDate;
endDate = BirtDateTime.addSecond( startDate, 10000 );
// vrací 31.pro 2008 13:16:40
endDate = BirtDateTime.addSecond( startDate, -10000 );
// vrací 31.pro 2008 7:43:20

V následujícím příkladě je přičteno 6000 sekund ke každé hodnotě data v poli Čas zahájení:

BirtDateTime.addSecond( row["Čas zahájení"], 6000 )

BirtDateTime.addWeek

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

Date BirtDateTime.addWeek( Date date, Number n )

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:

var startDate = "31.12.2008";
var endDate;
endDate = BirtDateTime.addWeek( startDate, 1 ); // returns Jan 07, 2009
endDate = BirtDateTime.addWeek( startDate, -1 ); // returns Dec 24, 2008

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

BirtDateTime.addWeek( row["Datum fakturace"], 2 )

BirtDateTime.addYear

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

Date BirtDateTime.addYear( Date date, Number n )

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:

var startDate = "31.12.2008";
var endDate;
endDate = BirtDateTime.addYear( startDate, 1 ); // vrací 31.pro 2009
endDate = BirtDateTime.addYear( startDate, -1 ); // vrací 31.pro 2007

V následujícím příkladě je přičteno 5 roků ke každé hodnotě data v poli Datum pronájmu (HireDate):

BirtDateTime.addYear( row["Datum pronájmu"], 5 )

BirtDateTime.day

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

integer BirtDateTime.day( Date date )

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

BirtDateTime.day( row["Datum expedice"] )

V následujícím příkladě je vrácen den v měsíci pro aktuální datum:

BirtDateTime.day( (BirtDateTime.today())

BirtDateTime.diffDay

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

integer BirtDateTime.diffDay( Date date1, Date date2 )

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:

BirtDateTime.diffDay( "2009-01-01", "2009-04-15" ) // vrací 104

V následujícím příkladě je vrácen počet dnů od aktuálního data do konce roku 2009:

BirtDateTime.diffDay( BirtDateTime.today(), "2009-12-31" )

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

BirtDateTime.diffDay( row["Datum fakturace"], row["Datum platby"] )

BirtDateTime.diffHour

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

integer BirtDateTime.diffHour( Date date1, Date date2 )

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:

BirtDateTime.diffHour( "2009-01-31 12:00:00", "2009-02-01 12:00:00")
// vrací 24
BirtDateTime.diffHour( "2009-01-31", "2009-02-01 12:00:00")
// vrací 36. Protože první datum neobsahuje čas, předpokládá se, že jde o půlnoc.

V následujícím příkladě je vrácen počet hodin od aktuálního data a času do konce roku 2009:

BirtDateTime.diffHour( BirtDateTime.now(), "2009-12-31" );

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

BirtDateTime.diffHour( row["StartTime"], row["FinishTime"] )

BirtDateTime.diffMinute

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

integer BirtDateTime.diffMinute( Date date1, Date date2 )

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:

BirtDateTime.diffMinute( "2009-01-31 1:30:30", "2009-01-31 10:45:00")
// vrací 555
BirtDateTime.diffMinute( "2009-01-31", "2009-01-31 12:00:00")
// vrací 720. Protože první datum neobsahuje čas, předpokládá se, že jde o půlnoc.

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:

BirtDateTime.diffMinute( BirtDateTime.now(), "2010-01-01" )

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

BirtDateTime.diffMinute( row["StartTime"], row["FinishTime"] )

BirtDateTime.diffMonth

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

integer BirtDateTime.diffMonth( Date date1, Date date2 )

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:

BirtDateTime.diffMonth( "2009-01-31", "2009-04-15") // vrací 3

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:

BirtDateTime.diffMonth( BirtDateTime.today(), "2010-01-01" );

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

BirtDateTime.diffMonth( row["ProjectStart"], row["ProjectComplete"] )

BirtDateTime.diffQuarter

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

integer BirtDateTime.diffQuarter( Date date1, Date date2 )

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:

BirtDateTime.diffQuarter( "2009-01-31", "2009-04-15") // vrací 1

V následujícím příkladě je vrácen počet čtvrtletí od aktuálního data do začátku roku 2010:

BirtDateTime.diffQuarter( BirtDateTime.today(), "2010-01-01" );

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

BirtDateTime.diffQuarter( row["ProjectStart"], row["ProjectComplete"] )

BirtDateTime.diffSecond

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

integer BirtDateTime.diffSecond( date1, date2 )

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:

BirtDateTime.diffSecond( "2009-01-31 11:30:30", "2009-01-31 12:00:00")
// vrací 1770
BirtDateTime.diffSecond( "2009-01-31", "2009-01-31 1:00:00")
// vrací 3600. Protože první datum neobsahuje čas, předpokládá se, že jde o půlnoc.

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:

BirtDateTime.diffSecond( BirtDateTime.now(), "2010-01-01" )

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

BirtDateTime.diffSecond( row["StartTime"], row["FinishTime"] )

BirtDateTime.diffWeek

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

integer BirtDateTime.diffWeek( Date date1, Date date2 )

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:

BirtDateTime.diffWeek( "2009-01-01", "2009-02-01") // vrací 5

V následujícím příkladě je vrácen počet týdnů od aktuálního data do začátku roku 2010:

BirtDateTime.diffWeek( BirtDateTime.today(), "2010-01-01" );

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

BirtDateTime.diffWeek( row["ProjectStart"], row["ProjectComplete"] )

BirtDateTime.diffYear

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

integer BirtDateTime.diffYear( Date date1, Date date2 )

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:

BirtDateTime.diffYear( "2005-01-01", "2009-06-01") // vrací 4

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:

BirtDateTime.diffYear( row["HireDate"], BirtDateTime.today() )

BirtDateTime.diffYear

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

integer BirtDateTime.diffYear( Date date1, Date date2 )

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:

BirtDateTime.diffYear( "2005-01-01", "2009-06-01") // vrací 4

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:

BirtDateTime.diffYear( row["HireDate"], BirtDateTime.today() )

BirtDateTime.firstDayOfMonth

Tato funkce vrací datum pro první den v měsíci, ve kterém se nezdařilo datum vstupu.

Syntaxe

Date BirtDateTime.firstDayOfMonth( Date date)

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:

BirtDateTime.firstDayOfMonth( "2009-02-15" ) // returns 2009-02-01

BirtDateTime.firstDayOfQuarter

Tato funkce vrací datum pro první den ve čtvrtletí, ve kterém se nezdařilo datum vstupu.

Syntaxe

Date BirtDateTime.firstDayOfQuarter( Date date)

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:

BirtDateTime.firstDayOfQuarter( "2009-02-15" ) // returns 2009-01-01

BirtDateTime.firstDayOfWeek

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

Date BirtDateTime.firstDayOfWeek( Date date)

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:

BirtDateTime.firstDayOfWeek( "2009-02-15" ) // returns 2009-02-15

BirtDateTime.firstDayOfYear

Tato funkce vrací datum pro první den v týdnu, ve kterém se nezdařilo datum vstupu.

Syntaxe

Date BirtDateTime.firstDayOfYear( Date date)

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:

BirtDateTime.firstDayOfYear( "2009-02-15" ) // returns 2009-01-01

BirtDateTime.month

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

string BirtDateTime.month( Date date, integer option )

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:

BirtDateTime.month( "2009-02-15" ) // vrací 2
BirtDateTime.month( "2009-02-15", 2 ) // vrací únor
BirtDateTime.month( "2009-02-15", 3) // vrací úno

V následujícím příkladě je vrácen měsíc pro aktuální datum:

BirtDateTime.month( (BirtDateTime.today() )

BirtDateTime.now

Tato funkce vrací aktuální datum a čas, například 2.úno 2009 14:05.

Syntaxe

Date BirtDateTime.now( )

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:

BirtDateTime.diffHour( BirtDateTime.now(), "2009-12-25" )

BirtDateTime.quarter

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

integer BirtDateTime.quarter( Date date )

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:

BirtDateTime.quarter( "2009-02-15" ) // vrací 1
BirtDateTime.quarter( "2009-07-10" ) // vrací 3

V následujícím příkladě je vráceno číslo čtvrtletí pro každou hodnotu v poli Datum uzavření (CloseDate):

BirtDateTime.quarter( row["CloseDate"] )

V následujícím příkladě je vráceno číslo čtvrtletí pro aktuální datum:

BirtDateTime.quarter( (BirtDateTime.today() )

BirtDateTime.today

Tato funkce vrací aktuální datum, které obsahuje časovou hodnotu půlnoci, např. 2.úno 2009 00:00.

Syntaxe

Date BirtDateTime.today( )

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:

BirtDateTime.diffDay( BirtDateTime.today(), "2009-12-25" )

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.

BirtDateTime.diffYear( [HireDate], BirtDateTime.today() )

BirtDateTime.week

Tato funkce vrací číslo od 1 do 52, které představuje číslo týdne pro dané datum.

Syntaxe

integer BirtDateTime.week( date )

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:

BirtDateTime.week( "2009-02-15" ) // vrací 8
BirtDateTime.week( "2009-10-12" ) // vrací 42

V následujícím příkladě je vráceno číslo týdne pro každou hodnotu v poli Datum uzavření (CloseDate):

BirtDateTime.week( row["CloseDate"] )

V následujícím příkladě je vráceno číslo týdne pro aktuální datum:

BirtDateTime.week( (BirtDateTime.today() )

BirtDateTime.weekDay

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

string BirtDateTime.weekDay( Date date, integer option )

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:

BirtDateTime.weekDay( "2009-02-02" ) // vrací 2
BirtDateTime.weekDay( "2009-02-02", 2 ) // vrací 1
BirtDateTime.weekDay( "2009-02-02", 4 ) // vrací pondělí

V následujícím příkladě je vrácen den v týdnu pro aktuální datum:

BirtDateTime.weekDay( (BirtDateTime.today() )

BirtDateTime.year

Tato funkce vrací čtyřčíselný údaj o roku pro dané datum. Například u data 19.1.2009, tato funkce vrací údaj 2009.

Syntaxe

integer BirtDateTime.year( date )

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

BirtDateTime.year( row["HireDate"] )

V následujícím příkladě je vrácen rok pro aktuální datum:

BirtDateTime.year( (BirtDateTime.today())

(c) Copyright Actuate Corporation 2013