용도
dimension: field_name {
value_format:"$#.00;($#.00)"
}
}
|
계층 구조
value_format |
가능한 필드 유형
측정기준, 측정결제 가능
Excel 스타일 형식이 포함된 문자열 |
정의
value_format 매개변수를 사용하면 Excel 스타일 형식을 사용하여 Looker의 데이터 값의 형식을 지정할 수 있습니다. 다음과 같은 방법으로 value_format를 사용할 수 있습니다.
- Excel 스타일의 형식을 특정 측정기준 또는 측정값에 직접 적용하기 위해 입력란 수준에서 자체적으로 적용합니다.
- 모델 수준에서
named_value_format매개변수의 하위 매개변수로 사용하여 여러 필드에 적용할 수 있는 재사용 가능한 맞춤 형식 만들기
측정기준 및 측정값에 직접 value_format 적용
value_format 매개변수는 측정기준 및 측정값에 모두 사용할 수 있습니다. value_format을 통해 측정기준에 Excel 스타일 형식을 적용하려면 측정기준 유형이 number이어야 합니다. value_format를 통해 측정값에 Excel 스타일 형식을 적용하려면 측정값이 type: string가 아닌 숫자여야 합니다. 예를 들면 다음과 같습니다.
dimension: order_amount {
type: number
sql: ${TABLE}.order_amount ;;
value_format: "$#.00;($#.00)"
}
measure: total_order_amount {
type: sum
sql: ${order_amount} ;;
value_format: "$#.00;($#.00)"
}
value_format를 사용하여 재사용 가능한 맞춤 형식 정의하기
value_format를 named_value_format와 함께 사용하여 재사용 가능한 형식을 정의하는 방법에 관한 자세한 내용은 named_value_format 매개변수의 문서 페이지를 참고하세요.
기본 서식 지정 옵션
Looker의 내장 값 형식 중 하나를 적용하려는 경우 value_format_name 매개변수 문서 페이지의 기본 형식 이름 섹션에 나열된 형식 중에서 선택할 수 있습니다. value_format_name를 사용하여 기본 제공 형식을 적용하는 방법에 관한 안내는 이 페이지를 참고하세요.
일반적인 형식 지정 문자열
value_format에서는 Excel 스타일의 형식 지정 문자열을 사용할 수 있습니다.
value_format매개변수와 함께 사용되는 형식은 시각화의 값 형식 필드에 사용되는 형식과 동일합니다. 단,value_format매개변수는 형식 문자열을 큰따옴표로 묶어야 합니다. 시각화의 값 형식에 대한 자세한 내용은 열 차트 옵션 문서 페이지를 참조하세요.
이러한 형식 지정 방법에 관한 Excel의 전체 가이드는 문서를 참고하세요. 그러나 현재 Looker에서는 날짜 형식 지정, 색상 형식 지정, 16진수 변환이 지원되지 않습니다.
가장 일반적인 형식 옵션이 여기에 표시됩니다. 국제 통화 기호와 같은 일부 특수문자는 큰따옴표로 묶어야 합니다.
value_format: "0" # Integer (123)
value_format: "*00#" # Integer zero-padded to 3 places (001)
value_format: "0 \" String\"" # Integer followed by a string (123 String)
# Note \"String\" can be replaced with any other word
value_format: "0.##" # Number up to 2 decimals (1. or 1.2 or 1.23)
value_format: "0.00" # Number with exactly 2 decimals (1.23)
value_format: "*00#.00" # Number zero-padded to 3 places and exactly 2 decimals (001.23)
value_format: "#,##0" # Number with comma between thousands (1,234)
value_format: "#,##0.00" # Number with comma between thousands and 2 decimals (1,234.00)
value_format: "0.000,,\" M\"" # Number in millions with 3 decimals (1.234 M)
# Note division by 1 million happens automatically
value_format: "0.000,\" K\"" # Number in thousands with 3 decimals (1.234 K)
# Note division by 1 thousand happens automatically
value_format: "$0" # Dollars with 0 decimals ($123)
value_format: "$0.00" # Dollars with 2 decimals ($123.00)
value_format: "\"€\"0" # Euros with 0 decimals (€123)
value_format: "$#,##0.00" # Dollars with comma btwn thousands and 2 decimals ($1,234.00)
value_format: "$#.00;($#.00)" # Dollars with 2 decimals, positive values displayed
# normally, negative values wrapped in parenthesis
value_format: "0\%" # Display as percent with 0 decimals (1 becomes 1%)
value_format: "0.00\%" # Display as percent with 2 decimals (1 becomes 1.00%)
value_format: "0%" # Convert to percent with 0 decimals (.01 becomes 1%)
value_format: "0.00%" # Convert to percent with 2 decimals (.01 becomes 1.00%)
value_format 매개변수를 사용하는 고급 조건부 서식의 예는 value_format를 사용한 조건부 서식 도움말을 참조하세요.
일반 과제
나눗셈의 소수점 누락
value_format를 사용할 때 발생하는 일반적인 SQL의 한 가지 문제는 SQL이 정수 수학을 처리하는 방법입니다. 5를 2로 나누면 대부분의 사용자는 2.5를 기대합니다. 그러나 많은 SQL 언어에서는 결과를 2로 반환하는데, 그 이유는 두 정수를 나누면 결과를 정수로 제공하기 때문입니다. 이 문제를 해결하려면 분자에 10진수 (예: 1.0 또는 100.0)를 곱하여 SQL에서 소수점 결과를 반환하도록 할 수 있습니다. 예를 들면 다음과 같습니다.
measure: active_users_percent {
type: number
sql: 100.000 * ${active_users} / ${users} ;;
value_format: "0.000"
}
number_format 사용자 속성으로 value_format 사용
value_format를 사용하여 모델의 필드 형식을 지정하는 경우 number_format 사용자 속성에서 선택한 숫자 형식이 value_format으로 적용된 형식 위에 적용됩니다. 이에 대한 예와 자세한 내용은 숫자 형식 현지화 문서 페이지를 참조하세요.