DateValue関数

DateValue関数は、VBA関数の中で日付・時刻関数に分類される関数です。

DateValue関数とは

DateValue関数は、日付を表すバリアント型 (内部処理形式 Date の Variant) の値を返します。

引数	省略	説明
構文	DateValue(date)
date	×	引数 date には、通常、100 年 1 月 1 日から 9999 年 12 月 31 日までの範囲の日付を表す文字列式を指定します。また、この範囲内の日付や時刻、または日付と時刻の両方を表す任意の式を指定することもできます。

引数 date が有効な日付の区切り文字によって区切られた数字だけが含まれる場合、DateValue 関数はコントロールパネルで設定した短い日付の書式に従って、年、月、および日の順序を認識します。また DateValue 関数は、日付に月の名前がそのまま記述してあっても、また省略した形式であっても認識します。たとえば、"1991/12/30" や "91/12/30" だけでなく、"平成 3 年 12 月 30 日"、"H3 - 12 - 30" などの形式で指定することもできます。

引数 date を指定するときに年を省略すると、DateValue 関数はシステムの日付を現在の年として使用します。

引数 date に時刻の値を含むとき、DateValue 関数はその時刻を戻り値として返しません。ただし、引数 date に不正な時刻 (たとえば "89:89") を指定したときには、エラーが発生します。

Calendar プロパティの設定がグレゴリオ暦の場合、引数 date にはグレゴリオ暦で表される日付を指定する必要があります。Calendar プロパティの設定が回教暦の場合、引数 date には回教暦で表される日付を指定する必要があります。Calendar プロパティの設定が回教暦の場合、引数 date には 1/1/100 (グレゴリオ暦 Aug 2, 718) ～ 4/3/9666 (グレゴリオ暦 Dec 31, 9999) の範囲の日付を表す文字列を指定できます。

DateValue関数のサンプルコード

次の例は、DateValue 関数を使って、文字列を日付に変換します。日付リテラルを使って、バリアント型 (Variant) や日付型 (Date) の変数に日付を直接代入することもできます (たとえば MyDate = #02/12/69#)。


Sub sample()

 Dim MyDate
 MyDate = DateValue("February 12, 1969")    ' 日付を返します。

End Sub

実行結果

解説

日付・時刻関数一覧

関数名	内容
Date	現在のシステム日付を算出します。
DateAdd	指定した期間を加えた値を算出します。
DateDiff	指定した時間単位で、2つの日付の差を算出します。
DatePart	日付の指定した部分を算出します。
DateSerial	指定した年月日に対応するバリアント型の値を算出します。
DateValue	日付を表すバリアント型の値を算出します。
Day	指定した日付から、日を表す1～31までの値を算出します。
Hour	指定した時刻から、時間を表す0～23の値を算出します。
Minute	指定した時刻から、分を表す0～59の値を算出します。
Month	指定した日付から、月を表す1～12までの値を算出します。
Now	現在のシステム日付と時刻を算出します。
Second	指定した時刻から、秒を表す0～59の値を算出します。
Time	現在のシステム時刻を算出します。
Timer	午前0時から経過した秒数を算出します。
TimeSerial	指定した時分秒をバリアント型の値で算出します。
TimeValue	時刻をバリアント型の値で取得します。
Weekday	指定した日付の曜日を算出します。
Year	指定した日付の年を算出します。