VBAのIE制御

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

目次

• DateValue関数とは
• DateValue関数のサンプルコード
  • 実行結果
  • 解説

DateValue関数とは

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

引数 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

※ドラッグ(スワイプ)すると全体を確認できます。

実行結果

解説

日付・時刻関数一覧