Conteúdo do FORMAT_STRING (MDX)

A propriedade da célula FORMAT_STRING formata a célula VALUE, criando o valor para a propriedade da célula FORMATTED_VALUE. A propriedade da célula FORMAT_STRING lida com valores brutos de string e numéricos, aplicando uma expressão de formato ao valor para retornar um valor formatado para a propriedade FORMATTED_VALUE da célula. As tabelas a seguir detalham a sintaxe e os caracteres de formatação usados para manipular valores numéricos e de cadeia de caracteres.

Valores de cadeia de caracteres

Uma expressão de formato para cadeias de caracteres pode ter uma ou duas seções separadas por um ponto-e-vírgula (;).

Uso	Resultado
Uma seção	O formato se aplica a todos os valores de cadeia de caracteres.
Duas seções	A primeira seção se aplica a dados de cadeia de caracteres, enquanto a segunda se aplica a valores nulos e cadeias de caracteres de comprimento zero ("").

Os caracteres descritos na tabela a seguir podem aparecer em cadeias de caracteres de formato.

Personagem	Descrição
@	Representa um espaço reservado de caractere que exibe um caractere ou um espaço. Se a cadeia de caracteres tiver um caractere na posição em que o sinal de at (@) aparece na cadeia de caracteres de formato, a cadeia de caracteres formatada exibirá o caractere. Caso contrário, a cadeia de caracteres formatada exibirá um espaço nessa posição. Os espaços reservados são preenchidos da direita para a esquerda, a menos que haja um ponto de exclamação (!) na cadeia de caracteres de formato.
&	Representa um espaço reservado de caractere que exibe um caractere ou nada. Se a cadeia de caracteres tiver um caractere na posição em que o e comercial (&) aparece, a cadeia de caracteres formatada exibirá o caractere. Caso contrário, a cadeia de caracteres formatada não exibirá nada. Os espaços reservados são preenchidos da direita para a esquerda, a menos que haja um ponto de exclamação (!) na cadeia de caracteres de formato.
<	Força minúsculas. A cadeia de caracteres formatada exibe todos os caracteres em formato minúsculo.
>	Converter para maiúsculas. A cadeia de caracteres formatada exibe todos os caracteres em formato maiúsculo.
!	Obriga o preenchimento dos espaços reservados da esquerda para a direita. (O padrão é preencher espaços reservados da direita para a esquerda.)

Valores numéricos

Uma expressão de formato definida pelo usuário para números pode ter de uma a quatro seções separadas por ponto-e-vírgula. Se o argumento de formato contiver um dos formatos numéricos nomeados, somente uma seção será permitida.

Uso	Resultado
Uma seção	A expressão de formato se aplica a todos os valores.
Duas seções	A primeira seção se aplica a valores positivos e zeros, o segundo a valores negativos.
Três seções	A primeira seção se aplica a valores positivos, o segundo a valores negativos e o terceiro a zeros.
Quatro seções	A primeira seção se aplica a valores positivos, o segundo a valores negativos, o terceiro a zeros e o quarto a valores nulos.

O exemplo a seguir tem duas seções. A primeira seção define o formato para valores positivos e zeros e a segunda seção define o formato para valores negativos.

"$#,##0;($#,##0)"

Se você incluir ponto-e-vírgula sem nada entre eles, a seção ausente será impressa usando o formato do valor positivo. Por exemplo, o seguinte formato exibe valores positivos e negativos usando o formato na primeira seção e exibe "Zero" se o valor for zero:

"$#,##0;;\Z\e\r\o"

A tabela a seguir lista os caracteres que podem aparecer na string de formato para formatos numéricos.

