Variant (dátum)értéket ad eredményül.
Szintaxis
DateValue ( date )
A kötelezőargumentum általában egy karakterlánc-kifejezés, amely 9999. január 1. és 9999. december 31. között történt. A dátum azonban bármely olyan kifejezés is lehet, amely az adott tartományban dátumokat, időpontokat, illetve dátumokat és időpontokat egyaránt jelenthet.
Megjegyzések
Ha a dátum olyan karakterlánc, amely csak érvényes dátumelválasztók-val elválasztott számokat tartalmaz, akkor a DateValue a rendszerben megadott Rövid dátum formátumnak megfelelően felismeri a hónap, a nap és az év sorrendjét. A DateValue a hónapneveket tartalmazó egyértelmű dátumokat is felismeri hosszú vagy rövidített formában. A DateValue a 1991.12.30- és 2011.012.30-ai felismerésen kívül 1991. december 30-át és 1991. december 30-át is felismeri.
Ha nem ad meg évértéket, akkor a DateValue a számítógép rendszerdátumának aktuális évét használja.
Ha a dátum argumentum időadatokat is tartalmaz, a DateValue függvény nem adja vissza. Ha azonban a dátum érvénytelen időadatokat (például "89:98") tartalmaz, hiba történik.
Megjegyzés: Dátum esetén,ha a Naptár tulajdonság gergely-naptár szerinti, a megadott dátumnak Gergely-naptár szerintinek kell lennie. Iszlám naptár használata esetén a megadott dátumnak az iszlám naptár szerintinek kell lennie. Ha a megadott dátum iszlám naptár, az argumentum dátuma egy karakterlánc, amely a 2000. 01. 01. dátumnak (Gergely-naptár szerinti augusztus 2. és 9666. 04. 03. között (Gergely-naptár, 9999. december 31.) megfelelő dátum.
Példák lekérdezésre
Kifejezés |
Eredmény: |
SELECT DateValue([DateTime]) AS Expr1 FROM ProductSales; |
A "DateTime" mező dátumértékét adja vissza Rövid dátum formátumban, időinformációk nélkül. |
SELECT DateValue([DateTime]) AS NewDate, Count(ProductSales.DateTime) AS CountOfDateTime FROM ProductSales GROUP BY DateValue([DateTime]); |
A "DateTime" mező dátumértékét adja vissza Rövid dátum formátumban, időinformációk nélkül. |
VBA-példa
Megjegyzés: A következő példák egy Visual Basic for Applications (VBA) modulban mutatják be a függvény használatát. A VBA használatáról a Keresés elem mellett található legördülő listából a fejlesztői forrásokat választva, majd egy vagy több keresőszót megadva kaphat további tájékoztatást.
Ebben a példában a DateValue függvény dátumértékké alakít egy karakterláncot. Dátum-literálok használatával közvetlenül is hozzárendelhet dátumokat egy Variant vagy Dátum változóhoz, például: MyDate = #2/12/69#.
Dim MyDate
MyDate = DateValue("February 12, 1969") ' Return a date.