日付を表すバリアント型 (内部処理形式 Date の Variant) の値を返します。
構文
DateValue(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" など) が含まれている場合は、エラーが発生します。
注
date の場合、Calendar プロパティ設定がグレゴリオ暦の場合、指定された日付はグレゴリオ暦である必要があります。 カレンダーがイスラム暦の場合は、イスラム暦で日付を指定する必要があります。 指定された日付が Hijri の場合、引数 date は、1/1/100 (グレゴリオ暦 8 月 2 日、718 年 8 月 2 日) から 4/3/9666 (グレゴリオ暦 12 月 31 日、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 関数を使用して文字列を日付に変換します。 また、日付リテラルを使用して 、バリアント型 変数または Date 変数 (MyDate = #2/12/69# など) に日付を直接割り当てることもできます。
Dim MyDate
MyDate = DateValue("February 12, 1969") ' Return a date.