USERCULTURE

Область применения: вычисление вычисляемого столбца вычисляемой таблицы Меры визуального элемента

Возвращает языковой стандарт (код языка-код страны) для текущего пользователя, определяемый операционной системой, параметрами браузера или службой Power BI.

Примечание. Сейчас эта функция поддерживается только в Power BI Premium на емкость, Power BI Premium на пользователя и Power BI Embedded.

Синтаксис

USERCULTURE()

Параметры

Это выражение не имеет параметров.

Возвращаемое значение

Языковой стандарт в виде строки.

Замечания

  • В службе Power BI языковой стандарт определяется в разделе Параметры>Язык>Параметры языка. Значение по умолчанию определяется языковым параметром браузера пользователя.

  • При использовании в выражениях вычисляемых таблиц и вычисляемых столбцов результат может зависеть от того, в каком режиме находится таблица — DirectQuery или импорт. В режиме DirectQuery результат определяется языком (языковым стандартом), указанным в параметрах языка в службе Power BI. По умолчанию в параметрах языка указывается, что языковой стандарт определяется языковыми настройками браузера пользователя. Это означает, что одна и та же вычисляемая таблица или столбец могут возвращать разные результаты в зависимости от языковых настроек браузера для каждого пользователя. В режиме импорта результат определяется статически во время обновления и не изменяется при выполнении запроса. Для управляемых обновлений, таких как запланированные или интерактивные, языковой стандарт не основывается на параметре языка браузера пользователя. В этом случае используется инвариантный языковой стандарт. Однако инвариантный языковой стандарт можно переопределить с помощью конечной точки XMLA, чтобы указать пользовательский языковой стандарт.

  • В сочетании с функцией параметров поля в Power BI userCULTURE можно использовать для надежного перевода заголовков и подписей динамической визуализации при использовании в выражениях объектов уровня строк (RLS) в той же модели. Однако выражения, содержащие USERCULTURE, вызываемые из-за пределов модели, такие как запросы и меры отчета live-connect, не должны полагаться на правильно переведенные заголовки и субтитры.

  • USERCULTURE возвращает правильный языковой стандарт пользователя при использовании в выражениях объектов, вызываемых из модели, таких как меры, безопасность на уровне строк (RLS) и элементы вычисления. Однако он может не возвращать правильный языковой стандарт пользователя при использовании в выражениях извне модели, таких как запросы и меры отчета live-connect.

  • В отчетах Live-connect USERCULTURE может не возвращать правильный языковой стандарт пользователя при вызове из выражения меры отчета.

Пример

Для следующего выражения

FORMAT(TODAY(), "dddd", USERCULTURE())

в зависимости от языковых параметров текущего пользователя USERCULTURE возвращает текущий день, например:

Локаль Отформатированный день недели
de-DE Dienstag
en-US Tuesday
es-ES_tradnl martes
eu-ES asteartea
it-IT martedì
nl-NL dinsdag
pl-PL wtorek
ro-RO marți
ru-RU вторник
uk-UA вівторок

Заголовки на основе выражений в Power BI
USERNAME
USERPRINCIPALNAME
USEROBJECTID