Compartilhar via


Conteúdo de FORMAT_STRING (MDX)

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

Valores de cadeia de caracteres

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

Uso Result
Uma seção O formato é aplicado a todos os valores da cadeia de caracteres.
Duas seções A primeira seção é aplicada aos dados da cadeia de caracteres, enquanto a segunda é aplicada a valores nulos de comprimento zero ("").

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

Caractere 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 onde aparece um sinal arroba (@) 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 naquela 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 onde aparece um sinal E comercial (&), 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 o uso de letra minúscula. A cadeia de caracteres formatada exibe todos os caracteres em formato de letra minúscula.
> Força o uso de letra maiúscula. A cadeia de caracteres formatada exibe todos os caracteres em formato de letra maiúscula.
! Força o preenchimento da esquerda para a direita de espaços reservados. (O padrão de preenchimento de 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, em qualquer lugar, de uma a quatro seções separadas por ponto-e-vírgula. Se o argumento de formato contiver um dos formatos numéricos nomeados, apenas uma seção será permitida.

Uso Result
Uma seção A expressão de formato é aplicada a todos os valores.
Duas seções A primeira seção é aplicada a valores positivos e zeros; a segunda a valores negativos.
Trê seções A primeira seção é aplicada a valores positivos, a segunda a valores negativos e a terceira a zeros.
Quatro seções A primeira seção é aplicada a valores positivos, a segunda a valores negativos, a terceira a zeros e a quarta a valores nulos.

O exemplo a seguir possui duas seções. A primeira define o formato dos valores positivos e dos zeros, enquanto a segunda define o formato dos valores negativos.

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

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

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

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

Caractere Descrição
Nenhum Exibe o número sem qualquer 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 onde aparece um zero 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 que zeros (em qualquer lado da divisão decimal) na cadeia de caracteres de formato, o valor formatado exibirá zeros à esquerda e à direita.

Se o número tiver mais dígitos à direita do separador decimal que zeros à direita do separador decimal na expressão de formato, o valor formatado arredondará o número para o mesmo número de casas decimais que a quantidade de zeros.

Se o número tiver mais dígitos à esquerda do separador decimal que zeros à esquerda do separador decimal na expressão de formato, o valor formatado exibirá os dígitos adicionais sem alteração.
# Representa um espaço reservado de dígito que exibe um dígito ou nada.

Se a expressão tiver um dígito na posição em que aparece um sinal numérico (#) na cadeia de caracteres de formato, o valor formatado exibirá o dígito. Caso contrário, o valor formatado não exibirá nada naquela posição.

O espaço reservado para sinal numérico (#) funciona como o espaço reservado para o dígito zero (0), exceto pelo fato de que os zeros à esquerda e à direita não serão exibidos se o número tiver a mesma quantidade de dígitos, ou menos, que de caracteres # em qualquer um dos lados do separador decimal na expressão de formato.
. Representa um espaço reservado decimal que determina quantos dígitos serão exibidos à esquerda e à direita do separador decimal.

Se a expressão de formato contiver apenas caracteres de sinal numérico (#) à esquerda do ponto (.), números menores que 1 começaram com um separador decimal. Para exibir um zero à esquerda no caso de números fracionais, use zero (0) como o primeiro espaço reservado para dígito à esquerda do separador decimal.

O caractere real usado como espaço reservado decimal na saída formatada depende do formato numérico reconhecido pelo sistema do computador.

Observação: em algumas localidades, a vírgula é usada como o separador decimal.
% Representa um espaço reservado de porcentagem. A expressão é multiplicada por 100. O caractere por cento (%) é inserido na posição em que o percentual aparece na cadeia de caracteres de formato.
, Representa um separador de milhar que separa os milhares das centenas em um número com quatro ou mais casas à esquerda do separador decimal.

O uso padrão do separador de milhar será especificado se o formato contiver um separador de milhar encerrado em espaços reservados para dígitos (0 ou #).

Dois separadores de mil adjacentes, ou um separador de milhar 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. Os números inferiores a 1 milhão são exibidos como 0. Dois separadores de milhar adjacentes em uma posição que não seja imediatamente à esquerda do separador decimal são tratados como se estivessem especificando o uso de um separador de milhar.

O caractere real usado como separador de milhar na saída formatada depende do formato numérico reconhecido pelo sistema do computador.

Observação: em algumas localidades, um ponto é usado como separador de milhar.
: Representa um separador de tempo que separa horas, minutos e segundos quando são formatados valores de tempo.

Observação: em algumas localidades, podem ser usados outros caracteres como separador de tempo.

O caractere real usado como separador de tempo na saída formatada é determinado pelas configurações do sistema do computador.
/ Representa um separador de data que separa dia, mês e ano quando são formatados valores de data.

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, podem ser usados outros caracteres como separador de data.
E- E+ e- e+ Representa formato científico.

Se a expressão de formato contiver pelo menos um espaço reservado para dígito (0 ou #) à direita de E-, E+, e-ou e+, o valor formatado será exibo em formato científico e E ou e será inserido entre o número e seu exponente. 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 menos 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 da 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 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 (\\). Estes são exemplos de caracteres que não podem ser exibidos como caracteres literais:

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 de caracteres,@&, <, >e !
"ABC" Exibe a cadeia de caracteres dentro das aspas duplas (" ").

Para incluir uma cadeia de caracteres em formato de um código, use Chr (34) para incluir o texto. (O código de caractere para aspas duplas é 34.)

Formatos numéricos nomeados

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

Nome do formato Descrição
General Number Exibe o número sem nenhum separador de milhar.
Currency Exibe o número com um separador de milhar, se apropriado. Exibe dois dígitos à direita do separador decimal. A saída se baseia 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 separador de milhar, 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 (%) à 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 Falso se o número for 0; caso contrário, exibe Verdadeiro.
On/Off Exibe Desabilitado se o número for 0; caso contrário, exibe Habilitado.

Valores de data

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

Caractere Descrição
: Representa um separador de tempo que separa horas, minutos e segundos quando são formatados valores de tempo.

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, podem ser usados outros caracteres como separador de tempo.
/ Representa um separador de data que separa dia, mês e ano quando são formatados valores de data.

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 ddddd e a hora como ttttt, nessa ordem.

Exibe as informações da data somente se não houver nenhuma parte fracionária no número de série de data. Exibe as informações da data somente se não houver nenhuma parte com número 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 (Dom-Sáb.
Dddd Exibe o dia como um nome completo (domingo a sábado).
ddddd Exibe a data completa (incluindo dia, mês e ano), formatada de acordo com a configuração de formato de data abreviada do seu sistema.

No Microsoft Windows, o formato de data abreviada padrão é d/m/aa.
dddddd Exibe o número sequencial de data (incluindo dia, mês e ano), formatado de acordo com a configuração de formato de data por extenso reconhecida pelo sistema do computador.

No Windows, o formato de data por extenso padrão é mmm dd, yyyy.
w Exibe o dia da semana como um número (de 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 vier imediatamente após h ou hh, será exibido o minuto em vez do mês.
mm Exibe o mês como um número com um zero à esquerda (01-12).

Se m vier imediatamente após h ou hh, será exibido o minuto em vez do mês.
mmm Exibe o mês como uma abreviação (Jan-Dec).
mmmm Exibe o mês como um nome de mês completo (janeiro a dezembro).
Q Exibe o trimestre do ano como um número (1-4).
y Exibe o dia do ano como um número (1-366).
aa Exibe o ano como um número de dois dígitos (00-99).
aaaa 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 à esquerda (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 Exibe a hora como uma hora completa (incluindo hora, minuto e segundo), formatada usando o separador de hora definido pelo formato de tempo por reconhecido pelo sistema do computador.

Um zero à esquerda será exibido se a opção de zero à esquerda estiver selecionada e a hora for anterior a 10:00 no ciclo A.M. ou P.M. Por exemplo, 09:59.

No Windows, o formato de hora padrão é h:mm:ss.
AM/PM Exibe AM em letras maiúsculas com todas as horas entre meia-noite e meio-dia; exibe PM em letras maiúsculas com todas as horas entre meio-dia e meia-noite.

Observação: usa o relógio de 12 horas.
am/pm Exibe am em letras minúsculas com todas as horas entre meia-noite e meio-dia; exibe pm em letras minúsculas com todas as horas entre meio-dia e meia-noite.

Observação: usa o relógio de 12 horas.
A/P Exibe A em letras maiúsculas com todas as horas entre meia-noite e meio-dia; exibe P em letras maiúsculas com todas as horas entre meio-dia e meia-noite.

Observação: usa o relógio de 12 horas.
a/p Exibe a em letras minúsculas com todas as horas entre meia-noite e meio-dia; exibe p em letras minúsculas com todas as horas entre meio-dia e meia-noite.

Observação: usa o relógio de 12 horas.
AMPM Exibe o texto da cadeia de caracteres AM conforme definido pelo sistema do computador com todas as horas entre meia-noite e meio-dia; Exibe o texto da cadeia de caracteres PM conforme definido pelo sistema do computador com todas as horas entre meio-dia e meia-noite.

Observação: usa o relógio de 12 horas.

AMPM pode ser em letras maiúsculas ou minúsculas, mas o formato da cadeia de caracteres exibida corresponde à cadeia de caracteres conforme definida pelas configurações do sistema do computador.

No Windows, o formato padrão é AM/PM.

Formatos de data nomeados

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, 4/3/93 05:34 PM. Se não houver nenhuma parte fracionária, exibirá só uma data, por exemplo, 4/3/93. Se não houver nenhuma parte inteira, só exibirá uma hora, por exemplo, 05:34 PM. O formato da exibição de data é determinado pelas configurações de sistema.
Long Date Exibe uma data de acordo com o formato de data por extenso de seu sistema.
Medium Date Exibe uma data usando o formato de data médio apropriado para a versão de idioma do aplicativo de host.
Short Date Exibe uma data usando o formato de data curto de seu sistema.
Long Time Exibe uma hora usando o formato de hora longo de seu sistema; inclui horas, minutos e segundos.
Medium Time Exibe uma hora no formato de 12 horas usando horas e minutos e o designator AM/PM.
Short Time Exibe uma hora usando o formato de 24 horas, por exemplo, 17:45.

Consulte Também

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