DateAndTime.DateValue メソッド

.NET Framework クラス ライブラリ リファレンス

DateAndTime.DateValue メソッド

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

名前空間: Microsoft.VisualBasic
アセンブリ: Microsoft.VisualBasic (microsoft.visualbasic.dll 内)
構文

Visual Basic (宣言)

Public Shared Function DateValue
 ( _
    StringDate As String _
) As DateTime

Visual Basic (使用法)

Dim StringDate As String
Dim returnValue As DateTime

returnValue = DateAndTime.DateValue(StringDate)

C#

public static DateTime DateValue (
    string StringDate
)

C++

public:
static DateTime DateValue (
    String^ StringDate
)

J#

public static DateTime DateValue (
    String StringDate
)

JScript

public static function DateValue
 (
    StringDate : String
) : DateTime

パラメータ

StringDate

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

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

解説

詳細については、Visual Basic のトピック「DateValue 関数 (Visual Basic)」を参照してください。

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

DateValue では、長い形式、省略形、数値形式の月の名前が識別されます。たとえば、DateValue では 12/30/1991 や 12/30/91 が識別されるだけでなく、December 30, 1991 や Dec 30, 1991 も識別されます。

StringDate の年の部分が省略されている場合、DateValue ではコンピュータのシステム日付での現在の年が使用されます。

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

使用例

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

Visual Basic

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
DateAndTime クラス
DateAndTime メンバ
Microsoft.VisualBasic 名前空間
DateTime
その他の技術情報
DateValue 関数 (Visual Basic)
DateSerial 関数 (Visual Basic)
Day 関数 (Visual Basic)
Month 関数 (Visual Basic)
Now プロパティ
TimeSerial 関数 (Visual Basic)
TimeValue 関数 (Visual Basic)
Weekday 関数 (Visual Basic)
Year 関数 (Visual Basic)
日付型 (Date) (Visual Basic)