DateTimeFormatter.WithResolverFields 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| WithResolverFields(ITemporalField[]) | |
| WithResolverFields(ICollection<ITemporalField>) |
傳回這個格式子的複本，其中包含一組新的解析程式欄位。 |
WithResolverFields(ITemporalField[])
[Android.Runtime.Register("withResolverFields", "([Ljava/time/temporal/TemporalField;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)]
public Java.Time.Format.DateTimeFormatter? WithResolverFields (params Java.Time.Temporal.ITemporalField[]? resolverFields);[<Android.Runtime.Register("withResolverFields", "([Ljava/time/temporal/TemporalField;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)>]
member this.WithResolverFields : Java.Time.Temporal.ITemporalField[] -> Java.Time.Format.DateTimeFormatter參數
- resolverFields
- ITemporalField[]
傳回
- 屬性
適用於
WithResolverFields(ICollection<ITemporalField>)
傳回這個格式子的複本，其中包含一組新的解析程式欄位。
[Android.Runtime.Register("withResolverFields", "(Ljava/util/Set;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)]
public Java.Time.Format.DateTimeFormatter? WithResolverFields (System.Collections.Generic.ICollection<Java.Time.Temporal.ITemporalField>? resolverFields);[<Android.Runtime.Register("withResolverFields", "(Ljava/util/Set;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)>]
member this.WithResolverFields : System.Collections.Generic.ICollection<Java.Time.Temporal.ITemporalField> -> Java.Time.Format.DateTimeFormatter參數
- resolverFields
- ICollection<ITemporalField>
新的解析程式欄位集，如果沒有字段，則為 null
傳回
以這個格式子為基礎的格式器，具有要求的解析程序樣式，而非 Null
- 屬性
備註
傳回這個格式子的複本，其中包含一組新的解析程式欄位。
這會傳回格式器，其狀態與這個格式器類似，但已設定解析程式字段。 根據預設，格式器沒有解析程式欄位。
變更解析程式欄位只會在剖析期間生效。 剖析文字字串會在兩個階段中發生。 階段 1 是基本文字剖析，根據新增至產生器的欄位。 階段 2 會將剖析的域值組解析為日期和/或時間物件。 解析程式欄位可用來篩選階段 1 與 2 之間的域值組。
這可用來在解決日期或時間的兩種或更多方式之間進行選取。 例如，如果格式器包含年、月、月、月和年，則有兩種方式可以解析日期。 使用自變數 ChronoField#YEAR YEAR 呼叫這個方法，並確保 ChronoField#DAY_OF_YEAR DAY_OF_YEAR 使用年和年中的日期來解析日期，這實際上表示在解析階段期間會忽略月份和月數。
以類似的方式，這個方法可以用來忽略要交叉檢查的次要字段。 例如，如果格式器包含年、月、月、日和星期幾，則只有一種方式可以解析日期，但星期幾的剖析值會針對解析的日期進行交叉檢查。 使用 自變數 ChronoField#YEAR YEAR呼叫這個方法， ChronoField#MONTH_OF_YEAR MONTH_OF_YEAR 並 ChronoField#DAY_OF_MONTH DAY_OF_MONTH 可確保日期已正確解析，但不會對星期天進行任何交叉檢查。
在實作方面，此方法的行為如下。 剖析階段的結果可視為欄位與值的對應。 此方法的行為是讓對應在階段 1 和 2 之間篩選，移除指定為此方法自變數以外的所有欄位。
這個實例不可變且不受此方法呼叫影響。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。