Partilhar via

  • Artigo

Formatos numéricos personalizados para a função FORMAT (DAX)

Uma expressão de formato definida pelo usuário para números pode ter de uma a três seções separadas por ponto-e-vírgula. Se o argumento Style da função Format contiver um dos formatos numéricos predefinidos, somente uma seção será permitida.

Se você usar

Este será o resultado

Uma seção apenas

A expressão de formato é aplicada a todos os valores.

Duas seções

A primeira seção é aplicada a valores positivos e zeros; a segunda se aplica a valores negativos.

Três seções

A primeira seção é aplicada a valores positivos, a segunda a valores negativos e a terceira a zeros.

Especificações de formato

A tabela a seguir identifica caracteres que você pode usar para criar formatos numéricos definidos pelo usuário.

Especificação de formato

Descrição

Nenhum

Exibe o número sem nenhuma formatação.

0 (caractere zero)

Espaço reservado para dígito. Exibe um dígito ou um zero. Se a expressão tiver um dígito na posição em que o zero aparece na cadeia de caracteres de formato, exibirá o dígito; de outra forma, exibirá um zero nessa posição.

Se o número tiver menos dígitos que zeros (em qualquer lado da divisão decimal) na expressão de formato, o valor formatado exibirá zeros à esquerda e à direita. Se o número tiver mais dígitos à direita do separador decimal que zeros à direita do separador decimal na expressão de formato, arredondará o número para o mesmo número de casas decimais que a quantidade de zeros. Se o número tiver mais dígitos à esquerda do separador decimal que zeros à esquerda do separador decimal na expressão de formato, exibirá os dígitos extras sem alteração.

#

Espaço reservado para dígito. Exibe um dígito ou nada. Se a expressão tiver um dígito na posição em que o caractere # aparece na cadeia de caracteres de formato, exibirá o dígito; de outra forma, não exibirá nada nessa posição.

Este símbolo funciona como o espaço reservado para o dígito zero (0), exceto pelo fato de que os zeros à esquerda e à direita não serão exibidos se o número tiver a mesma quantidade de dígitos, ou menos, de caracteres # em qualquer um dos lados do separador decimal na expressão de formato.

. (caractere de ponto)

Espaço reservado para decimal. O espaço reservado para decimal determina quantos dígitos serão exibidos à esquerda e à direita do separador decimal. Se a expressão de formato contiver apenas caracteres # à esquerda desse símbolo, números menores que 1 começarão com um separador decimal. Para exibir um zero à esquerda no caso de números fracionais, use zero como o primeiro espaço reservado para dígito à esquerda do separador decimal. Em algumas localidades, a vírgula é usada como o separador decimal. O caractere real usado como espaço reservado decimal na saída formatada depende do formato numérico reconhecido pelo seu sistema. Dessa forma, você deve usar o ponto como o espaço reservado para decimal nos formatos, mesmo que esteja em uma localidade que utilize uma vírgula como espaço reservado para decimal. A cadeia de caracteres formatada aparecerá no formato correto para a localidade.

%

Espaço reservado para porcentagem. Multiplica a expressão 100. O caractere por cento (%) é inserido na posição onde aparece na cadeia de caracteres de formato.

, (caractere de vírgula)

Separador de milhar. O separador de milhar separa os milhares das centenas em um número com quatro ou mais casas à esquerda do separador decimal. O uso padrão do separador de milhar será especificado se o formato contiver um separador de milhar cercado por espaços reservados para dígitos (0 ou #).

Um separador de milhar imediatamente à esquerda do separador decimal (quer um decimal tenha sido especificado ou não) ou como o caractere da extrema direita na cadeia de caracteres significa "escalar o número dividindo-o por 1.000, arredondando se necessário". Números menores do que 1.000, porém maiores ou iguais a 500 são exibidos como 1, e números menores do que 500 são exibidos como 0. Dois separadores de milhares adjacentes nessa posição são escalados em um fator de 1 milhão, e um fator adicional de 1.000 para cada separador adicional.

Vários separadores em qualquer posição sem ser imediatamente à esquerda do separador decimal ou na posição da extrema esquerda na cadeia de caracteres são tratados simplesmente como especificando o uso de um separador de milhar. Em algumas localidades, um ponto é usado como separador de milhar. O caractere real usado como separador de milhar na saída formatada depende do Formato Numérico reconhecido pelo seu sistema. Assim, você deverá usar a vírgula como o separador de milhar nos seus formatos, mesmo que esteja em uma localidade que utilize um ponto como separador de milhar. A cadeia de caracteres formatada aparecerá no formato correto para a localidade.

Por exemplo, considere as três cadeias de caracteres de formato seguintes:

"#,0.", que usa o separador de milhar para formatar o número 100 milhões como a cadeia de caracteres "100,000,000".

"#0,.", que usa a escala por um fator de mil para formatar o número 100 milhões como a cadeia de caracteres "100000".

"#,0,.", que usa o separador de milhar e a escala por mil para formatar o número 100 milhões como a cadeia de caracteres "100,000".

: (caractere de dois-pontos)

Separador de hora. Em algumas localidades, outros caracteres podem ser usados para representar o separador de hora. O separador de hora separa horas, minutos e segundos quando valores de tempo são formatados. O caractere real usado como separador de hora na saída formatada é determinado pelas configurações do seu sistema.

/ (caractere de barra)

Separador de data. Em algumas localidades, outros caracteres podem ser usados para representar o separador de data. O separador de data separa dia, mês e ano quando valores de data são formatados. O caractere real usado como separador de data na saída formatada é determinado pelas configurações do seu sistema.

E- , E+ , e- , e+

Formato científico. Se a expressão de formato contiver pelo menos um espaço reservado para dígito (0 ou #) à esquerda de E-, E+, e- ou e+, o número será exibido em formato científico, e E ou e será inserido entre o número e seu expoente. O número de espaços reservados para dígito à esquerda determina o número de dígitos do expoente. Use E - ou e - para colocar um sinal de menos junto a expoentes negativos. Use E + ou e + para colocar um sinal de menos junto a expoentes negativos e um sinal de mais junto a expoentes positivos. Você também deve incluir espaços reservados para dígitos à direita desse símbolo para obter a formatação correta.

-+$()

Caracteres literais. Esses caracteres são exibidos exatamente conforme digitados na cadeia de caracteres de formato. Para exibir um caractere diferente do listado, coloque uma barra invertida (\) antes dele ou coloque-o entre aspas duplas (" ").

\ (caractere de barra invertida)

Exibe o próximo caractere da cadeia de caracteres de formato. Para exibir um caractere que tem um significado especial como um caractere literal, coloque uma barra invertida (\) antes dele. A barra invertida não é exibida. Usar uma barra invertida é o mesmo que colocar o próximo caractere entre aspas duplas. Para exibir uma barra invertida, use duas barras invertidas (\\).

Exemplos de caracteres que não podem ser exibidos como caracteres literais são: os caracteres de formatação de data e hora (a, c, d, h, m, n, p, q, s, t, w, y, / e :), os caracteres de formatação numérica (#, 0, %, E, e, vírgula e ponto) e os caracteres de formatação da cadeia (@, &, <, > e !).

"ABC"

Exibe a cadeia de caracteres entre aspas duplas (" "). Para colocar uma cadeia de caracteres no argumento de estilo de dentro do código, use Chr(34) para englobar o texto (34 é o código de caractere para aspas (")).

A tabela a seguir contém alguns exemplos de expressões de formato para números. (Estes exemplos presumem que a configuração de localidade do seu sistema seja Inglês-EUA.) A primeira coluna contém as cadeias de caracteres de formato da função Format; as outras colunas contêm a saída resultante se os dados formatados tiverem o valor atribuído nos cabeçalhos das colunas.

Formato (estilo)

"5" formatado como

"-5" formatado como

"0.5" formatado como

"0" formatado como

Cadeia de caracteres de comprimento zero ("")

5

-5

0.5

0

0

5

-5

1

0

0.00

5.00

-5.00

0.50

0.00

#,##0

5

-5

1

0

$#,##0;($#,##0)

$5

($5)

$1

$0

$#,##0.00;($#,##0.00)

$5.00

($5.00)

$0.50

$0.00

0%

500%

-500%

50%

0%

0.00%

500.00%

-500.00%

50.00%

0.00%

0.00E+00

5.00E+00

-5.00E+00

5.00E-01

0.00E+00

0.00E-00

5.00E00

-5.00E00

5.00E-01

0.00E00

"$#,##0;;\Z\e\r\o"

$5

$-5

$1

Zero

Comentários

Se você incluir ponto-e-vírgula sem colocar nada entre eles, a seção perdida será impressa usando o formato do valor positivo.