Свойства ячеек MDX - свойства FORMATTED_VALUEMDX Cell Properties - FORMATTED_VALUE Property

Область применения: ДаSQL Server Analysis Services неAzure Analysis ServicesAPPLIES TO: yesSQL Server Analysis Services noAzure Analysis Services

Свойство FORMATTED_VALUE основано на взаимодействии свойств ячейки VALUE, FORMAT_STRING и LANGUAGE.The FORMATTED_VALUE property is built on the interactions of the VALUE, FORMAT_STRING and LANGUAGE properties of the cell. В этом разделе объясняется, как эти свойства взаимодействуют для построения свойства FORMATTED_VALUE.This topic explains how these properties interact to build the FORMATTED_VALUE property.

Свойства VALUE, FORMAT_STRING, LANGUAGEVALUE, FORMAT_STRING, LANGUAGE properties

В следующей таблице описано, что представляют собой эти свойства. Эти сведения помогут сочетать указанные свойства.The following table explains what these properties are, to help prepare us to use them in combination.

VALUEVALUE
Неформатированное значение ячейки.The unformatted value of the cell.

FORMAT_STRINGFORMAT_STRING
Шаблон форматирования, применяемый к значению ячейки для создания свойства FORMATTED_VALUEThe formatting template to be applied to the value of the cell to generate FORMATTED_VALUE property

LANGUAGELANGUAGE
Спецификация локали, применяемая вместе со свойством FORMAT_STRING для создания локализованной версии свойства FORMATTED_VALUEThe locale specification to be applied alongside FORMAT_STRING to generate a localized version of FORMATTED_VALUE

Построение свойства FORMATTED_VALUEFORMATTED_VALUE constructed

Свойство FORMATTED_VALUE строится с помощью значения свойства VALUE и применения шаблона формата, указанного в свойстве FORMAT_STRING для этого значения.The FORMATTED_VALUE property is constructed by using the value from the VALUE property and applying the format template specified in the FORMAT_STRING property to that value. Кроме того, если значением форматирования является литерал именованного форматирования , то спецификация свойства LANGUAGE изменяет вывод свойства FORMAT_STRING так, чтобы следовать языку значения "named formatting".In addition, whenever the formatting value is a named formatting literal the LANGUAGE property specification modifies the output of FORMAT_STRING to follow the language usage for the named formatting. Все значения «named formatting literal» определяются так, что их можно локализовать.Named formatting literals are all defined in a way that can be localized. Например, "General Date" является спецификацией, которую можно локализовать, в противоположность шаблону "YYYY-MM-DD hh:nn:ss", , в котором дата представлена так, как определено шаблоном, независимо от спецификации языка.For example, "General Date" is a specification that can be localized, as opposed to the following template "YYYY-MM-DD hh:nn:ss", which states that the date is to be presented as defined by the template regardless of the language specification.

Если между шаблоном FORMAT_STRING и спецификацией LANGUAGE возникает конфликт, то шаблон FORMAT_STRING переопределяет спецификацию LANGUAGE.If there is a conflict between the FORMAT_STRING template and the LANGUAGE specification, the FORMAT_STRING template overrides the LANGUAGE specification. Например, если FORMAT_STRING="$ #0" и LANGUAGE=1034 (испанский), а VALUE=123.456, то FORMATTED_VALUE="$ 123" вместо FORMATTED_VALUE="€ 123" (ожидаемый формат в евро), так как значение шаблона формата переопределяет указанный языковой стандарт.For example, if FORMAT_STRING="$ #0" and LANGUAGE=1034 (Spain), and VALUE=123.456 then FORMATTED_VALUE="$ 123" instead of FORMATTED_VALUE="€ 123", the expected format is in Euros, because the value of the format template overrides the language specified.

ПримерыExamples

В следующих примерах показан вывод, полученный, когда свойство LANGUAGE использовалось совместно со свойством FORMAT_STRING.The following examples show the output obtained when LANGUAGE is used in conjunction with FORMAT_STRING.

В первом примере показано форматирование численных значений. Во втором примере показано форматирование значений даты и времени.The first example explains formatting numerical values; the second example explains formatting date and time values.

Для каждого примера дан код многомерного выражения.For each example the Multidimensional Expressions (MDX) code is given.

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

Результаты в транспонированном виде выглядят следующим образом, если приведенный выше запрос многомерных выражений запускался с помощью среды Среда SQL Server Management StudioSQL Server Management Studio через сервер, а локаль клиента равна 1033:The results, transposed, when the above MDX query was run using Среда SQL Server Management StudioSQL Server Management Studio over a server and client with locale 1033 are as follows:

ЧленMember FORMATTED_VALUEFORMATTED_VALUE ОбъяснениеExplanation
ОбъектA $ 5 040,00$5,040.00 Свойство FORMAT_STRING имеет значение Currency , свойство LANGUAGE имеет значение 1033, унаследованное от значения локали системы.FORMAT_STRING is set to Currency and LANGUAGE is 1033, inherited from system locale value
BB € 5 040,00€5.040,00 Свойство FORMAT_STRING имеет значение Currency (унаследованное из примера А), а свойству LANGUAGE явно задано значение 1034 (испанский), следовательно, используется знак евро, другой десятичный разделитель и другой разделитель групп разрядов.FORMAT_STRING is set to Currency (inherited from A) and LANGUAGE is explicitly set to 1034 (Spain) hence the Euro sign, the different decimal separator and the different thousand separator.
CC $ 5 040,00$5.040,00 Свойство FORMAT_STRING имеет значение $#,##0.00 , переопределяющее значение Currency из примера А, а свойству LANGUAGE явно задано значение 1034 (испанский).FORMAT_STRING is set to $#,##0.00 an override to Currency, from A, and LANGUAGE is explicitly set to 1034 (Spain). Так как свойство FORMAT_STRING явно задает символ валюты $, свойство FORMATTED_VALUE представлено символом «$».Because the FORMAT_STRING property explicitly set the currency symbol to $, the FORMATTED_VALUE is presented with the $ sign. Но так как . (точка) и , (запятая) являются заполнителями для десятичного разделителя и разделителя групп разрядов соответственно, то спецификация языкового стандарта влияет на них, создавая вывод, локализованный для десятичного разделителя и разделителей групп разрядов.However, because . (dot) and , (comma) are placeholders for decimal separator and thousand separator respectively, the language specification affects them generating an output that is localized for decimal and thousand separators.
DD 5.04E+035.04E+03 Свойство FORMAT_STRING имеет значение Scientific , свойство LANGUAGE имеет значение 1033, унаследованное от значения локали системы, следовательно, десятичным разделителем является . (точка).FORMAT_STRING is set to Scientific and LANGUAGE is set to 1033, inherited from system locale value, hence . (dot) is the decimal separator.
EE 5,04E+035,04E+03 Свойство FORMAT_STRING имеет значение Scientific , а свойству LANGUAGE явно присвоено значение 1034, , следовательно, десятичным разделителем является , (запятая).FORMAT_STRING is set to Scientific and LANGUAGE is set explicitly to 1034, hence , (comma) is the decimal separator.
ЖF 50,40 %50.40% Свойство FORMAT_STRING имеет значение Percent , свойство LANGUAGE имеет значение 1033, унаследованное от значения локали системы, следовательно, десятичным разделителем является . (точка).FORMAT_STRING is set to Percent and LANGUAGE is set to 1033, inherited from system locale value, hence . (dot) is the decimal separator.

Обратите внимание, что VALUE было изменено с 5040 на 0.5040.Note that VALUE was changed from 5040 to 0.5040
ЖG 50,40 %50,40% Свойство FORMAT_STRING имеет значение Percent, унаследованное из примера Е, а свойству LANGUAGE явно присвоено значение 1034 , следовательно, десятичным разделителем является , (запятая).FORMAT_STRING is set to Percent, inherited from F, and LANGUAGE is set explicitly to 1034 hence , (comma) is the decimal separator.

