Partilhar via


Usar cadeias de caracteres de formato personalizado no Power BI Desktop

APLICA-SE A: Serviço Power BI do Power BI Desktop

Com cadeias de caracteres de formato personalizado no Power BI Desktop, você pode personalizar como os campos aparecem nos elementos visuais e garantir que seus relatórios tenham a aparência desejada.

Screenshot of Power BI desktop in Modeling view, highlighting Custom in the Format dropdown menu.

Como usar cadeias de caracteres de formato personalizado

Para criar cadeias de caracteres de formato personalizadas, selecione o campo no modo de exibição Modelagem e selecione a seta suspensa em Formatar no painel Propriedades.

Screenshot of the Properties pane, highlighting the Format menu.

Depois de selecionar Personalizar no menu suspenso Formatar , escolha em uma lista de cadeias de caracteres de formato comumente usadas.

Screenshot of the Formatting menu, highlighting Custom.

Sintaxe de formato personalizado suportada

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 suportam toda a sintaxe usada em outros produtos.

As tabelas a seguir definem a sintaxe com suporte no Power BI.

Símbolos de data suportados

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 Hijri não têm abreviaturas)
mmmm Exibe nomes completos de meses
yy 00-99 (Últimos dois dígitos do ano)
yyyy 100-9999 (ano de três ou quatro dígitos)

Símbolos de tempo suportados

Símbolo Intervalo
h 0-23 (1-12 com "AM" ou "PM" anexado) (Hora do dia, sem zero à esquerda)
hh 00-23 (01-12 com "AM" ou "PM" em anexo) (Hora do dia, com um zero à esquerda)
n 0-59 (Minuto de hora, sem zero à esquerda)
nn 00-59 (Minuto de hora, com um zero à esquerda)
m 0-59 (Minuto de hora, sem zero à esquerda). Apenas se precedido por h ou hh
mm 00-59 (Minuto de hora, com um zero à esquerda). Apenas se precedido por h ou hh
s 0-59 (segundo do minuto, sem zero à frente)
ss 00-59 (Segundo de minuto, com um zero à frente)

Você pode ver um exemplo de como formatar cadeias de caracteres de valor personalizadas.

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 ponto-e-vírgula sem nada entre eles, a seção ausente não será exibida (será ""). Se você não especificar o ponto-e-vírgula, ele usará o formato positivo.

Aqui estão exemplos de formatos diferentes para cadeias de valores diferentes:

Valores Format String Format String Format String Format String
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 predefinidos:

Nome do formato Descrição
Data Geral Exiba uma data e hora, por exemplo, 03/04/93 17:34. Se não houver uma parte fracionada, exiba apenas uma data, por exemplo, 4/3/93. Se não houver uma parte inteira, apenas o tempo de exibição, por exemplo, 17:34. A exibição da data é determinada pelas configurações do sistema.
Data Longa Exiba uma data de acordo com o formato de data longa do seu sistema.
Data abreviada Exiba uma data usando o formato de data abreviada do seu sistema.
Longo Tempo Exiba um tempo usando o formato de tempo longo do seu sistema; inclui horas, minutos, segundos.
Tempo curto Exiba um horário usando o formato de 24 horas, por exemplo, 17:45.

Formatos numéricos nomeados

A tabela a seguir identifica os formatos numéricos nomeados predefinidos:

Nome do formato Descrição
Número geral Número de exibição sem separador de milhar.
Moeda Exibe o número com um separador mil. Exiba dois dígitos à direita do separador decimal. A saída é baseada nas configurações de localidade do sistema.
Fixo Exiba pelo menos um dígito à esquerda e dois dígitos à direita do separador decimal.
Standard Exiba o número com separador de milhar, pelo menos um dígito à esquerda e dois dígitos à direita do separador decimal.
Percentagem Número de exibição multiplicado por 100 com um sinal de porcentagem ( % ) anexado à direita. Exiba sempre dois dígitos à direita do separador decimal.
Científico Use notação científica padrão.

A tabela a seguir identifica os caracteres que você pode usar para criar formatos de data/hora definidos pelo usuário.

