Formatação de números em insights e relatórios

Use o Editor de formato numérico para configurar como os números serão exibidos nos seus insights e relatórios. Você pode arredondar números, acomodar configurações regionais, adicionar símbolos de moeda, ajustar cores ou incluir conjuntos de caracteres nos números.

As alterações de formatação feitas no Editor de formato numérico modificam a formatação do espaço de trabalho todo. Para alterações específicas de formatação, consulte Formatar números.

Antes de começar

Esta seção é para usuários das interfaces Pixel Perfeito e Responsiva.

Para ter uma visão geral abrangente da terminologia do GoodData, consulte Glossário do GoodData.

Para obter mais detalhes sobre a interface de usuário do GoodData, consulte Portal GoodData.

Configurações regionais e formatação de números

Os exemplos de sintaxe de formatação neste artigo são baseados na configuração regional padrão do GoodData:

  • Vírgulas (,) são usadas para separar milhares.
  • Pontos (.) são usados ​​para separar casas decimais.

Por exemplo:

1,234.12

Se você alterar as configurações de formatação regionais do seu espaço de trabalho (por exemplo, a que usa vírgulas para separar valores decimais e espaços para separar milhares), a sintaxe de formatação será alterada de acordo com todas as novas métricas e as não modificadas já existentes. A sintaxe de formatação de métrica personalizada não será afetada.

Exemplo:

Configurações da contaSintaxe padrão
1,234.56

#,##0.00

1 234,56# ##0,00

Acessando o Editor de formato numérico

A maneira de acessar o Editor de formato numérico depende da interface de usuário que você está usando.

Na interface de usuário Responsiva, clique na aba Gerir:

  1. Clique em Métricas. A lista de métricas é exibida.

  2. Clique na métrica que você deseja modificar. A página com os detalhes da métrica é exibida. 

  3. Clique em Editar. O Editor de formato numérico é exibido.

  4. Aplique a sintaxe de formatação no campo de formatos numéricos personalizados. 

 

Na interface do usuário Pixel Perfeito, você também pode acessar o Editor de Métricas Personalizadas no painel Relatórios.

  1. Acesse: Criar relatório > painel O quê > coluna Métricas.
  2. Selecione uma métrica.
  3. Clique em Editar na coluna Detalhes de uma métrica.

Preservar os zeros estranhos

Para preservar zeros a mais, use um 0 no lugar do símbolo de hash (#) na sintaxe de formatação de números.

Quando símbolos # são usados na sintaxe de formatação de número, quaisquer zeros que não ocupam uma casa decimal de valor são removidos. No entanto, usar um 0 no lugar do símbolo # na formatação de sintaxe preserva zeros estranhos.

A seguir está o sintaxe de formatação de número de padrão: 

#,##0.00

Implicações:

  • #.##0,00: Se a casa da unidade estiver vazia, um zero é exibido em seu lugar.
  • #.##0,00: Se não há casas de dezena e centena com valor, zeros são exibidos nesses lugares.

Com essa formatação de números, os resultados são como a seguir: 

Exemplo

Sintaxe

Valor de entrada

Resultado exibido

Preservando os zeros na casa da unidade

 

#.##

0.05

.05

0,##

0.05

0.05

Preservando a zeros no caso de um valor de 0

 

#.##

0

valor nulo (nada exibido)

0.##

0

0

Preservando os zeros na casa decimais

 

#,#.##

1000.00

1,000

#,#.00

1000.00

1,000.00

Arredondamento para um número inteiro e casas decimais

O número de símbolos de hash (#) à direita do ponto decimal dita o número de valores de casa decimal a exibir. Se o número de entrada tem mais valores de casas que o especificado pela sintaxe de formatação, o valor da última casa decimal é arredondado. Por exemplo, #,# aplicado a 7,25 resulta em um valor de exibição de 7,3.

Para especificar como esses valores de casa decimal devem ser preenchidos com zeros quando nulos, use zeros no lugar de símbolos hash para aquelas casas decimais na sintaxe de formatação de número. 

FormataçãoValor de entradaResultado exibido
#.##77
#.0077.00

 Caso contrário, zeros e símbolos de hash serão intercambiáveis ​​na sintaxe de formatação de números. 

Sintaxe

Descrição

Valor de entrada

Resultado exibido

#

Arredonda para o número inteiro mais próximo

19676916585.269

19676916585

#.#

"Arredonda para a casa decimal mais próxima; para valores de números inteiros, casas decimais não são mostradas"

19676916585.269  19676916585

19676916585.3  19676916585

#.0

"Arredonda para a casa decimal mais próxima; para valores de números inteiros, zeros são mostrados na casa decimal"

19676916585.269  19676916585

19676916585.3  19676916585.0

#.##

Arredonda para a casa de centena mais próxima

19676916585.269

19676916585.27

#.###

Arredonda para a casa de milhar mais próxima

19676916585.269

19676916585.269

Separa milhares, milhões e assim por diante

Insira uma vírgula entre os símbolos de hash na sintaxe de formatação de números personalizada para separar milhares nos conjuntos de números (milhares, milhões, bilhões etc.). 

Sintaxe

Descrição

Valor de entrada

Resultado exibido

#

Arredonda para o número inteiro mais próximo

19676916585

19676916585

#,#

"Arredonda para o número inteiro mais próximo; insere vírgulas a cada três casas de valores"

19676916585

19,676,916,585

Truncando números grandes

Cada ponto adicionado à esquerda do ponto decimal efetivamente truncará o número por outros três valores de casa, começando com unidades, dezenas e centenas. 

Sintaxe

Descrição

Valor de entrada

Resultado exibido

#,

"Arredonda para o milhar mais próximo; remove dígitos de unidades, dezenas e centenas"

19676916585.269

19676917

#,#,

"Arredonda para o milhar mais próximo; remove dígitos de unidades, dezenas e centenas; insere vírgulas a cada três casas de valores"

19676916585.269

19,676,917

#,,

Arredonda para o milhão mais próximo; remove todos os dígitos até uma casa de centena de milhar.

19676916585.269

19677

#,,,

"Arredonda para o bilhão mais próximo; remove todos os dígitos até a casa de centena de milhões; insere a letra B após o número"

19676916585.269

20

#,,,.##

Divide o número por um bilhão; arredonda para a casa de centena mais próxima

19676916585.269

19.68

Você pode fornecer contexto para valores truncados adicionando letras como K, M e B (milhares, milhões e bilhões) para a sintaxe de formatação de número personalizada. Estas letras não têm impacto sobre o valor do número; a letra só é inserida no resultado: 

Sintaxe

Descrição

Valor de entrada

Resultado exibido

#,K

"Arredonda para o milhar mais próximo; remove dígitos de unidades, dezenas e centenas; insere a letra K após o número"

19676916585.269

19676916 K

#,, M

"Arredonda para o milhão mais próximo; remove todos os dígitos até a casa de centena de milhar; insere a letra M após o número"

19676916585.269

19677 M

#,,, B

"Arredonda para o bilhão mais próximo; remove todos os dígitos até a casa de centena de milhões; insere a letra B após o número"

19676916585.269

20 B

Exibição de símbolos interpretáveis

Você pode exibir símbolos em sua formatação de número personalizada que podem ser interpretado diferentemente pelo Portal GoodData. Para forçar a exibição de um literal na formatação de número personalizada, insira uma barra invertida (\) antes do caractere.

Suponhamos que você queira exibir símbolos de porcentagem em sua formatação. No entanto, o símbolo de porcentagem (%) tem um significado especial na formatação personalizada; indica que um valor de dados deve ser multiplicado por 100. Se você adicionar esse símbolo à formatação, o valor 97 será exibido como 9700%, em vez de 97%.

Para exibir o símbolo de porcentagem sem afetar o valor dos dados, use o seguinte na sua formatação: \%

Alguns exemplos são listados abaixo:

Sintaxe

Descrição

Valor de entrada

Resultado exibido

#%

"Multiplica o valor por 100; arredonda o valor para o número inteiro mais próximo; insere um símbolo de porcentagem após o número"

.56472

56%

#.##%

Multiplica o valor por 100; exibe os primeiros dois valores de casa decimal do número; acrescenta um símbolo de porcentagem após o número

.56472

56.47%

#.##\%

Exibe os dois primeiros valores de casa decimal do número; acrescenta um símbolo de porcentagem após o número; o valor do número não é afetado pelo sinal de porcentagem

.56472

.56%

Inserir caracteres UTF-8 (símbolos de moeda, unidades SI e imperial etc.)

Todos os símbolos UTF-8, exceto vírgulas, pontos e símbolos de porcentagem, que são adicionados à sintaxe de formatação de número personalizada, são exibidos ao lado dos valores numéricos. 

Vírgulas, pontos e símbolos de porcentagem podem ser interpretados pelo aplicativo como comandos de sintaxe.

Sintaxe

Descrição

Valor de entrada

Resultado exibido

$#

Coloca um cifrão antes do número

19676916585

$19676916585

#

Coloca um símbolo antes do número

19676916585

19676916585

# gramas

Acrescenta uma sequência de caracteres após o número

19676916585

19676916585 gramas

#...,# bilhões

"Arredonda para a dezena de bilhão mais próxima; inclui uma sequência de caracteres após o novo número"

19676916585

19,7 bilhões

Por exemplo, para exibir o valor em dólares americanos, simplesmente adicione o cifrão ($) ao formato padrão disponível no Editor de formato de número.

$#,##0.00

“Isso exibirá o valor típico dos Estados Unidos; por exemplo, $1,234,567.89:”

  • milhares separados por vírgulas
  • ponto decimal
  • duas casas decimais (incluindo quantias como $1.00)

Da mesma maneira, use £ para exibir valores em libras esterlinas. Você também pode combinar símbolos. Por exemplo, para especificar um valor em dólares canadenses, use o prefixo C$.

Você também pode usar caracteres UTF-8 para criar exibições de barra. No exemplo a seguir, uma barra de exibição é definida para valores métricos entre 0,0 e 1,0:

[>=.9][color=2190c0]██████████; [>=.8][color=2190c0]█████████░; [>=.7][color=2190c0]████████░░; [>=.6][color=2190c0]███████░░░; [>=.5][color=2190c0]██████░░░░; [>=.4][color=2190c0]█████░░░░░; [>=.3][color=2190c0]████░░░░░░; [>=.2][color=2190c0]███░░░░░░░; [>=.1][color=2190c0]██░░░░░░░░; [color=2190c0]█░░░░░░░░░

Conversão de unidade na formatação de métrica 

A conversão de unidades permite implementar aritmética simples para formatar métricas em várias saídas de exibição, como duração ou tamanho.

Por exemplo, uma entrada de segundos pode mostrar um resultado de hh:mm ao converter segundos em horas e o restante em minutos e aplicando o formato correto do resultado.

Formato

Blocos de formato aritmético podem ser incluídos em qualquer lugar na sequência de formato personalizado, mas não podem ser aninhados.

Eles têm a seguinte estrutura:

{{{div|mod|format}}}

Esses blocos recebem o mesmo número de entrada como a sequência de formatação principal da qual fazem parte.

Blocos de formato podem ser parametrizados da seguinte forma:

  • div - o argumento que divide o número de entrada.

  • mod - o módulo calculado a partir do resultado do cálculo da divisão.

  • format - o resultado exibido do formato aplicado ao número de entrada dividido por div modulo mod.

Exemplo  1:

{{{86400||#}}} days\, {{{3600|24|00}}}:{{{60|60|00}}}:{{{|60.|00.000}}} hours

Resulta no seguinte

Valor de entrada do fato (em segundos)Exibição do resultado
120523.5211 dias, 09:28:43.521 horas
34123.5211 dias, 09:28:43.520 horas

Exemplo 2:

{{{24||[>1]# days\, ;[>0]# day\, ;#}}}{{{|24|0}}}:{{{0.016666666|60.|00}}} hours

Resulta no seguinte

Valor de entrada do fato (em horas)Exibição do resultado
23.7523:45 horas
38.51 dias, 14:30 horas
642 dias, 16:00 horas

Ainda nesta seção: