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 -> DateTimePublic 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