Előző témakörKövetkező témakör


DateTimeSpan osztály

A statikus DateTimeSpan osztály két dátum vagy időpont között eltelt idő meghatározására és időtartamok összeadására vagy kivonására szolgáló függvényeket biztosít. Függvények készletével szolgál a két dátum közötti különbség kezeléséhez. Mivel az időtartamok csak számok, ezért az alkalmazás szokásos matematikát használ rajtuk: szorzás, osztás, összeadás, kivonás, és így tovább. Ez az osztály statikus. Az alkalmazás nem tud példányokat létrehozni az osztályból.

DateTimeSpan.addDate

Ez a függvény olyan új dátumot ad vissza, ami a kiindulási dátum és adott számú év, hónap és nap összege. A hónapok száma lehet 12-nél több, és a napok száma lehet több, mint egy hónap napjainak száma. Az összesített hatás olyan, mintha három külön művelet lenne. Először adja hozzá az éveket. Aztán az eredményül kapott dátumot használva adja hozzá a hónapokat. Majd az eredményül kapott dátumot használva adja hozzá a napokat.

Hónap hozzáadásakor elképzelhető, hogy az eredményül kapott dátum nem érvényes. Például egy hónap hozzáadása a január 31. dátumhoz az érvénytelen február 31. dátumhoz vezetne. A függvény úgy állítja be a dátumot, hogy érvényes legyen; ebben az esetben ha az év nem szökőév, akkor a február 28 napos, és a keletkező dátum március 3-a lenne.

Az év, hónap és nap argumentumok bármelyike lehet null vagy nem definiált. Ha így van, akkor az értéket úgy tekinti a rendszer, mintha nulla lenne.

Az év, hónap és nap argumentumok bármelyike lehet negatív. Ebben az esetben az eredmény olyan, mintha az egység kivonásra került volna az alapdátumból.

Szintaxis

DateTimeSpan.addDate( kezdődátum, év, hónap, nap )

Argumentumok

Visszatérési érték

Olyan dátum, ami az évek, hónapok és napok kezdődátumhoz adásának eredménye.

Példa

var kezdődátum = date.parse( "2004-12-31" ); 
var végdátum; 
végdátum = DateTimeSpan( kezdődátum, 1, 0, 0 ); // 2005-12-31 
végdátum = DateTimeSpan( kezdődátum, 0, 1, 0 ); // 2005-1-31 
végdátum = DateTimeSpan( kezdődátum, 0, 0, 1 ); // 2005-1-1 
végdátum = DateTimeSpan( kezdődátum, 1, 1, 1 ); // 2005-3-4 

Lásd még

DateTimeSpan.addTime függvény

DateTimeSpan.subDate függvény

DateTimeSpan.addTime

Ez a függvény olyan új dátumot ad vissza, ami a kiindulási dátum és adott számú óra, perc és másodperc összege. Az órák száma lehet nagyobb, mint 24, és a percek és másodpercek száma nagyobb, mint 60. Az összesített hatás olyan, mintha három külön művelet lenne: először az órákat adja hozzá. Aztán az eredményül kapott dátumot használva adja hozzá a perceket. Majd az eredményül kapott dátumot használva adja hozzá a másodperceket.

Az óra, perc, másodperc argumentumok bármelyike lehet null vagy nem definiált. Ha így van, akkor az értéket úgy tekinti a rendszer, mintha nulla lenne.

Az óra, perc, másodperc argumentumok bármelyike lehet negatív. Ebben az esetben az eredmény olyan, mintha az egység kivonásra került volna az alapdátumból.

Szintaxis

DateTimeSpan.addTime( kezdődátum, óra, perc, másodperc )

Argumentumok

Visszatérési érték

Olyan dátum, ami az órák, percek és másodpercek kezdődátumhoz adásának eredménye.

Lásd még

DateTimeSpan.addDate függvény

DateTimeSpan.subTime függvény

DateTimeSpan.days

A két dátum közötti napok számát adja vissza. A nap a naptár változása. Így a február 27-én délután 11:59:59-től február 28-án éjfélig eltelt idő egy nap, mint ahogy a február 27-én éjféltől február 28-án 11:59:59-ig eltelt idő is.

Szintaxis

DateTimeSpan.days( kezdődátum, végdátum )

Argumentumok

Visszatérési érték

A két dátum közötti napok számát adja vissza.

DateTimeSpan.hours

Ez a függvény a két időpont között eltelt teljes órák számát adja vissza. Egy egész óra egy óra adott percétől a következő óra ugyanazon percéig tart. Például 1:23:00-tól 2:23:00-ig egy óra telik el, de 1:23:00-tól 2:22:59-ig nulla egész óra.

Szintaxis

DateTimeSpan.hours( kezdődátum, végdátum )

Argumentumok

Visszatérési érték

A két dátum közötti egész órák számát adja vissza.

DateTimeSpan.minutes

Ez a függvény a két időpont között eltelt teljes percek számát adja vissza. Egy egész perc egy perc adott másodpercétől a következő perc ugyanazon másodpercéig tart. Például 1:23:00-tól 1:24:00-ig egy perc telik el, de 1:23:00-tól 1:23:59-ig nulla egész perc.

Szintaxis

DateTimeSpan.minutes( kezdődátum, végdátum )

Argumentumok

Visszatérési érték

A két dátum közötti egész percek számát adja vissza.

DateTimeSpan.months

Ez a függvény a két időpont között eltelt teljes hónapok számát adja vissza. Egy egész hónap az egyik hónap adott napjától a következő hónap ugyanannyiadik napjáig terjedő időszak. Például a február 28-tól március 28-ig eltelt idő egy hónap, de a február 28-tól március 26-ig eltelt idő nulla egész hónap.

Szintaxis

DateTimeSpan.months( kezdődátum, végdátum )

Argumentumok

Visszatérési érték

Visszaadja a két dátum között eltelt teljes hónapok számát.

DateTimeSpan.seconds

Ez a függvény a két időpont között eltelt másodpercek számát adja vissza.

Szintaxis

DateTimeSpan.seconds( kezdődátum, végdátum )

Argumentumok

Visszatérési érték

A két dátum közötti egész percek számát adja vissza.

DateTimeSpan.subDate

Ez a függvény olyan új dátumot ad vissza, ami a kiindulási dátum és adott számú év, hónap és nap különbsége. A hónapok száma lehet 12-nél több, és a napok száma lehet több, mint egy hónap napjainak száma. Az összesített hatás olyan, mintha három külön művelet lenne. Először vonja ki az éveket. Aztán az eredményül kapott dátumot használva vonja ki a hónapokat. Majd az eredményül kapott dátumot használva vonja ki a napokat.

Hónap kivonásakor elképzelhető, hogy az eredményül kapott dátum nem érvényes. Például egy hónap kivonása a március 30. dátumból az érvénytelen február 30. dátumhoz vezetne. A függvény úgy igazítja a dátumot, hogy érvényes legyen, figyelve a hónap utolsó érvényes napjára. Ebben az esetben ha az év nem szökőév, akkor az igazított dátum február 28.

Az év, hónap és nap argumentumok bármelyike lehet null vagy nem definiált. Ebben az esetben az értéket úgy tekinti a rendszer, mintha nulla lenne.

Az év, hónap és nap argumentumok bármelyike lehet negatív. Ebben az esetben az eredmény olyan, mintha az egység hozzáadásra került volna az alapdátumhoz.

Szintaxis

DateTimeSpan.subDate( kezdődátum, év, hónap, nap )

Argumentumok

Visszatérési érték

Olyan dátum, ami az évek, hónapok és napok kezdődátumból kivonásának eredménye.

Lásd még

DateTimeSpan.addDate függvény

DateTimeSpan.subTime függvény

DateTimeSpan.subTime

Ez a függvény olyan új dátumot ad vissza, ami a kiindulási dátum és adott számú óra, perc és másodperc különbsége. Az órák száma lehet nagyobb, mint 24, és a percek és másodpercek száma nagyobb, mint 60. Az összesített hatás olyan, mintha három külön művelet lenne. Először vonja ki az órákat. Aztán az eredményül kapott dátumot használva vonja ki a perceket. Majd az eredményül kapott dátumot használva vonja ki a másodperceket.

Az óra, perc, másodperc argumentumok bármelyike lehet null vagy nem definiált. Ebben az esetben az értéket úgy tekinti a rendszer, mintha nulla lenne.

Az óra, perc, másodperc argumentumok bármelyike lehet negatív. Ebben az esetben az eredmény olyan, mintha az egység hozzáadásra került volna az alapdátumhoz.

Szintaxis

DateTimeSpan.subTime( kezdődátum, óra, perc, másodperc )

Argumentumok

Visszatérési érték

Olyan dátum, ami az órák, percek és másodpercek kezdődátumból kivonásának eredménye.

Lásd még

DateTimeSpan.addTime függvény

DateTimeSpan.subDate függvény

DateTimeSpan.years

Ez a függvény a két időpont között eltelt teljes évek számát adja vissza. Egy teljes év egy év adott hónap, nap időpontjától a következő év ugyanazon hónap, nap, időpontjáig tart. A szökőévek miatt a teljes év néha 365, néha pedig 366 napból áll.

Ha valamelyik argumentum nem dátum, akkor kivétel történik. Ha valamelyik argumentum null, akkor az eredmény is null.

Szintaxis

DateTimeSpan.years( kezdődátum, végdátum )

Argumentumok

Visszatérési érték

A két dátum közötti egész évek számát adja vissza.


(c) Copyright Actuate Corporation 2006

Előző témakörKövetkező témakör