Formatter Classe

Definição

[Android.Runtime.Register("java/util/Formatter", DoNotGenerateAcw=true)]
public sealed class Formatter : Java.Lang.Object, IDisposable, Java.Interop.IJavaPeerable, Java.IO.ICloseable, Java.IO.IFlushable

[<Android.Runtime.Register("java/util/Formatter", DoNotGenerateAcw=true)>]
type Formatter = class
    inherit Object
    interface ICloseable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface IFlushable

Herança

Object

Object

Formatter

Atributos

RegisterAttribute

Implementações

IJavaObject IJavaPeerable ICloseable IFlushable IDisposable

Comentários

Um interpretador para cadeias de caracteres de formato printf. Essa classe fornece suporte para justificativa e alinhamento de layout, formatos comuns para dados numéricos, de cadeia de caracteres e de data/hora e saída específica de localidade. Tipos Java comuns, como byte, java.math.BigDecimal BigDecimale Calendar são suportados. A personalização de formatação limitada para tipos de usuário arbitrários é fornecida por meio da Formattable interface.

Formatters não são necessariamente seguros para acesso multithread. A segurança das roscas é 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 cadeias de caracteres de formato sejam semelhantes ao 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 rigorosa do que a de 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 cadeias de caracteres de formato são, portanto, destinadas a ser reconhecíveis para programadores C, mas não necessariamente completamente compatíveis com aquelas em C.

Exemplos de uso esperado:

<blockquote>

StringBuilder sb = new StringBuilder();
              // Send all output to the Appendable object sb
              Formatter formatter = new Formatter(sb, Locale.US);

              // Explicit argument indices may be used to re-order output.
              formatter.format("%4$2s %3$2s %2$2s %1$2s", "a", "b", "c", "d")
              // -> " d  c  b  a"

              // Optional locale as the first argument can be used to get
              // locale-specific formatting of numbers.  The precision and width can be
              // given to round and align the value.
              formatter.format(Locale.FRANCE, "e = %+10.4f", Math.E);
              // -> "e =    +2,7183"

              // The '(' numeric flag may be used to format negative numbers with
              // parentheses rather than a minus sign.  Group separators are
              // automatically inserted.
              formatter.format("Amount gained or lost since last statement: $ %(,.2f",
                               balanceDelta);
              // -> "Amount gained or lost since last statement: $ (6,217.58)"

</blockquote>

Existem métodos convenientes para solicitações de formatação comuns, conforme ilustrado pelas seguintes chamadas:

<blockquote>

// Writes a formatted string to System.out.
              System.out.format("Local time: %tT", Calendar.getInstance());
              // -> "Local time: 13:34:18"

              // Writes formatted output to System.err.
              System.err.printf("Unable to open file '%1$s': %2$s",
                                fileName, exception.getMessage());
              // -> "Unable to open file 'food': No such file or directory"

</blockquote>

Como C's sprintf(3), Strings podem ser formatados usando o método String#format(String,Object...) String.formatestático :

<blockquote>

// Format a string containing a date.
              import java.util.Calendar;
              import java.util.GregorianCalendar;
              import static java.util.Calendar.*;

              Calendar c = new GregorianCalendar(1995, MAY, 23);
              String s = String.format("Duke's Birthday: %1$tb %1$te, %1$tY", c);
              // -> s == "Duke's Birthday: May 23, 1995"

</blockquote>

<h3>"org">Organização</h3>

Esta especificação é dividida em duas seções. A primeira seção, Resumo, aborda os conceitos básicos de formatação. Esta seção destina-se a usuários que desejam começar rapidamente e estão familiarizados com a impressão formatada em outras linguagens de programação. A segunda seção, Detalhes, abrange os detalhes específicos da implementação. Destina-se a usuários que desejam uma especificação mais precisa do comportamento de formatação.

<h3>"resumo">Resumo</h3>

Esta seção destina-se a fornecer uma breve visão geral dos conceitos de formatação. Para obter detalhes comportamentais precisos, consulte a seção Detalhes.

<h4>"syntax">Formatar sintaxe< de cadeia de caracteres/h4>

Todo método que produz saída formatada requer uma cadeia de caracteres de formato e uma lista de argumentos. A cadeia de caracteres de formato é uma String que pode conter texto fixo e um ou mais especificadores de formato incorporados. Considere o seguinte exemplo:

<blockquote>

Calendar c = ...;
              String s = String.format("Duke's Birthday: %1$tm %1$te,%1$tY", c);

</blockquote>

Essa cadeia de caracteres de formato é o primeiro argumento para o format método. Ele contém três especificadores de formato "%1$tm", "%1$te" e "%1$tY" que indicam como os argumentos devem ser processados e onde eles devem ser inseridos no texto. As partes restantes da cadeia de caracteres de formato são texto fixo, incluindo "Dukes Birthday: " e quaisquer outros espaços ou pontuação.

A lista de argumentos consiste em todos os argumentos passados para o método após a cadeia de caracteres de formato. No exemplo acima, a lista de argumentos é de tamanho um e consiste no java.util.Calendar Calendar objeto c.

<ul>

<li> Os especificadores de formato para tipos gerais, de caracteres e numéricos têm a seguinte sintaxe:

<blockquote>

%[argument_index$][flags][width][.precision]conversion

</blockquote>

O argument_index opcional é um inteiro decimal que indica a posição do argumento na lista de argumentos. O primeiro argumento é referenciado por "1$", o segundo por "2$", etc.

Os sinalizadores opcionais são um conjunto de caracteres que modificam o formato de saída. O conjunto de sinalizadores válidos depende da conversão.

A largura opcional é um inteiro decimal positivo que indica o número mínimo de caracteres a serem gravados na saída.

A precisão opcional é um inteiro decimal não negativo geralmente usado para restringir o número de caracteres. O comportamento específico depende da conversão.

A conversão necessária é um caractere que indica como o argumento deve ser formatado. O conjunto de conversões válidas para um determinado argumento depende do tipo de dados do argumento.

<li> Os especificadores de formato para tipos que são usados para representar datas e horas têm a seguinte sintaxe:

<blockquote>

%[argument_index$][flags][width]conversion

</blockquote>

Os argument_index opcionais, os sinalizadores e a largura são definidos como acima.

A conversão necessária é uma sequência de dois caracteres. O primeiro caractere é 't' ou 'T'. O segundo caractere indica o formato a ser usado. Esses caracteres são semelhantes, mas não completamente idênticos aos definidos pelo GNU date e POSIX strftime(3c).

<li> Os especificadores de formato que não correspondem a argumentos têm a seguinte sintaxe:

<blockquote>

%[flags][width]conversion

</blockquote>

Os sinalizadores opcionais e a largura são definidos como acima.

A conversão necessária é um caractere que indica o conteúdo a ser inserido na saída.

</ul>

<h4> Conversões </h4>

As conversões são divididas nas seguintes categorias:

<Ol>

<li><b>Geral</b> - pode ser aplicado a qualquer tipo de argumento

<li>b Caractere</b> - pode ser aplicado a tipos básicos que representam caracteres Unicode: char, Character, byte, Byte, shorte Short.>< Essa conversão também pode ser aplicada aos tipos int e Integer quando Character#isValidCodePoint retorna<true li><b>Numérico</b>

<Ol>

<li>b Integral/b> - pode ser aplicado aos tipos integrais Java: byte, Byte, shortintShort, , e Integer, long, Longe java.math.BigInteger BigInteger (mas não char ou )Character<><

<li><b>Ponto Flutuante</b> - pode ser aplicado aos tipos de ponto flutuante Java: float, Float, double, Doublee java.math.BigDecimal BigDecimal</ol>

<li><b>Data/Hora</b> - pode ser aplicado a tipos Java que são capazes de codificar uma data ou hora: long, Long, CalendarDate , e TemporalAccessor TemporalAccessor<li><b>Percent/b> -< produz um literal '%' ('\u0025')

<li><b>Line Separator</b> - produz o separador de linha específico da plataforma

</Ol>

Para a categoria Geral, Caractere, Numérico, Integral e Conversão de Data/Hora, a menos que especificado de outra forma, se o argumento arg for null, então o resultado será "null".

A tabela a seguir resume as conversões com suporte. As conversões denotadas por um caractere maiúsculo (ou seja'B', , 'H', 'S', 'E''G''X''A''C'e 'T') são as mesmas que para os caracteres de conversão minúsculas correspondentes, exceto que o resultado é convertido em maiúsculas de acordo com as java.util.Locale Localeregras do . Se não houver nenhuma localidade explícita especificada, seja na construção da instância ou como um parâmetro para sua chamada de método, então o java.util.Locale.Category#FORMAT default locale é usado.

