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 sintaksei 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, katra DateSerial argumenta skaitļu diapazonam ir jābūt vienībai pieņemamajā diapazonā; tas ir, 1–31 dienām un 1–12 mēnešiem. Taču var 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.
Nākamajā piemērā absolūto datumu skaitļu vietā izmantotas skaitliskas izteiksmes. Šeit funkcija DateSerial atgriež datumu, kas ir dienu 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. maiju.
DateSerial(1990 - 10, 8 - 2, 1 - 1)
Gada argumenta gadskaitlis tiek interpretēts, pamatojoties uz lietotāja definētiem datora iestatījumiem. Noklusējuma iestatījumi paredz, ka vērtības diapazonā no 0 līdz 29 (ieskaitot) tiek interpretētas kā gadi no 2000. līdz 2029. gadam. Noklusējuma vērtības diapazonā no 30 līdz 99 tiek interpretētas kā gadi no 1930. līdz 1999. gadam. Visu pārējo gadu argumentiem izmantojiet četrciparu gadskaitli (piemēram, 1800).
Windows versijas, kas vecākas par Windows 2000, interpretē divciparu gadskaitli, pamatojoties uz iepriekš aprakstītajiem noklusējumiem. Lai pārliecinātos, vai funkcija atgriež pareizo vērtību, izmantojiet četrciparu gadu.
Ja kāds arguments pārsniedz šī argumenta pieņemto 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ā gada vietā tas tiek lietots. Ja kāds atsevišķs arguments ir ārpus diapazona no -32 768 līdz 32 767, rodas kļūda. Ja ar trim argumentiem norādītais datums atrodas ārpus pieņemamā datumu diapazona, rodas kļūda.
Piezīme
Ja vērtība, kas atrodas Calendar rekvizīta iestatījumā Gregora kalendārā, tiek pieņemts, ka norādītā vērtība ir Gregora. Ja rekvizīta Calendar iestatījums ir Hidžras, tiek pieņemts, ka norādītā vērtība ir Hidžras.
Atgrieztā datuma daļa ir norādīta pašreizējā Visual Basic kalendāra laika perioda vienībās. Piemēram, ja pašreizējais kalendārs ir Hidžras 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ā gadskaitļi no 1400 līdz 1499. Visu pārējo gadu vērtībām izmantojiet pilnu četrciparu gadskaitli (piemēram, 1520).
Vaicājuma piemērs
| Izteiksme | Rezultāti |
|---|---|
| SELECT Dateserial(2018,12,13) AS NewDate FROM ProductSales; | Atgriež funkcijas argumentos ievadīto konkrētā gada, mēneša un dienas "datumu" un kolonnā "Jauns_datums" parādīto datumu. Rezultāts: "13/12/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ā izmantota funkcija DateSerial , lai atgrieztu konkrē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.