DateAndTime.DateValue(String) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
文字列で表した日付情報を含む 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 エラーが発生します。
適用対象
こちらもご覧ください
.NET