TimeSpan.TryParse メソッド

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

TimeSpan.TryParse メソッド

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

文字列で指定した時間間隔から、新しい TimeSpan オブジェクトを作成します。各パラメータは、時間間隔と新しい TimeSpan オブジェクトが返される変数を指定します。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim s As String
Dim result As TimeSpan
Dim returnValue As Boolean

returnValue = TimeSpan.TryParse(s, result)

C#

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

C++

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

J#

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

JScript

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

パラメータ

s

時間間隔を指定する文字列。

result

このメソッドが返されるときに、s で指定した時間間隔を表すオブジェクトを格納します。変換に失敗した場合は、Zero を格納します。このパラメータは初期化せずに渡されます。

戻り値
s が正常に変換された場合は true。それ以外の場合は false。s パラメータが null 参照 (Visual Basic では Nothing) である、無効な書式である、 パラメータの時間間隔が MinValue よりも小さい値か、MaxValue よりも大きい値で表されている、日、時間、分、秒の各構成要素のうち、少なくとも 1 つが有効値の範囲にない) に該当する場合、この演算は false を返します。

解説

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

s パラメータでは、次の形式で時間間隔を指定します。

[ws][-]{ d | d.hh:mm[:ss[.ff]] | hh:mm[:ss[.ff]] }[ws]

角かっこ ([および]) で囲まれている項目は省略可能です。中かっこ ({および}) で囲まれて縦棒 (|) で区切られた項目は、選択肢のリストからいずれかを選択する必要があります。コロン (:) とピリオド (.) は必須のリテラル文字です。その他の項目は次のとおりです。

項目	説明
ws	省略可能な空白。
"-"	負の TimeSpan を示す省略可能なマイナス記号。
d	日数 (0 ～ 10,675,199)。
hh	時間数 (0 ～ 23)。
mm	分数 (0 ～ 59)。
ss	省略可能な秒数 (0 ～ 59)。
ff	省略可能な秒の端数 (小数点以下 1 ～ 7 桁)。

s のすべての構成要素には、MinValue 以上で MaxValue 以下の時間間隔を指定する必要があります。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
TimeSpan 構造体
TimeSpan メンバ
System 名前空間