Parse(String,IFormatProvider,DateTimeStyles) メソッド

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

構文

Visual Basic (宣言)
C#

Public Overloads Shared Function Parse( _
   ByVal s As String, _
   ByVal provider As IFormatProvider, _
   ByVal styles As DateTimeStyles _
) As DateTimeEx

public static DateTimeEx Parse( 
   string s,
   IFormatProvider provider,
   DateTimeStyles styles
)

パラメータ

s: 変換する日付と時刻を表す文字列（String 型）
provider: 引数 s についてのカルチャ固有の形式指定情報（System.IFormatProvider 型）
styles: 引数 s の許容範囲を指定する定数の組み合わせ（System.Globalization.DateTimeStyles 型）

戻り値の型

指定した文字列に等価なDateTimeEx。

解説

Parseメソッドは、引数 provider で指定したカルチャ固有の形式指定情報と、引数 styles で指定した書式スタイルを使用して、引数 s で指定した日付と時刻の文字列を等価なDateTimeExの値に変換します。

引数 s には、引数 provider によって提供されるDateTimeFormatInfoで規定される形式に適合する日付と時刻の文字列を設定します。

引数 provider には、カルチャ固有の日付と時刻の形式指定情報を格納しているIFormatProviderを設定します。 provider をNullに設定すると、現在のカルチャの形式指定情報が使用されます。

引数 styles で意味のある設定値は、DateTimeStyles.AdjustToUniversalとDateTimeStyles.NoCurrentDateDefaultの２つです。 DateTimeStyles列挙体のその他の値は、GrapeCity.Web.Input.Core.DateTimeEx.ParseExactメソッドで使用します。

Parseメソッドは、静的メンバ（特定のオブジェクトではなく型自体に属している）なので、インスタンスを使って参照することはできません。型の名前である「DateTimeEx」を使って参照します。

Parseメソッドで引数 s だけを指定する場合、コントロールパネルの［地域のオプション］-［日付］-［カレンダー］の設定よっては、予想外の戻り値になることがあります。
たとえば、コントロールパネルの［カレンダー］を和暦に設定している場合、引数 s に"2010/01/31"を渡すと、西暦2010年ではなく、平成2010年と解釈されます。このような事態が想定されるときは、引数 provider を設定して、明示的にカレンダーを指定する必要があります。以下に、簡単なサンプルコードを示します。

Imports System.Globalization Imports GrapeCity.Web.Input.Core ' カレンダーを指定します。 Dim ci As CultureInfo = New CultureInfo("ja-JP", True) Dim dtFI As DateTimeFormatInfo = ci.DateTimeFormat dtFI.Calendar = New GregorianCalendar() ' Parseメソッドを実行します。 Dim dtEx As DateTimeEx = DateTimeEx.Parse("2010/01/31", dtFI)

using System.Globalization; using GrapeCity.Web.Input.Core; // カレンダーを指定します。 CultureInfo ci = new CultureInfo("ja-JP", true); DateTimeFormatInfo dtFI = ci.DateTimeFormat; dtFI.Calendar = new GregorianCalendar(); // Parseメソッドを実行します。 DateTimeEx dtEx = DateTimeEx.Parse("2010/01/31", dtFI);

使用例

次のサンプルコードは、Parseメソッドの使用方法を示します。

Visual Basic
C#

Imports System.Diagnostics
Imports System.Globalization
Imports GrapeCity.Web.Input.Core

' 各引数を設定します。
Dim s As String = "31 03 09 14:30:00"
Dim provider As IFormatProvider = New CultureInfo("de-DE", True)
Dim styles As DateTimeStyles = DateTimeStyles.NoCurrentDateDefault

' 指定した引数に基づいてDateTimeExの値を生成します。
Dim dtEx As DateTimeEx = DateTimeEx.Parse(s, provider, styles)

' 生成したDateTimeExの値を確認します。
Debug.WriteLine(dtEx.ToString())

using System.Diagnostics;
using System.Globalization;
using GrapeCity.Web.Input.Core;

// 各引数を設定します。
string s = "31 03 09 14:30:00";
IFormatProvider provider = new CultureInfo("de-DE", true);
DateTimeStyles styles = DateTimeStyles.NoCurrentDateDefault;

// 指定した引数に基づいてDateTimeExの値を生成します。
DateTimeEx dtEx = DateTimeEx.Parse(s, provider, styles);

// 生成したDateTimeExの値を確認します。
Debug.WriteLine(dtEx.ToString());

参照

DateTimeEx クラス
 DateTimeEx メンバ
 オーバーロード一覧