<table class="striped"><caption style="display:none">genConv</caption><thead<>tr><th scope="col" style="vertical-align:bottom"> Conversion <th scope="col" style="vertical-align:bottom"> Argument Category <th scope="col" style="vertical-align:bottom"> Descrição </thead<>tbody<>tr><th scope="row" style="vertical-align:top"'b'>, 'B'<td style="vertical-align:top" > geral <td> Se o argumento arg é null, então o resultado é "false". Se arg for um boolean ou Boolean, o resultado será a cadeia de caracteres retornada por String#valueOf(boolean) String.valueOf(arg). Caso contrário, o resultado será "verdadeiro".

<><tr th scope="row" style="vertical-align:top"'h'>, 'H'<td style="vertical-align:top"> geral <td> O resultado é obtido invocando Integer.toHexString(arg.hashCode()).

<><tr th scope="row" style="vertical-align:top"'s'>,<'S' td style="vertical-align:top"> general <td> Se arg implementa Formattable, então Formattable#formatTo arg.formatTo é invocado. Caso contrário, o resultado é obtido invocando arg.toString().

<><tr th scope="row" style="vertical-align:top">'c', 'C'<td style="vertical-align:top"> caractere <td> O resultado é um caractere Unicode

<><tr th scope="row" style="vertical-align:top"><'d'td style="vertical-align:top"> integral <td> O resultado é formatado como um inteiro decimal

<><tr th scope="row" style="vertical-align:top"><'o'td style="vertical-align:top"> integral <td> O resultado é formatado como um inteiro octal

<><tr th scope="row" style="vertical-align:top">'x', 'X'<td style="vertical-align:top"> integral <td> O resultado é formatado como um inteiro hexadecimal

<><tr th scope="row" style="vertical-align:top">'e', 'E'<td style="vertical-align:top"> ponto <flutuante td> O resultado é formatado como um número decimal em notação científica computadorizada

<><tr th scope="row" style="vertical-align:top"><'f'td style="vertical-align:top"> ponto <flutuante td> O resultado é formatado como um número decimal

<><tr th scope="row" style="vertical-align:top">'g', 'G'<td style="vertical-align:top"> ponto <flutuante td> O resultado é formatado usando notação científica computadorizada ou formato decimal, dependendo da precisão e do valor após o arredondamento.

<><tr th scope="row" style="vertical-align:top">'a', 'A'<td style="vertical-align:top"> ponto <flutuante td> O resultado é formatado como um número hexadecimal de ponto flutuante com um significante e um expoente. Essa conversão é <b>não</b> suportada para o BigDecimal tipo, apesar de este último estar na categoria de argumento de ponto flutuante.

<><tr th scope="row" style="vertical-align:top">'t', 'T'<td style="vertical-align:top"> data/hora <td> Prefixo para caracteres de conversão de data e hora. Consulte Conversões de data/hora.

<><tr th scope="row" style="vertical-align:top"'%'><td style="vertical-align:top"> percent <td> O resultado é um literal '%' ()'\u0025'

<><tr th scope="row" style="vertical-align:top"><'n'td style="vertical-align:top"> separador <de linha td> O resultado é o separador de linha específico da plataforma

</tbody></tabela>

Quaisquer caracteres não explicitamente definidos como conversões são ilegais e são reservados para extensões futuras.

<h4>"dt">Conversões< de data/hora/h4>

Os seguintes caracteres de sufixo de conversão de data e hora são definidos para as 't' conversões e 'T' . Os tipos são semelhantes, mas não completamente idênticos aos definidos pelo GNU date e POSIX strftime(3c). Tipos de conversão adicionais são fornecidos para acessar a funcionalidade específica do Java (por exemplo 'L' , por milissegundos dentro do segundo).

Os seguintes caracteres de conversão são usados para tempos de formatação:

<table class="striped">caption style="display:none">time</caption<>tbody<>tr><th scope="row" style="vertical-align:top">'H'<td> Hora do dia para o relógio de 24 horas, formatado como dois dígitos com um zero à esquerda conforme necessário, ou seja, . 00 - 23<

<><tr th scope="row" style="vertical-align:top"><'I'td> Hour para o relógio de 12 horas, formatado como dois dígitos com um zero à esquerda conforme necessário, ou seja01 - 12, .

<><tr th scope="row" style="vertical-align:top"><'k'td> Hora do dia para o relógio de 24 horas, ou seja0 - 23, .

<><tr th scope="row" style="vertical-align:top"><'l'td> Hora para o relógio de 12 horas, ou seja1 - 12, .

<><tr th scope="row" style="vertical-align:top"><'M'td> Minuto dentro da hora formatado como dois dígitos com um zero à esquerda conforme necessário, ou seja00 - 59, .

<><tr th scope="row" style="vertical-align:top"'S'<>td> Segundos dentro do minuto, formatados como dois dígitos com um zero à esquerda conforme necessário, ou seja 00 - 60 , ("60" é um valor especial necessário para suportar segundos bissextos).

<><tr th scope="row" style="vertical-align:top"><'L'td> Milésimo de segundo formatado como três dígitos com zeros à esquerda conforme necessário, ou seja000 - 999, .

<><tr th scope="row" style="vertical-align:top"><'N'td> Nanosecond dentro do segundo, formatado como nove dígitos com zeros à esquerda conforme necessário, ou seja000000000 - 999999999, .

<><tr th scope="row" style="vertical-align:top"><'p'td> Locale-specific java.text.DateFormatSymbols#getAmPmStrings marcador da manhã ou da tarde em minúsculas, por exemplo""am ou "pm". O uso do prefixo 'T' de conversão força essa saída a maiúsculas.

<><tr th scope="row" style="vertical-align:top">'z'<td>RFC 822 estilo fuso horário numérico deslocado do GMT, por exemplo. -0800 Esse valor será ajustado conforme a necessidade para o horário de verão. Para long, Longe Date o fuso horário usado é o fuso horário padrão TimeZone#getDefault() para esta instância da máquina virtual Java.

<><tr th scope="row" style="vertical-align:top"<>'Z'td> Uma cadeia de caracteres que representa a abreviação do fuso horário. Esse valor será ajustado conforme a necessidade para o horário de verão. Para long, Longe Date o fuso horário usado é o fuso horário padrão TimeZone#getDefault() para esta instância da máquina virtual Java. A localidade do Formatter substituirá a localidade do argumento (se houver).

<><tr th scope="row" style="vertical-align:top"<'s'>td> Segundos desde o início da época a partir de 1 de Janeiro de 1970 00:00:00 UTC, ou sejaLong.MIN_VALUE/1000, até .Long.MAX_VALUE/1000

<><tr th scope="row" style="vertical-align:top"><'Q'td> Milésimos de segundos desde o início da época a partir de 1 de Janeiro de 1970 00:00:00 UTC, ou sejaLong.MIN_VALUE, até .Long.MAX_VALUE

</tbody></tabela>

Os seguintes caracteres de conversão são usados para formatar datas:

<table class="listrado"><caption style="display:none">date</caption><tbody>

<><tr th scope="row" style="vertical-align:top"'B'<>td> Locale-specific java.text.DateFormatSymbols#getMonths nome completo do mês, por exemplo"January", "February", .

<><tr th scope="row" style="vertical-align:top"'b'<>td> Locale-specific java.text.DateFormatSymbols#getShortMonths nome abreviado do mês, por exemplo"Jan", "Feb", .

<><tr th scope="row" style="vertical-align:top"><'h'td> O mesmo que .'b'

<><tr th scope="row" style="vertical-align:top"'A'<>td> Nome completo específico da localidade do java.text.DateFormatSymbols#getWeekdays dia da semana, por exemplo"Sunday", ,<"Monday" tr><th scope="row" style="vertical-align:top"'a'><td> Nome abreviado específico da localidade do java.text.DateFormatSymbols#getShortWeekdays dia da semana, por exemplo"Sun", , "Mon"<tr><th scope="row" style="vertical-align:top"'C'<>td> Ano de quatro dígitos dividido por 100, formatado como dois dígitos com zero à esquerda conforme necessário, ou seja00 - 99<, tr><th scope="row" style="vertical-align:top"<'Y'>td> Year, formatado como pelo menos quatro dígitos com zeros à esquerda conforme necessário, por exemplo0092, igual 92 a CE para o calendário gregoriano.

<><tr th scope="row" style="vertical-align:top"><'y'td> Últimos dois dígitos do ano, formatados com zeros à esquerda conforme necessário, ou seja00 - 99, .

<><tr th scope="row" style="vertical-align:top"><'j'td> Dia do ano, formatado como três dígitos com zeros à esquerda conforme necessário, por exemplo001 - 366, para o calendário gregoriano.

<><tr th scope="row" style="vertical-align:top"><'m'td> Mês, formatado como dois dígitos com zeros à esquerda conforme necessário, ou seja01 - 13, .

