語言

DateFormat.Parse 方法

定義

命名空間:
Android.Icu.Text
組件:
Mono.Android.dll

多載

名稱 Description
Parse(String, ParsePosition)

根據給定的解析位置解析日期/時間字串。
Parse(String, Calendar, ParsePosition)

根據給定的解析位置解析日期/時間字串。
Parse(String)

解析日期/時間字串。

Parse(String, ParsePosition)

根據給定的解析位置解析日期/時間字串。

[Android.Runtime.Register("parse", "(Ljava/lang/String;Ljava/text/ParsePosition;)Ljava/util/Date;", "GetParse_Ljava_lang_String_Ljava_text_ParsePosition_Handler", ApiSince=24)]
public virtual 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", ApiSince=24)>]
abstract member Parse : string * Java.Text.ParsePosition -> Java.Util.Date
override this.Parse : string * Java.Text.ParsePosition -> Java.Util.Date

參數

text
String

要解析的日期/時間字串

pos
ParsePosition

輸入時，開始解析的起點;輸出時，則表示解析終止的位置，或若解析失敗則為起始位置。

傳回

Date

A Date，若輸入無法解析則為 Null

屬性
RegisterAttribute

備註

根據給定的解析位置解析日期/時間字串。 例如，時間文字「07/10/96 下午4：5 PDT」會被解析成相當於Date（837039928046）的日期。

預設情況下，解析較寬鬆：如果輸入不是此物件格式方法所用的形式，但仍可解析為日期，則解析成功。 用戶端可透過呼叫 setLenient（false） 來堅持嚴格遵守格式。

請注意，某些曆法（如中國農曆）所採用的正常日期格式，並未指定足夠的欄位以使日期無法明確解析。 以中國農曆為例，雖然指定了當前60年週期內的年份，但自曆法開始日期（曆法物件ERA欄位中）以來的週期數通常不包含在格式中，且解析可能假設錯誤的年代。 在這種情況下，建議用戶端使用解析法進行解析，該方法將曆法傳入時，將曆法傳入為當前日期，或在格式中缺少時應假設的時代/週期中的某個日期。

Java 文件 android.icu.text.DateFormat.parse(java.lang.String, java.text.ParsePosition)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於

Parse(String, Calendar, ParsePosition)

根據給定的解析位置解析日期/時間字串。

[Android.Runtime.Register("parse", "(Ljava/lang/String;Landroid/icu/util/Calendar;Ljava/text/ParsePosition;)V", "GetParse_Ljava_lang_String_Landroid_icu_util_Calendar_Ljava_text_ParsePosition_Handler", ApiSince=24)]
public abstract void Parse(string? text, Android.Icu.Util.Calendar? cal, Java.Text.ParsePosition? pos);
[<Android.Runtime.Register("parse", "(Ljava/lang/String;Landroid/icu/util/Calendar;Ljava/text/ParsePosition;)V", "GetParse_Ljava_lang_String_Landroid_icu_util_Calendar_Ljava_text_ParsePosition_Handler", ApiSince=24)>]
abstract member Parse : string * Android.Icu.Util.Calendar * Java.Text.ParsePosition -> unit

參數

text
String

要解析的日期/時間字串

cal
Calendar

日曆在輸入時設定為要用來處理被解析日期/時間字串缺失值的日期和時間，輸出則設定為解析後的日期/時間。 一般來說，呼叫此方法前應先初始化此方法——依照期望行為，要麼清除或設定為當前日期。 如果這個解析失敗，日曆可能仍然被修改過。 當日曆類型與此 DateFormat 實例所持有的內部日曆不同時，日曆欄位的值會根據初始化的內部日曆，並以該日曆取出的時間與時區進行解析，然後解析結果（以毫秒為單位的時間與時區）會回到該日曆。

pos
ParsePosition

輸入時，開始解析的起點;輸出時，則表示解析終止的位置，或若解析失敗則為起始位置。

屬性
RegisterAttribute

備註

根據給定的解析位置解析日期/時間字串。 例如，時間文字「07/10/96 下午4：5 PDT」會被解析成一個等同於日期（837039928046）的日曆。 呼叫者在此方法前，應以兩種方式初始化日曆（除非保留現有欄位資訊）：（1） 清除日曆，或 （2） 將日曆設為當前日期（或任何應使用欄位提供解析日期中缺少值的日期）。 例如，中國曆法通常不會標示年曆或週期;此時，傳入的曆法應設定為應假設的時代，通常是當前紀元。

預設情況下，解析較寬鬆：如果輸入不是此物件格式方法所用的形式，但仍可解析為日期，則解析成功。 用戶端可透過呼叫 setLenient（false） 來堅持嚴格遵守格式。

Java 文件 android.icu.text.DateFormat.parse(java.lang.String, android.icu.util.Calendar, java.text.ParsePosition)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於

Parse(String)

解析日期/時間字串。

[Android.Runtime.Register("parse", "(Ljava/lang/String;)Ljava/util/Date;", "GetParse_Ljava_lang_String_Handler", ApiSince=24)]
public virtual Java.Util.Date? Parse(string? text);
[<Android.Runtime.Register("parse", "(Ljava/lang/String;)Ljava/util/Date;", "GetParse_Ljava_lang_String_Handler", ApiSince=24)>]
abstract member Parse : string -> Java.Util.Date
override this.Parse : string -> Java.Util.Date

參數

text
String

要解析的日期/時間字串

傳回

Date

A Date，若輸入無法解析則為 Null

屬性
RegisterAttribute

備註

解析日期/時間字串。 例如，時間文字「07/10/96 下午4：5 PDT」會被解析成相當於Date（837039928046）的日期。 解析從字串的起始點開始，盡可能深入。 假設沒有遇到解析錯誤，這個函式不會回傳解析中佔用了多少字串的資訊。 如果你需要這些資訊，可以使用帶有 ParsePosition 的 parse（） 版本。

預設情況下，解析較寬鬆：如果輸入不是此物件格式方法所用的形式，但仍可解析為日期，則解析成功。 用戶端可透過呼叫 setLenient（false） 來堅持嚴格遵守格式。

請注意，某些曆法（如中國農曆）所採用的正常日期格式，並未指定足夠的欄位以使日期無法明確解析。 以中國農曆為例，雖然指定了當前60年週期內的年份，但自曆法開始日期（曆法物件ERA欄位中）以來的週期數通常不包含在格式中，且解析可能假設錯誤的年代。 在這種情況下，建議用戶端使用解析法進行解析，該方法將曆法傳入時，將曆法傳入為當前日期，或在格式中缺少時應假設的時代/週期中的某個日期。

Java 文件 android.icu.text.DateFormat.parse(java.lang.String)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於