Personagem Descrição
( : ) Separador de tempo. Em algumas localidades, outros caracteres podem ser usados para representar o separador de tempo. O separador de tempo separa horas, minutos e segundos quando os valores de tempo são formatados. O caractere real usado como separador de tempo 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 em que os valores de data são formatados. O caractere real usado como separador de data na saída formatada é determinado pelas configurações do sistema.
d Exiba o dia como um número sem um zero à esquerda (1–31).
dd Exiba o dia como um número com um zero à esquerda (01–31).
ddd Exiba o dia como uma abreviatura (Dom–Sáb). Localizado.
dddd Mostre o dia como um nome completo (domingo a sábado). Localizado.
m Exiba o mês como um número sem um zero à esquerda (1–12). Se m se seguir imediatamente a h ou hh, é apresentado o minuto em vez do mês.
mm Exiba o mês como um número com um zero à esquerda (01–12). Se m se seguir imediatamente a h ou hh, é apresentado o minuto em vez do mês.
mmm Exiba o mês como uma abreviatura (jan–dez). Localizado.
mmmm Exiba o mês como um nome completo do mês (janeiro a dezembro). Localizado.
yy Exiba o ano como um número de dois dígitos (00–99).
yyyy Exiba o ano como um número de quatro dígitos (100–9999).
h Exiba a hora como um número sem um zero à esquerda (0–23).
hh Exiba a hora como um número com um zero à esquerda (00–23).
n Exiba o minuto como um número sem um zero à esquerda (0–59).
nn Exiba o minuto como um número com um zero à esquerda (00–59).
s Exiba o segundo como um número sem um zero à esquerda (0–59).
ss Exiba o segundo como um número com um zero à esquerda (00–59).
TT Use o relógio de 12 horas e exiba uma AM maiúscula a qualquer hora antes do meio-dia; exiba uma PM maiúscula a qualquer hora entre meio-dia e 23h59.

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

Personagem Descrição
None Exiba o número sem formatação.
( 0 ) Espaço reservado para dígitos. Exiba um dígito ou zero. Se a expressão tiver um dígito na posição em que o 0 aparece na cadeia de caracteres de formato, exiba-o. Caso contrário, exiba um zero nessa posição. Se o número tiver menos dígitos do que zeros (em ambos os lados do decimal) na expressão de formato, exiba zeros à esquerda ou à direita. Se o número tiver mais dígitos à direita do separador decimal do que zeros à direita, arredondar o número para tantas casas decimais quantas forem zeros. Se o número tiver mais dígitos à esquerda do separador decimal do que zeros à esquerda, exiba os dígitos extras sem modificação.
# ( ) Espaço reservado para dígitos. Exiba um dígito ou nada. Se a expressão tiver um dígito na posição em que o # aparece na cadeia de formatação, exiba-o; caso contrário, não exiba nada nessa posição. Esse símbolo funciona como o espaço reservado de zero dígitos, exceto que os zeros à esquerda e à direita não são exibidos se o número tiver os mesmos ou menos dígitos do que os caracteres # em ambos os lados do separador decimal na expressão de formato.
( . ) Espaço reservado decimal. Em algumas localidades, uma vírgula é usada como separador decimal. O espaço reservado decimal determina quantos dígitos são exibidos à esquerda e à direita do separador decimal. Se a expressão de formato contiver apenas sinais numéricos à 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 0 como o espaço reservado para o primeiro dígito à esquerda do separador decimal. O caractere real usado como um espaço reservado decimal na saída formatada depende do formato de número reconhecido pelo seu sistema.
(%) Espaço reservado para porcentagem. A expressão é multiplicada por 100. O caractere de porcentagem ( % ) é inserido na posição em que aparece na cadeia de caracteres de formato.
( , ) Mil separadores. Em algumas localidades, um ponto é usado como separador de mil. O separador de milhares separa milhares de centenas dentro de um número que tem quatro ou mais lugares à esquerda do separador decimal. O uso padrão do separador de mil é especificado se o formato contiver um separador de mil cercado por espaços reservados para dígitos ( 0 ou # ). Dois separadores de mil adjacentes ou um separador de mil imediatamente à esquerda do separador decimal (quer seja especificado ou não um decimal) significa "dimensionar o número dividindo-o por 1000, arredondando conforme necessário". Por exemplo, você pode usar a cadeia de caracteres de formato "##0,," para representar 100 milhões como 100. Números menores que 1 milhão são exibidos como 0. Dois separadores de mil adjacentes em qualquer posição que não seja imediatamente à esquerda do separador decimal são tratados simplesmente como especificando o uso de um separador mil. O caractere real usado como separador de mil na saída formatada depende do formato de número reconhecido pelo seu sistema.
( : ) Separador de tempo. Em algumas localidades, outros caracteres podem ser usados para representar o separador de tempo. O separador de tempo separa horas, minutos e segundos quando os valores de tempo são formatados. O caractere real usado como separador de tempo 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 em que os valores de data são formatados. O caractere real usado como separador de data na saída formatada é determinado pelas configurações do sistema.
( E- E+ e- e+ ) Formato científico. Se a expressão de formato contiver pelo menos um espaço reservado para dígitos ( 0 ou ) à direita de E-, E+, e-, ou e+, o número é exibido em formato científico e E ou # e é inserido entre o número e seu expoente. O número de espaços reservados para dígitos à direita 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.
- + $ ( ) Exiba um caractere literal. Para exibir um caractere diferente, preceda-o com uma barra invertida (\) ou coloque-o entre aspas duplas (" ").
\ ( ) Exiba o próximo caractere na cadeia de caracteres de formato. Para exibir um caractere que tenha um significado especial como um caractere literal, preceda-o com uma barra invertida (\). 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 (\\). 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 cadeia de caracteres (@, &, , <>e !).
("ABC") Exiba a cadeia de caracteres dentro das aspas duplas (" ").

Para obter mais informações, consulte: