DateTimeFormatter.Parse 方法

定義

命名空間:

Java.Time.Format

組件:

Mono.Android.dll

多載

名稱	Description
Parse(ICharSequence)	完整解析文本，產生一個時間物件。
Parse(String)	完整解析文本，產生一個時間物件。
Parse(ICharSequence, ParsePosition)	利用此格式化器解析文本，提供對文本位置的控制。
Parse(ICharSequence, ITemporalQuery)	完整解析文字，產生指定類型的物件。
Parse(String, ParsePosition)	利用此格式化器解析文本，提供對文本位置的控制。
Parse(String, ITemporalQuery)	完整解析文字，產生指定類型的物件。

Parse(ICharSequence)

完整解析文本，產生一個時間物件。

[Android.Runtime.Register("parse", "(Ljava/lang/CharSequence;)Ljava/time/temporal/TemporalAccessor;", "", ApiSince=26)]
public Java.Time.Temporal.ITemporalAccessor? Parse(Java.Lang.ICharSequence? text);

[<Android.Runtime.Register("parse", "(Ljava/lang/CharSequence;)Ljava/time/temporal/TemporalAccessor;", "", ApiSince=26)>]
member this.Parse : Java.Lang.ICharSequence -> Java.Time.Temporal.ITemporalAccessor

參數

text

ICharSequence

要解析的文字，而非 null

傳回

ITemporalAccessor

解析後的時間物件，而非空

屬性

RegisterAttribute

備註

完整解析文本，產生一個時間物件。

此方法解析整個文本，產生一個時間對象。 通常使用 #parse(CharSequence, TemporalQuery)會更實用。 此方法的結果已 TemporalAccessor 解決，並應用基本的驗證檢查以確保日期時間的有效性。

如果解析完成時未閱讀整段文字，或在解析或合併過程中出現問題，則會拋出例外。

Java 文件 java.time.format.DateTimeFormatter.parse(java.lang.CharSequence)。

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

Parse(String)

完整解析文本，產生一個時間物件。

public Java.Time.Temporal.ITemporalAccessor? Parse(string? text);

member this.Parse : string -> Java.Time.Temporal.ITemporalAccessor

參數

text

String

要解析的文字，而非 null

傳回

ITemporalAccessor

解析後的時間物件，而非空

備註

完整解析文本，產生一個時間物件。

此方法解析整個文本，產生一個時間對象。 通常使用 #parse(CharSequence, TemporalQuery)會更實用。 此方法的結果已 TemporalAccessor 解決，並應用基本的驗證檢查以確保日期時間的有效性。

如果解析完成時未閱讀整段文字，或在解析或合併過程中出現問題，則會拋出例外。

Java 文件 java.time.format.DateTimeFormatter.parse(java.lang.CharSequence)。

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

Parse(ICharSequence, ParsePosition)

利用此格式化器解析文本，提供對文本位置的控制。

[Android.Runtime.Register("parse", "(Ljava/lang/CharSequence;Ljava/text/ParsePosition;)Ljava/time/temporal/TemporalAccessor;", "", ApiSince=26)]
public Java.Time.Temporal.ITemporalAccessor? Parse(Java.Lang.ICharSequence? text, Java.Text.ParsePosition? position);

[<Android.Runtime.Register("parse", "(Ljava/lang/CharSequence;Ljava/text/ParsePosition;)Ljava/time/temporal/TemporalAccessor;", "", ApiSince=26)>]
member this.Parse : Java.Lang.ICharSequence * Java.Text.ParsePosition -> Java.Time.Temporal.ITemporalAccessor

參數

text

ICharSequence

要解析的文字，而非 null

position

ParsePosition

解析位置，並以解析長度及任何錯誤索引更新，非空

傳回

ITemporalAccessor

解析後的時間物件，而非空

屬性

RegisterAttribute

備註

利用此格式化器解析文本，提供對文本位置的控制。

這樣可以解析文字，而不需要從字串的開頭開始或結束於結尾。 此方法的結果已 TemporalAccessor 解決，並應用基本的驗證檢查以確保日期時間的有效性。

文本將從指定的起始 ParsePosition點解析。 整個文本長度不必解析，解析 ParsePosition 結束時會更新索引。

此方法的操作與使用 ParsePosition 在 上的 java.text.Format類似方法略有不同。 該類別會使用錯誤 ParsePosition索引回傳錯誤。 相較之下，若發生錯誤，此方法會拋出 a DateTimeParseException ，例外包含錯誤索引。 此行為改變是必要的，因為此 API 中解析與解析日期/時間的複雜度增加。

