USERCULTURE

适用于:计算列计算表度量值视觉计算

返回当前用户的区域设置(语言代码-国家/地区代码),该设置由操作系统、浏览器设置或 Power BI 服务确定。

注意:目前仅 Power BI Premium per capacity、Power BI Premium per user 和 Power BI Embedded 支持此函数。

语法

DAX
USERCULTURE()

parameters

此表达式没有参数。

返回值

字符串形式的区域设置。

注解

  • 在 Power BI 服务中,区域设置由“设置”>“语言”>“语言设置”确定。 默认值由用户的浏览器语言设置确定。

  • 在计算表和计算列表达式中使用时,结果可能会有所不同,具体取决于表是处于 DirectQuery 还是导入模式。 在 DirectQuery 模式下,结果由 Power BI 服务的“语言设置”中指定的语言(区域设置)确定。 “语言设置”中的默认值指定区域设置由用户的浏览器语言设置确定,这意味着同一计算表或列可以根据每个用户的浏览器语言设置返回不同的结果。 在导入模式下,结果在刷新期间静态确定,并且在查询时不会变化。 对于托管刷新(例如计划的或交互式托管刷新),区域设置不基于用户的浏览器语言设置,而是保持固定。 但可以通过使用 XMLA 终结点指定自定义区域设置来覆盖固定的区域设置。

  • 当 USERCULTURE 与 Power BI 中的“字段参数”功能结合使用时,如果用于同一模型内的度量值和行级别安全性 (RLS) 对象表达式,它可用于可靠地转换动态可视化效果标题和字幕。 但是,不应依赖包含从模型外部调用的 USERCULTURE 的表达式(例如查询和实时连接报表度量值)来获取正确转换的标题和字幕。

  • 在从模型中调用的对象表达式(如度量值、行级安全性 (RLS) 和计算项)中使用 USERCULTURE 时,它会返回正确的用户区域设置。 但是,在模型外部的表达式中使用时(例如查询和实时连接报表度量值),它可能不会返回正确的用户区域设置。

  • 在实时连接报表中,当从报表度量值表达式调用时,USERCULTURE 可能不会返回正确的用户区域设置。

示例

对于以下表达式:

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

根据当前用户的语言设置,USERCULTURE 返回当前日期,例如:

Locale 已设置格式的工作日
de-DE Dienstag
zh-CN 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