Edellinen ohjeaiheSeuraava ohjeaihe


Luokka DateTimeSpan

Staattisen DateTimeSpan-luokan funktioiden avulla voi selvittää kahden päivämäärän tai kellonajan välisen ajanjakson pituuden ja lisätä tai vähentää ajanjaksoja. Se sisältää joukon funktioita, joiden avulla voi käsitellä kahden päivämäärän välistä eroa. Koska päivämäärien ajanjaksot ovat numeroita, sovellus voi käyttää niissä tavallista matematiikkaa: esimerkiksi kerto-, jako-, yhteen- ja vähennyslaskua. Tämä luokka on staattinen. Sovellus ei voi luoda luokan ilmentymiä.

DateTimeSpan.addDate

Tämä funktio palauttaa uuden päivämäärän eli summan, joka muodostetaan lisäämällä aloituspäivämäärään annetut vuodet, kuukaudet ja päivät. Kuukausien määrä voi olla suurempi kuin 12, ja päivien määrä voi olla suurempi kuin kuukaudenpäivien määrä. Nettovaikutus on sama kuin kyseessä olisi kolme eri toimintoa. Ensin lisätään vuodet. Sitten tuloksena olevaan päivämäärään lisätään kuukaudet. Lopuksi tuloksena olevaan päivämäärään lisätään päivät.

Kun kuukausi lisätään, tuloksena oleva päivämäärä ei välttämättä ole kelvollinen. Jos esimerkiksi lisätään yksi kuukausi tammikuun 31. päivään, tuloksena on helmikuun 31., joka on virheellinen päivämäärä. Funktio muuttaa päivämäärän kelvolliseksi. Jos kyseessä ei ole karkausvuosi, helmikuussa on 28 päivää, joten tuloksena olisi maaliskuun 3. päivä.

Vuosi-, kuukausi- ja päiväargumentit voivat olla tyhjiä tai määrittämättömiä. Jos näin on, arvoa käsitellään kuin se olisi nolla.

Vuosi-, kuukausi- ja päiväargumentit voivat olla negatiivisia. Tässä tapauksessa tulos on sama kuin jos yksikkö olisi vähennetty peruspäivämäärästä.

Syntaksi

DateTimeSpan.addDate( aloituspäivä, vuodet, kuukaudet, päivät )

Argumentit

Palautukset

Päivämäärä, joka muodostetaan lisäämällä vuodet, kuukaudet ja päivät aloituspäivään.

Esimerkki

var startDate = date.parse( "2004-12-31" ); 
var endDate; 
endDate = DateTimeSpan( aloituspäivä, 1, 0, 0 ); // palauttaa 2005-12-31 
endDate = DateTimeSpan( aloituspäivä, 0, 1, 0 ); // palauttaa 2005-1-31 
endDate = DateTimeSpan( aloituspäivä, 0, 0, 1 ); // palauttaa 2005-1-1 
endDate = DateTimeSpan( aloituspäivä, 1, 1, 1 ); // palauttaa 2005-3-4 

Katso myös

DateTimeSpan.addTime-funktio

DateTimeSpan.subDate-funktio

DateTimeSpan.addTime

Tämä funktio palauttaa uuden päivämäärän eli summan, joka muodostetaan lisäämällä aloituspäivään annetut tunnit, minuutit ja sekunnit. Tuntien määrä voi olla suurempi kuin 24 ja minuuttien sekä sekuntien määrä suurempi kuin 60. Nettovaikutus on sama kuin kyseessä olisi kolme eri toimintoa: Ensin lisätään tunnit. Sitten tuloksena olevaan päivämäärään lisätään minuutit. Lopuksi tuloksena olevaan päivämäärään lisätään sekunnit.

Mikä tahansa tunti-, minuutti- ja sekuntiargumenteista voi olla tyhjä tai määrittämätön. Jos näin on, arvoa käsitellään kuin se olisi nolla.

Mikä tahansa tunti-, minuutti- ja sekuntiargumenteista voi olla negatiivinen. Tässä tapauksessa tulos on sama kuin jos yksikkö olisi vähennetty peruspäivämäärästä.

Syntaksi

DateTimeSpan.addTime( aloituspäivä, tunnit, minuutit, sekunnit )

Argumentit

Palautukset

Päivämäärä, joka muodostetaan lisäämällä tunnit, minuutit ja sekunnit aloituspäivään.

Katso myös

DateTimeSpan.addDate-funktio

DateTimeSpan.subTime-funktio

DateTimeSpan.days

Palauttaa kahden päivämäärän välisten päivien määrän. Päivä määritellään muutokseksi kalenterissa. Siten, helmikuun 27. päivä kello 23.59.59 - helmikuun 28. päivän keskiyö on yksi päivä, kuten myös helmikuun 27. päivän keskiyö - helmikuun 28. päivä kello 23.59.59.

Syntaksi

DateTimeSpan.days( aloituspäivä, lopetuspäivä )

Argumentit

Palautukset

Palauttaa kahden päivämäärän välisten päivien määrän.

DateTimeSpan.hours

Tämä funktio palauttaa kahden kellonajan välisten kokonaisten tuntien määrän. Kokonainen tunti määritellään ajanjaksoksi tunnin tietystä minuutista seuraavan tunnin samaan minuuttiin. Esimerkki: 1.23.00 - 2.23.00 on yksi tunti, mutta 1.23.00 - 2.22.59 on nolla kokonaista tuntia.

Syntaksi

DateTimeSpan.hours( aloituspäivä, lopetuspäivä )

Argumentit

Palautukset

Palauttaa kahden päivämäärän välisten kokonaisten tuntien määrän.

DateTimeSpan.minutes

