DateTimeFormatter.WithResolverFields Método

[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

Parâmetros

Retornos

um formatador com base nesse formatador com os campos de resolvedor solicitados, não nulo

Atributos

RegisterAttribute

Comentários

Os campos resolvedores restringem os campos usados durante a fase de resolução da análise.

[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

Parâmetros

Retornos

um formatador com base nesse formatador com o estilo de resolvedor solicitado, não nulo

Atributos

RegisterAttribute

Comentários

Retorna uma cópia desse formatador com um novo conjunto de campos resolvedores.

Isso retorna um formatador com estado semelhante a esse formatador, mas com os campos de resolvedor definidos. Por padrão, um formatador não tem campos resolvedores.

Alterar os campos de resolvedor só tem um efeito durante a análise. A análise de uma cadeia de caracteres de texto ocorre em duas fases. A fase 1 é uma análise de texto básica de acordo com os campos adicionados ao construtor. A fase 2 resolve os pares de valor de campo analisados em objetos de data e/ou hora. Os campos de resolvedor são usados para filtrar os pares campo-valor entre a fase 1 e 2.

Isso pode ser usado para selecionar entre duas ou mais maneiras pelas quais uma data ou hora pode ser resolvida. Por exemplo, se o formatador consistir em ano, mês, dia do mês e dia do ano, haverá duas maneiras de resolver uma data. Chamar esse método com os argumentos ChronoField#YEAR YEAR e ChronoField#DAY_OF_YEAR DAY_OF_YEAR garantirá que a data seja resolvida usando o ano e o dia do ano, o que significa efetivamente que o mês e o dia do mês são ignorados durante a fase de resolução.

De maneira semelhante, esse método pode ser usado para ignorar campos secundários que, de outra forma, seriam verificados entre nós. Por exemplo, se o formatador consistir em ano, mês, dia do mês e dia da semana, haverá apenas uma maneira de resolver uma data, mas o valor analisado para o dia da semana será verificado de forma cruzada em relação à data resolvida. Chamar esse método com os argumentos ChronoField#YEAR YEARChronoField#MONTH_OF_YEAR MONTH_OF_YEAR e ChronoField#DAY_OF_MONTH DAY_OF_MONTH garantirá que a data seja resolvida corretamente, mas sem nenhuma verificação cruzada para o dia da semana.

Em termos de implementação, esse método se comporta da seguinte maneira. O resultado da fase de análise pode ser considerado um mapa de campo a valor. O comportamento desse método é fazer com que esse mapa seja filtrado entre a fase 1 e 2, removendo todos os campos diferentes daqueles especificados como argumentos para esse método.

Essa instância é imutável e não afetada por essa chamada de método.

Java documentação para java.time.format.DateTimeFormatter.withResolverFields(java.util.Set<java.time.temporal.TemporalField>).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.