다음을 통해 공유


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를 포함하는 식은 올바르게 번역된 제목 및 캡션에 의존해서는 안 됩니다.

  • USERCULTURE는 측정값, RLS(행 수준 보안) 및 계산 항목과 같은 모델 내에서 호출된 개체 식에 사용되는 경우 올바른 사용자 로캘을 반환합니다. 그러나 쿼리 및 라이브 연결 보고서 측정값과 같이 모델 외부의 식에서 사용되는 경우 올바른 사용자 로캘을 반환하지 않을 수 있습니다.

  • 라이브 연결 보고서에서 USERCULTURE는 보고서 측정값 식에서 호출할 때 올바른 사용자 로캘을 반환하지 않을 수 있습니다.

예시

다음 식의 경우,

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

현재 사용자의 언어 설정에 따라 USERCULTURE가 현재 요일을 반환합니다. 예를 들면 다음과 같습니다.

Locale 서식이 지정된 평일
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 Desktop의 식 기반 제목
USERNAME
USERPRINCIPALNAME
USEROBJECTID