Atgriež Variant (Date) vērtību norādītajam gadam, mēnesim un dienai.
Sintakse
DateSerial ( gads, mēnesis, diena )
Brīdinājums Pārliecinieties, vai argumenti ir pareizajā vērtību diapazonā. Nederīgs arguments var izraisīt nepareizu rezultātu.
Funkcijas DateSerial sintaksē ir šādi argumenti:
Arguments |
Apraksts |
gads |
Obligāts arguments. Vesels skaitlis. Skaitlis no 100 līdz 9999, ieskaitot, vai skaitliska izteiksme. |
mēnesis |
Obligāts arguments. Vesels skaitlis. Jebkāda skaitliska izteiksme. |
diena |
Obligāts arguments. Vesels skaitlis. Jebkāda skaitliska izteiksme. |
Piezīmes
Lai norādītu datumu, piemēram, 1991. gada 31. decembris, skaitļu diapazonam katrā DateSerialarguments ir jābūt mērvienības akceptētā diapazonā; tas ir, 1–31 dienām un 1–12 mēnešiem. Tomēr varat arī norādīt relatīvos datumus katram argumentam, izmantojot jebkuru skaitlisku izteiksmi, kas apzīmē noteiktu dienu, mēnešu vai gadu skaitu pirms vai pēc noteikta datuma.
Šajā piemērā absolūto datumu skaitļu vietā tiek izmantotas skaitliskas izteiksmes. Šeit funkcija DateSerial atgriež datumu, kas ir diena pirms pirmās dienas (1 - 1), divus mēnešus pirms augusta (8 - 2), 10 gadus pirms 1990. gada (1990 - 10); citiem vārdiem sakot, 1980. gada 31. maijs.
DateSerial(1990 - 10, 8 - 2, 1 - 1)
Argumenta gads divciparu gadi tiek interpretēti, pamatojoties uz lietotāja definētiem datora iestatījumiem. Noklusējuma iestatījumi ir vērtības no 0 līdz 29, ieskaitot, tiek interpretētas kā 2000–2029 gadi. Noklusējuma vērtības no 30 līdz 99 tiek interpretētas kā gadi no 1930 līdz 1999. Visiem pārējiem gada argumentiem izmantojiet četrciparu gadskaitļu (piemēram, 1800).
Windows versijās, kas ir vecākas par Windows 2000, tiek interpretēti divciparu gadi, pamatojoties uz iepriekš aprakstītajiem noklusējuma iestatījumiem. Lai funkcija atgrieztu pareizu vērtību, izmantojiet četrciparu gadskaitti.
Ja kāds arguments pārsniedz argumenta akceptēto diapazonu, tas atbilstoši tiek palielināts uz nākamo lielāko vienību. Piemēram, ja norādāt 35 dienas, tas tiek novērtēts kā viens mēnesis un noteikts dienu skaits atkarībā no tā, kurā gadā tā tiek lietota. Ja kāds no argumentiem atrodas ārpus diapazona no -32 768 līdz 32 767, rodas kļūda. Ja ar trim argumentiem norādītais datums neietilpst pieņemamā datumu diapazonā, rodas kļūda.
Piezīme.: Ja gada, mēneša undienas rekvizīta iestatījums ir Gregora kalendārs, tiek pieņemts, ka norādītā vērtība ir Gregora. Ja rekvizīta Kalendārs iestatījums ir Hidžras, tiek pieņemts, ka norādītā vērtība ir Hidžras.
Atgrieztā datuma daļa ir pašreizējā Visual Basic kalendāra laika perioda mērvienībās. Piemēram, ja pašreizējais kalendārs ir Hidžras kalendārs un atgriežamā datuma daļa ir gads, gada vērtība ir Hidžras gads. Argumenta gadā vērtības no 0 līdz 99, ieskaitot, tiek interpretētas kā gadi no 1400 līdz 1499. Visu pārējo gadu vērtības izmantojiet pilno četrciparu gadskaitļu (piemēram, 1520).
Vaicājuma piemērs
Izteiksme |
Rezultāti |
SELECT Dateserial(2018;12;13) AS NewDate FROM ProductSales; |
Atgriež funkcijas argumentos ievadītā norādītā gada, mēneša un dienas "datumu" un tiek parādīts kolonnā "Jauns_datums". Rezultāts: "01.13.2018.". |
VBA piemērs
Piezīme.: Turpmākajos piemēros redzama šīs funkcijas izmantošana Visual Basic for Applications (VBA) modulī. Lai iegūtu papildinformāciju par darbu ar VBA, nolaižamajā sarakstā atlasiet Uzziņas materiāli izstrādātājiem blakus meklēšanas lodziņam un ievadiet šajā lodziņā vienu vai vairākus vārdus.
Šajā piemērā tiek izmantota funkcija DateSerial , lai atgrieztu norādītā gada, mēneša un dienas datumu.
Dim MyDate ' MyDate contains the date for February 12, 1969. MyDate = DateSerial(1969, 2, 12) ' Return a date.