日付を表すバリアント型 (内部処理形式 Date の Variant) の値を返します。
構文
DateValue(date)
通常、required date引数は、100 年 1 月 1 日から 9999 年 12 月 31 日までの日付を表す文字列式です。 ただし、 date は、その範囲内の日付、時刻、または日付と時刻の両方を表すことができる式にすることもできます。
解説
date が有効な日付の区切り記号で区切られた数値のみを含む文字列である場合、DateValue は、システムに指定された短い日付形式に従って、月、日、年の順序を認識します。 DateValue は、完全形または省略形の月の名前を含む一義的な日付も認識します。 たとえば、12/30/1991 や 12/30/91 だけでなく、December 30, 1991 や Dec 30, 1991 も DateValue は認識します。
日付の年の部分を省略すると、DateValue は、コンピューターのシステム日付から現在の年を使用します。
date 引数に時間情報が含まれている場合、DateValue はそれを返しません。 ただし、 日付 に無効な時刻情報 ("89:98" など) が含まれている場合は、エラーが発生します。
注
日付の場合、Calendar プロパティ設定がグレゴリオ暦の場合、指定された日付はグレゴリオ暦である必要があります。 カレンダーがイスラム暦の場合は、イスラム暦で日付を指定する必要があります。 指定された日付がイスラム暦の場合、引数の 日付 は、100/1/1 (グレゴリオ暦 718 年 8 月 2 日) から 9666/4/3 (グレゴリオ暦 9999 年 12 月 31 日) までの日付を表す 文字列 です。
クエリの例
| Expression | 結果 |
|---|---|
| SELECT DateValue([DateTime]) AS Expr1 FROM ProductSales; | 時刻情報を含まない短い日付形式で、フィールド "DateTime" の日付値を返します。 |
| SELECT DateValue([DateTime]) AS NewDate, Count(ProductSales.DateTime) AS CountOfDateTime FROM ProductSales GROUP BY DateValue([DateTime]); | 時刻情報を含まない短い日付形式で、フィールド "DateTime" の日付値を返します。 |
VBA の例
注
次の例は、Visual Basic for Applications (VBA) モジュールでのこの関数の使用方法を示しています。 VBA の使用方法の詳細については、[検索] の横にあるドロップダウン リストで [開発者用リファレンス] を選び、検索ボックスに検索する用語を入力します。
この例では、 DateValue 関数を使用して文字列を日付に変換します。 日付リテラルを使用して、日付を バリアント または 日付 変数に直接割り当てることもできます (例: MyDate = #2/12/69#)。
Dim MyDate
MyDate = DateValue("February 12, 1969") ' Return a date.