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.
Veja as seções fornecidas no final deste capítulo - Formatos numéricos predefinidos e formatos numéricos personalizados para a função FORMAT.
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.
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.
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."
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 -
|
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 .
|
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.
No entanto, alguns caracteres não podem ser exibidos como caracteres literais. Por exemplo,
|
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 (")). |