![]() ![]() |
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.
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.
DateTimeSpan.addDate( kezdődátum, év, hónap, nap )
Olyan dátum, ami az évek, hónapok és napok kezdődátumhoz adásának eredménye.
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
DateTimeSpan.addTime függvény
DateTimeSpan.subDate függvény
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.
DateTimeSpan.addTime( kezdődátum, óra, perc, másodperc )
Olyan dátum, ami az órák, percek és másodpercek kezdődátumhoz adásának eredménye.
DateTimeSpan.addDate függvény
DateTimeSpan.subTime függvény
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.
DateTimeSpan.days( kezdődátum, végdátum )
A két dátum közötti napok számát adja vissza.
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.
DateTimeSpan.hours( kezdődátum, végdátum )
A két dátum közötti egész órák számát adja vissza.
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.
DateTimeSpan.minutes( kezdődátum, végdátum )
A két dátum közötti egész percek számát adja vissza.
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.
DateTimeSpan.months( kezdődátum, végdátum )
Visszaadja a két dátum között eltelt teljes hónapok számát.
Ez a függvény a két időpont között eltelt másodpercek számát adja vissza.
DateTimeSpan.seconds( kezdődátum, végdátum )
A két dátum közötti egész percek számát adja vissza.
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.
DateTimeSpan.subDate( kezdődátum, év, hónap, nap )
Olyan dátum, ami az évek, hónapok és napok kezdődátumból kivonásának eredménye.
DateTimeSpan.addDate függvény
DateTimeSpan.subTime függvény
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.
DateTimeSpan.subTime( kezdődátum, óra, perc, másodperc )
Olyan dátum, ami az órák, percek és másodpercek kezdődátumból kivonásának eredménye.
DateTimeSpan.addTime függvény
DateTimeSpan.subDate függvény
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.
DateTimeSpan.years( kezdődátum, végdátum )
A két dátum közötti egész évek számát adja vissza.
![]() ![]() |