DatePart-funktio

Palauttaa variantin (kokonaisluvun), joka sisältää määritetyn osan annetusta päivämäärästä.

Syntaksi

DatePart ( aikaväli, päivämäärä [, viikonensimmäinenpäivä] [, vuodenensimmäinenviikko] )

DatePart-funktion syntaksilla on seuraavat argumentit:

Argumentti

Kuvaus

aikaväli

Pakollinen. Merkkijonolauseke, joka on palautettava aikaväli.

päivämäärä

Pakollinen. Muuttuja-arvo (päivämäärä), jonka haluat arvioida.

viikonensimmäinenpäivä

Valinnainen. vakio, joka määrittää viikon ensimmäisen päivän. Jos tätä argumenttia ei määritetä, oletusasetus on sunnuntai.

vuodenensimmäinenviikko

Valinnainen. Vakio, joka määrittää vuoden ensimmäisen viikon. Jos tätä argumenttia ei määritetä, vuoden ensimmäisenä viikkona käytetään oletusarvoisesti viikkoa, johon tammikuun 1. päivä sijoittuu.


Aset ukset

Aikaväli argumentti-argumentin asetukset ovat seuraavat:

Asetus

Kuvaus

yyyy

Vuosi

q

Vuosineljännes

m

Kuukausi

y

Vuoden päivä

d

Päivä

w

Viikonpäivä

ww

Viikko

h

Tunti

n

Minuutti

s

Sekunti


Viikonensimmäinenpäivä -argumentilla on seuraavat asetukset:

Vakio

Arvo

Kuvaus

vbUseSystem

0

Käytä NLS API -asetusta.

vbSunday

1

Sunnuntai (oletus)

vbMonday

2

Maanantai

vbTuesday

3

Tiistai

vbWednesday

4

Keskiviikko

vbThursday

5

Torstai

vbFriday

6

Perjantai

vbSaturday

7

Lauantai


Vuodenensimmäinenviikko -argumentilla on seuraavat asetukset:

Vakio

Arvo

Kuvaus

vbUseSystem

0

Käytä NLS API -asetusta.

vbFirstJan1

1

Aloita viikosta, jossa on 1. tammikuuta (oletus).

vbFirstFourDays

2

Aloita ensimmäisestä viikosta, jossa on vähintään neljä uuden vuoden päivää.

vbFirstFullWeek

3

Aloita vuoden ensimmäisestä täydestä viikosta.


Huomautuksia

DatePart-funktiolla lasketaan päivämäärä ja palautetaan tietty aikaväli. Voit laskea DatePart-funktiolla esimerkiksi viikonpäivän tai kuluvan tunnin.

Viikonensimmäinenpäivä -argumentti vaikuttaa laskutoimituksissa, joissa käytetään aikavälejä tarkoittavia w- ja ww-symboleja.

Jos päivämäärä on päivämääräliteraali, määritetty vuosi liitetään pysyvästi päivämäärään. Jos päivämäärä kirjoitetaan kuitenkin lainausmerkkeihin (” ”) ja vuosi jätetään pois, kuluva vuosi lisätään koodiin aina, kun päivämäärä-lauseke lasketaan. Näin voidaan kirjoittaa koodia, joka on käyttökelpoista eri vuosina.

Huomautus: Jos kalenterin ominaisuusasetus on Gregoriaaninen, päivämäärä-argumenttien päivämäärä täytyy antaa gregoriaanisen kalenterin mukaisena. Islamilaista kalenteria käytettäessä päivämäärä täytyy antaa islamilaisen kalenterin mukaisena.

Funktion palauttama päivämääräosa ilmoitetaan käytössä olevan arabialaisen kalenterin aikaväliyksikön mukaisesti. Jos käytössä on esimerkiksi islamilainen kalenteri ja palautettava päivämääräosa on vuosi, vuosiarvo ilmoitetaan islamilaisen kalenterin vuotena.

Esimerkki

Huomautus: Seuraavissa esimerkeissä kerrotaan, kuinka tätä funktiota käytetään Visual Basic for Applications (VBA) -moduulissa. Jos haluat lisätietoja VBA:n käytöstä, valitse Sovelluskehittäjän opasHaku-kentän viereisestä luettelosta ja anna yksi tai useampi hakuehto hakukenttään.

Tässä esimerkissä käytetään DatePart-funktiota ja lasketaan, mihin vuosineljännekseen tietty päivämäärä sijoittuu.

Dim TheDate As Date    ' Declare variables.
Dim Msg
TheDate = InputBox("Enter a date:")
Msg = "Quarter: " & DatePart("q", TheDate)
MsgBox Msg
Kehitä taitojasi
Tutustu koulutusmateriaaliin
Saat uudet ominaisuudet ensimmäisten joukossa
Liity Office Insider -käyttäjiin

Oliko näistä tiedoista hyötyä?

Kiitos palautteesta!

Kiitos palautteestasi! Näyttää siltä, että Office-tukiedustajamme avusta voi olla sinulle hyötyä.

×