- java.util.Formatter
- java.time.format.DateTimeFormatter
- java.text.DecimalFormat
- Descrição: Um intérprete para strings de formato no estilo printf. Esta classe fornece suporte para justificação e alinhamento de layout, formatos comuns para dados numéricos, de string e de data / hora e saída específica de local. Tipos Java comum, como byte, BigDecimal, e Calendar são suportados. A personalização de formatação limitada para tipos de usuários arbitrários é fornecida por meio da Formattableinterface.
Os formatadores não são necessariamente seguros para acesso multithread. A segurança de thread é opcional e é de responsabilidade dos usuários dos métodos desta classe. A impressão formatada para a linguagem Java é fortemente inspirada em C's printf. Embora as strings de formato sejam semelhantes a C, algumas personalizações foram feitas para acomodar a linguagem Java e explorar alguns de seus recursos. Além disso, a formatação Java é mais restrita do que a C; por exemplo, se uma conversão for incompatível com um sinalizador, uma exceção será lançada. Em C, os sinalizadores inaplicáveis são silenciosamente ignorados. As strings de formato devem, portanto, ser reconhecidas por programadores C, mas não necessariamente totalmente compatíveis com aqueles em C.
Exemplos de uso esperado:
StringBuilder sb = new StringBuilder ();
// Envia todas as saídas para o objeto Appendable sb
Formatter formatter = novo Formatter (sb, Locale.US);
// Índices de argumentos explícitos podem ser usados para reordenar a saída.
formatter.format ("% 4 $ 2s% 3 $ 2s% 2 $ 2s% 1 $ 2s", "a", "b", "c", "d")
// -> "dcb a"
// localidade opcional como o primeiro argumento pode ser usado para obter
// formatação de números específica da localidade. A precisão e largura podem ser
// dado para arredondar e alinhar o valor.
formatter.format (Locale.FRANCE, "e =% + 10.4f", Math.E);
// -> "e = +2,7183"
// O sinalizador numérico '(' pode ser usado para formatar números negativos com
// parênteses em vez de um sinal de menos. Os separadores de grupo são
// inserido automaticamente.
formatter.format ("Montante ganho ou perdido desde a última declaração: $% (,. 2f",
balanceDelta);
// -> "Montante ganho ou perdido desde a última declaração: $ (6.217,58)"
Formatador para impressão e análise de objetos de data e hora. Esta classe fornece o principal ponto de entrada do aplicativo para impressão e análise e fornece implementações comuns de DateTimeFormatter:
- Usando constantes predefinidas, como ISO_LOCAL_DATE
- Usando letras padrão, como uuuu-MMM-dd
- Usando estilos localizados, como longoumedium Formatadores mais complexos são fornecidos por DateTimeFormatterBuilder.
As principais classes de data e hora fornecem dois métodos - um para formatação format(DateTimeFormatter formatter), e outro para análise parse(CharSequence text, DateTimeFormatter formatter),.
Por exemplo:
Data LocalDate = LocalDate.now (); String text = date.format (formatter); LocalDate parsedDate = LocalDate.parse (texto, formatador);
Além do formato, os formatadores podem ser criados com Locale, Chronology, ZoneId e DecimalStyle desejados.
O withLocale método retorna um novo formatador que substitui o local. A localidade afeta alguns aspectos de formatação e análise. Por exemplo, o ofLocalizedDatefornece um formatador que usa o formato de data específico do local.
O withChronology método retorna um novo formatador que substitui a cronologia. Se substituído, o valor de data e hora é convertido para a cronologia antes da formatação. Durante a análise, o valor de data e hora é convertido para a cronologia antes de ser retornado.
O withZone método retorna um novo formatador que substitui a zona. Se substituído, o valor de data e hora é convertido em um ZonedDateTime com o ZoneId solicitado antes da formatação. Durante a análise, o ZoneId é aplicado antes que o valor seja retornado.
O withDecimalStyle método retorna um novo formatador que substitui o DecimalStyle. Os símbolos DecimalStyle são usados para formatação e análise.
Alguns aplicativos podem precisar usar a java.text.Format classe mais antiga para formatação. O toFormat()método retorna uma implementação de java.text.Format.
- Padrões para formatação e análise
Os padrões são baseados em uma sequência simples de letras e símbolos. Um padrão é usado para criar um Formatador usando os métodos ofPattern(String)e ofPattern(String, Locale). Por exemplo, "d MMM uuuu"formatará 03-12-2011 como '3 de dezembro de 2011'. Um formatador criado a partir de um padrão pode ser usado quantas vezes forem necessárias, é imutável e seguro para threads. Por exemplo:
Data LocalDate = LocalDate.now ();
DateTimeFormatter formatter = DateTimeFormatter.ofPattern ("aaaa MM dd");
String text = date.format (formatter);
LocalDate parsedDate = LocalDate.parse (texto, formatador);