BirtDateTime-luokan funktioiden avulla voit selvittää kahden päivämäärän tai kellonajan välisen ajanjakson pituuden, lisätä tai vähentää ajanjaksoja ja noutaa päivämäärän osia. Koska päivämäärien ajanjaksot ovat numeroita, sovellus voi käyttää niissä tavallisia matemaattisia toimintoja, kuten 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, joka muodostetaan lisäämällä aloituspäivään annetut päivät. Lisättävien päivien määrä voi olla negatiivinen. Tässä tapauksessa tulos on sama kuin jos määritetty luku olisi vähennetty päivämäärästä.
Syntaksi
Parametrit
pvm
Päivämääräobjekti. Päivämääräobjekti, joka kuvaa päivämäärää.
n
Lukuobjekti. Päivämäärään lisättävien päivien määrä. Järjestelmä käsittelee desimaalilukuja kokonaislukuina (se pyöristää ne alaspäin lähimpään kokonaislukuun).
Palautukset
Päivämääräobjekti. Päivämäärä, joka muodostetaan lisäämällä määritetyt päivät aloituspäivään.
Esimerkkejä
Seuraavassa esimerkissä määritettyyn päivämäärään lisätään kaksi päivää:
Seuraavassa esimerkissä lisätään 15 päivää kuhunkin InvoiceDate-kentän päivämääräarvoon:
Tämä funktio palauttaa uuden päivämäärän, joka muodostetaan lisäämällä aloituspäivään annetut tunnit. Lisättävien tuntien määrä voi olla negatiivinen. Tässä tapauksessa tulos on sama kuin jos määritetty luku olisi vähennetty päivämäärästä.
Syntaksi
Parametrit
pvm
Päivämääräobjekti, joka kuvaa päivämäärää. Jos aloituspäivämäärässä ei ole kellonaika-arvoa, funktio käyttää oletusarvon mukaan kellonaikana keskiyötä (00:00:00).
n
Lukuobjekti. Päivämäärään lisättävien tuntien määrä.
Palautukset
Päivämääräobjekti. Päivämäärä, joka muodostetaan lisäämällä määritetyt tunnit aloituspäivään.
Esimerkkejä
Seuraavassa esimerkissä päivämäärään ja kellonaikaan lisätään tunteja:
Seuraavassa esimerkissä lisätään 36 tuntia kuhunkin StartTime-kentän päivämääräarvoon:
Tämä funktio palauttaa uuden päivämäärän, joka muodostetaan lisäämällä aloituspäivään annetut minuutit. Lisättävien minuuttien määrä voi olla negatiivinen. Tässä tapauksessa tulos on sama kuin jos määritetty luku olisi vähennetty päivämäärästä.
Syntaksi
Parametrit
pvm
Päivämääräobjekti, joka kuvaa päivämäärää. Jos aloituspäivämäärässä ei ole kellonaika-arvoa, funktio käyttää oletusarvon mukaan kellonaikana keskiyötä (00:00:00).
n
Lukuobjekti. Päivämäärään lisättävien minuuttien määrä.
Palautukset
Päivämääräobjekti. Päivämäärä, joka muodostetaan lisäämällä määritetyt minuutit aloituspäivään.
Esimerkkejä
Seuraavassa esimerkissä päivämäärään ja kellonaikaan lisätään minuutteja:
Seuraavassa esimerkissä lisätään 15 minuuttia kuhunkin StartTime-kentän päivämääräarvoon:
Tämä funktio palauttaa uuden päivämäärän, joka muodostetaan lisäämällä aloituspäivään annetut kuukaudet. Lisättävien kuukausien määrä voi olla negatiivinen. Tässä tapauksessa tulos on sama kuin jos määritetty luku olisi vähennetty päivämäärästä.
Tämä funktio palauttaa aina kelvollisen päivämäärän. Tulospäivämäärän päivämääräosa aikaistetaan tarvittaessa tulosvuoden tuloskuukauden viimeiseksi päivämääräksi. Jos esimerkiksi lisäät yhden kuukauden päivämäärään 31.12.2008, addMonth( )-funktio palauttaa päivämäärän 29.2.2008 (2008 on karkausvuosi), ei päivämäärää 31.2.2008.
Syntaksi
Parametrit
pvm
Päivämääräobjekti. Päivämääräobjekti, joka kuvaa päivämäärää.
n
Lukuobjekti. Päivämäärään lisättävien kuukausien määrä. Järjestelmä käsittelee desimaalilukuja kokonaislukuina (se pyöristää ne alaspäin).
Palautukset
Päivämääräobjekti. Päivämäärä, joka muodostetaan lisäämällä määritetyt kuukaudet aloituspäivään.
Esimerkkejä
Seuraavassa esimerkissä määritettyyn päivämäärään lisätään kuukausia:
Seuraavassa esimerkissä lisätään 10 kuukautta kuhunkin InvoiceDate-kentän päivämääräarvoon:
Tämä funktio palauttaa uuden päivämäärän, joka muodostetaan lisäämällä aloituspäivään annetut vuosineljännekset. Vuosineljännes on kolmen kuukauden pituinen. Jos esimerkiksi lisäät kaksi vuosineljännestä päivämäärään 10.9.2008, funktio palauttaa päivämäärän 10.3.2009. Lisättävien vuosineljännesten määrä voi olla negatiivinen. Tässä tapauksessa tulos on sama kuin jos määritetty luku olisi vähennetty päivämäärästä.
Syntaksi
Parametrit
pvm
Päivämääräobjekti, joka kuvaa päivämäärää.
n
Lukuobjekti. Päivämäärään lisättävien vuosineljännesten määrä.
Palautukset
Päivämääräobjekti. Päivämäärä, joka muodostetaan lisäämällä määritetyt vuosineljännekset aloituspäivään.
Esimerkkejä
Seuraavassa esimerkissä määritettyyn päivämäärään lisätään vuosineljänneksiä:
Seuraavassa esimerkissä lisätään kaksi vuosineljännestä kuhunkin ForecastClosing-kentän päivämääräarvoon:
Tämä funktio palauttaa uuden päivämäärän, joka muodostetaan lisäämällä aloituspäivään annetut sekunnit. Lisättävien sekuntien määrä voi olla negatiivinen. Tässä tapauksessa tulos on sama kuin jos määritetty luku olisi vähennetty päivämäärästä.
Syntaksi
Parametrit
pvm
Päivämääräobjekti, joka kuvaa päivämäärää. Jos aloituspäivämäärässä ei ole kellonaika-arvoa, funktio käyttää oletusarvon mukaan kellonaikana keskiyötä (00:00:00).
n
Lukuobjekti. Päivämäärään lisättävien sekuntien määrä.
Palautukset
Päivämääräobjekti. Tulos, joka saadaan lisäämällä määritetyt sekunnit aloituspäivään.
Esimerkkejä
Seuraavassa esimerkissä päivämäärään ja kellonaikaan lisätään sekunteja:
Seuraavassa esimerkissä lisätään 6 000 sekuntia kuhunkin StartTime-kentän päivämääräarvoon:
Tämä funktio palauttaa uuden päivämäärän, joka muodostetaan lisäämällä aloituspäivään annetut viikot. Lisättävien viikkojen määrä voi olla negatiivinen. Tässä tapauksessa tulos on sama kuin jos määritetty luku olisi vähennetty päivämäärästä.
Syntaksi
Parametrit
pvm
Päivämääräobjekti, joka kuvaa päivämäärää.
n
Lukuobjekti. Päivämäärään lisättävien viikkojen määrä.
Palautukset
Päivämääräobjekti. Päivämäärä, joka muodostetaan lisäämällä määritetyt viikot aloituspäivään.
Esimerkkejä
Seuraavassa esimerkissä määritettyyn päivämäärään lisätään viikkoja:
Seuraavassa esimerkissä lisätään kaksi viikkoa kuhunkin InvoiceDate-kentän päivämääräarvoon:
Tämä funktio palauttaa uuden päivämäärän, joka muodostetaan lisäämällä aloituspäivään annetut vuodet. Lisättävien vuosien määrä voi olla negatiivinen. Tässä tapauksessa tulos on sama kuin jos määritetty luku olisi vähennetty päivämäärästä.
Syntaksi
Parametrit
pvm
Päivämääräobjekti, joka kuvaa päivämäärää.
n
Lukuobjekti. Päivämäärään lisättävien vuosien määrä. Järjestelmä käsittelee desimaalilukuja kokonaislukuina (se pyöristää ne alaspäin).
Palautukset
Päivämäärä, joka muodostetaan lisäämällä määritetyt vuodet aloituspäivään.
Esimerkkejä
Seuraavassa esimerkissä määritettyyn päivämäärään lisätään vuosia:
Seuraavassa esimerkissä lisätään viisi vuotta kuhunkin HireDate-kentän päivämääräarvoon:
Tämä funktio palauttaa luvun 1 - 31, joka vastaa määritetyn päivämäärän kuukaudenpäivää. Jos päivämäärä on esimerkiksi 19.1.2009, funktio palauttaa luvun 19.
Syntaksi
Parametri
pvm
Päivämääräobjekti. Päivämääräobjekti, josta päivä noudetaan.
Palautukset
Määritetyn päivämäärän kuukaudenpäivää vastaava kokonaisluku.
Esimerkkejä
Seuraava esimerkki palauttaa kuukaudenpäivän kustakin ShipDate-kentän arvosta:
Seuraava esimerkki palauttaa kuluvan päivämäärän kuukaudenpäivän:
Tämä funktio palauttaa kahden päivämäärän välisten päivien määrän. Määrä lasketaan vähentämällä ensimmäisen päivämääräarvon päiväosa toisen päivämääräarvon päiväosasta. Jos ensimmäinen päivämäärä on esimerkiksi 30.12.2008 (23.59.59.) ja toinen 31.12.2008 (00.00.00), funktio palauttaa yhden päivän, vaikka päivämääräarvojen aikaväli on vain yksi sekunti.
Syntaksi
Parametrit
pvm1
Päivämääräobjekti, joka määrittää aikavälin alun.
pvm2
Päivämääräobjekti, joka määrittää aikavälin lopun.
Palautukset
Kokonaisluku. Kahden päivämäärän välisten päivien määrä.
Esimerkkejä
Seuraava esimerkki palauttaa määritettyjen päivämäärien välisten päivien määrän:
Seuraava esimerkki palauttaa kuluvan päivämäärän ja vuoden 2009 lopun välisten päivien määrän:
Seuraava esimerkki palauttaa InvoiceDate- ja PaymentDate-kenttien arvojen välisten päivien määrän:
Tämä funktio palauttaa kahden päivämäärän välisten tuntien määrän. Tuntilukema lasketaan vähentämällä ensimmäisen päivämääräarvon tuntiosa toisen päivämääräarvon tuntiosasta. Jos ensimmäinen päivämäärä on esimerkiksi 31.1.2009 (1.30.00.) ja toinen 31.1.2009 (2.00.00), funktio palauttaa yhden tunnin, vaikka päivämääräarvojen aikaväli on vain 30 minuuttia. Jos päivämäärässä ei ole kellonaika-arvoa, funktio käyttää oletusarvon mukaan kellonaikana keskiyötä (00.00.00).
Syntaksi
Parametrit
pvm1
Päivämääräobjekti, joka määrittää aikavälin alun.
pvm2
Päivämääräobjekti, joka määrittää aikavälin lopun.
Palautukset
Kokonaisluku. Kahden päivämäärän välisten tuntien määrä.
Esimerkkejä
Seuraava esimerkki palauttaa määritettyjen päivämäärien välisten tuntien määrän:
Seuraava esimerkki palauttaa kuluvan päivämäärän ja vuoden 2009 lopun välisten tuntien määrän:
Seuraava esimerkki palauttaa StartTime- ja FinishTime-kenttien arvojen välisten tuntien määrän:
Tämä funktio palauttaa kahden päivämäärän välisten minuuttien määrän. Minuuttilukema lasketaan vähentämällä ensimmäisen päivämääräarvon minuuttiosa toisen päivämääräarvon minuuttiosasta. Jos ensimmäinen päivämäärä on esimerkiksi 31.1.2009 (1.30.59.) ja toinen 31.1.2009 (1.31.00), funktio palauttaa yhden minuutin, vaikka päivämääräarvojen aikaväli on vain yksi sekunti. Jos päivämäärässä ei ole kellonaika-arvoa, funktio käyttää oletusarvon mukaan kellonaikana keskiyötä (00.00.00).
Syntaksi
Parametrit
pvm1
Päivämääräobjekti, joka määrittää aikavälin alun.
pvm2
Päivämääräobjekti, joka määrittää aikavälin lopun.
Palautukset
Kokonaisluku. Kahden päivämäärän välisten minuuttien määrä.
Esimerkkejä
Seuraava esimerkki palauttaa määritettyjen päivämäärien välisten minuuttien määrän:
Seuraava esimerkki palauttaa kuluvan päivämäärän ja vuoden 2010 alun välisten minuuttien määrän:
Seuraava esimerkki palauttaa StartTime- ja FinishTime-kenttien arvojen välisten minuuttien määrän:
Tämä funktio palauttaa kahden päivämäärän välisten kuukausien määrän. Kuukausilukema lasketaan vähentämällä ensimmäisen päivämääräarvon kuukausiosa toisen päivämääräarvon kuukausiosasta. Jos ensimmäinen päivämäärä on esimerkiksi 31.1.2009 ja toinen 1.2.2009, funktio palauttaa yhden kuukauden, vaikka päivämääräarvojen aikaväli on vain yksi päivä.
Syntaksi
Parametrit
pvm1
Päivämääräobjekti, joka määrittää aikavälin alun.
pvm2
Päivämääräobjekti, joka määrittää aikavälin lopun.
Palautukset
Kokonaisluku. Kahden päivämäärän välisten kuukausien määrä.
Esimerkkejä
Seuraava esimerkki palauttaa määritettyjen päivämäärien välisten kuukausien määrän:
Seuraava esimerkki palauttaa kuluvan päivämäärän ja vuoden 2010 alun välisten kuukausien määrän:
Seuraava esimerkki palauttaa ProjectStart- ja ProjectComplete-kenttien arvojen välisten kuukausien määrän:
Tämä funktio palauttaa kahden päivämäärän välisten vuosineljännesten määrän. Vuosineljänneslukema lasketaan vähentämällä ensimmäisen päivämääräarvon kuukausiosa toisen päivämääräarvon kuukausiosasta. Kolmen kuukauden ero vastaa yhtä vuosineljännestä. Jos ensimmäinen päivämäärä on esimerkiksi 31.1.2009 ja toinen 1.7.2009, funktio palauttaa luvun 2. Jos ensimmäinen päivämäärä on 1.1.2009 ja toinen 30.9.2009, funktio palauttaa luvun 2.
Syntaksi
Parametrit
pvm1
Päivämääräobjekti, joka määrittää aikavälin alun.
pvm2
Päivämääräobjekti, joka määrittää aikavälin lopun.
Palautukset
Kokonaisluku. Kahden päivämäärän välisten vuosineljännesten määrä.
Esimerkkejä
Seuraava esimerkki palauttaa määritettyjen päivämäärien välisten vuosineljännesten määrän:
Seuraava esimerkki palauttaa kuluvan päivämäärän ja vuoden 2010 alun välisten vuosineljännesten määrän:
Seuraava esimerkki palauttaa ProjectStart- ja ProjectComplete-kenttien arvojen välisten vuosineljännesten määrän:
Tämä funktio palauttaa kahden päivämäärän välisten sekuntien määrän. Jos päivämäärässä ei ole kellonaika-arvoa, funktio käyttää oletusarvon mukaan kellonaikana keskiyötä (00.00.00).
Syntaksi
Parametrit
pvm1
Päivämääräobjekti, joka määrittää aikavälin alun.
pvm2
Päivämääräobjekti, joka määrittää aikavälin lopun.
Palautukset
Kokonaisluku. Kahden päivämäärän välisten sekuntien määrä.
Esimerkkejä
Seuraava esimerkki palauttaa määritettyjen päivämäärien välisten sekuntien määrän:
Seuraava esimerkki palauttaa kuluvan päivämäärän ja vuoden 2010 alun välisten sekuntien määrän:
Seuraava esimerkki palauttaa StartTime- ja FinishTime-kenttien arvojen välisten sekuntien määrän:
Tämä funktio palauttaa kahden päivämäärän välisten viikkojen määrän. Viikkolukema lasketaan vähentämällä ensimmäisen päivämääräarvon viikko-osa toisen päivämääräarvon viikko-osasta. Jos ensimmäinen päivämäärä on esimerkiksi 2.1.2009 (vuoden ensimmäinen viikko) ja toinen 5.1.2009 (vuoden toinen viikko), funktio palauttaa yhden viikon, vaikka päivämääräarvojen aikaväli on vain kolme päivää.
Syntaksi
Parametrit
pvm1
Päivämääräobjekti, joka määrittää aikavälin alun.
pvm2
Päivämääräobjekti, joka määrittää aikavälin lopun.
Palautukset
Kokonaisluku. Kahden päivämäärän välisten viikkojen määrä.
Esimerkkejä
Seuraava esimerkki palauttaa määritettyjen päivämäärien välisten viikkojen määrän:
Seuraava esimerkki palauttaa kuluvan päivämäärän ja vuoden 2010 alun välisten viikkojen määrän:
Seuraava esimerkki palauttaa ProjectStart- ja ProjectComplete-kenttien arvojen välisten viikkojen määrän:
Tämä funktio palauttaa kahden päivämäärän välisten vuosien määrän. Vuosilukema lasketaan vähentämällä ensimmäisen päivämääräarvon vuosiosa toisen päivämääräarvon vuosiosasta. Jos ensimmäinen päivämäärä on esimerkiksi 1.1.2009 ja toinen 31.12.2009, funktio palauttaa luvun 0. Jos ensimmäinen päivämäärä on 15.11.2008 ja toinen 15.1.2009, funktio palauttaa luvun 1.
Syntaksi
Parametrit
pvm1
Päivämääräobjekti, joka määrittää aikavälin alun.
pvm2
Päivämääräobjekti, joka määrittää aikavälin lopun.
Palautukset
Kokonaisluku. Kahden päivämäärän välisten vuosien määrä.
Esimerkkejä
Seuraava esimerkki palauttaa määritettyjen päivämäärien välisten vuosien määrän:
Seuraava esimerkki palauttaa HireDate-kentän arvon ja kuluvan päivän välisten vuosien määrän:
Tämä funktio palauttaa kahden päivämäärän välisten vuosien määrän. Vuosilukema lasketaan vähentämällä ensimmäisen päivämääräarvon vuosiosa toisen päivämääräarvon vuosiosasta. Jos ensimmäinen päivämäärä on esimerkiksi 1.1.2009 ja toinen 31.12.2009, funktio palauttaa luvun 0. Jos ensimmäinen päivämäärä on 15.11.2008 ja toinen 15.1.2009, funktio palauttaa luvun 1.
Syntaksi
Parametrit
pvm1
Päivämääräobjekti, joka määrittää aikavälin alun.
pvm2
Päivämääräobjekti, joka määrittää aikavälin lopun.
Palautukset
Kokonaisluku. Kahden päivämäärän välisten vuosien määrä.
Esimerkkejä
Seuraava esimerkki palauttaa määritettyjen päivämäärien välisten vuosien määrän:
Seuraava esimerkki palauttaa HireDate-kentän arvon ja kuluvan päivän välisten vuosien määrän:
Tämä funktio palauttaa sen kuukauden ensimmäisen päivän päivämäärän, jonka ajalle syötetty päivämäärä osuu.
Syntaksi
Parametrit
pvm
Päivämääräobjekti, josta kuukausi noudetaan.
Palautukset
Päivämääräobjekti. Annetun päivämäärän kuukauden ensimmäinen päivä.
Esimerkkejä
Seuraavassa esimerkissä on määritetyn päivämäärän kuukausiarvo eri palautusmuodoissa:
Tämä funktio palauttaa sen vuosineljänneksen ensimmäisen päivän päivämäärän, jonka ajalle syötetty päivämäärä osuu.
Syntaksi
Parametrit
pvm
Päivämääräobjekti, josta vuosineljännes noudetaan.
Palautukset
Päivämääräobjekti. Annetun päivämäärän vuosineljänneksen ensimmäinen päivä.
Esimerkkejä
Seuraavassa esimerkissä on määritetyn päivämäärän vuosineljännesarvo eri palautusmuodoissa:
Tämä funktio palauttaa sen viikon ensimmäisen päivän päivämäärän, jonka ajalle syötetty päivämäärä osuu (viikonpäivä on tällöin aina sunnuntai).
Syntaksi
Parametrit
pvm
Päivämääräobjekti, josta viikko noudetaan.
Palautukset
Päivämääräobjekti. Annetun päivämäärän viikon ensimmäinen päivä.
Esimerkkejä
Seuraavassa esimerkissä on määritetyn päivämäärän viikkoarvo eri palautusmuodoissa:
Tämä funktio palauttaa sen vuoden ensimmäisen päivän päivämäärän, jonka ajalle syötetty päivämäärä osuu.
Syntaksi
Parametrit
pvm
Päivämääräobjekti, josta vuosi noudetaan.
Palautukset
Päivämääräobjekti. Annetun päivämäärän vuoden ensimmäinen päivä.
Esimerkkejä
Seuraavassa esimerkissä on määritetyn päivämäärän vuosiarvo eri palautusmuodoissa:
Tämä funktio palauttaa määritetyn päivämäärän mukaisen kuukauden. Funktio palauttaa valinnan mukaan joko kuukauden järjestysnumeron tai kuukauden koko nimen tai nimilyhenteen. Kuukauden nimi määräytyy paikallistunnuksen mukaan.
Syntaksi
Parametrit
pvm
Päivämääräobjekti, josta kuukausi noudetaan.
valinta
Kokonaisluku. Valinnainen. Luku, joka määrittää kuukauden palautusmuodon. Käytä jotakin seuraavista arvoista:
Jos argumenttia ei ole määritetty, funktio palauttaa kuukauden lukuna.
Palautukset
Merkkijono. Määritetyn päivämäärän mukainen kuukausi.
Esimerkkejä
Seuraavassa esimerkissä on määritetyn päivämäärän kuukausiarvo eri palautusmuodoissa:
Seuraava esimerkki palauttaa kuluvan päivämäärän kuukauden:
Tämä funktio palauttaa kuluvan päivämäärän ja kellonajan, kuten 2.2.2009 14.05.
Syntaksi
Palautukset
Päivämääräobjekti. Kuluva päivämäärä ja kellonaika.
Esimerkki
Seuraava esimerkki palauttaa kuluvan päivämäärän ja joulun välisten tuntien määrän:
Tämä funktio palauttaa luvun 1 - 4, joka vastaa määritetyn päivämäärän mukaista vuosineljännestä. Ensimmäisen vuosineljänneksen alkamispäivä on 1.1.
Syntaksi
Parametri
pvm
Päivämääräobjekti, josta vuosineljännes noudetaan.
Palautukset
Kokonaisluku. Määritetyn päivämäärän mukainen vuosineljännes.
Esimerkkejä
Seuraavassa esimerkissä on palautettuna määrättyjen päivämäärien mukaiset vuosineljännekset:
Seuraava esimerkki palauttaa vuosineljänneksen kustakin CloseDate-kentän arvosta:
Seuraava esimerkki palauttaa kuluvan päivämäärän vuosineljänneksen numeron:
Tämä funktio palauttaa kuluvan päivämäärän ja keskiyön kellonajan, esimerkiksi 2.2.2009 00.00.
Syntaksi
Palautukset
Päivämääräobjekti. Kuluva päivämäärä ja keskiyön kellonaika.
Esimerkkejä
Seuraava esimerkki palauttaa kuluvan päivämäärän ja joulun välisten päivien määrän:
Seuraava esimerkki palauttaa HireDate-kentän kunkin arvon ja kuluvan päivän välisten vuosien määrät:
Tämä funktio palauttaa luvun 1 - 52, joka vastaa määritetyn päivämäärän mukaisen viikon järjestysnumeroa.
Syntaksi
Parametri
pvm
Päivämääräobjekti, josta viikon numero noudetaan.
Palautukset
Kokonaisluku. Määritetyn päivämäärän mukainen viikon numero.
Esimerkkejä
Seuraavassa esimerkissä on palautettuna määrättyjen päivämäärien mukaiset viikkojen numerot:
Seuraava esimerkki palauttaa viikon numeron kustakin CloseDate-kentän arvosta:
Seuraava esimerkki palauttaa kuluvan päivämäärän viikon numeron:
Tämä funktio palauttaa määritetyn päivämäärän mukaisen viikonpäivän. Funktio palauttaa valinnan mukaan joko viikonpäivän järjestysnumeron tai viikonpäivän koko nimen tai nimilyhenteen. Viikonpäivän nimi määräytyy paikallistunnuksen mukaan.
Syntaksi
Parametrit
pvm
Päivämääräobjekti, josta viikonpäivä noudetaan.
valinta
Kokonaisluku. Valinnainen. Luku, joka määrittää palautusmuodon. Käytä jotakin seuraavista arvoista:
Jos argumenttia ei ole määritetty, funktio toimii valinnan 1 mukaisesti.
Palautukset
Merkkijono. Määritetyn päivämäärän mukainen päivä.
Esimerkkejä
Seuraavassa esimerkissä on määritetyn päivämäärän viikonpäiväarvo eri palautusmuodoissa:
Seuraava esimerkki palauttaa kuluvan päivämäärän viikonpäivän:
Tämä funktio palauttaa määritetyn päivämäärän mukaisen vuoden neljän numeron pituisena. Jos päivämäärä on esimerkiksi 19.1.2009, funktio palauttaa arvon 2009.
Syntaksi
Parametri
pvm
Päivämääräobjekti, josta vuosi noudetaan.
Palautukset
Kokonaisluku. Määritetyn päivämäärän vuosi neljän numeron pituisena.
Esimerkkejä
Seuraava esimerkki palauttaa HireDate-kentän kunkin arvon mukaisen vuoden:
Seuraava esimerkki palauttaa kuluvan päivämäärän mukaisen vuoden: