![]() ![]() |
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ä.
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ä.
DateTimeSpan.addDate( aloituspäivä, vuodet, kuukaudet, päivät )
Päivämäärä, joka muodostetaan lisäämällä vuodet, kuukaudet ja päivät aloituspäivään.
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
DateTimeSpan.addTime-funktio
DateTimeSpan.subDate-funktio
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ä.
DateTimeSpan.addTime( aloituspäivä, tunnit, minuutit, sekunnit )
Päivämäärä, joka muodostetaan lisäämällä tunnit, minuutit ja sekunnit aloituspäivään.
DateTimeSpan.addDate-funktio
DateTimeSpan.subTime-funktio
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.
DateTimeSpan.days( aloituspäivä, lopetuspäivä )
Palauttaa kahden päivämäärän välisten päivien määrän.
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.
DateTimeSpan.hours( aloituspäivä, lopetuspäivä )
Palauttaa kahden päivämäärän välisten kokonaisten tuntien määrän.
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.
DateTimeSpan.minutes( aloituspäivä, lopetuspäivä )
Palauttaa kahden päivämäärän välisten kokonaisten minuuttien määrän.
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.
DateTimeSpan.months( aloituspäivä, lopetuspäivä )
Palauttaa kahden päivämäärän välisten täysien kuukausien määrän.
Tämä funktio palauttaa kahden kellonajan välisten sekuntien määrän.
DateTimeSpan.seconds( aloituspäivä, lopetuspäivä )
Palauttaa kahden päivämäärän välisten kokonaisten minuuttien määrän.
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.
DateTimeSpan.subDate( aloituspäivä, vuodet, kuukaudet, päivät )
Päivämäärä, joka muodostetaan vähentämällä vuodet, kuukaudet ja päivät aloituspäivästä.
DateTimeSpan.addDate-funktio
DateTimeSpan.subTime-funktio
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.
DateTimeSpan.subTime( aloituspäivä, tunnit, minuutit, sekunnit )
Päivämäärä, joka muodostetaan vähentämällä tunnit, minuutit ja sekunnit aloituspäivästä.
DateTimeSpan.addTime-funktio
DateTimeSpan.subDate-funktio
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ä.
DateTimeSpan.years( aloituspäivä, lopetuspäivä )
Palauttaa kahden päivämäärän välisten kokonaisten vuosien määrän.
![]() ![]() |