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

Resultado

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

Resultado

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ês 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 onde 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çãoObservaçã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 onde a porcentagem 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 milhar adjacentes, ou um separador de milhar imediatamente à esquerda do separador decimal (independentemente de um decimal ter sido especificado), significa "escalar o número dividindo-o por 1000, arredondando se 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 exibido 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çãoObservaçã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çãoObservaçã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çãoObservaçã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 para dígito determina o número de dígitos do exponente. Use E - ou e - para incluir um sinal de menos junto a exponentes negativos. Use E + ou e + para incluir um sinal de menos junto a exponentes negativos e um sinal de mais junto a exponentes positivos.

- + $ ( )

Exibe um caractere literal.

Para exibir um outro caractere que não seja um dos listados, coloque uma barra invertida (\) antes do caractere ou coloque-o 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 cadeias de caracteres —@, &, <, > e !

"ABC"

Exibe a cadeia de caracteres entre aspas duplas (" ").

Para incluir uma cadeia de caracteres em formato a partir 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 é 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 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çãoObservaçã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çãoObservação
Em algumas localidades, podem ser usados outros caracteres 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 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 inteiro (domingo-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 seqüencial 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 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 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-dez).

mmmm

Exibe o mês como um nome completo de mês (janeiro-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).

yy

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 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çãoObservaçã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çãoObservaçã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çãoObservaçã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çãoObservaçã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çãoObservaçã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.