![]() ![]() |
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.
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.
DateTimeSpan.addDate( startDate, roky, měsíce, dny )
Datum, které je výsledkem přičtení roků, měsíců a dnů k počátečnímu datu.
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
Funkce DateTimeSpan.addTime
Funkce DateTimeSpan.subDate
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.
DateTimeSpan.addTime( startDate, hodiny, minuty, sekundy )
Datum, které je výsledkem přičtení hodin, minut a sekund k počátečnímu datu.
Funkce DateTimeSpan.addDate
Funkce DateTimeSpan.subTime
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.
DateTimeSpan.days( startDate, endDate )
Vrací počet dní mezi dvěma daty.
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.
DateTimeSpan.hours( startDate, endDate )
Počet celých hodin mezi dvěma daty.
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.
DateTimeSpan.minutes( startDate, endDate )
Počet celých minut mezi dvěma daty.
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ů.
DateTimeSpan.months( startDate, endDate )
Vrací počet celých měsíců mezi dvěma daty.
Tato funkce vrátí počet sekund mezi dvěma časy.
DateTimeSpan.seconds( startDate, endDate )
Počet celých minut mezi dvěma daty.
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.
DateTimeSpan.subDate( startDate, roky, měsíce, dny )
Datum, které je výsledkem odečtení roků, měsíců a dnů od počátečního data.
Funkce DateTimeSpan.addDate
Funkce 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.
DateTimeSpan.subTime( startDate, hodiny, minuty, sekundy )
Datum, které je výsledkem odečtení hodin, minut a sekund od počátečního data.
Funkce DateTimeSpan.addTime
Funkce DateTimeSpan.subDate
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.
DateTimeSpan.years( startDate, endDate )
Počet celých roků mezi dvěma daty.
![]() ![]() |