Předchozí témaNásledující téma


Třída DateTimeSpan

Statická třída DateTimeSpan poskytuje funkce ke stanovení množství času mezi dvěma daty nebo časovými údaji a pro sčítání či odečítání časových intervalů. Poskytuje sadu funkcí pro práci s rozdíly mezi dvěma daty. 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.

DateTimeSpan.addDate

Tato funkce vrací nové datum, které je výsledkem přičtení daného počtu roků, měsíců a dnů k počátečnímu datu. Měsíce mohou být větší než 12 a dny mohou být větší než počet dnů v měsíců. Výsledný efekt je, jako by zde byly tři různé operace. Nejprve přičtěte roky. Potom použijte výsledné datum a přičtěte měsíce. Potom použijte výsledné datum a přičtěte dny.

Při přičítání měsíců nemusí být výsledné datum platné. Například přičtením jednoho měsíce k 31. lednu dostaneme neplatné datum 31. února. Funkce datum upraví tak, aby bylo platné; pokud rok není přestupný, má v tomto případě únor 28 dnů a výsledné datum bude 3. březen.

Všechny argumenty roků, měsíců nebo dnů mohou být prázdné nebo nedefinované. Pokud je tomu tak, pak se hodnota považuje za nulovou.

Všechny argumenty roků, měsíců nebo dnů mohou být záporné. V tomto případě je výsledek takový, jako by byla tato jednotka odečtena od základního data.

Syntaxe

DateTimeSpan.addDate( startDate, roky, měsíce, dny )

Argumenty

Vrací

Datum, které je výsledkem přičtení roků, měsíců a dnů k počátečnímu datu.

Příklad

var startDate = date.parse( "2004-12-31" ); 
var endDate; 
endDate = DateTimeSpan( startDate, 1, 0, 0 ); // vrátí 2005-12-31 
endDate = DateTimeSpan( startDate, 0, 1, 0 ); // vrátí 2005-1-31 
endDate = DateTimeSpan( startDate, 0, 0, 1 ); // vrátí 2005-1-1 
endDate = DateTimeSpan( startDate, 1, 1, 1 ); // vrátí 2005-3-4 

Viz také

Funkce DateTimeSpan.addTime

Funkce DateTimeSpan.subDate

DateTimeSpan.addTime

Tato funkce vrací nové datum, které je výsledkem přičtení daného počtu hodin, minut a sekund k počátečnímu datu. Hodiny mohou být větší než 24 a minuty a sekundy mohou být větší než 60. Výsledný efekt je, jako by zde byly tři různé operace: Nejprve přičtěte hodiny. Potom použijte výsledné datum a přičtěte minuty. Potom použijte výsledné datum a přičtěte sekundy.

Všechny argumenty hodin, minut a sekund mohou být prázdné nebo nedefinované. Pokud je tomu tak, pak se hodnota považuje za nulovou.

Všechny argumenty hodin, minut a sekund mohou být záporné. V tomto případě je výsledek takový, jako by byla tato jednotka odečtena od základního data.

Syntaxe

DateTimeSpan.addTime( startDate, hodiny, minuty, sekundy )

Argumenty

Vrací

Datum, které je výsledkem přičtení hodin, minut a sekund k počátečnímu datu.

Viz také

Funkce DateTimeSpan.addDate

Funkce DateTimeSpan.subTime

DateTimeSpan.days

Vrací počet dní mezi dvěma daty. Den je definován jako změna kalendáře. Doba od 23:59:59 27. února do půlnoci 28. února je tedy jeden den, stejně jako doba od půlnoci 27. února do 11:59:59 28. února.

Syntaxe

DateTimeSpan.days( startDate, endDate )

Argumenty

Vrací

Vrací počet dní mezi dvěma daty.

DateTimeSpan.hours

Tato funkce vrátí počet celých hodin mezi dvěma časy. Celá hodina je definována jako interval od dané minuty v hodině do stejné minuty v následující hodině. Například 1:23:00 až 2:23:00 je jedna hodina, zatímco 1:23:00 až 2:22:59 je nula celých hodin.

Syntaxe

DateTimeSpan.hours( startDate, endDate )

Argumenty

Vrací

Počet celých hodin mezi dvěma daty.

DateTimeSpan.minutes