Обратите внимание, что VALUE было унаследовано из значения в примере Е.Note that VALUE was inherited from F value.
ЗH НетNo Свойство FORMAT_STRING имеет значение YES/NO, свойству VALUE присвоено значение 0, а свойству LANGUAGE явно задано значение 1034. Так как нет отличия между английским "NO" и испанским "NO", пользователь не увидит отличий в значениях свойства FORMATTED_VALUE.FORMAT_STRING is set to YES/NO, VALUE is set to 0 and LANGUAGE is set explicitly to 1034; because there is no difference between English NO and Spanish NO the user sees no difference in the FORMATTED_VALUE.
II SISI Свойство FORMAT_STRING имеет значение YES/NO, свойству VALUE присвоено значение 59, а свойству LANGUAGE явно присвоено значение 1034. Как определено форматированием YES/NO, любое значение, отличное от нуля (0), является значением "YES", и, так как указан испанский язык, свойство FORMATTED_VALUE имеет значение "SI".FORMAT_STRING is set to YES/NO, VALUE is set to 59 and LANGUAGE is set explicitly to 1034; as defined for YES/NO formatting, any value different from zero (0) is a YES and because language is set to Spanish then the FORMATTED_VALUE is SI.
КJ DesactivadoDesactivado Свойство FORMAT_STRING имеет значение ON/OFF, свойству VALUE присвоено значение 0, а свойству LANGUAGE явно присвоено значение 1034. Как определено форматированием ON/OFF, любое значение, отличное от нуля (0), является значением "OFF", и, так как указан испанский язык, свойство FORMATTED_VALUE имеет значение "Desactivado".FORMAT_STRING is set to ON/OFF, VALUE is set to 0 and LANGUAGE is set explicitly to 1034; as defined for ON/OFF formatting, any value equal to zero (0) is an OFF and because language is set to Spanish then the FORMATTED_VALUE is Desactivado.
ЛK ActivadoActivado Свойство FORMAT_STRING имеет значение ON/OFF, свойству VALUE присвоено значение -312, а свойству LANGUAGE явно присвоено значение 1034. Как определено форматированием ON/OFF, любое значение, отличное от нуля (0), является значением «ON», и, так как указан испанский язык, свойство FORMATTED_VALUE имеет значение «Activado».FORMAT_STRING is set to ON/OFF, VALUE is set to -312 and LANGUAGE is set explicitly to 1034; as defined for ON/OFF formatting, any value different from zero (0) is an ON and because language is set to Spanish then the FORMATTED_VALUE is Activado.

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

Результаты в транспонированном виде выглядят следующим образом, если приведенный выше запрос многомерных выражений запускался с помощью среды Среда SQL Server Management StudioSQL Server Management Studio через сервер, а локаль клиента равна 1033:The results, transposed, when the above MDX query was run using Среда SQL Server Management StudioSQL Server Management Studio over a server and client with locale 1033 are as follows:

ЧленMember FORMATTED_VALUEFORMATTED_VALUE ОбъяснениеExplanation
ОбъектA 3/12/1959 6:30:00 AM3/12/1959 6:30:00 AM Свойству FORMAT_STRING явно присвоено значение General Date выражением CDate(). Свойство LANGUAGE имеет значение 1033 (английский), унаследованное от значения локали системы.FORMAT_STRING is set implicitly to General Date by the CDate() expression and LANGUAGE is 1033 (English), inherited from system locale value
BB Thursday, March 12, 1959Thursday, March 12, 1959 Свойству FORMAT_STRING явно присвоено значение Long Date . Свойство LANGUAGE имеет значение 1033 (английский), унаследованное от значения локали системы.FORMAT_STRING is set explicitly to Long Date and LANGUAGE is 1033 (English), inherited from system locale value
CC 12/03/1959 6:30:0012/03/1959 6:30:00 Свойству FORMAT_STRING явно присвоено значение General Date . Свойству LANGUAGE явно присвоено значение 1034 (испанский).FORMAT_STRING is set explicitly to General Date and LANGUAGE is explicitly 1034 (Spanish).