如果格式化器多次解析同一個欄位且值不同，結果將是錯誤。

Java 文件 java.time.format.DateTimeFormatter.parse(java.lang.CharSequence, java.text.ParsePosition)。

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

Parse(ICharSequence, ITemporalQuery)

完整解析文字，產生指定類型的物件。

[Android.Runtime.Register("parse", "(Ljava/lang/CharSequence;Ljava/time/temporal/TemporalQuery;)Ljava/lang/Object;", "", ApiSince=26)]
[Java.Interop.JavaTypeParameters(new System.String[] { "T" })]
public Java.Lang.Object? Parse(Java.Lang.ICharSequence? text, Java.Time.Temporal.ITemporalQuery? query);

[<Android.Runtime.Register("parse", "(Ljava/lang/CharSequence;Ljava/time/temporal/TemporalQuery;)Ljava/lang/Object;", "", ApiSince=26)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "T" })>]
member this.Parse : Java.Lang.ICharSequence * Java.Time.Temporal.ITemporalQuery -> Java.Lang.Object

參數

text

ICharSequence

要解析的文字，而非 null

query

ITemporalQuery

定義要解析的型別的查詢，而非 null

傳回

Object

解析的日期時間，不是空

屬性

RegisterAttribute JavaTypeParametersAttribute

備註

完整解析文字，產生指定類型的物件。

大多數應用程式應該使用這種方法來進行解析。 它會解析整段文字以產生所需的日期時間。 查詢通常是對某 from(TemporalAccessor) 方法的方法的參考。 例如：

LocalDateTime dt = parser.parse(str, LocalDateTime::from);

如果解析完成時未閱讀整段文字，或在解析或合併過程中出現問題，則會拋出例外。

Java 文件 java.time.format.DateTimeFormatter.parse(java.lang.CharSequence, java.time.temporal.TemporalQuery<T>)。

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

Parse(String, ParsePosition)

利用此格式化器解析文本，提供對文本位置的控制。

public Java.Time.Temporal.ITemporalAccessor? Parse(string? text, Java.Text.ParsePosition? position);

member this.Parse : string * Java.Text.ParsePosition -> Java.Time.Temporal.ITemporalAccessor

參數

text

String

要解析的文字，而非 null

position

ParsePosition

解析位置，並以解析長度及任何錯誤索引更新，非空

傳回

ITemporalAccessor

解析後的時間物件，而非空

備註

利用此格式化器解析文本，提供對文本位置的控制。

這樣可以解析文字，而不需要從字串的開頭開始或結束於結尾。 此方法的結果已 TemporalAccessor 解決，並應用基本的驗證檢查以確保日期時間的有效性。

文本將從指定的起始 ParsePosition點解析。 整個文本長度不必解析，解析 ParsePosition 結束時會更新索引。

此方法的操作與使用 ParsePosition 在 上的 java.text.Format類似方法略有不同。 該類別會使用錯誤 ParsePosition索引回傳錯誤。 相較之下，若發生錯誤，此方法會拋出 a DateTimeParseException ，例外包含錯誤索引。 此行為改變是必要的，因為此 API 中解析與解析日期/時間的複雜度增加。

如果格式化器多次解析同一個欄位且值不同，結果將是錯誤。

Java 文件 java.time.format.DateTimeFormatter.parse(java.lang.CharSequence, java.text.ParsePosition)。

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

Parse(String, ITemporalQuery)

完整解析文字，產生指定類型的物件。

public Java.Lang.Object? Parse(string? text, Java.Time.Temporal.ITemporalQuery? query);

member this.Parse : string * Java.Time.Temporal.ITemporalQuery -> Java.Lang.Object

參數

text

String

要解析的文字，而非 null

query

ITemporalQuery

定義要解析的型別的查詢，而非 null

傳回

Object

解析的日期時間，不是空

備註

完整解析文字，產生指定類型的物件。

大多數應用程式應該使用這種方法來進行解析。 它會解析整段文字以產生所需的日期時間。 查詢通常是對某 from(TemporalAccessor) 方法的方法的參考。 例如：

LocalDateTime dt = parser.parse(str, LocalDateTime::from);

如果解析完成時未閱讀整段文字，或在解析或合併過程中出現問題，則會拋出例外。

Java 文件 java.time.format.DateTimeFormatter.parse(java.lang.CharSequence, java.time.temporal.TemporalQuery<T>)。

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