Tato funkce vrátí počet celých minut mezi dvěma časy. Celá minuta je definována jako interval od dané sekundy v minutě do stejné sekundy v následující minutě. Například 1:23:00 až 1:24:00 je jedna minuta, zatímco 1:23:00 až 1:22:59 je nula celých minut.

Syntaxe

DateTimeSpan.minutes( startDate, endDate )

Argumenty

Vrací

Počet celých minut mezi dvěma daty.

DateTimeSpan.months

Tato funkce vrátí počet celých měsíců mezi dvěma daty. Celý měsíc je definován jako časový interval od n-tého dne jednoho měsíce do n-tého dne následujícího měsíce. Například 28. únor až 28. březen je jeden měsíc, zatímco 28. únor až 26. březen je nula celých měsíců.

Syntaxe

DateTimeSpan.months( startDate, endDate )

Argumenty

Vrací

Vrací počet celých měsíců mezi dvěma daty.

DateTimeSpan.seconds

Tato funkce vrátí počet sekund mezi dvěma časy.

Syntaxe

DateTimeSpan.seconds( startDate, endDate )

Argumenty

Vrací

Počet celých minut mezi dvěma daty.

DateTimeSpan.subDate

Tato funkce vrací nové datum, které je výsledkem odečtení daného počtu roků, měsíců a dnů od počátečního data. Měsíce mohou být větší než 12 a dny mohou být větší než počet dnů v měsíců. Výsledný efekt je, jako by zde byly tři různé operace. Nejprve odečtěte roky. Potom použijte výsledné datum a odečtěte měsíce. Potom použijte výsledné datum a odečtěte dny.

Při odečítání měsíců nemusí být výsledné datum platné. Například odečtením jednoho měsíce od 30. března dostaneme neplatné datum 30. února. Funkce upraví datum na platné tak, že je upraví na poslední platný den v měsíci. Pokud rok není přestupný, bude v tomto případě datum upraveno na 28.únor.

Všechny argumenty roků, měsíců nebo dnů mohou být prázdné nebo nedefinované. Pokud je tomu tak, pak se hodnota považuje za nulovou.

Všechny argumenty roků, měsíců nebo dnů mohou být záporné. V tomto případě je výsledek takový, jako by byla tato jednotka přičtena k základnímu datu.

Syntaxe

DateTimeSpan.subDate( startDate, roky, měsíce, dny )

Argumenty

Vrací

Datum, které je výsledkem odečtení roků, měsíců a dnů od počátečního data.

Viz také

Funkce DateTimeSpan.addDate

Funkce DateTimeSpan.subTime

DateTimeSpan.subTime

Tato funkce vrací nové datum, které je výsledkem odečtení daného počtu hodin, minut a sekund od počátečního data. Hodiny mohou být větší než 24 a minuty a sekundy mohou být větší než 60. Výsledný efekt je, jako by zde byly tři různé operace. Nejprve odečtěte hodiny. Potom použijte výsledné datum a odečtěte minuty. Potom použijte výsledné datum a odečtěte sekundy.

Všechny argumenty hodin, minut a sekund mohou být prázdné nebo nedefinované. Pokud je tomu tak, pak se hodnota považuje za nulovou.

Všechny argumenty hodin, minut a sekund mohou být záporné. V tomto případě je výsledek takový, jako by byla tato jednotka přičtena k základnímu datu.

Syntaxe

DateTimeSpan.subTime( startDate, hodiny, minuty, sekundy )

Argumenty

Vrací

Datum, které je výsledkem odečtení hodin, minut a sekund od počátečního data.

Viz také

Funkce DateTimeSpan.addTime

Funkce DateTimeSpan.subDate

DateTimeSpan.years

Tato funkce vrátí počet celých roků mezi dvěma daty. Celý rok je definován jako probíhající od daného měsíce, dne a času v jednom roce do stejného měsíce, dne a času v následujícím roce. Kvůli přestupným rokům někdy celý rok obsahuje 356 dní a někdy 366 dní.

Pokud je kterýkoli z argumentů jiný než datum, dojde k výjimce. Pokud má některý argument hodnotu null, pak má výsledek také hodnotu null.

Syntaxe

DateTimeSpan.years( startDate, endDate )

Argumenty

Vrací

Počet celých roků mezi dvěma daty.


(c) Copyright Actuate Corporation 2006

Předchozí témaNásledující téma