<><tr th scope="row" style="vertical-align:top"'d'<>td> Dia do mês, formatado como dois dígitos com zeros à esquerda conforme necessário, ou seja01 - 31<, tr><th scope="row" style="vertical-align:top"'e'<>td> Dia do mês, formatado como dois dígitos, ou seja1 - 31, .

</tbody></tabela>

Os caracteres de conversão a seguir são usados para formatar composições comuns de data/hora.

<table class="listrado"><caption style="display:none">composites</caption><tbody>

<><tr th scope="row" style="vertical-align:top"'R'<>td> Hora formatada para o relógio de 24 horas como "%tH:%tM"<tr><th scope="row" style="vertical-align:top"'T'<>td> Hora formatada para o relógio de 24 horas como ."%tH:%tM:%tS"

<><tr th scope="row" style="vertical-align:top"><'r'td> Hora formatada para o relógio de 12 horas como ."%tI:%tM:%tS %Tp" A localização do marcador da manhã ou da tarde ('%Tp') pode ser dependente da localidade.

<><tr th scope="row" style="vertical-align:top"><'D'td> Data formatada como ."%tm/%td/%ty"

<><tr th scope="row" style="vertical-align:top">'F'<td>ISO 8601 data completa formatada como ."%tY-%tm-%td"

<><tr th scope="row" style="vertical-align:top"'c'<>td> Data e hora formatadas como "%ta %tb %td %tT %tZ %tY", por exemplo, . "Sun Jul 20 16:17:00 EDT 1969"

</tbody></tabela>

Quaisquer caracteres não explicitamente definidos como sufixos de conversão de data/hora são ilegais e são reservados para extensões futuras.

<h4> Bandeiras </h4>

A tabela a seguir resume os sinalizadores com suporte. y significa que o sinalizador é suportado para os tipos de argumento indicados.

<table class="striped"><caption style="display:none">genConv</caption><thead<>tr><th scope="col" style="vertical-align:bottom"> Flag <th scope="col" style="vertical-align:bottom"> General <th scope="col" style="vertical-align:bottom"> Caractere <th scope="col" style="vertical-align:bottom"> Integral <th scope="col" style="vertical-align:bottom"> Ponto <flutuante th scope="col" style=" vertical-align:bottom"> Data/Hora <th scope="col" style="vertical-align:bottom"> Descrição </thead><tbody><tr><th scope="row"> '-' <td style="text-align:center; vertical-align:top"> y <td style="text-align:center; vertical-align:top"> y <td style="text-align:center; vertical-align:top"> y <td style="text-align:center; vertical-align:top"> y <td style="text-align:center; vertical-align:top"> y <td> O resultado será justificado à esquerda.

<><tr th scope="row"> '#' <td style="text-align:center; vertical-align:top"> y<sup>1</sup<>td style="text-align:center; vertical-align:top"> - <td style="text-align:center; vertical-align:top"> y³<td style="text-align:center; vertical-align:top"> y <td style="text-align:center; vertical-align:top"> - <td> O resultado deve usar um formulário alternativo dependente da conversão

<><tr th scope="linha"> '+' <td style="text-align:center; vertical-align:top"> - <td style="text-align:center; vertical-align:top"> - <td style="text-align:center; vertical-align:top"> y<sup>4</sup<>td style="text-align:center; vertical-align:top"> y <td style="text-align:center; vertical-align:top"> - <td> O resultado sempre incluirá um sinal

<><tr th scope="linha"> '   ' <td style="text-align:center; vertical-align:top"> - <td style="text-align:center; vertical-align:top"> - <td style="text-align:center; vertical-align:top"> y⁴<td style="text-align:center; vertical-align:top"> y <td style="text-align:center; vertical-align:top"> - <td> O resultado incluirá um espaço à esquerda para valores positivos

<><tr th scope="linha"> '0' <td style="text-align:center; vertical-align:top"> - <td style="text-align:center; vertical-align:top"> - <td style="text-align:center; vertical-align:top"> y <td style="text-align:center; vertical-align:top"> y <td style="text-align:center; vertical-align:top"> - <td> o resultado será zero-acolchoado