Обратите внимание, что месяц и день меняются местами, если сравнивать с американским стилем форматированияNote that month and day are switched when compared to U.S. formatting style
DD jueves, 12 de marzo de 1959jueves, 12 de marzo de 1959 Свойству FORMAT_STRING явно присвоено значение Long Date . Свойству LANGUAGE явно присвоено значение 1034 (испанский).FORMAT_STRING is set explicitly to Long Date and LANGUAGE is explicitly 1034 (Spanish).

Обратите внимание, что месяц и день недели написаны на испанскомNote that month and day of the week are worded in Spanish
EE 1959/03/12 6:30:001959/03/12 6:30:00 Свойству FORMAT_STRING явно присвоено значение General Date . Свойству LANGUAGE явно присвоено значение 1041 (Японский).FORMAT_STRING is set explicitly to General Date and LANGUAGE is explicitly 1041 (Japanese).

Обратите внимание, что формат даты теперь выглядит как Год/Месяц/День Часы:Минуты:СекундыNote that the date is now formatted Year/Month/Day Hour:Minutes:Seconds
ЖF 1959年3月12日1959年3月12日 Свойству FORMAT_STRING явно присвоено значение Long Date . Свойству LANGUAGE явно присвоено значение 1041 (Японский).FORMAT_STRING is set explicitly to Long Date and LANGUAGE is explicitly 1041 (Japanese).
ЖG 6:30:006:30:00 AM Свойству FORMAT_STRING явно присвоено значение Long Time . Свойство LANGUAGE имеет значение 1033 (английский), унаследованное от значения локали системы.FORMAT_STRING is set explicitly to Long Time and LANGUAGE is 1033 (English), inherited from system locale value.
ЗH 06:3006:30 Свойству FORMAT_STRING явно присвоено значение Short Time . Свойство LANGUAGE имеет значение 1033 (английский), унаследованное от значения локали системы.FORMAT_STRING is set explicitly to Short Time and LANGUAGE is 1033 (English), inherited from system locale value.
II 6:30:006:30:00 Свойству FORMAT_STRING явно присвоено значение Long Time . Свойству LANGUAGE явно присвоено значение 1034 (испанский).FORMAT_STRING is set explicitly to Long Time and LANGUAGE is set explicitly to 1034 (Spanish).
КJ 06:3006:30 Свойству FORMAT_STRING явно присвоено значение Short Time . Свойству LANGUAGE явно присвоено значение 1034 (испанский).FORMAT_STRING is set explicitly to Short Time and LANGUAGE is set explicitly to 1034 (Spanish).
ЛK 6:30:006:30:00 Свойству FORMAT_STRING явно присвоено значение Long Time . Свойству LANGUAGE явно присвоено значение 1041 (японский).FORMAT_STRING is set explicitly to Long Time and LANGUAGE is set explicitly to 1041 (Japanese).
LL 06:3006:30 Свойству FORMAT_STRING явно присвоено значение Short Time . Свойству LANGUAGE явно присвоено значение 1041 (японский).FORMAT_STRING is set explicitly to Short Time and LANGUAGE is set explicitly to 1041 (Japanese).

См. такжеSee Also

Строка формата Format_string & #40; Многомерные Выражения & #41; FORMAT_STRING Contents (MDX)
С помощью свойства ячейки & #40; Многомерные Выражения & #41; Using Cell Properties (MDX)
Создание и использование значений свойств & #40; Многомерные Выражения & #41; Creating and Using Property Values (MDX)
Основные принципы запросов многомерных Выражений & #40; Службы Analysis Services & #41;MDX Query Fundamentals (Analysis Services)