USERCULTURE

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Retorna a localidade (código de país de código de idioma) para o usuário atual, determinada pelo sistema operacional, pelas configurações do navegador ou pelo serviço do Power BI.

Nota: atualmente, essa função tem suporte apenas no Power BI Premium por capacidade, Power BI Premium por usuário e Power BI Embedded.

Sintaxe

USERCULTURE()

Parâmetros

Essa expressão não tem parâmetros.

Valor retornado

Localidade como uma cadeia de caracteres.

Comentários

• No serviço do Power BI, a localidade é determinada por Configurações>Linguagem>Configurações de Linguagem. O padrão é determinado pela configuração de linguagem do navegador do usuário.

• Quando usado em tabela calculada e expressões de coluna calculadas, o resultado pode diferir, dependendo se a tabela estiver no modo DirectQuery ou Import. Quando no modo DirectQuery, o resultado é determinado pela linguagem (localidade) especificada nas Configurações de Linguagem no serviço do Power BI. O padrão nas Configurações de Linguagem especifica que a localidade é determinada pela configuração de linguagem do navegador do usuário, o que significa que a mesma tabela ou coluna calculada pode retornar resultados diferentes, dependendo das configurações de linguagem do navegador para cada usuário. No modo Import, o resultado é determinado estaticamente durante a atualização e não varia no momento da consulta. Para atualizações gerenciadas, como agendadas ou interativas, a localidade não se baseia na configuração de linguagem do navegador do usuário, mas usa uma localidade invariável. No entanto, a localidade invariável pode ser substituída usando o ponto de extremidade XMLA para especificar uma localidade personalizada.

• Quando combinado com o recurso Parâmetros de campo no Power BI, USERCULTURE pode ser usado para traduzir de forma confiável títulos e legendas de visualização dinâmica quando usado em expressões de objeto RLS (segurança em nível de linha) e medida no mesmo modelo. No entanto, expressões que contêm USERCULTURE chamadas de fora do modelo, como consultas e medidas de relatório de conexão dinâmica, não devem ser confiadas para títulos e legendas traduzidos corretamente.

• USERCULTURE retorna a localidade correta do usuário quando usada em expressões de objeto chamadas de dentro do modelo, como medidas, RLS (segurança em nível de linha) e itens de cálculo. No entanto, ele pode não retornar a localidade correta do usuário quando usado em expressões de fora do modelo, como consultas e medidas de relatório de conexão dinâmica.

• Em relatórios do Live-connect, USERCULTURE pode não retornar a localidade correta do usuário quando chamado de uma expressão de medida de relatório.

Exemplo

Use a seguinte expressão,

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

Dependendo da configuração de linguagem do usuário atual, USERCULTURE retorna o dia atual, por exemplo:

Locale	Dia da semana formatado
de-DE	Dienstag
pt-BR	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	вівторок

Conteúdo relacionado

Títulos com base em expressão no Power BI
USERNAME
USERPRINCIPALNAME
USEROBJECTID