<><tr th scope="row"> '," <td style="text-align:center; vertical-align:top"> - <td style="text-align:center; vertical-align:top"> - <td style="text-align:center; vertical-align:top"> y<sup>2</sup<>td style="text-align:center; vertical-align:top"> y⁵<td style="text-align:center; vertical-align:top"> - <td> O resultado incluirá java.text.DecimalFormatSymbols#getGroupingSeparator agrupando separadores<tr><th scope="row"> '(' <td style="text-align:center; vertical-align:top"> - <td style="text-align:center; vertical-align:top"> - <td style="text-align:center; vertical-align:top"> y<sup>4</sup<>td style="text-align:center; vertical-align:top"> y⁵<td style="text-align:center"> - <td> O resultado colocará números negativos entre parênteses

</tbody></tabela>

¹ Depende da definição de Formattable.

² Apenas para 'd' conversão.

³ For 'o', 'x'e 'X' somente conversões.

⁴ Para 'd', 'o', 'x'e 'X' conversões aplicadas a java.math.BigInteger BigInteger ou 'd' aplicadas a byte, Byte, short, Shortint , e Integer, longe Long.

⁵ Somente para 'e', 'E', 'g''f', e 'G' conversões.

Quaisquer caracteres não explicitamente definidos como sinalizadores são ilegais e são reservados para extensões futuras.

<h4> Largura </h4>

A largura é o número mínimo de caracteres a serem gravados na saída. Para a conversão do separador de linha, a largura não é aplicável; se for fornecida, uma exceção será lançada.

<h4> Precisão </h4>

Para tipos de argumento gerais, a precisão é o número máximo de caracteres a serem gravados na saída.

Para as conversões 'a'de ponto flutuante , 'A', , 'e''E', e 'f' a precisão é o número de dígitos após o ponto radix. Se a conversão for 'g' ou 'G', então a precisão é o número total de dígitos na magnitude resultante após o arredondamento.

Para os tipos de argumento caractere, integral e data/hora e as conversões de separador de porcentagem e linha, a precisão não é aplicável; se uma precisão for fornecida, uma exceção será lançada.

<h4> Índice de argumentos </h4>

O índice de argumento é um inteiro decimal que indica a posição do argumento na lista de argumentos. O primeiro argumento é referenciado por "1$", o segundo por "2$", etc.

Outra maneira de referenciar argumentos por posição é usar o '<' sinalizador ('\u003c'), que faz com que o argumento para o especificador de formato anterior seja reutilizado. Por exemplo, as duas instruções a seguir produziriam cadeias de caracteres idênticas:

<blockquote>

Calendar c = ...;
              String s1 = String.format("Duke's Birthday: %1$tm %1$te,%1$tY", c);

              String s2 = String.format("Duke's Birthday: %1$tm %<te,%<tY", c);

</blockquote>

<><hr h3>"detail">Detalhes</h3>

Esta seção destina-se a fornecer detalhes comportamentais para formatação, incluindo condições e exceções, tipos de dados com suporte, localização e interações entre sinalizadores, conversões e tipos de dados. Para obter uma visão geral dos conceitos de formatação, consulte o Resumo

Quaisquer caracteres não explicitamente definidos como conversões, sufixos de conversão de data/hora ou sinalizadores são ilegais e são reservados para extensões futuras. O uso de tal caractere em uma sequência de caracteres de formato fará com que um UnknownFormatConversionException ou UnknownFormatFlagsException seja lançado.

Se o especificador de formato contiver uma largura ou precisão com um valor inválido ou que não seja suportado, um IllegalFormatWidthException ou IllegalFormatPrecisionException respectivamente será lançado.

Se um especificador de formato contiver um caractere de conversão que não seja aplicável ao argumento correspondente, um IllegalFormatConversionException será lançado.

Todas as exceções especificadas podem ser lançadas por qualquer um dos format métodos de, bem como por quaisquer format métodos de Formatter conveniência, como String#format(String,Object...) String.format e java.io.PrintStream#printf(String,Object...) PrintStream.printf.

Para a categoria Geral, Caractere, Numérico, Integral e Conversão de Data/Hora, a menos que especificado de outra forma, se o argumento arg for null, então o resultado será "null".

As conversões denotadas por um caractere maiúsculo (ou seja'B', , 'H', 'S', 'E''G''X''A''C'e 'T') são as mesmas que para os caracteres de conversão minúsculas correspondentes, exceto que o resultado é convertido em maiúsculas de acordo com as java.util.Locale Localeregras do . Se não houver nenhuma localidade explícita especificada, seja na construção da instância ou como um parâmetro para sua chamada de método, então o java.util.Locale.Category#FORMAT default locale é usado.

<h4>"dgen">Geral</h4>

As seguintes conversões gerais podem ser aplicadas a qualquer tipo de argumento:

<table class="listrado"><caption style="display:none">dgConv</caption><tbody>

<><tr th scope="row" style="vertical-align:top"<'b'>td style="vertical-align:top"'\u0062'><td> Produz "true" ou "false" conforme retornado por .Boolean#toString(boolean)

Se o argumento é null, então o resultado é "false". Se o argumento for um boolean ou Boolean, o resultado será a cadeia de caracteres retornada por String#valueOf(boolean) String.valueOf(). Caso contrário, o resultado será "true".

Se a '#' bandeira for dada, então um FormatFlagsConversionMismatchException será lançado.

<><tr th scope="row" style="vertical-align:top"'B'><td style="vertical-align:top"'\u0042'<>td> A variante maiúscula de .'b'

<><tr th scope="row" style="vertical-align:top">'h'<td style="vertical-align:top"'\u0068'><td> Produz uma cadeia de caracteres que representa o valor do código hash do objeto.

O resultado é obtido invocando Integer.toHexString(arg.hashCode()).

Se a '#' bandeira for dada, então um FormatFlagsConversionMismatchException será lançado.

<><tr th scope="row" style="vertical-align:top"'H'><td style="vertical-align:top"'\u0048'<>td> A variante maiúscula de .'h'

<><tr th scope="row" style="vertical-align:top">'s'<td style="vertical-align:top"'\u0073'><td> Produz uma cadeia de caracteres.

Se o argumento implementa Formattable, seu Formattable#formatTo formatTo método é chamado. Caso contrário, o resultado é obtido invocando o método do toString() argumento.

Se a '#' bandeira é dada e o argumento não é um Formattable , então um FormatFlagsConversionMismatchException será lançado.

<><tr th scope="row" style="vertical-align:top"'S'><td style="vertical-align:top"'\u0053'<>td> A variante maiúscula de .'s'

</tbody></tabela>

Os seguintes sinalizadores "dFlags"> se aplicam a conversões gerais:

<table class="listrado"><caption style="display:none">dFlags</caption><tbody>

<><tr th scope="row" style="vertical-align:top">'-'<td style="vertical-align:top"'\u002d'><td> Left justifica a saída. Os espaços ('\u0020') serão adicionados no final do valor convertido, conforme necessário para preencher a largura mínima do campo. Se a largura não for fornecida, um MissingFormatWidthException será lançado. Se esse sinalizador não for dado, a saída será justificada à direita.

<><tr th scope="row" style="vertical-align:top">'#'<td style="vertical-align:top"'\u0023'><td> Requer que a saída use um formulário alternativo. A definição do formulário é especificada pela conversão.

</tbody></tabela>

A largura "genWidth"> é o número mínimo de caracteres a serem gravados na saída. Se o comprimento do valor convertido for menor que a largura, a saída será preenchida por '  ' ('\u0020') até que o número total de caracteres seja igual à largura. O preenchimento está à esquerda por padrão. Se a '-' bandeira for dada, o preenchimento estará à direita. Se a largura não for especificada, não há mínimo.

A precisão é o número máximo de caracteres a serem gravados na saída. A precisão é aplicada antes da largura, assim a saída será truncada para precision caracteres mesmo que a largura seja maior que a precisão. Se a precisão não for especificada, não há limite explícito no número de caracteres.

<h4>"dchar">Caractere</h4>

Esta conversão pode ser aplicada a char e Character. Ele também pode ser aplicado aos tipos , , , e Shortint , e Integer quando Character#isValidCodePoint retorna true. shortBytebyte Se ele retornar false , então um IllegalFormatCodePointException testamento será lançado.

<table class="listrado"><caption style="display:none">charConv</caption><tbody>

<><tr th scope="row" style="vertical-align:top">'c'<td style="vertical-align:top"'\u0063'><td> Formata o argumento como um caractere Unicode, conforme descrito em Representação de Caracteres Unicode. Isso pode ser mais de um 16 bits char no caso em que o argumento representa um caractere suplementar.

Se a '#' bandeira for dada, então um FormatFlagsConversionMismatchException será lançado.

<><tr th scope="row" style="vertical-align:top"'C'><td style="vertical-align:top"'\u0043'<>td> A variante maiúscula de .'c'

</tbody></tabela>

O '-' sinalizador definido para Conversões gerais se aplica. Se a '#' bandeira for dada, então um FormatFlagsConversionMismatchException será lançado.

A largura é definida como para conversões gerais.

A precisão não é aplicável. Se a precisão for especificada, um IllegalFormatPrecisionException será lançado.

<h4>"dnum">Numérico</h4>

As conversões numéricas são divididas nas seguintes categorias:

<Ol>

<li><b>Byte, Curto, Inteiro e Longo</b><li<>b>BigInteger</b><li><b>Float e Double</b><li><b>BigDecimal</b></ol>

Os tipos numéricos serão formatados de acordo com o seguinte algoritmo:

<b>"L10nAlgorithm"> Algoritmo de Localização Numérica</b>

Depois que os dígitos são obtidos para a parte inteira, a parte fracionária e o expoente (conforme apropriado para o tipo de dados), a seguinte transformação é aplicada:

<Ol>

<li> Cada caractere de dígito d na cadeia de caracteres é substituído por um dígito específico da localidade calculado em relação ao java.text.DecimalFormatSymbols#getZeroDigit() zero dígitoz; que é d - '0' +  z.

<li> Se um separador decimal estiver presente, um separador decimal java.text.DecimalFormatSymbols#getDecimalSeparator específico da localidade será substituído.

<li> Se o ',' sinalizador ('\u002c') "L10nGroup"> for fornecido, o separador de agrupamento java.text.DecimalFormatSymbols#getGroupingSeparator específico da localidade será inserido examinando a parte inteira da cadeia de caracteres dos dígitos menos significativos para os mais significativos e inserindo um separador em intervalos definidos pelo tamanho de agrupamento java.text.DecimalFormat#getGroupingSize() da localidade.

<li> Se o '0' sinalizador for fornecido, os dígitos zero java.text.DecimalFormatSymbols#getZeroDigit() específicos da localidade serão inseridos após o caractere de sinal, se houver, e antes do primeiro dígito diferente de zero, até que o comprimento da cadeia de caracteres seja igual à largura do campo solicitado.

<li> Se o valor for negativo e o '(' sinalizador for dado, então um '(' ('\u0028') é precedido e um ')' ('\u0029') é acrescentado.

<li> Se o valor for negativo (ou zero negativo de ponto flutuante) e '(' a bandeira não for dada, então um '-' ('\u002d') será precedido.

<li> Se o '+' sinalizador for dado e o valor for positivo ou zero (ou zero positivo de ponto flutuante), então um '+' ('\u002b') será precedido.

</Ol>

Se o valor for NaN ou infinito positivo, as cadeias literais "NaN" ou "Infinito", respectivamente, serão saída. Se o valor for infinito negativo, então a saída será "(Infinito)" se o '(' sinalizador for dado, caso contrário, a saída será "-Infinito". Esses valores não são localizados.

"dnint"><b> Byte, Curto, Inteiro e Longo </b>

As conversões a seguir podem ser aplicadas a byte, Byte, short, intShort, e Integer, longe Long.

<table class="listrado"><caption style="display:none">IntConv</caption><tbody>

<><tr th scope="row" style="vertical-align:top">'d'<td style="vertical-align:top"'\u0064'><td> Formata o argumento como um inteiro decimal. O algoritmo de localização é aplicado.

Se o '0' sinalizador for dado e o valor for negativo, o preenchimento zero ocorrerá após o sinal.

Se a '#' bandeira for dada, então um FormatFlagsConversionMismatchException será lançado.

<><tr th scope="row" style="vertical-align:top">'o'<td style="vertical-align:top"'\u006f'><td> Formata o argumento como um inteiro na base oito. Nenhuma localização é aplicada.

Se x for negativo, o resultado será um valor não assinado gerado pela adição de 2ⁿ ao valor onde n é o número de bits no tipo retornado pelo campo estático SIZE nas classes Byte#SIZE Byte, Short#SIZE Short, Integer#SIZE Integer ou Long#SIZE Long, conforme apropriado.

Se o '#' sinalizador for dado, a saída sempre começará com o indicador '0'radix .

Se o '0' sinalizador for dado, a saída será preenchida com zeros à esquerda para a largura do campo após qualquer indicação de sinal.

Se '(', '+', '   ', ou ',' bandeiras são dadas então um FormatFlagsConversionMismatchException será lançado.

<><tr th scope="row" style="vertical-align:top">'x'<td style="vertical-align:top"'\u0078'><td> Formata o argumento como um inteiro na base dezesseis. Nenhuma localização é aplicada.

Se x for negativo, o resultado será um valor não assinado gerado pela adição de 2ⁿ ao valor onde n é o número de bits no tipo retornado pelo campo estático SIZE nas classes Byte#SIZE Byte, Short#SIZE Short, Integer#SIZE Integer ou Long#SIZE Long, conforme apropriado.

Se o '#' sinalizador for dado, a saída sempre começará com o indicador "0x"radix .

Se o '0' sinalizador for dado, a saída será preenchida para a largura do campo com zeros à esquerda após o indicador ou sinal radix (se presente).

Se '(', '  ', '+', ou ',' bandeiras são dadas, então um FormatFlagsConversionMismatchException será lançado.

<><tr th scope="row" style="vertical-align:top"'X'><td style="vertical-align:top"'\u0058'<>td> A variante maiúscula de .'x' A cadeia de caracteres inteira que representa o número será convertida em String#toUpperCase maiúsculas, incluindo os 'x' (se houver) e todos os dígitos hexadecimais ( - '\u0061''\u0066').'a' - 'f'

</tbody></tabela>

Se a conversão for 'o', 'x'ou 'X' e ambos os '#' sinalizadores e os '0' sinalizadores forem dados, o resultado conterá o indicador radix ('0' para octal e "0x" ou "0X" para hexadecimal), algum número de zeros (com base na largura) e o valor.

Se o '-' sinalizador não for fornecido, o preenchimento do espaço ocorrerá antes do sinal.

Os seguintes sinalizadores "intFlags"> se aplicam a conversões integrais numéricas:

<table class="listrado"><caption style="display:none">intFlags</caption><tbody>

<><tr th scope="row" style="vertical-align:top">'+'<td style="vertical-align:top"'\u002b'><td> Requer que a saída inclua um sinal positivo para todos os números positivos. Se esse sinalizador não for dado, apenas os valores negativos incluirão um sinal.

Se ambas as '+''  ' bandeiras forem dadas, então uma IllegalFormatFlagsException vontade será lançada.

<><tr th scope="row" style="vertical-align:top"'  '><td style="vertical-align:top"'\u0020'<>td> Requer que a saída inclua um único espaço extra ('\u0020') para valores não negativos.

Se ambas as '+''  ' bandeiras forem dadas, então uma IllegalFormatFlagsException vontade será lançada.

<><tr th scope="row" style="vertical-align:top">'0'<td style="vertical-align:top"'\u0030'><td> Requer que a saída seja preenchida com java.text.DecimalFormatSymbols#getZeroDigit zeros para a largura mínima do campo seguindo qualquer sinal ou indicador radix, exceto ao converter NaN ou infinito. Se a largura não for fornecida, um MissingFormatWidthException será lançado.

Se ambas as '-''0' bandeiras forem dadas, então uma IllegalFormatFlagsException vontade será lançada.

<><tr th scope="row" style="vertical-align:top">','<td style="vertical-align:top"'\u002c'><td> Requer que a saída inclua os separadores de grupo java.text.DecimalFormatSymbols#getGroupingSeparator específicos da localidade, conforme descrito na seção "grupo" do algoritmo de localização.

<><tr th scope="row" style="vertical-align:top"<>'('td style="vertical-align:top">'\u0028'<td> Requer que a saída preceda um '(' ('\u0028') e acrescente um ')' ('\u0029') a valores negativos.

</tbody></tabela>

Se nenhum sinalizador "intdFlags"> for fornecido, a formatação padrão será a seguinte:

<ul>

<li> A saída é justificada à direita dentro do width<li> Números negativos começam com um '-' ('\u002d')

<li> Números positivos e zero não incluem um sinal ou espaço à esquerda extra

<li> Nenhum separador de agrupamento está incluído

</ul>

A largura "intWidth"> é o número mínimo de caracteres a serem gravados na saída. Isso inclui quaisquer sinais, dígitos, separadores de agrupamento, indicador radix e parênteses. Se o comprimento do valor convertido for menor que a largura, a saída será preenchida por espaços ('\u0020') até que o número total de caracteres seja igual à largura. O preenchimento está à esquerda por padrão. Se '-' a bandeira for dada, o preenchimento estará à direita. Se a largura não for especificada, não haverá mínimo.

A precisão não é aplicável. Se a precisão for especificada, um IllegalFormatPrecisionException será lançado.

"dnbint"><b> BigInteger </b>

As seguintes conversões podem ser aplicadas ao java.math.BigInteger.

<table class="listrado"><caption style="display:none">bIntConv</caption><tbody>

<><tr th scope="row" style="vertical-align:top">'d'<td style="vertical-align:top"'\u0064'><td> Requer que a saída seja formatada como um inteiro decimal. O algoritmo de localização é aplicado.

Se a '#' bandeira for dada FormatFlagsConversionMismatchException será lançada.

<><tr th scope="row" style="vertical-align:top">'o'<td style="vertical-align:top"'\u006f'><td> Requer que a saída seja formatada como um inteiro na base oito. Nenhuma localização é aplicada.

Se x for negativo, o resultado será um valor assinado começando com '-' ('\u002d'). A saída assinada é permitida para esse tipo porque, ao contrário dos tipos primitivos, não é possível criar um equivalente não assinado sem assumir um tamanho de tipo de dados explícito.

Se x for positivo ou zero e o '+' sinalizador for dado, o resultado começará com '+' ('\u002b').

Se o '#' sinalizador for dado, a saída sempre começará com '0' prefixo.

Se o '0' sinalizador for dado, a saída será preenchida com zeros à esquerda para a largura do campo após qualquer indicação de sinal.

Se a ',' bandeira for dada, então um FormatFlagsConversionMismatchException será lançado.

<><tr th scope="row" style="vertical-align:top">'x'<td style="vertical-align:top"'\u0078'><td> Requer que a saída seja formatada como um inteiro na base dezesseis. Nenhuma localização é aplicada.

Se x for negativo, o resultado será um valor assinado começando com '-' ('\u002d'). A saída assinada é permitida para esse tipo porque, ao contrário dos tipos primitivos, não é possível criar um equivalente não assinado sem assumir um tamanho de tipo de dados explícito.

Se x for positivo ou zero e o '+' sinalizador for dado, o resultado começará com '+' ('\u002b').

Se o '#' sinalizador for dado, a saída sempre começará com o indicador "0x"radix .

Se o '0' sinalizador for dado, a saída será preenchida para a largura do campo com zeros à esquerda após o indicador ou sinal radix (se presente).

Se a ',' bandeira for dada, então um FormatFlagsConversionMismatchException será lançado.

<><tr th scope="row" style="vertical-align:top"'X'><td style="vertical-align:top"'\u0058'<>td> A variante maiúscula de .'x' A cadeia de caracteres inteira que representa o número será convertida em String#toUpperCase maiúsculas, incluindo os 'x' (se houver) e todos os dígitos hexadecimais ( - '\u0061''\u0066').'a' - 'f'

</tbody></tabela>

Se a conversão for 'o', 'x'ou 'X' e ambos os '#' sinalizadores e os '0' sinalizadores forem dados, o resultado conterá o indicador base ('0' para octal e "0x" ou "0X" para hexadecimal), algum número de zeros (com base na largura) e o valor.

Se o '0' sinalizador for dado e o valor for negativo, o preenchimento zero ocorrerá após o sinal.

Se o '-' sinalizador não for fornecido, o preenchimento do espaço ocorrerá antes do sinal.

Todos os sinalizadores definidos para Byte, Short, Integer e Long se aplicam. O comportamento padrão quando nenhum sinalizador é fornecido é o mesmo que para Byte, Curto, Inteiro e Longo.

A especificação de largura é a mesma definida para Byte, Curto, Inteiro e Longo.

A precisão não é aplicável. Se a precisão for especificada, um IllegalFormatPrecisionException será lançado.

"dndec"><b> Float e Double</b>

As conversões a seguir podem ser aplicadas a float, doubleFloate Double.

<table class="striped"><caption style="display:none">floatConv</caption><tbody>

<><tr th scope="row" style="vertical-align:top"'e'><td style="vertical-align:top"'\u0065'<>td> Requer que a saída seja formatada usando notação científica computadorizada "científica".> O algoritmo de localização é aplicado.

A formatação da magnitude m depende do seu valor.

Se m é NaN ou infinito, as cadeias literais "NaN" ou "Infinito", respectivamente, serão produzidas. Esses valores não são localizados.

Se m é zero-positivo ou zero-negativo, então o expoente será "+00".

Caso contrário, o resultado será uma cadeia de caracteres que representa o sinal e a magnitude (valor absoluto) do argumento. A formatação do sinal é descrita no algoritmo de localização. A formatação da magnitude m depende do seu valor.

Seja n o inteiro único tal que 10ⁿ <= m < 10ⁿ⁺¹; então que a seja o quociente matematicamente exato de m e 10ⁿ de modo que 1 <= a < 10. A magnitude é então representada como a parte inteira de a, como um único dígito decimal, seguido pelo separador decimal seguido por dígitos decimais que representam a parte fracionária de a, seguido pelo separador do expoente java.text.DecimalFormatSymbols#getExponentSeparator específico da localidade (por exemplo 'e', ), seguido pelo sinal do expoente, seguido por uma representação de n como um inteiro decimal, como produzido pelo método Long#toString(long, int), e zero-acolchoado para incluir pelo menos dois dígitos.

O número de dígitos no resultado para a parte fracionária de m ou a é igual à precisão. Se a precisão não for especificada, o valor padrão será 6. Se a precisão for menor do que o número de dígitos que apareceriam após o ponto decimal na cadeia de caracteres retornada por Float#toString(float) ou Double#toString(double) respectivamente, o valor será arredondado usando o algoritmo java.math.RoundingMode#HALF_UP arredondar metade para cima. Caso contrário, zeros podem ser acrescentados para atingir a precisão. Para uma representação canônica do valor, use Float#toString(float) ou Double#toString(double) conforme apropriado.

Se a ',' bandeira for dada, então um FormatFlagsConversionMismatchException será lançado.

<><tr th scope="row" style="vertical-align:top"'E'><td style="vertical-align:top"'\u0045'<>td> A variante maiúscula de .'e' O símbolo do expoente será o separador do expoente java.text.DecimalFormatSymbols#getExponentSeparator específico da localidade (por exemplo, 'E').

<><tr th scope="row" style="vertical-align:top">'g'<td style="vertical-align:top"'\u0067'><td> Requer que a saída seja formatada em notação científica geral, conforme descrito abaixo. O algoritmo de localização é aplicado.

Após o arredondamento para a precisão, a formatação da magnitude resultante m depende do seu valor.

Se m for maior ou igual a 10<sup-4></sup> mas menor que 10^precision, então ele é representado em formato decimal.

Se m é menor que 10<sup-4></sup> ou maior ou igual a 10^precision, então ele é representado em notação científica computadorizada.

O número total de dígitos significativos em m é igual à precisão. Se a precisão não for especificada, o valor padrão será 6. Se a precisão é 0, então é considerado 1.

Se a '#' bandeira for dada, então um FormatFlagsConversionMismatchException será lançado.

<><tr th scope="row" style="vertical-align:top"'G'><td style="vertical-align:top"'\u0047'<>td> A variante maiúscula de .'g'

<><tr th scope="row" style="vertical-align:top"'f'><td style="vertical-align:top"'\u0066'<>td> Requer que a saída seja formatada usando o formato decimal "decimal".> O algoritmo de localização é aplicado.

O resultado é uma cadeia de caracteres que representa o sinal e a magnitude (valor absoluto) do argumento. A formatação do sinal é descrita no algoritmo de localização. A formatação da magnitude m depende do seu valor.

Se m NaN ou infinito, as cadeias literais "NaN" ou "Infinito", respectivamente, serão saída. Esses valores não são localizados.

A magnitude é formatada como a parte inteira de m, sem zeros à esquerda, seguida pelo separador decimal seguido por um ou mais dígitos decimais representando a parte fracionária de m.

O número de dígitos no resultado para a parte fracionária de m ou a é igual à precisão. Se a precisão não for especificada, o valor padrão será 6. Se a precisão for menor do que o número de dígitos que apareceriam após o ponto decimal na cadeia de caracteres retornada por Float#toString(float) ou Double#toString(double) respectivamente, o valor será arredondado usando o algoritmo java.math.RoundingMode#HALF_UP arredondar metade para cima. Caso contrário, zeros podem ser acrescentados para atingir a precisão. Para uma representação canônica do valor, use Float#toString(float) ou Double#toString(double) conforme apropriado.

<><tr th scope="row" style="vertical-align:top">'a'<td style="vertical-align:top"'\u0061'><td> Requer que a saída seja formatada em forma exponencial hexadecimal. Nenhuma localização é aplicada.

O resultado é uma cadeia de caracteres que representa o sinal e a magnitude (valor absoluto) do argumento x.

Se x for negativo ou um valor zero negativo, o resultado começará com '-' ('\u002d').

Se x for positivo ou um valor positivo zero e o '+' sinalizador for dado, o resultado começará com '+' ('\u002b').

A formatação da magnitude m depende do seu valor.

<ul>

<li> Se o valor for NaN ou infinito, as cadeias literais "NaN" ou "Infinito", respectivamente, serão saída.

<li> Se m é zero, então ele é representado pela cadeia de caracteres "0x0.0p0".

<li> Se m é um double valor com uma representação normalizada, então substrings são usadas para representar os campos significante e expoente. O significante é representado pelos caracteres "0x1." seguidos pela representação hexadecimal do restante do significante como uma fração. O expoente é representado por 'p' ('\u0070') seguido por uma sequência decimal do expoente imparcial como se fosse produzido invocando Integer#toString(int) Integer.toString o valor do expoente. Se a precisão for especificada, o valor será arredondado para o número determinado de dígitos hexadecimais.

<li> Se m é um double valor com uma representação subnormal, então, a menos que a precisão seja especificada para estar no intervalo de 1 a 12, inclusive, o significante é representado pelos caracteres '0x0.' seguidos pela representação hexadecimal do resto do significante como uma fração, e o expoente representado por 'p-1022'. Se a precisão estiver no intervalo [1,  12], o valor subnormal é normalizado de tal forma que começa com os caracteres '0x1.', arredondado para o número de dígitos hexadecimais de precisão, e o expoente ajustado de acordo. Observe que deve haver pelo menos um dígito diferente de zero em um significado subnormal.

</ul>

Se as '('',' bandeiras são dadas, então um FormatFlagsConversionMismatchException será lançado.

<><tr th scope="row" style="vertical-align:top"'A'><td style="vertical-align:top"'\u0041'<>td> A variante maiúscula de .'a' A cadeia de caracteres inteira que representa o número será convertida em maiúsculas, incluindo o 'x' () e 'p' ('\u0070' e todos os dígitos hexadecimais'f''a' - ().'\u0061' - '\u0066''\u0078'

</tbody></tabela>

Todos os sinalizadores definidos para Byte, Short, Integer e Long se aplicam.

Se o '#' sinalizador for fornecido, o separador decimal estará sempre presente.

Se nenhum sinalizador "floatdFlags"> for fornecido, a formatação padrão será a seguinte:

<ul>

<li> A saída é justificada à direita dentro do width<li> Números negativos começam com um '-'<li> Números positivos e zero positivo não incluem um sinal ou espaço à esquerda extra

<li> Nenhum separador de agrupamento está incluído

<li> O separador decimal só aparecerá se um dígito o seguir

</ul>

A largura "floatDWidth"> é o número mínimo de caracteres a serem gravados na saída. Isso inclui quaisquer sinais, dígitos, separadores de agrupamento, separadores decimais, símbolo exponencial, indicador radix, parênteses e cadeias de caracteres que representem infinito e NaN, conforme aplicável. Se o comprimento do valor convertido for menor que a largura, a saída será preenchida por espaços ('\u0020') até que o número total de caracteres seja igual à largura. O preenchimento está à esquerda por padrão. Se a '-' bandeira for dada, o preenchimento estará à direita. Se a largura não for especificada, não haverá mínimo.

Se a conversão "floatDPrec"> for 'e', 'E' ou 'f', então a precisão é o número de dígitos após o separador decimal. Se a precisão não for especificada, então presume-se 6que seja .

Se a conversão for 'g' ou 'G', então a precisão é o número total de dígitos significativos na magnitude resultante após o arredondamento. Se a precisão não for especificada, o valor padrão será 6. Se a precisão é 0, então é considerado 1.

Se a conversão for 'a' ou 'A', então a precisão é o número de dígitos hexadecimais após o ponto radix. Se a precisão não for fornecida, todos os dígitos retornados por Double#toHexString(double) serão produzidos.

"dnbdec"><b> BigDecimal </b>

As seguintes conversões podem ser aplicadas java.math.BigDecimal BigDecimal.

<table class="striped"><caption style="display:none">floatConv</caption><tbody>

<><tr th scope="row" style="vertical-align:top"'e'><td style="vertical-align:top"'\u0065'<>td> Requer que a saída seja formatada usando notação científica computadorizada "bscientific".> O algoritmo de localização é aplicado.

A formatação da magnitude m depende do seu valor.

Se m é zero-positivo ou zero-negativo, então o expoente será "+00".

Caso contrário, o resultado será uma cadeia de caracteres que representa o sinal e a magnitude (valor absoluto) do argumento. A formatação do sinal é descrita no algoritmo de localização. A formatação da magnitude m depende do seu valor.

Seja n o inteiro único tal que 10ⁿ <= m < 10ⁿ⁺¹; então que a seja o quociente matematicamente exato de m e 10ⁿ de modo que 1 <= a < 10. A magnitude é então representada como a parte inteira de a, como um único dígito decimal, seguido pelo separador decimal seguido por dígitos decimais representando a parte fracionária de a, seguido pelo símbolo do expoente ('\u0065'), seguido pelo sinal 'e' do expoente, seguido por uma representação de n como um inteiro decimal, conforme produzido pelo método Long#toString(long, int), e zero-acolchoado para incluir pelo menos dois dígitos.

O número de dígitos no resultado para a parte fracionária de m ou a é igual à precisão. Se a precisão não for especificada, o valor padrão será 6. Se a precisão for menor que o número de dígitos à direita do ponto decimal, o valor será arredondado usando o algoritmo java.math.RoundingMode#HALF_UP arredondar metade para cima. Caso contrário, zeros podem ser acrescentados para atingir a precisão. Para uma representação canônica do valor, use BigDecimal#toString().

Se a ',' bandeira for dada, então um FormatFlagsConversionMismatchException será lançado.

<><tr th scope="row" style="vertical-align:top"'E'><td style="vertical-align:top"'\u0045'<>td> A variante maiúscula de .'e' O símbolo do expoente será 'E' ('\u0045').

<><tr th scope="row" style="vertical-align:top">'g'<td style="vertical-align:top"'\u0067'><td> Requer que a saída seja formatada em notação científica geral, conforme descrito abaixo. O algoritmo de localização é aplicado.

Após o arredondamento para a precisão, a formatação da magnitude resultante m depende do seu valor.

Se m for maior ou igual a 10<sup-4></sup> mas menor que 10^precision, então ele é representado em formato decimal.

Se m é menor que 10<sup-4></sup> ou maior ou igual a 10^precision, então ele é representado em notação científica computadorizada.

O número total de dígitos significativos em m é igual à precisão. Se a precisão não for especificada, o valor padrão será 6. Se a precisão é 0, então é considerado 1.

Se a '#' bandeira for dada, então um FormatFlagsConversionMismatchException será lançado.

<><tr th scope="row" style="vertical-align:top"'G'><td style="vertical-align:top"'\u0047'<>td> A variante maiúscula de .'g'

<><tr th scope="row" style="vertical-align:top"'f'><td style="vertical-align:top"'\u0066'<>td> Requer que a saída seja formatada usando o formato decimal "bdecimal".> O algoritmo de localização é aplicado.

O resultado é uma cadeia de caracteres que representa o sinal e a magnitude (valor absoluto) do argumento. A formatação do sinal é descrita no algoritmo de localização. A formatação da magnitude m depende do seu valor.

A magnitude é formatada como a parte inteira de m, sem zeros à esquerda, seguida pelo separador decimal seguido por um ou mais dígitos decimais representando a parte fracionária de m.

O número de dígitos no resultado para a parte fracionária de m ou a é igual à precisão. Se a precisão não for especificada, o valor padrão será 6. Se a precisão for menor que o número de dígitos à direita do ponto decimal, o valor será arredondado usando o algoritmo java.math.RoundingMode#HALF_UP arredondar metade para cima. Caso contrário, zeros podem ser acrescentados para atingir a precisão. Para uma representação canônica do valor, use BigDecimal#toString().

</tbody></tabela>

Todos os sinalizadores definidos para Byte, Short, Integer e Long se aplicam.

Se o '#' sinalizador for fornecido, o separador decimal estará sempre presente.

O comportamento padrão quando nenhum sinalizador é fornecido é o mesmo que para Float e Double.

A especificação de largura e precisão é a mesma definida para Float e Double.

<h4>"ddt">Data/Hora</h4>

Essa conversão pode ser aplicada a long, Long, CalendarDate e<TemporalAccessor TemporalAccessor table class="striped"<>caption style="display:none">DTConv</caption><tbody>

<><tr th scope="row" style="vertical-align:top">'t'<td style="vertical-align:top"'\u0074'><td> Prefixo para caracteres de conversão de data e hora. <><tr th scope="row" style="vertical-align:top"'T'><td style="vertical-align:top"'\u0054'<>td> A variante maiúscula de .'t'

</tbody></tabela>

Os seguintes sufixos de caracteres de conversão de data e hora são definidos para as 't' conversões e 'T' . Os tipos são semelhantes, mas não completamente idênticos aos definidos pelo GNU date e POSIX strftime(3c). Tipos de conversão adicionais são fornecidos para acessar a funcionalidade específica do Java (por exemplo 'L' , por milissegundos dentro do segundo).

Os seguintes caracteres de conversão são usados para tempos de formatação:

<table class="listrado"><caption style="display:none">time</caption><tbody>

<><tr th scope="row" style="vertical-align:top">'H'<td style="vertical-align:top">'\u0048'<td> Hora do dia para o relógio de 24 horas, formatado como dois dígitos com um zero à esquerda conforme necessário, ou seja, corresponde 00 à meia-noite. 00 - 23

<><tr th scope="row" style="vertical-align:top"'I'><td style="vertical-align:top"'\u0049'<>td> Hora para o relógio de 12 horas, formatado como dois dígitos com um zero à esquerda conforme necessário, ou seja01 - 12, . 01 corresponde a uma hora (manhã ou tarde).

<><tr th scope="row" style="vertical-align:top">'k'<td style="vertical-align:top">'\u006b'<td> Hora do dia para o relógio de 24 horas, ou seja, corresponde 0 à meia-noite. 0 - 23

<><tr th scope="row" style="vertical-align:top">'l'<td style="vertical-align:top">'\u006c'<td> Hora para o relógio de 12 horas, ou seja1 - 12, corresponde 1 a uma hora (manhã ou tarde).

<><tr th scope="row" style="vertical-align:top"'M'><td style="vertical-align:top"'\u004d'<>td> Minuto dentro da hora formatado como dois dígitos com um zero à esquerda conforme necessário, ou seja00 - 59, .

<><tr th scope="row" style="vertical-align:top">'S'<td style="vertical-align:top">'\u0053'<td> Segundos dentro do minuto, formatados como dois dígitos com um zero à esquerda conforme necessário, ou seja 00 - 60 , ("60" é um valor especial necessário para suportar segundos bissextos).

<><tr th scope="row" style="vertical-align:top"'L'><td style="vertical-align:top"'\u004c'<>td> Milésimo de segundo formatado como três dígitos com zeros à esquerda conforme necessário, ou seja000 - 999, .

<><tr th scope="row" style="vertical-align:top"'N'><td style="vertical-align:top"'\u004e'<>td> Nanosecond dentro do segundo, formatado como nove dígitos com zeros à esquerda conforme necessário, ou seja000000000 - 999999999, . A precisão desse valor é limitada pela resolução do sistema operacional ou hardware subjacente.

<><tr th scope="row" style="vertical-align:top"'p'><td style="vertical-align:top"'\u0070'<>td> Locale-specific java.text.DateFormatSymbols#getAmPmStrings marcador da manhã ou da tarde em minúsculas, por exemplo""am ou "pm". O uso do prefixo 'T' de conversão força essa saída a maiúsculas. (Observe que 'p' produz saída em letras minúsculas. Isso é diferente do GNU date e POSIX strftime(3c) , que produzem saída maiúscula.)

<><tr th scope="row" style="vertical-align:top"'z'<>td style="vertical-align:top"<'\u007a'>td>RFC 822 style numeric time zone offset from GMT, por exemplo. -0800 Esse valor será ajustado conforme a necessidade para o horário de verão. Para long, Longe Date o fuso horário usado é o fuso horário padrão TimeZone#getDefault() para esta instância da máquina virtual Java.

<><tr th scope="row" style="vertical-align:top">'Z'<td style="vertical-align:top"'\u005a'><td> Uma cadeia de caracteres que representa a abreviação do fuso horário. Esse valor será ajustado conforme a necessidade para o horário de verão. Para long, Longe Date o fuso horário usado é o fuso horário padrão TimeZone#getDefault() para esta instância da máquina virtual Java. A localidade do Formatter substituirá a localidade do argumento (se houver).

<><tr th scope="row" style="vertical-align:top"<'s'>td style="vertical-align:top"'\u0073'><td> Segundos desde o início da época a partir de 1 de Janeiro de 1970 00:00:00 UTC, ou sejaLong.MIN_VALUE/1000, até .Long.MAX_VALUE/1000

<><tr th scope="row" style="vertical-align:top"<'Q'>td style="vertical-align:top">'\u004f'<td> Milésimos de segundos desde o início da época a partir de 1 de Janeiro de 1970 00:00:00 UTC, ou sejaLong.MIN_VALUE, até .Long.MAX_VALUE A precisão desse valor é limitada pela resolução do sistema operacional ou hardware subjacente.

</tbody></tabela>

Os seguintes caracteres de conversão são usados para formatar datas:

<table class="listrado"><caption style="display:none">date</caption><tbody>

<><tr th scope="row" style="vertical-align:top">'B'<td style="vertical-align:top">'\u0042'<td> Locale-specific java.text.DateFormatSymbols#getMonths nome completo do mês, por exemplo"January", "February", .

<><tr th scope="row" style="vertical-align:top">'b'<td style="vertical-align:top">'\u0062'<td> Locale-specific java.text.DateFormatSymbols#getShortMonths nome abreviado do mês, por exemplo"Jan", "Feb", .

<><tr th scope="row" style="vertical-align:top"'h'><td style="vertical-align:top"'\u0068'<>td> O mesmo que .'b'

<><tr th scope="row" style="vertical-align:top">'A'<td style="vertical-align:top"'\u0041'<>td> Nome completo específico da localidade do java.text.DateFormatSymbols#getWeekdays dia da semana, por exemplo"Sunday", , "Monday"<tr><th scope="row" style="vertical-align:top"<'a'>td style="vertical-align:top"><'\u0061'td> Locale-specific short name of the java.text.DateFormatSymbols#getShortWeekdays dia da semana, por exemplo"Sun", "Mon"<, tr><th scope="row" style="vertical-align:top">'C'<td style="vertical-align:top">'\u0043'<td> Ano de quatro dígitos dividido por , formatado como 100dois dígitos com zero à esquerda conforme necessário, ou seja<00 - 99, tr><th scope="row" style="vertical-align:top">'Y'<td style="vertical-align:top">'\u0059'<td> Ano, formatado para pelo menos quatro dígitos com zeros à esquerda conforme necessário, por exemplo0092, igual 92 a CE para o calendário gregoriano.

<><tr th scope="row" style="vertical-align:top"'y'><td style="vertical-align:top"'\u0079'<>td> Últimos dois dígitos do ano, formatados com zeros à esquerda conforme necessário, ou seja00 - 99, .

<><tr th scope="row" style="vertical-align:top"'j'><td style="vertical-align:top"'\u006a'<>td> Dia do ano, formatado como três dígitos com zeros à esquerda conforme necessário, por exemplo001 - 366, para o calendário gregoriano. 001 corresponde ao primeiro dia do ano.

<><tr th scope="row" style="vertical-align:top"<'m'>td style="vertical-align:top"><'\u006d'td> Mês, formatado como dois dígitos com zeros à esquerda conforme necessário, ou seja01 - 13, onde "01" é o primeiro mês do ano e ("13" é um valor especial necessário para suportar calendários lunares).

<><tr th scope="row" style="vertical-align:top">'d'<td style="vertical-align:top">'\u0064'<td> Dia do mês, formatado como dois dígitos com zeros à esquerda conforme necessário, ou seja01 - 31, onde "01" é o primeiro dia do mês.

<><tr th scope="row" style="vertical-align:top">'e'<td style="vertical-align:top">'\u0065'<td> Dia do mês, formatado como dois dígitos, ou seja1 - 31, onde "1" é o primeiro dia do mês.

</tbody></tabela>

Os caracteres de conversão a seguir são usados para formatar composições comuns de data/hora.

<table class="listrado"><caption style="display:none">composites</caption><tbody>

<><tr th scope="row" style="vertical-align:top"<'R'>td style="vertical-align:top">'\u0052'<td> Hora formatada para o relógio de 24 horas como "%tH:%tM"<tr><th scope="row" style="vertical-align:top"<'T'>td style="vertical-align:top"'\u0054'<>td> Hora formatada para o relógio de 24 horas como ."%tH:%tM:%tS"

<><tr th scope="row" style="vertical-align:top"'r'><td style="vertical-align:top"'\u0072'<>td> Hora formatada para o relógio de 12 horas como ."%tI:%tM:%tS %Tp" A localização do marcador da manhã ou da tarde ('%Tp') pode ser dependente da localidade.

<><tr th scope="row" style="vertical-align:top"'D'><td style="vertical-align:top"'\u0044'<>td> Data formatada como ."%tm/%td/%ty"

<><tr th scope="row" style="vertical-align:top"'F'<>td style="vertical-align:top"<'\u0046'>td>ISO 8601 data completa formatada como ."%tY-%tm-%td"

<><tr th scope="row" style="vertical-align:top">'c'<td style="vertical-align:top">'\u0063'<td> Data e hora formatadas como "%ta %tb %td %tT %tZ %tY", por exemplo, . "Sun Jul 20 16:17:00 EDT 1969"

</tbody></tabela>

O '-' sinalizador definido para Conversões gerais se aplica. Se a '#' bandeira for dada, então um FormatFlagsConversionMismatchException será lançado.

A largura é o número mínimo de caracteres a serem gravados na saída. Se o comprimento do valor convertido for menor que o width , a saída será preenchida por espaços ('\u0020') até que o número total de caracteres seja igual à largura. O preenchimento está à esquerda por padrão. Se a '-' bandeira for dada, o preenchimento estará à direita. Se a largura não for especificada, não haverá mínimo.

A precisão não é aplicável. Se a precisão for especificada, um IllegalFormatPrecisionException será lançado.

<h4>"dper">Percent/<h4>

A conversão não corresponde a nenhum argumento.

<table class="listrado"><caption style="display:none">DTConv</caption><tbody>

<><tr th scope="row" style="vertical-align:top"'%'<>td> O resultado é um literal '%' ()'\u0025'

A largura é o número mínimo de caracteres a serem gravados na saída, incluindo o '%'. Se o comprimento do valor convertido for menor que o width , a saída será preenchida por espaços ('\u0020') até que o número total de caracteres seja igual à largura. O preenchimento está à esquerda. Se a largura não for especificada, então apenas a '%' saída é.

O '-' sinalizador definido para Conversões gerais se aplica. Se quaisquer outras bandeiras forem fornecidas, então um FormatFlagsConversionMismatchException será lançado.

A precisão não é aplicável. Se a precisão for especificada, um IllegalFormatPrecisionException será lançado.

</tbody></tabela>

<h4>"dls">Separador< de linha/h4>

A conversão não corresponde a nenhum argumento.

<table class="listrado"><caption style="display:none">DTConv</caption><tbody>

<><tr th scope="row" style="vertical-align:top"><'n'td> o separador de linha específico da plataforma conforme retornado por .System#lineSeparator()

</tbody></tabela>

Sinalizadores, largura e precisão não são aplicáveis. Se algum for fornecido, um IllegalFormatFlagsException, IllegalFormatWidthExceptione IllegalFormatPrecisionException, respectivamente serão lançados.

<h4>"dpos">Índice de argumentos</h4>

Os especificadores de formato podem fazer referência a argumentos de três maneiras:

<ul>

<li>A indexação explícita é usada quando o especificador de formato contém um índice de argumento. O índice de argumento é um inteiro decimal que indica a posição do argumento na lista de argumentos. O primeiro argumento é referenciado por "1$", o segundo por "2$", etc. Um argumento pode ser referenciado mais de uma vez.

Por exemplo:

<blockquote>

formatter.format("%4$s %3$s %2$s %1$s %4$s %3$s %2$s %1$s",
                               "a", "b", "c", "d")
              // -> "d c b a d c b a"

</blockquote>

<li>A indexação relativa é usada quando o especificador de formato contém um '<' sinalizador ('\u003c') que faz com que o argumento para o especificador de formato anterior seja reutilizado. Se não houver nenhum argumento anterior, então um MissingFormatArgumentException é lançado.

<blockquote>

formatter.format("%s %s %<s %<s", "a", "b", "c", "d")
               // -> "a b b b"
               // "c" and "d" are ignored because they are not referenced

</blockquote>

<li>A indexação ordinária é usada quando o especificador de formato não contém um índice de argumento nem um '<' sinalizador. A cada especificador de formato que usa indexação ordinária é atribuído um índice implícito sequencial na lista de argumentos que é independente dos índices usados pela indexação explícita ou relativa.

<blockquote>

formatter.format("%s %s %s %s", "a", "b", "c", "d")
              // -> "a b c d"

</blockquote>

</ul>

É possível ter uma string de formato que utiliza todas as formas de indexação, por exemplo:

<blockquote>

formatter.format("%2$s %s %<s %s", "a", "b", "c", "d")
              // -> "b a a b"
              // "c" and "d" are ignored because they are not referenced

</blockquote>

O número máximo de argumentos é limitado pela dimensão máxima de uma matriz Java, conforme definido por <cite>The Java™ Especificação</citação> de máquina virtual. Se o índice de argumento não corresponder a um argumento disponível, um MissingFormatArgumentException será lançado.

Se houver mais argumentos do que especificadores de formato, os argumentos extras serão ignorados.

A menos que especificado de outra forma, passar um null argumento para qualquer método ou construtor nesta classe fará com que um NullPointerException seja lançado.

Adicionado em 1.5.

Documentação Java para java.util.Formatter.

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.

Construtores

Propriedades

Métodos

Implantações explícitas de interface

Métodos de Extensão

Aplica-se a