Vrne podatkovni tip Različica (datum) za navedeno leto, mesec in dan.
Sintaksa
DateSerial ( leto, mesec, dan )
Opozorilo Prepričajte se, da so argumenti v pravilnem obsegu vrednosti. Neveljaven argument lahko povzroči nepravilen rezultat.
Sintaksa funkcije DateSerial ima te argumente:
Argument |
Opis |
leto |
Obvezno. Celo število. Število med 100 in vključno 9999 ali več številski izraz. |
mesec |
Obvezno. Celo število. Poljuben številski izraz. |
dan |
Obvezno. Celo število. Poljuben številski izraz. |
Opombe
Če želite določiti datum, na primer 31. december 1991, mora biti obseg števil zaargumentDateSerial v sprejetem obsegu za enoto; to pomeni 1–31 za dni in 1–12 za mesece. Vendar pa lahko določite tudi relativne datume za vsak argument, pri tem pa uporabite poljuben številski izraz, ki predstavlja nekaj dni, mesecev ali let pred določenim datumom ali po tem datumu.
V tem primeru so namesto absolutnih števil datumov uporabljeni številski izrazi. Tukaj funkcija DateSerial vrne datum, ki je dan pred prvim dnem (1 - 1), dva meseca pred avgustom (8 - 2), 10 let pred 1990 (1990 - 10); z drugimi besedami: 31. maj 1980.
DateSerial(1990 - 10, 8 - 2, 1 - 1)
Dvomestne letnice za argument leto se tolmačijo glede na uporabniško določene nastavitve računalnika. Privzete nastavitve, to so vrednosti med 0 in vključno 29, se tolmačijo kot leta 2000–2029. Privzete vrednosti od 30 do 99 se tolmačijo kot leta 1930–1999. Za vse druge argumente leto uporabite štirimestno letnico (na primer 1800).
Različice sistema Windows, starejši od sistema Windows 2000, dvomestne letnice tolmačijo glede na zgoraj opisane privzete nastavitve. Če želite zagotoviti, da bo funkcija vrnila ustrezno vrednost, uporabite štirimestno letnico.
Če kateri od argumentov preseže sprejeti obseg za ta argument, se ustrezno poviša na naslednjo večjo enoto. Na primer, če določite 35 dni, bo to ovrednoteno kot en mesec in nekaj dni, odvisno od tega, kje v letu bo uporabljeno. Če je en sam argument zunaj obsega od – 32.768 do 32.767, pride do napake. Če je datum, ki ga določajo trije argumenti, zunaj sprejemljivega obsega datumov, pride do napake.
Opomba: Za leto, mesecin dan, če je lastnost Calendar nastavljena na gregorijanski, mora biti podana vrednost datum gregorijanskega koledarja. Če je lastnost Calendar nastavljena na islamski koledar, se domneva, da je podana vrednost datum islamskega koledarja.
Vrnjeni del datuma je v enotah časovnega obdobja trenutnega koledarja Visual Basic. Na primer, če gre za trenutni islamski koledar in je del datuma, ki ga želite vrniti leto, bo vrednost leta leto islamskega koledarja. Za argument leto se vrednosti med 0 in vključno 99, tolmačijo kot leta 1400–1499. Za vse druge vrednosti argumenta leto uporabite štirimestno letnico (na primer 1520).
Primer poizvedbe
Izraz |
Rezultati |
SELECT Dateserial(2018,12,13) AS NewDate FROM ProductSales; |
Vrne »datum« za navedeno leto, mesec in dan, vnesen v argumente funkcije in se prikaže v stolpcu »NovDatum«. Rezultat: »12. 13. 2018«. |
primer VBA
Opomba: V spodnjih primerih je prikazana uporaba te funkcije v modulu Visual Basic for Applications (VBA). Če želite več informacij o delu z modulom VBA, izberite Vsebina za razvijalce na spustnem seznamu ob možnosti Iskanje in v iskalno polje vnesite enega ali več izrazov.
V tem primeru je funkcija DateSerial uporabljena za vrnitev datuma za določeno leto, mesec in dan.
Dim MyDate ' MyDate contains the date for February 12, 1969. MyDate = DateSerial(1969, 2, 12) ' Return a date.