Usar cadeias de caracteres de formato personalizado no Power BI Desktop
APLICA-SE A: 
Power BI Desktop 
Serviço do Power BI
Com cadeias de caracteres de formato personalizado no Power BI Desktop, é possível personalizar a aparência dos campos em visuais e ter a certeza de que seus relatórios fiquem do jeito que você quer.
As cadeias de caracteres de formato existem em três níveis:
- Modelo. Você pode definir uma cadeia de caracteres de formato para campos no modelo ou usar uma cadeia de caracteres de formato dinâmico para formatar sua medida. Em qualquer lugar que você use esse campo, a cadeia de caracteres de formato é aplicada, a menos que seja substituída por uma cadeia de caracteres de formato no nível do elemento ou visual.
- Visual. Você pode definir cadeias de caracteres de formato em qualquer coluna, medida ou cálculo visual que esteja em seu visual, mesmo que elas já tenham uma cadeia de caracteres de formato. Nesse caso, a cadeia de caracteres de formato de nível de modelo é substituída e a cadeia de caracteres de formato de nível visual é usada. Se você alterar a agregação em um campo, que invalida uma cadeia de caracteres de formato de nível visual definida anteriormente, a cadeia de caracteres de formato será removida. As cadeias de caracteres de formato de nível visual para campos são mantidas para campos, mas não para cálculos visuais. Se você definir uma cadeia de caracteres de formato de nível visual em um campo e, em seguida, remover e ler esse campo para o mesmo visual, a cadeia de caracteres de formato de nível visual será restabelecida. Por outro lado, para um cálculo visual, a cadeia de caracteres de formato não é restabelecida.
- Elemento. Você pode definir uma cadeia de caracteres de formato para rótulos de dados e para elementos específicos do novo cartão e dos novos visuais de segmentação. Esse nível será expandido para incluir mais no futuro. Qualquer cadeia de caracteres de formato definida aqui substitui o conjunto de cadeias de caracteres de formato no nível visual e do modelo.
Esses níveis são hierárquicos, com o nível do modelo sendo o nível mais baixo e o nível do elemento mais alto. Uma cadeia de caracteres de formato definida em uma coluna, medida ou cálculo visual em um nível mais alto substitui o que foi definido em um nível inferior.
Como os cálculos visuais não estão no modelo, eles não podem ter uma cadeia de caracteres de formato definida no nível do modelo, mas podem no nível visual ou do elemento. Medidas e colunas podem ter cadeias de caracteres de formato nos três níveis:
| Nível | Impactos | Disponível para |
|---|---|---|
| Element | Elemento selecionado do visual selecionado | Medidas, Colunas, Cálculos Visuais |
| Visual | Visual selecionado | Medidas, Colunas, Cálculos Visuais |
| Modelar | Todos os visuais, todas as páginas, todos os relatórios no mesmo modelo | Medidas, Colunas |
A cadeia de caracteres de formato de nível de elemento só está disponível para rótulos de dados e visuais específicos no momento.
Como usar cadeias de caracteres de formato personalizado
Para usar cadeias de caracteres de formato personalizado, primeiro você precisa decidir em qual nível você vai trabalhar: Modelo, Visual ou Elemento.
Adicionar uma cadeia de caracteres de formato de nível de modelo
Para criar cadeias de caracteres de formato personalizado no modelo, selecione o campo na exibição Modelagem, em seguida, selecione a seta suspensa em Formatar no painel Propriedades.
Depois de selecionar Personalizar no menu suspenso Formatar, escolha uma opção na lista de strings de formatos comumente usadas.
Adicionar uma cadeia de caracteres de formato de nível visual
Para criar uma cadeia de caracteres de formato de nível visual, primeiro adicione o campo ou cálculo visual ao seu visual. Em seguida, com o visual selecionado, abra o painel de formato e vá para a seção Geral do painel de formato. Localize as configurações Formatar dados e configure a cadeia de caracteres de formato:
Observação
Por enquanto, você precisará inserir uma cadeia de caracteres de formato .NET em vez de uma cadeia de caracteres de formato VBA. Esse é um problema temporário que será resolvido em uma versão futura.
Adicionar uma cadeia de caracteres de formato de nível de elemento
Para criar uma cadeia de caracteres de formato de nível de elemento, abra o painel Formatar e localize as seções de cadeia de caracteres de formato para o elemento no qual você deseja definir o formato. Tenha em mente que nem todos os elementos dão suporte a cadeias de caracteres de formato. Para definir uma cadeia de caracteres de formato em um rótulo de dados, abra a seção Visual do painel Formatar, defina Rótulos de Dados>Valor>Exibir unidades para personalizar e inserir o código de formato:
Sintaxe de formato personalizado permitida
As cadeias de caracteres de formato personalizado seguem a sintaxe de estilo VBA, comum ao Excel e a outros produtos da Microsoft, mas não dão suporte a todas as sintaxes usadas em outros produtos.
Observação
Por enquanto, as cadeias de caracteres de formato de nível visual exigem que você insira uma cadeia de caracteres de formato .NET em vez disso. Esse é um problema temporário que será resolvido em uma versão futura.
As tabelas a seguir definem a sintaxe aceita no Power BI.
Símbolos de data com suporte
| Símbolo | Intervalo |
|---|---|
| d | 1-31 (dia do mês, sem zero à esquerda) |
| dd | 01-31 (dia do mês, com um zero à esquerda) |
| m | 1-12 (mês do ano, sem zero à esquerda, começando com Janeiro = 1) |
| mm | 01-12 (mês do ano, com um zero à esquerda, começando com Janeiro = 01) |
| mmm | Exibe nomes de meses abreviados (nomes de meses islâmicos não são abreviados) |
| mmmm | Exibe nomes de meses completos |
| aa | 00-99 (dois últimos dígitos do ano) |
| aaaa | 100-9999 (ano de três ou quatro dígitos) |
Símbolos de tempo com suporte
| Símbolo | Intervalo |
|---|---|
| h | 0-23 (1-12 com acréscimo de “AM” ou “PM”) (hora do dia, sem zero à esquerda) |
| hh | 00-23 (01-12 com acréscimo de “AM” ou “PM”) (hora do dia, com zero à esquerda) |
| n | 0-59 (minuto da hora, sem zero à esquerda) |
| nn | 00-59 (minuto da hora, com um zero à esquerda) |
| m | 0-59 (minuto da hora, sem zero à esquerda). Somente se precedido por h ou hh |
| mm | 00-59 (minuto da hora, com um zero à esquerda). Somente se precedido por h ou hh |
| s | 0-59 (segundo do minuto, sem zero à esquerda) |
| ss | 00-59 (segundo do minuto, com um zero à esquerda) |
Você pode ver um exemplo de como formatar cadeias de caracteres de valor personalizado.
Uma expressão de formato definido pelo usuário para números pode ter de uma a três seções separadas por ponto e vírgula. Se você incluir pontos e vírgulas sem nada entre eles, a seção ausente não será exibida. Em vez disso, você verá "". Se você não especificar o ponto e vírgula, ele usará o formato positivo.
Veja a seguir os exemplos de diferentes formatos para diferentes cadeias de caracteres de valor:
| Valores | Cadeia de formato | Cadeia de formato | Cadeia de formato | Cadeia de formato |
|---|---|---|---|---|
| 0.00;-0.0;"Zero" | 0,00;; | 0,00;-0,0; | 0,00; | |
| -1,234 | -1,2 | "" | -1,2 | "" |
| 0 | "Zero" | "" | "" | 0,00 |
| 1,234 | 1,23 | 1,23 | 1,23 | 1,23 |
A tabela a seguir identifica os formatos de data e hora nomeados:
| Nome do formato | Descrição |
|---|---|
| Data Geral | Exibe uma data e/ou hora, por exemplo, 3/4/93 17:34. Se não houver parte fracionária, exibe somente uma data, por exemplo, 3/4/93. Se não houver parte inteira, exibe apenas a hora, por exemplo, 17:34. A exibição da data é determinada pelas configurações do sistema. |
| Data por Extenso | Exibe uma data de acordo com o formato de data por extenso do sistema. |
| Data Abreviada | Exibe uma data usando o formato de data abreviado do sistema. |
| Hora Detalhada | Exibe a hora usando o formato de hora detalhada do sistema; inclui horas, minutos e segundos. |
| Hora Abreviada | Exibe uma hora usando o formato de 24 horas, por exemplo, 17:45. |
Formatos numéricos nomeados
A tabela a seguir identifica os formatos numéricos nomeados:
| Nome do formato | Descrição |
|---|---|
| Número Geral | Exibe o número sem separador de milhar. |
| Moeda | Exibe o número sem um separador de milhar. Exibe dois dígitos após o separador decimal. A saída se baseia nas configurações de localidade do sistema. |
| Fixo | Exibe pelo menos um dígito antes e dois dígitos após o separador decimal. |
| Standard | Exibe o número com separador de milhar, pelo menos um dígito antes e dois dígitos após o separador decimal. |
| Percent | Exibe o número multiplicado por 100 com um sinal de porcentagem (%). Sempre exibe dois dígitos após o separador decimal. |
| Científico | Usa a notação científica padrão. |
A tabela a seguir identifica caracteres que você pode usar para criar formatos de data/hora definidos pelo usuário.
| Caractere | Descrição |
|---|---|
| ( : ) | Separador de hora. Em algumas localidades, outros caracteres podem ser usados para representar o separador de hora. O separador de horas separa hora, minutos e segundos quando os valores de hora são formatados. O caractere real usado como o separador de hora na saída formatada é determinado pelas configurações do sistema. |
| ( / ) | Separador de data. Em algumas localidades, outros caracteres podem ser usados para representar o separador de data. O separador de data separa o dia, o mês e o ano quando os valores de data são formatados. O caractere real usado como o separador de data na saída formatada é determinado pelas configurações do sistema. |
| d | Exibe o dia como um número sem zero à esquerda (1-31). |
| dd | Exibe o dia como um número com um zero à esquerda (01-31). |
| ddd | Exibe o dia como uma abreviação (dom-sáb). Localizado. |
| dddd | Exibe o dia como um nome completo (domingo-sábado). Localizado. |
| m | Exibe o mês como um número sem zero à esquerda (1-12). Se m vier em seguida de h ou hh, será exibido o minuto em vez do mês. |
| mm | Exibe o mês como um número sem zero à esquerda (01-12). Se m vier em seguida de h ou hh, será exibido o minuto em vez do mês. |
| mmm | Exibe o mês como uma abreviação (jan-dez). Localizado. |
| mmmm | Exibe o mês como um nome de mês completo (janeiro-dezembro). Localizado. |
| aa | Exibe o ano como um número de dois dígitos (00–99). |
| yyyy | Exibe o ano como um número de quatro dígitos (100–9999). |
| h | Exibe a hora como um número sem zero à esquerda (0-23). |
| hh | Exibe a hora como um número com um zero à esquerda (00-23). |
| n | Exibe o minuto como um número sem zero à esquerda (0-59). |
| nn | Exibe o minuto como um número com um zero à esquerda (00-59). |
| s | Exibe o segundo como um número sem zero à esquerda (0-59). |
| ss | Exibe o segundo como um número com um zero à esquerda (00-59). |
| tt | Usa o relógio de 12 horas e exibe AM em letras maiúsculas em qualquer hora antes do meio-dia; exibe PM em letras maiúsculas em qualquer hora entre meio-dia e 11:59 PM. |
A tabela a seguir identifica caracteres que você pode usar para criar formatos de número definidos pelo usuário.
| Caractere | Descrição |
|---|---|
| Nenhum | Exibe o número sem formatação. |
| ( 0 ) | Espaço reservado de dígito. Exibe um dígito ou um zero. Se a expressão tiver um dígito na posição em que 0 aparece na cadeia de caracteres de formato, exibe-o. 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 do que há de zeros após o separador decimal, arredonde o número para a mesma quantidade de casas decimais que o número de zeros. Se o número tiver mais dígitos do que há de zeros antes do separador decimal, exibe os dígitos extras sem modificação. |
| ( # ) | Espaço reservado de dígito. Exibe um dígito ou nada. Se a expressão tiver um dígito na posição em que # aparece na cadeia de caracteres de formato, exibe-o; caso contrário, não exibe nada nessa posição. Este símbolo funciona como o espaço reservado de zero dígito. No entanto, os zeros no início e no final não serão exibidos se o número tiver menos ou a mesma quantidade de dígitos do que os caracteres # em ambos os lados do separador decimal na expressão de formato. |
| ( . ) | Espaço reservado de decimal. Em algumas localidades, uma vírgula é usada como o separador decimal. O espaço reservado decimal determina quantos dígitos são exibidos antes e após o separador decimal. Se a expressão do formato contiver apenas sinais de número à esquerda desse símbolo, números menores que 1 começarão com um separador decimal. Para mostrar um zero à esquerda exibido com números fracionários, use 0 como o espaço reservado do primeiro dígito à esquerda do separador decimal. O caractere real usado como espaço reservado decimal na saída formatada depende do Formato de Número reconhecido pelo seu sistema. |
| (%) | Espaço reservado de porcentagem. A expressão é multiplicada por 100. O caractere de porcentagem ( % ) é inserido na posição em que ele aparece na cadeia de caracteres de formato. |
| ( , ) | Separadores de milhar. Em algumas localidades, um ponto é usado como um separador de milhar. O separador de milhar separa milhares de centenas em 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 entre os espaços reservados para dígitos ( 0 ou # ). Dois separadores de milhar adjacentes ou um separador de milhar imediatamente à esquerda do separador decimal (se um decimal for ou não especificado) significa "dimensionar o número dividindo-o por 1.000, arredondando conforme necessário". Por exemplo, você pode usar a cadeia de caracteres de formato "##0,," para representar 100 milhões como 100. Os números inferiores a 1 milhão são exibidos como 0. Dois separadores de milhar adjacentes em qualquer posição que não seja imediatamente à esquerda do separador decimal são tratados simplesmente como especificação do uso de um separador de milhar. O caractere real usado como o separador de milhar na saída formatada depende do Formato de Número reconhecido pelo seu sistema. |
| ( : ) | Separador de hora. Em algumas localidades, outros caracteres podem ser usados para representar o separador de hora. O separador de horas separa hora, minutos e segundos quando os valores de hora são formatados. O caractere real usado como o separador de hora na saída formatada é determinado pelas configurações do sistema. |
| ( / ) | Separador de data. Em algumas localidades, outros caracteres podem ser usados para representar o separador de data. O separador de data separa o dia, o mês e o ano quando os valores de data são formatados. O caractere real usado como o separador de data na saída formatada é determinado pelas configurações do sistema. |
| ( E- E+ e- e+ ) | Formato científico. Se a expressão do formato contiver pelo menos um espaço reservado para dígito (0 ou #) após 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 de dígito determina o número de dígitos no expoente. Use E- ou e- para colocar um sinal de menos ao lado de expoentes negativos. Use E+ ou e+ para colocar um sinal de menos ao lado de expoentes negativos e um sinal de mais ao lado de expoentes positivos. |
| - + $ ( ) | Exibe um caractere literal. Para exibir um caractere diferente, preceda-o de uma barra invertida (\) ou coloque-o entre aspas duplas (" "). |
| ( \ ) | Exibe o próximo caractere na 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 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 (\\). Os caracteres de formatação de data e hora (a, c, d, h, m, n, p, q, s, t, w, / e :) não podem ser exibidos como caracteres literais, os caracteres de formatação numérica (#, 0, %, E, e, vírgula e ponto) e os caracteres de formatação de string (@, &, <, >, !). |
| ("ABC") | Exibe a cadeia de caracteres entre aspas duplas (" "). |
Considerações e limitações
- Você não pode definir uma cadeia de caracteres de formato personalizado para campos que são do tipo cadeia de caracteres ou booliano.
Conteúdo relacionado
Para saber mais, veja: