DateAndTime.DateValue(String) メソッド

定義

文字列で表した日付情報を含む Date 値を返します。時刻情報は午前 0 時 (00:00:00) に設定されます。

public:
 static DateTime DateValue(System::String ^ StringDate);
public static DateTime DateValue (string StringDate);
static member DateValue : string -> DateTime
Public Function DateValue (StringDate As String) As DateTime

パラメーター

StringDate
String

必須です。 1 年 1 月 1 日の 00:00:00 から、9999 年 12 月 31 日の 23:59:59 までの日付/時刻値を表す文字列式。

戻り値

文字列で表した日付情報を含む Date 値であり、時刻情報は午前 0 時 (00:00:00) に設定されます。

例外

StringDate に無効な時刻情報が含まれています。

この例では、 関数を DateValue 使用して文字列を日付に変換します。 日付リテラルを使用して、 や Date 変数 (例: oldDate = #2/12/69#) に日付をObject直接割り当てることもできます。

Dim oldDate As Date
oldDate = DateValue("February 12, 1969")

注釈

有効な日付区切り記号で区切られた 1 から 12 までの数値のみが含まれている場合 StringDate は、 DateValue システムに指定された短い日付形式に従って月、日、年の順序を認識します。 DateValue は、 名前空間の クラスの CurrentCulture プロパティの現在の CultureInfo カレンダー設定を System.Globalization 使用します。 既定値CurrentCultureは、コントロール パネル設定によって決まります。 名前空間の クラスの プロパティを ShortDatePattern 設定することで、 DateTimeFormatInfo 短い日付形式を System.Globalization オーバーライドできます。

DateValue は、長い形式、省略形、および数値形式で月名を認識します。 たとえば、1991 年 12 月 30 日と 12 月 30 日/91 日を認識することに加えて、 DateValue 1991 年 12 月 30 日と 1991 年 12 月 30 日も認識されます。

の年部分 StringDate を省略した場合は、 DateValue コンピューターのシステム日付から現在の年を使用します。

引数に時刻情報が StringDate 含まれている場合、 DateValue 戻り値には含まれません。 ただし、"89:98" などの無効な時刻情報が含まれている場合 StringDate は、 InvalidCastException エラーが発生します。

適用対象

こちらもご覧ください