DateTimeFormatter.WithResolverFields Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| WithResolverFields(ITemporalField[]) | |
| WithResolverFields(ICollection<ITemporalField>) |
Retorna uma cópia desse formatador com um novo conjunto de campos do resolvedor. |
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.DateTimeFormatterParâmetros
- resolverFields
- ITemporalField[]
Retornos
- Atributos
Aplica-se a
WithResolverFields(ICollection<ITemporalField>)
Retorna uma cópia desse formatador com um novo conjunto de campos do resolvedor.
[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.DateTimeFormatterParâmetros
- resolverFields
- ICollection<ITemporalField>
O novo conjunto de campos do resolvedor, nulo se nenhum campo
Retornos
um formatador baseado nesse formatador com o estilo resolvedor solicitado, não nulo
- Atributos
Comentários
Retorna uma cópia desse formatador com um novo conjunto de campos do resolvedor.
Isso retorna um formatador com estado semelhante a esse formatador, mas com os campos do resolvedor definidos. Por padrão, um formatador não tem campos de resolução.
A alteração dos campos do resolvedor só tem 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 campo-valor analisados em objetos de data e/ou hora. Os campos do resolvedor são usados para filtrar os pares de valor de campo entre as fases 1 e 2.
Isso pode ser usado para selecionar entre duas ou mais maneiras de resolver uma data ou hora. Por exemplo, se o formatador consistir em ano, mês, dia do mês e dia do ano, há 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, significando 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 cruzados. 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á cruzado com a data resolvida. Chamar esse método com os argumentos ChronoField#YEAR YEARe ChronoField#MONTH_OF_YEAR MONTH_OF_YEAR ChronoField#DAY_OF_MONTH DAY_OF_MONTH garantirá que a data seja resolvida corretamente, mas sem qualquer verificação cruzada para o dia da semana.
Em termos de implementação, este método comporta-se da seguinte forma. 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 as fases 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.
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.