DateAndTime.DateValue(String) メソッド

定義

名前空間:

Microsoft.VisualBasic

アセンブリ:

Microsoft.VisualBasic.Core.dll

ソース:

DateAndTime.vb

文字列で表した日付情報を含む 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 までの日付/時刻値を表す文字列式。

戻り値

DateTime

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

例外

InvalidCastException

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 エラーが発生します。

こちらもご覧ください

• DateSerial(Int32, Int32, Int32)
• Day(DateTime)
• Month(DateTime)
• Now
• TimeSerial(Int32, Int32, Int32)
• TimeValue(String)
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• DateTime
• データ型の概要 (Visual Basic)