Personagem	Descrição
Nenhum	Exibe o número sem nenhuma formatação.
0	Representa um espaço reservado de dígito que exibe um dígito ou um zero (0). Se o número tiver um dígito na posição em que o zero aparece na cadeia de caracteres de formato, o valor formatado exibirá o dígito. Caso contrário, o valor formatado exibirá um zero nessa posição. Se o número tiver menos dígitos do que zeros (em ambos os lados do decimal) na cadeia de caracteres de formato, o valor formatado exibirá 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, o valor formatado arredondará o número para quantas casas decimais houver 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, o valor formatado exibirá os dígitos adicionais sem modificação.
#	Representa um marcador de dígito que mostra um dígito ou nada. Se a expressão tiver um dígito na posição em que o sinal de número (#) aparece na cadeia de caracteres de formato, o valor formatado exibirá o dígito. Caso contrário, o valor formatado não exibirá nada nessa posição. O marcador de número (#) funciona como o marcador de dígito zero (0), exceto que zeros à esquerda e à direita não aparecerão se o número tiver o mesmo número ou menos dígitos que os caracteres # de cada lado do separador decimal na expressão de formato.
.	Representa um espaço reservado decimal que determina quantos dígitos são exibidos à esquerda e à direita do separador decimal. Se a expressão de formato contiver apenas caracteres de sinal de número (#) à esquerda do período (.), números menores que 1 começarão com um separador decimal. Para exibir um zero à esquerda com números fracionários, use o dígito zero (0) como a primeira posição à esquerda do separador decimal. O caractere efetivo utilizado como marcador decimal na saída formatada depende do formato de número reconhecido pelo sistema computacional. Observação: em algumas localidades, uma vírgula é usada como separador decimal.
%	Representa um marcador de porcentagem. A expressão é multiplicada por 100. O caractere de porcentagem (%) é inserido na posição em que a porcentagem aparece na cadeia de caracteres de formato.
,	Representa um separador de mil que separa milhares de centenas em um número que tem quatro ou mais locais à esquerda do separador decimal. O uso padrão do separador de mil será especificado se o formato contiver um separador de mil entre os espaços reservados de dígito (0 ou #). Dois separadores de mil adjacentes, ou um separador de mil imediatamente à esquerda do separador decimal (se um decimal é especificado ou não), significa "dimensionar o número dividindo o número 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 milhar adjacentes em qualquer posição que não seja imediatamente à esquerda do separador decimal são tratados como especificando o uso de um separador de milhar. O caractere real usado como o separador de mil na saída formatada depende do formato de número reconhecido pelo sistema de computador. Observação: em algumas localidades, um período é usado como o separador de mil.
:	Representa um separador de tempo que separa horas, minutos e segundos quando os valores de tempo são formatados. Observação: em algumas localidades, outros caracteres podem ser usados como separador de tempo. O caractere real usado como separador de tempo na saída formatada é determinado pelas configurações do sistema no computador.
/	Representa um separador de data que 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 no computador. Observação: em algumas localidades, outros caracteres podem ser usados como separador de data.
E- E+ e- e+	Representa o formato científico. Se a expressão de formato contiver pelo menos um espaço reservado de dígito (0 ou #) à direita de E-, E+, e-, ou e+, o valor formatado será exibido no formato científico e E ou e será inserido entre o número e o expoente do número. O número de espaços reservados de dígito à direita determina o número de dígitos no expoente. Use E- ou e- para incluir um sinal de subtração ao lado de expoentes negativos. Use E+ ou e+ para incluir um sinal de menos ao lado de expoentes negativos e um sinal de adição ao lado de expoentes positivos.
- + $ ( )	Exibe um caractere literal. Para exibir um caractere diferente de um dos listados, coloque uma barra invertida (\) antes do caractere ou coloque o caractere 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 do caractere. 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 (\\). Exemplos de caracteres que não podem ser exibidos como caracteres literais incluem os seguintes caracteres: 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 cadeia: @, &, <, >, e !
"ABC"	Exibe a cadeia de caracteres dentro das aspas duplas (" "). Para incluir uma cadeia de caracteres dentro do código, use Chr(34) para delimitar o texto. (O código de caractere para uma aspa dupla é 34.)

Formatos numéricos nomeados

A tabela a seguir identifica os nomes de formato numérico predefinidos:

Nome do formato	Descrição
`General Number`	Exibe o número sem nenhum separador de milhares.
`Currency`	Exibe o número com um separador de milhares, se apropriado. Exibe dois dígitos à direita do separador decimal. A saída é baseada nas configurações de localidade do sistema.
`Fixed`	Exibe pelo menos um dígito à esquerda e dois dígitos à direita do separador decimal.
`Standard`	Exibe o número com o separador de mil, pelo menos um dígito à esquerda e dois dígitos à direita do separador decimal.
`Percent`	Exibe o número multiplicado por 100 com um sinal de porcentagem (%) acrescentado à direita. Sempre exibe dois dígitos à direita do separador decimal.
`Scientific`	Usa notação científica padrão.
`Yes/No`	Exibe Não se o número for 0; caso contrário, exibe Sim.
`True/False`	Exibe False se o número for 0; caso contrário, exibe True.
`On/Off`	Exibe Desativado se o número for 0; caso contrário, exibe Ativado.

Valores de data

A tabela a seguir identifica caracteres que podem aparecer na cadeia de caracteres de formato para formatos de data/hora.

Personagem	Descrição
:	Representa um separador de tempo que 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 do computador. Observação: em algumas localidades, outros caracteres podem ser usados como separador de tempo.
/	Representa um separador de data que 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 do computador. Observação: em algumas localidades, outros caracteres podem ser usados para representar o separador de data
C	Exibe a data como dddddd e exibe a hora como ttttt, nessa ordem. Exibe apenas informações de data se não houver nenhuma parte fracionária no valor serial da data. Exibe apenas informações de tempo se não houver nenhuma parte de inteiro.
d	Exibe o dia como um número sem um 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 (Sun-Sat).
dddd	Exibe o dia como um nome completo (Sunday-Saturday).
ddddd	Exibe a data como uma data completa (incluindo dia, mês e ano), formatada de acordo com a configuração de formato de data curta do sistema. Para o Microsoft Windows, o formato de data curta padrão é m/d/yyy.
dddddd	Exibe um número de série de data como uma data completa (incluindo dia, mês e ano), formatada de acordo com a configuração de data longa reconhecida pelo sistema de computador. Para o Windows, o formato de data longa padrão é mmmm dd,yyy.
w	Exibe o dia da semana como um número (1 para domingo a 7 para sábado).
Ww	Exibe a semana do ano como um número (1-54).
m	Exibe o mês como um número sem um zero à esquerda (1-12). Se m imediatamente seguir h ou hh, o minuto em vez do mês será exibido.
milímetro	Exibe o mês como um número com um zero à esquerda (01-12). Se m imediatamente seguir h ou hh, o minuto em vez do mês será exibido.
mmm	Exibe o mês como uma abreviação (Jan-Dec).
Mmmm	Exibe o mês como um nome de mês completo (January-December).
q	Exibe o trimestre do ano como um número (1-4).
y	Exibe o dia do ano como um número (1-366).
aaa	Exibe o ano como um número de dois dígitos (00-99).
yyyyy	Exibe o ano como um número de quatro dígitos (100-9999).
h	Exibe a hora como um número sem zeros à esquerda (0-23).
Hh	Exibe a hora como um número com zeros à frente (00-23).
n	Exibe o minuto como um número sem zeros à esquerda (0-59).
nn	Exibe o minuto como um número com zeros à esquerda (00-59).
s	Exibe o segundo como um número sem zeros à esquerda (0-59).
ss	Exibe o segundo como um número com zeros à esquerda (00-59).
t t t t t t	Exibe uma hora como uma hora completa (incluindo hora, minuto e segundo), formatada usando o separador de tempo definido pelo formato de tempo reconhecido pelo sistema de computador. Um zero à esquerda será exibido se a opção zero à esquerda estiver selecionada e a hora for anterior a 10:00 no ciclo A.M. ou P.M. Por exemplo, 09:59, Para o Windows, o formato de hora padrão é h:mm:ss.
AM/PM	Exibe um AM maiúsculo com qualquer hora da meia-noite até o meio-dia; exibe um PM maiúsculo com qualquer hora do meio-dia até a meia-noite. Observação: usa o relógio de 12 horas.
am/pm	Exibe um am minúsculo com qualquer hora da meia-noite até o meio-dia; exibe um pm minúsculo com qualquer hora do meio-dia até a meia-noite. Observação: usa o relógio de 12 horas.
A/P	Exibe um A maiúsculo com qualquer hora da meia-noite até o meio-dia; exibe um P maiúsculo com qualquer hora do meio-dia até a meia-noite. Observação: usa o relógio de 12 horas.
a/p	Exibe um minúsculo a para qualquer hora entre meia-noite e meio-dia; exibe um minúsculo p para qualquer hora entre meio-dia e meia-noite. Observação: usa o relógio de 12 horas.
AMPM	Exibe o literal AM conforme definido pelo sistema de computador com qualquer hora da meia-noite até o meio-dia; exibe o literal PM conforme definido pelo sistema de computador com qualquer hora do meio-dia até a meia-noite. Observação: usa o relógio de 12 horas. O AMPM pode ser maiúsculo ou minúsculo, mas a forma do texto exibido corresponde ao texto conforme definido pelas configurações do sistema do computador. Para o Windows, o formato padrão é AM/PM.

Formatos de data com nome

A tabela a seguir identifica os nomes de formato de data e hora predefinidos:

Nome do Formato	Descrição
`General Date`	Exibe uma data e/ou hora. Para números reais, exibe uma data e hora, por exemplo, 3/4/93 05:34 PM. Se não houver nenhuma parte fracionária, exibirá apenas uma data, por exemplo, 3/4/93. Se não houver nenhuma parte inteira, exibirá apenas uma hora, por exemplo, 17h34. O formato da exibição de data é determinado pelas configurações do sistema.
`Long Date`	Exibe uma data de acordo com o formato de data longa do sistema.
`Medium Date`	Exibe uma data usando o formato de data média apropriado para a versão de idioma do aplicativo host.
`Short Date`	Exibe uma data usando o formato de data curta do sistema.
`Long Time`	Exibe um tempo usando o formato de longo tempo do sistema; inclui horas, minutos e segundos.
`Medium Time`	Exibe um tempo no formato de 12 horas usando horas e minutos e o designador AM/PM.
`Short Time`	Exibe uma hora usando o formato de 24 horas, por exemplo, 17:45.

Consulte Também

LANGUAGE e FORMAT_STRING no VALOR_FORMATADO
Usando propriedades de célula (MDX)
Criando e usando valores de propriedade (MDX)
Conceitos básicos da consulta MDX (Analysis Services)

Last updated on 2017-03-06

Partilhar via