Texto DAX - função FORMAT

Descrição

Converte um valor em texto de acordo com o formato especificado.

Sintaxe

FORMAT (<value>, <format_string>)

Parâmetros

Sr. Não. Parâmetro e Descrição
1

value

Um valor ou expressão que avalia um único valor.

2

format_string

Uma string que representa um estilo de formatação.

  • Para formatar números, você pode usar formatos numéricos predefinidos ou criar formatos numéricos definidos pelo usuário.

Veja as seções fornecidas no final deste capítulo - Formatos numéricos predefinidos e formatos numéricos personalizados para a função FORMAT.

  • Para formatar datas e horas, você pode usar formatos de data / hora predefinidos ou criar formatos de data / hora definidos pelo usuário.

Consulte o tutorial - DAX nesta biblioteca de tutoriais para obter detalhes sobre a formatação de datas e horas.

Valor de retorno

Uma string contendo um valor formatado conforme definido por format_string.

Observações

  • Se o valor for BLANK (), a função FORMAT retorna uma string vazia.

  • Se format_string for BLANK (), o valor será formatado com um formato de "Número Geral" ou "Data Geral" (de acordo com o tipo de dados do valor).

Exemplo

A tabela a seguir mostra os resultados da função FORMAT com o primeiro valor do argumento fornecido na primeira linha e format_string fornecido na primeira coluna. Consulte as seções fornecidas abaixo desta tabela para entender as strings de formato.

"5" "-5" "0,5" "0"
String 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-1 0,00E00
"$ #, ## 0 ;; \ Z \ e \ r \ o" $ 5 $ -5 $ 1 Zero

Formatos numéricos pré-definidos para a função FORMAT

A tabela a seguir identifica os nomes de formato numérico predefinidos que podem ser usados ​​por nome para o argumento de estilo de formato da função Format.

Sr. Não. String de formato e descrição
1

"General Number"

Exibe o número sem separadores de milhar.

2

"Currency"

Exibe o número com separadores de milhar, se apropriado.

Exibe dois dígitos à direita do separador decimal.

A saída é baseada nas configurações locais do sistema.

3

"Fixed"

Exibe pelo menos um dígito à esquerda e dois dígitos à direita do separador decimal.

4

"Standard"

Exibe o número com separadores de milhar, pelo menos um dígito à esquerda e dois dígitos à direita do separador decimal.

5

"Percent"

Exibe o número multiplicado por 100 com um sinal de porcentagem (%) anexado imediatamente à direita.

Sempre exibe dois dígitos à direita do separador decimal.

6

"Scientific"

Usa notação científica padrão, fornecendo dois dígitos significativos.

7

"Yes/No"

Exibe Não se o número for 0. Caso contrário, exibe Sim.

8

"True/False"

Exibe False se o número for 0. Caso contrário, exibe True.

9

"On/Off"

Exibe Desligado se o número for 0. Caso contrário, exibe Ligado.

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

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 format_string da função Format contiver um dos formatos numéricos predefinidos, apenas uma seção será permitida.

A tabela a seguir mostra como as seções são aplicadas durante a formatação.

Sr. Não. Resultado de número de seção e formato
1

One section only

A expressão de formato se aplica a todos os valores.

2

Two sections

A primeira seção se aplica a valores positivos e zeros.

O segundo se aplica a valores negativos.

3

Three sections

A primeira seção se aplica a valores positivos.

A segunda seção se aplica a valores negativos.

A terceira seção se aplica a zeros.

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

A tabela a seguir identifica os caracteres que você pode usar para criar formatos de número definidos pelo usuário.

Sr. Não. Especificação e descrição do formato
1

None

Exibe o número sem formatação.

2

0 (zero character)

Marcador de posição de dígito. Exibe um dígito ou zero.

Se a expressão tiver um dígito na posição onde o zero aparece na string de formato, exibe o dígito. Caso contrário, exibe um zero nessa posição.

Se o número tiver menos dígitos do que zeros (em qualquer lado do decimal) na expressão de formato, exibe zeros à esquerda ou à direita.

Se o número tiver mais dígitos à direita do separador decimal do que zeros à direita do separador decimal na expressão de formato, arredonda o número para tantas casas decimais quantas forem de zeros.

Se o número tiver mais dígitos à esquerda do separador decimal do que zeros à esquerda do separador decimal na expressão de formato, exibe os dígitos extras sem modificação.

  • Se a expressão tiver um dígito na posição onde o caractere # aparece na string de formato, exibe o dígito.

  • Caso contrário, não exibe nada nessa posição.

Este símbolo funciona como o marcador de posição de 0 dígito, exceto que os zeros à esquerda e à direita não são exibidos se o número tiver menos dígitos do que # caracteres em cada lado do separador decimal na expressão de formato.

3

. (dot character)

Marcador de posição decimal. O marcador decimal determina quantos dígitos são exibidos à esquerda e à direita do separador decimal.

  • Se a expressão de formato contiver apenas # caracteres à esquerda deste símbolo, os números menores que 1 começam com um separador decimal.

  • Para exibir um zero à esquerda exibido com números fracionários, use o zero como o primeiro espaço reservado para dígito à esquerda do separador decimal.

Em alguns locais, uma vírgula é usada como separador decimal. O caractere real usado como marcador decimal na saída formatada depende do formato de número reconhecido pelo sistema. Portanto, você deve usar o ponto como marcador de posição decimal em seus formatos, mesmo se estiver em um local que use uma vírgula como marcador de posição decimal. A string formatada aparecerá no formato correto para o local.

4

%

Marcador de posição de porcentagem. Multiplica a expressão por 100. O caractere de porcentagem (%) é inserido na posição em que aparece na string de formato.

5

, (comma character)

Separador de milhar. O separador de mil separa milhares de centenas dentro de um número que tem quatro ou mais casas à esquerda do separador decimal.

O uso padrão do separador de milhar é especificado se o formato contiver um separador de milhar rodeado por espaços reservados para dígitos (0 ou #). Um separador de milhar imediatamente à esquerda do separador decimal (se um decimal for especificado ou não) ou como o caractere mais à direita na string significa "dimensionar o número dividindo-o por 1.000, arredondando conforme necessário."

  • Números menores que 1.000, mas maiores ou iguais a 500 são exibidos como 1 e números menores que 500 são exibidos como 0.

  • Dois mil separadores adjacentes nesta escala de posição por um fator de 1 milhão e um fator adicional de 1.000 para cada separador adicional.

  • Separadores múltiplos em qualquer posição que não seja imediatamente à esquerda do separador decimal ou na posição mais à direita na string são tratados simplesmente como especificando o uso de um separador de milhar.

Em alguns locais, um ponto é usado como separador de milhar. O caractere real usado como separador de milhar na saída formatada depende do Formato do Número reconhecido pelo seu sistema. Portanto, você deve usar a vírgula como separador de mil em seus formatos, mesmo se estiver em um local que use um ponto como separador de mil. A string formatada aparecerá no formato correto para o local.

Exemplos -

  • "#, 0." Usa o separador de milhares para formatar o número 100 milhões como a string "100.000.000".

  • "# 0 ,." Usa a escala por um fator de mil para formatar o número 100 milhões como a string "100000".

  • "#, 0 ,." Usa o separador de milhares e escala em mil para formatar o número 100 milhões como a string "100.000".

6

: (colon character)

Separador de hora. O separador de hora separa horas, minutos e segundos quando os valores de hora são formatados.

Em alguns locais, outros caracteres podem ser usados ​​para representar o separador de hora. O caractere real usado como separador de hora na saída formatada é determinado pelas configurações do sistema.

7

/ (forward slash character)

Separador de data. O separador de data separa o dia, mês e ano quando os valores de data são formatados.

Em alguns locais, outros caracteres podem ser usados ​​para representar o separador de data. O caractere real usado como separador de data na saída formatada é determinado pelas configurações do sistema.

8

E- , E+ , e- , e+

Scientific format.

Se a expressão de formato contiver pelo menos um marcador de posição de um 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 marcadores de posição de dígitos à esquerda determina o número de dígitos no expoente.
  • Use E- ou e- para colocar um sinal de menos próximo aos expoentes negativos.
  • Use E + ou e + para colocar um sinal de menos ao lado dos expoentes negativos e um sinal de mais ao lado dos expoentes positivos.
  • Você também deve incluir espaços reservados para dígitos à direita deste símbolo para obter a formatação correta.
9

-+$()

Personagens literais. Esses caracteres são exibidos exatamente como digitados na string de formato.

Para exibir um caractere diferente dos listados, coloque uma barra invertida (\) antes dele ou coloque-o entre aspas duplas ("").

10

\ (backward slash character)

Exibe o próximo caractere na string de formato. Para exibir um caractere que tem significado especial como caractere literal, coloque uma barra invertida (\) antes dele.

  • A barra invertida em si 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.

No entanto, alguns caracteres não podem ser exibidos como caracteres literais. Por exemplo,

  • 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)
  • Os caracteres de formatação de string (@, &, <,> e!)
11

"ABC"

Exibe a string entre aspas duplas (""). Para incluir uma string no argumento de estilo de dentro do código, você deve usar Chr (34) para incluir o texto (34 é o código de caractere para uma aspa (")).