Palauttaa variantin (kokonaisluvun), joka sisältää määritetyn osan annetusta päivämäärästä.
|
Varoitus Tämän funktion käytössä on ongelma. Joidenkin kalenteri vuosien viimeinen maanantai voidaan palauttaa viikoksi 53, kun sen pitäisi olla viikko 1. Lisä tietoja ja vaihtoehtoinen menetelmä on Ohje aiheessa muoto-tai DatePart-funktiot voivat palauttaa väärän viikko numeron vuoden viimeisenä maanantaina. |
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ä ei määritetä, ensimmäisen viikon oletetaan olevan viikko, jolloin tammikuu 1 toteutuu. |
Asetukset
Aika väli -argumentilla on seuraavat asetukset:
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.
Kysely esimerkit
Lauseke | Tulokset |
|---|---|
|
Valitse DatePart ("VVVV", [DateofSale]) kuin tuote myynti-kohdan päivä määrä. |
Palauttaa "DateofSale"-kentän päivämäärä arvojen vuosi luvun. |
|
Valitse DatePart ("q", [DateofSale]) kuin tuote myynti-kohdan päivä määrä. |
Palauttaa vuosi neljänneksen (kalenteri vuoden perusteella)-kentän päivämäärä arvot "DateofSale". |
|
Valitse DatePart ("y", [DateofSale]) kuin tuote myynti-kohdan päivä määrä. |
Palauttaa vuoden päivä luvun (1 – 365), joka on "DateofSale"-kentän päivämäärä arvojen arvo. |
|
Valitse DatePart ("d", [DateofSale]) kuin tuote myynti-kohdan päivä määrä. |
Palauttaa päivä-arvon, joka on "DateofSale"-kentän päivämäärä arvot. |
|
Valitse DatePart ("w", [DateofSale]) kuin uusi päivä määrä ProductSales; |
Palauttaa päivä määrän (1 – 7, jossa 1 on sunnuntai) Päivämäärä arvojen kentässä "DateofSale". |
|
Valitse DatePart ("WW", [DateofSale]) kuin tuote myynti-kohdan päivä määrä. |
Palauttaa viikon numeron (1 – 52), jossa on "DateofSale"-kentän päivämäärä arvot. |
|
Valitse DatePart ("h", [DateTime]). |
Palauttaa DateTime-kentän päivämäärä arvojen tunti arvon. |
|
Valitse DatePart ("n", [DateTime]). |
Palauttaa "DateTime"-kentän päivämäärä arvojen minuutit. |
|
Valitse DatePart ("s", [DateTime]). |
Palauttaa "DateTime"-kentän päivämäärä arvojen sekunnit. |
VBA-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
