LANGUAGE e FORMAT_STRING em FORMATED_VALUE
A propriedade FORMATTED_VALUE é criada com base nas interações das propriedades VALUE, FORMAT_STRING e LANGUAGE da célula. Este tópico explica como essas propriedades interagem para criar a propriedade FORMATTED_VALUE.
Propriedades VALUE, FORMAT_STRING, LANGUAGE
A tabela a seguir explica o que são essas propriedades, para ajudá-lo na preparação para o uso combinado delas.
VALUE
O valor não formatado da célula.FORMAT_STRING
O modelo de formatação a ser aplicado ao valor da célula para gerar a propriedade FORMATTED_VALUELANGUAGE
A especificação de localidade a ser aplicada junto com FORMAT_STRING para gerar uma versão localizada de FORMATTED_VALUE
FORMATTED_VALUE construída
A propriedade FORMATTED_VALUE é construída com o uso do valor da propriedade VALUE e a aplicação do modelo de formato especificado na propriedade FORMAT_STRING para esse valor. Além disso, sempre que o valor de formatação for um named formatting literal, a especificação da propriedade LANGUAGE modifica a saída de FORMAT_STRING para seguir o uso do idioma da formatação nomeada. Os literais de formatação nomeada são definidos de modo que possam ser localizados. Por exemplo, "General Date" é uma especificação que pode ser localizada, em oposição ao seguinte modelo "YYYY-MM-DD hh:nn:ss",, que declara que a data deve ser apresentada conforme o definido pelo modelo, independentemente da especificação de idioma.
Se houver um conflito entre o modelo FORMAT_STRING e a especificação LANGUAGE, FORMAT_STRING substituirá LANGUAGE. Por exemplo, se FORMAT_STRING="$ #0" e LANGUAGE=1034 (Spain), e VALUE=123.456, D_VALUE="$ 123" em vez de FORMATTED_VALUE="€ 123", o formato esperado estará em Euros, porque o valor do modelo do formato substitui o idioma especificado.
Exemplos
Os exemplos a seguir mostram a saída obtida quando LANGUAGE é usado junto com FORMAT_STRING.
O primeiro exemplo explica os valores numéricos da formatação; o segundo exemplo explica os valores de data e hora da formatação.
Para cada exemplo, o código MDX é atribuído.
with
member measures.A as 5040, FORMAT_STRING="Currency"
member measures.B as measures.A, LANGUAGE=1034
member measures.C as measures.A, LANGUAGE=1034 , FORMAT_STRING="$#,##0.00"
member measures.D as measures.A, FORMAT_STRING="Scientific"
member measures.E as measures.A, LANGUAGE=1034 , FORMAT_STRING="Scientific"
member measures.F as 0.5040, FORMAT_STRING="Percent"
member measures.G as measures.F, LANGUAGE=1034
member measures.H as 0, LANGUAGE=1034 , FORMAT_STRING="Yes/No"
member measures.I as 59, LANGUAGE=1034 , FORMAT_STRING="Yes/No"
member measures.J as 0, LANGUAGE=1034 , FORMAT_STRING="ON/OFF"
member measures.K as -312, LANGUAGE=1034 , FORMAT_STRING="ON/OFF"
Select {measures.A, measures.B, measures.C, measures.D, measures.E, measures.F, measures.G, measures.H, measures.I, measures.J, measures.K} on 0
from [Adventure Works]
cell properties VALUE, FORMAT_STRING, LANGUAGE, FORMATTED_VALUE
Os resultados, transpostos, quando a consulta MDX acima estava sendo executada com o uso de SQL Server Management Studio em um servidor e cliente com a localidade 1033, da seguinte forma:
Membro |
FORMATTED_VALUE |
Explicação |
---|---|---|
A |
$5,040.00 |
FORMAT_STRING é definido como Currency e LANGUAGE é 1033, informações herdadas do valor de localidade do sistema |
B |
€5.040,00 |
FORMAT_STRING é definido como Currency (herdado de A) e LANGUAGE é definido explicitamente como 1034 (Spain), daí o sinal de Euro, o separador decimal e de milhar diferente. |
C |
$5.040,00 |
FORMAT_STRING é definido como $#,##0.00, uma substituição para Moeda, de A, e LANGUAGE é definido explicitamente para 1034 (Spain). Como a propriedade FORMAT_STRING define explicitamente o símbolo de moeda como $, FORMATTED_VALUE é apresentado com o sinal $. No entanto, como . (ponto) e , (vírgula) são espaços reservados para separadores de decimal e de milhar, a especificação de idioma os afeta gerando uma saída localizada para separadores decimal e de milhar. |
D |
5.04E+03 |
FORMAT_STRING é definido como Scientific e LANGUAGE é definido como 1033, herdados do valor de localidade do sistema, por isso o . (ponto) é o separador decimal. |
E |
5,04E+03 |
FORMAT_STRING é definido como Scientific e LANGUAGE é definido explicitamente como 1034,, por isso a , (vírgula) é o separador decimal. |
F |
50.40% |
FORMAT_STRING é definido como Percent e LANGUAGE é definido como 1033, herdados do valor de localidade do sistema, por isso o . (ponto) é o separador decimal. Observe que VALUE foi alterado de 5040 para 0.5040 |
G |
50,40% |
FORMAT_STRING é definido como Percent, herdado de F, e LANGUAGE é definido explicitamente como 1034, por isso a , (vírgula) é o separador decimal. Observe que VALUE foi herdado do valor F. |
H |
Não |
FORMAT_STRING é definido como YES/NO, VALUE é definido como 0 e LANGUAGE é definido explicitamente como 1034; como não há nenhuma diferença entre English NO e Spanish NO, o usuário não vê diferença em FORMATTED_VALUE. |
I |
SI |
FORMAT_STRING é definido como YES/NO, VALUE é definido como 59 e LANGUAGE é definido explicitamente como 1034; conforme definido para a formatação YES/NO, qualquer valor diferente de zero (0) é um YES e como o idioma é definido como Spanish, FORMATTED_VALUE é SI. |
J |
Desativado |
FORMAT_STRING é definido como ON/OFF, VALUE é definido como 0 e LANGUAGE é definido explicitamente como 1034; conforme definido para a formatação ON/OFF, qualquer valor equivalente a zero (0) é um OFF e, como o idioma está definido para Spanish, FORMATTED_VALUE é Desativado. |
K |
Ativado |
FORMAT_STRING é definido como ON/OFF, VALUE é definido como -312 e LANGUAGE é definido explicitamente como 1034; conforme definido para a formatação ON/OFF, qualquer valor diferente de zero (0) é um ON e como o idioma é definido como Spanish, FORMATTED_VALUE é Ativado. |
with
member measures.A as 'CDate("1959-03-12 06:30")'
member measures.B as measures.A, FORMAT_STRING="Long Date"
member measures.C as measures.A, LANGUAGE=1034 , FORMAT_STRING="General Date"
member measures.D as measures.A, LANGUAGE=1034, FORMAT_STRING="Long Date"
member measures.E as measures.A, LANGUAGE=1041 , FORMAT_STRING="General Date"
member measures.F as measures.A, LANGUAGE=1041 , FORMAT_STRING="Long Date"
member measures.G as measures.A, FORMAT_STRING="Long Time"
member measures.H as measures.A, FORMAT_STRING="Short Time"
member measures.I as measures.A, LANGUAGE=1034 , FORMAT_STRING="Long Time"
member measures.J as measures.A, LANGUAGE=1034 , FORMAT_STRING="Short Time"
member measures.K as measures.A, LANGUAGE=1041 , FORMAT_STRING="Long Time"
member measures.L as measures.A, LANGUAGE=1041 , FORMAT_STRING="Short Time"
Select {measures.A, measures.B, measures.C, measures.D, measures.E, measures.F
, measures.G, measures.H, measures.I, measures.J, measures.K, measures.L} on 0
from [Adventure Works]
cell properties VALUE, FORMAT_STRING, LANGUAGE, FORMATTED_VALUE
Os resultados, transpostos, quando a consulta MDX acima estava sendo executada com o uso de SQL Server Management Studio em um servidor e cliente com a localidade 1033, da seguinte forma:
Membro |
FORMATTED_VALUE |
Explicação |
---|---|---|
A |
3/12/1959 6:30:00 AM |
FORMAT_STRING é definido implicitamente como General Date pela expressão CDate() e LANGUAGE é definido como 1033 (English), herdado do valor de localidade do sistema. |
B |
Quinta-feira, 12 de março de 1959 |
FORMAT_STRING é definido explicitamente como Long Date e LANGUAGE é 1033 (English), herdado do valor de localidade do sistema. |
C |
12/03/1959 6:30:00 |
FORMAT_STRING é definido explicitamente para General Date e LANGUAGE é explicitamente 1034 (Spanish). Observe que o mês e o dia são alternados quando comparados com o estilo de formatação dos EUA |
D |
jueves, 12 de marzo de 1959 |
FORMAT_STRING é definido explicitamente para Long Date e LANGUAGE é explicitamente 1034 (Spanish). Observe que o mês e o dia da semana estão em espanhol |
E |
1959/03/12 6:30:00 |
FORMAT_STRING é definido explicitamente para General Date e LANGUAGE é explicitamente 1041 (Japanese). Observe que a data agora está formatada como Ano/Mês/Dia Hora:Minutos:Segundos |
F |
1959年3月12日 |
FORMAT_STRING é definido explicitamente para Long Date e LANGUAGE é explicitamente 1041 (japonês). |
G |
6:30:00 AM |
FORMAT_STRING é definido explicitamente como Long Time e LANGUAGE é 1033 (English), herdado do valor de localidade do sistema. |
H |
06:30 |
FORMAT_STRING é definido explicitamente como Short Time e LANGUAGE é 1033 (English), herdado do valor de localidade do sistema. |
I |
6:30:00 |
FORMAT_STRING é definido explicitamente para Long Time e LANGUAGE é explicitamente definido como 1034 (Spanish). |
J |
06:30 |
FORMAT_STRING é definido explicitamente para Short Time e LANGUAGE é definido explicitamente como 1034 (Spanish). |
K |
6:30:00 |
FORMAT_STRING é definido explicitamente para Long Time e LANGUAGE é definido explicitamente como 1041 (Japanese). |
L |
06:30 |
FORMAT_STRING é definido explicitamente para Short Time e LANGUAGE é explicitamente 1041 (Japanese). |
Consulte também
Conceitos
Conteúdo de FORMAT_STRING (MDX)
Usando propriedades da célula (MDX)