Egy dátumvariantot ad eredményül.
Szintaxis
DateValue(date)
A kötelező dátumargumentumáltalában egy olyan karakterlánc-kifejezés, amely 100. január 1. és 9999. december 31. közötti dátumnak felel meg. A dátum azonban bármilyen olyan kifejezést tartalmazhat, amely egy, a megadott tartományon belüli dátumnak, időpontnak vagy mindkettőnek felel meg.
Megjegyzések
Ha a dátum olyan karakterlánc, amely csak érvényes dátumelválasztókkal elválasztott számokat tartalmaz, a DateValue a hónap, a nap és az év sorrendjét a rendszerben megadott rövid dátumformátumnak megfelelően ismeri fel. A Dátumérték felismeri a hosszú és rövidített hónapneveket tartalmazó egyértelmű dátumokat is. Például az 1991.12.30. és a 2991.12.30. dátum felismerése mellett a Dátumérték felismeri az 1991. december 30. és az 1991. december 30. dátumot is.
Ha a dátum év részét elhagyja, a DateValue a számítógép rendszerdátumának aktuális évét használja.
Ha a Dátum argumentum időpontot tartalmaz, a Dátumérték nem adja vissza azt. Ha azonban a dátum érvénytelen időadatot tartalmaz (például "89:98"), hiba lép fel.
Megjegyzés
Ha a dátum beállítása a Calendar tulajdonság Gergely-naptár szerinti értékre van állítva, 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, a dátum argumentum a 2010. 01. 01. (Gergely-naptár 718. augusztus 2.) és 9666. 04. 03. (Gergely-naptár 9999. december 31.) közötti dátumnak felel meg.
Példák lekérdezésekre
| Expression (Kifejezés) | Eredmény: |
|---|---|
| SELECT DateValue([DateTime]) AS Expr1 FROM ProductSales; | A "Dátum/idő" mező dátumértékeit adja vissza rövid dátumformátumban, időpont-információ nélkül. |
| SELECT DateValue([DateTime]) AS NewDate, Count(ProductSales.DateTime) AS CountOfDateTime FROM ProductSales GROUP BY DateValue([DateTime]); | A "Dátum/idő" mező dátumértékeit adja vissza rövid dátumformátumban, időpont-információ 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.
Ez a példa a DateValue függvény segítségével dátummá alakít egy karakterláncot. Dátumkonstansok használatával közvetlenül is hozzárendelhet dátumot egy Variant vagy Dátum változóhoz, például: SajátDátum = #69.02.12.#.
Dim MyDate
MyDate = DateValue("February 12, 1969") ' Return a date.