Tämä funktio palauttaa kahden kellonajan välisten kokonaisten minuuttien määrän. Kokonainen minuutti määritellään ajanjaksoksi minuutin tietystä sekunnista seuraavan minuutin samaan sekuntiin. Esimerkki: 1.23.00 - 1.24.00 on yksi minuutti, mutta 1.23.00 - 1.22.59 on nolla kokonaista minuuttia.

Syntaksi

DateTimeSpan.minutes( aloituspäivä, lopetuspäivä )

Argumentit

Palautukset

Palauttaa kahden päivämäärän välisten kokonaisten minuuttien määrän.

DateTimeSpan.months

Tämä funktio palauttaa kahden päivämäärän välisten kokonaisten kuukausien määrän. Kokonainen kuukausi määritellään ajanjaksoksi kuun tietystä kuukaudenpäivästä seuraavan kuun samaan päivään. Esimerkki: helmikuun 28. - maaliskuun 28. on yksi kuukausi, mutta helmikuun 28. - maaliskuun 26. on nolla kokonaista kuukautta.

Syntaksi

DateTimeSpan.months( aloituspäivä, lopetuspäivä )

Argumentit

Palautukset

Palauttaa kahden päivämäärän välisten täysien kuukausien määrän.

DateTimeSpan.seconds

Tämä funktio palauttaa kahden kellonajan välisten sekuntien määrän.

Syntaksi

DateTimeSpan.seconds( aloituspäivä, lopetuspäivä )

Argumentit

Palautukset

Palauttaa kahden päivämäärän välisten kokonaisten minuuttien määrän.

DateTimeSpan.subDate

Tämä funktio palauttaa uuden päivämäärän, joka muodostetaan vähentämällä annetut vuodet, kuukaudet ja päivät aloituspäivästä. Kuukausien määrä voi olla suurempi kuin 12, ja päivien määrä voi olla suurempi kuin kuukaudenpäivien määrä. Nettovaikutus on sama kuin kyseessä olisi kolme eri toimintoa. Ensin vähennetään vuodet. Sitten tuloksena olevasta päivämäärästä vähennetään kuukaudet. Lopuksi tuloksena olevasta päivämäärästä vähennetään päivät.

Kun kuukausi vähennetään, tuloksena oleva päivämäärä ei välttämättä ole kelvollinen. Jos esimerkiksi maaliskuun 30. päivästä vähennetään kuukausi, tuloksena on helmikuun 30. päivä, joka on virheellinen päivämäärä. Funktio muuttaa päivämäärän kelvolliseksi muuttamalla päiväksi kuukauden viimeisen kelvollisen päivämäärän. Tässä tapauksessa päivämääräksi määritetään helmikuun 28., jos kyseessä ei ole karkausvuosi.

Vuosi-, kuukausi- ja päiväargumentit voivat olla tyhjiä tai määrittämättömiä. Jos näin on, arvoa käsitellään kuin se olisi nolla.

Vuosi-, kuukausi- ja päiväargumentit voivat olla negatiivisia. Tässä tapauksessa tulos on sama kuin jos yksikkö olisi lisätty peruspäivämäärään.

Syntaksi

DateTimeSpan.subDate( aloituspäivä, vuodet, kuukaudet, päivät )

Argumentit

Palautukset

Päivämäärä, joka muodostetaan vähentämällä vuodet, kuukaudet ja päivät aloituspäivästä.

Katso myös

DateTimeSpan.addDate-funktio

DateTimeSpan.subTime-funktio

DateTimeSpan.subTime

Tämä funktio palauttaa uuden päivämäärän, joka muodostetaan vähentämällä annetut tunnit, minuutit ja sekunnit aloituspäivästä. Tuntien määrä voi olla suurempi kuin 24 ja minuuttien sekä sekuntien määrä suurempi kuin 60. Nettovaikutus on sama kuin kyseessä olisi kolme eri toimintoa. Ensin vähennetään tunnit. Sitten tuloksena olevasta päivämäärästä vähennetään minuutit. Lopuksi tuloksena olevasta päivämäärästä vähennetään sekunnit.

Mikä tahansa tunti-, minuutti- ja sekuntiargumenteista voi olla tyhjä tai määrittämätön. Jos näin on, arvoa käsitellään kuin se olisi nolla.

Mikä tahansa tunti-, minuutti- ja sekuntiargumenteista voi olla negatiivinen. Tässä tapauksessa tulos on sama kuin jos yksikkö olisi lisätty peruspäivämäärään.

Syntaksi

DateTimeSpan.subTime( aloituspäivä, tunnit, minuutit, sekunnit )

Argumentit

Palautukset

Päivämäärä, joka muodostetaan vähentämällä tunnit, minuutit ja sekunnit aloituspäivästä.

Katso myös

DateTimeSpan.addTime-funktio

DateTimeSpan.subDate-funktio

DateTimeSpan.years

Tämä funktio laskee kahden päivämäärän välisten kokonaisten vuosien määrän. Kokonainen vuosi määritellään ajanjaksoksi, joka alkaa tietystä kuukaudesta, päivästä ja kellonajasta ja jatkuu samaan ajankohtaan seuraavana vuonna. Karkausvuosien takia kokonainen vuosi sisältää välillä 365 päivää, välillä 366 päivää.

Jos jompikumpi argumenteista on muu kuin päivämäärä, tuloksena on poikkeus. Jos jompikumpi argumenteista on tyhjä, myös tulos on tyhjä.

Syntaksi

DateTimeSpan.years( aloituspäivä, lopetuspäivä )

Argumentit

Palautukset

Palauttaa kahden päivämäärän välisten kokonaisten vuosien määrän.


(c) Copyright Actuate Corporation 2006

Edellinen ohjeaiheSeuraava ohjeaihe