DateTime.TryParseとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

DateTime.TryParse メソッド (String, IFormatProvider, DateTimeStyles, DateTime)

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定したカルチャ固有の書式情報と書式スタイルを使用して、指定した日付と時刻の文字列形式を等価の DateTime の値に変換します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Shared Function TryParse
 ( _
    s As String, _
    provider As IFormatProvider, _
    styles As DateTimeStyles, _
    <OutAttribute> ByRef result As DateTime
 _
) As Boolean

Visual Basic (使用法)

Dim s As String
Dim provider As IFormatProvider
Dim styles As DateTimeStyles
Dim result As DateTime
Dim returnValue As Boolean

returnValue = DateTime.TryParse(s, provider, styles, result)

public static bool TryParse
 (
    string s,
    IFormatProvider provider,
    DateTimeStyles styles,
    out DateTime result
)

C++

public:
static bool TryParse (
    String^ s, 
    IFormatProvider^ provider, 
    DateTimeStyles styles, 
    [OutAttribute] DateTime% result
)

public static boolean TryParse (
    String s, 
    IFormatProvider provider, 
    DateTimeStyles styles, 
    /** @attribute OutAttribute() */ /** @ref */ DateTime result
)

JScript

JScript では、値型の引数は参照渡しされません。

パラメータ

s: 変換する日付と時刻を格納した文字列。

provider: s に関するカルチャ固有の書式情報を提供する IFormatProvider オブジェクト。

styles: s で使用可能な書式を示す、DateTimeStyles 値のビットごとの組み合わせ。通常指定する値は、None です。

result: 変換に成功した場合は、s に格納された日時と等しい DateTime 値が格納されます。変換に失敗した場合は MinValue が格納されます。s パラメータが null 参照 (Visual Basic では Nothing) の場合、または、日付と時刻を表す有効な文字列形式が指定されていない場合、変換に失敗します。このパラメータは初期化せずに渡されます。

戻り値
s パラメータが正常に変換された場合は true。それ以外の場合は false。

例外

例外の種類	条件
ArgumentException	styles が有効な DateTimeStyles 値ではありません。または styles に、無効な DateTimeStyles 値の組み合わせが指定されています (AssumeLocal と AssumeUniversal の両方が指定されているなど)。

例外の種類

条件

ArgumentException

styles が有効な DateTimeStyles 値ではありません。

または

styles に、無効な DateTimeStyles 値の組み合わせが指定されています (AssumeLocal と AssumeUniversal の両方が指定されているなど)。

解説

TryParse メソッドは、変換が失敗した場合でも例外をスローしない点を除いては、Parse メソッドと同じです。

文字列 s は、provider パラメータによって提供される DateTimeFormatInfo オブジェクトの書式情報を使用して解析されます。

このメソッドは、認識されないデータを無視して s を完全に解析しようとします。s に時刻だけを指定して日付を指定しない場合は、style パラメータによって、現在または既定の日付のどちらを使用するかを決定します。s に日付だけを指定して時刻を指定しない場合は、午前 00:00 が既定の時刻として使用されます。s 内の先頭、内部、または末尾にある空白文字は無視されます。日時は、前後にシャープ記号文字 ('#', U+0023) を付け、最後に 1 つ以上の NULL 文字 (U+0000) を付けて指定できます。s パラメータに、DateTimeFormatInfo クラスのトピックで説明した形式のいずれかを使用して、日付と時刻表現を格納してください。

provider パラメータには、カルチャ固有の日時書式情報を指定します。たとえば、特定の言語における曜日の名前や、月、日、年の優先表示順序を指定します。provider が null 参照 (Visual Basic では Nothing) の場合は、現在のカルチャが使用されます。

カスタムカルチャの解析

カスタムカルチャ用に生成された日時の文字列を解析する場合は、TryParse メソッドではなく、TryParseExact メソッドを使用することで、より正確な解析結果を得ることができます。カスタムカルチャの日時を表す文字列は、あまり複雑なものだと正しく解析できない場合があります。TryParse メソッドは、いくつかの暗黙の解析パターンに基づいて文字列を解析しようと試みますが。そのいずれのパターンを使っても正しく解析できない場合があります。これに対し、TryParseExact メソッドでは、成功する確率の高い、正確な解析パターンを明示的に指定できます。

カスタムカルチャの詳細については、System.Globalization.CultureAndRegionInfoBuilder クラスのトピックを参照してください。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DateTime 構造体
DateTime メンバ
System 名前空間
Parse
String
ParseExact
CultureInfo
CurrentInfo
その他の技術情報
書式設定の概要

DateTime.TryParse メソッド (String, DateTime)

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定した文字列形式の日付と時刻を等価の DateTime の値に変換します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Shared Function TryParse
 ( _
    s As String, _
    <OutAttribute> ByRef result As DateTime
 _
) As Boolean

Visual Basic (使用法)

Dim s As String
Dim result As DateTime
Dim returnValue As Boolean

returnValue = DateTime.TryParse(s, result)

public static bool TryParse
 (
    string s,
    out DateTime result
)

C++

public:
static bool TryParse (
    String^ s, 
    [OutAttribute] DateTime% result
)

public static boolean TryParse (
    String s, 
    /** @attribute OutAttribute() */ /** @ref */ DateTime result
)

JScript

JScript では、値型の引数は参照渡しされません。

パラメータ

s: 変換する日付と時刻を格納した文字列。

result: 変換に成功した場合は、s に格納された日時と等しい DateTime 値が格納されます。変換に失敗した場合は MinValue が格納されます。s パラメータが null 参照 (Visual Basic では Nothing) の場合、または、日付と時刻を表す有効な文字列形式が指定されていない場合、変換に失敗します。このパラメータは初期化せずに渡されます。

戻り値
s パラメータが正常に変換された場合は true。それ以外の場合は false。

解説

TryParse メソッドは、変換が失敗した場合でも例外をスローしない点を除いては、Parse メソッドと同じです。

文字列 s は、現在のカルチャに合わせて初期化されている DateTimeFormatInfo オブジェクトの書式情報を使用して解析されます。

このメソッドは、認識されないデータを無視して s を完全に解析しようとします。このメソッドは、認識されないデータをできる限り無視し、不足している月、日、および年の情報に現在の時刻を格納します。s に日付だけを指定して時刻を指定しない場合は、深夜 (00:00) が使用されます。s 内の先頭、内部、または末尾にある空白文字は無視されます。日時は、前後にシャープ記号文字 ('#', U+0023) を付け、最後に 1 つ以上の NULL 文字 (U+0000) を付けて指定できます。

s パラメータに、DateTimeFormatInfo クラスのトピックで説明した形式のいずれかを使用して、日付と時刻表現を格納してください。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DateTime 構造体
DateTime メンバ
System 名前空間
Parse
String
ParseExact
CultureInfo
CurrentInfo
その他の技術情報
書式設定の概要

DateTime.TryParse メソッド

指定した文字列形式の日付と時刻を等価の DateTime の値に変換します。
オーバーロードの一覧

名前	説明
DateTime.TryParse (String, DateTime)	指定した文字列形式の日付と時刻を等価の DateTime の値に変換します。
DateTime.TryParse (String, IFormatProvider, DateTimeStyles, DateTime)	指定したカルチャ固有の書式情報と書式スタイルを使用して、指定した日付と時刻の文字列形式を等価の DateTime の値に変換します。