Language

SimpleDateFormat.Parse(String, ParsePosition) メソッド

定義

文字列からテキストを解析して、 Dateを生成します。

[Android.Runtime.Register("parse", "(Ljava/lang/String;Ljava/text/ParsePosition;)Ljava/util/Date;", "GetParse_Ljava_lang_String_Ljava_text_ParsePosition_Handler")]
public override Java.Util.Date? Parse(string? text, Java.Text.ParsePosition? pos);
[<Android.Runtime.Register("parse", "(Ljava/lang/String;Ljava/text/ParsePosition;)Ljava/util/Date;", "GetParse_Ljava_lang_String_Ljava_text_ParsePosition_Handler")>]
override this.Parse : string * Java.Text.ParsePosition -> Java.Util.Date

パラメーター

text
String

String。その一部を解析する必要があります。

pos
ParsePosition

上で説明したように、インデックスとエラー インデックスの情報を含む ParsePosition オブジェクト。

返品

文字列から解析された Date 。 エラーが発生した場合は、null を返します。

属性

例外

パターンに無効な文字がある場合は 。

注釈

文字列からテキストを解析して、 Dateを生成します。

このメソッドは、 posによって指定されたインデックスから始まるテキストの解析を試みます。 解析が成功した場合、 pos のインデックスは、最後に使用された文字の後のインデックスに更新されます (解析では、文字列の末尾までのすべての文字が必ずしも使用されるとは限りません)、解析された日付が返されます。 更新された pos を使用して、このメソッドの次の呼び出しの開始点を示すことができます。 エラーが発生した場合、 pos のインデックスは変更されず、 pos のエラー インデックスはエラーが発生した文字のインデックスに設定され、null が返されます。

この解析操作では、 DateFormat#calendar calendar を使用して Dateが生成されます。 calendarの日付/時刻フィールドはすべて、解析前に Calendar#clear() がクリアされ、calendarの日時フィールドの既定値が、不足している日時情報に使用されます。 たとえば、解析操作から年の値が指定されていない場合、解析された Date の年の値は 1970 GregorianCalendar になります。 TimeZone値は、指定されたパターンとtextのタイム ゾーン値に応じて上書きされる可能性があります。 #setTimeZone(java.util.TimeZone) setTimeZoneの呼び出しによって以前に設定されたTimeZone値は、追加の操作のために復元する必要がある場合があります。

<b>WARNING:</b> このメソッドを使用して日付を逆シリアル化しないでください。 基になるローカライズされた日付/時刻形式と解析動作は、ロケールの一般的な使用法が変わると、Android バージョン間で変更される可能性があります。 iso-8601 インスタント形式を逆シリアル化するためのタイムスタンプまたはjava.time.format.DateTimeFormatter#ISO_INSTANTを格納するために、long型を使用することを検討してください。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象