데모값 필드 설정표시 서식
같은 값을 통화·단위 축약·접미사로 바꿔 출력하는 데모입니다.
주요 특징
numberFormat은 값을 바꾸지 않고 출력 문자열의 형식을 지정합니다. 아래 표에서 4가지 필드는 완전히 같은 매출 합계이고, 서식만 다르게 설정합니다.
| 값 필드 | numberFormat | 출력 예 |
|---|---|---|
| 기본 서식 | (없음 → 테이블 기본값 #,##0) | 83,232 |
| 통화 | '"$",#,##0.00' | $83,232.14 |
| 천 단위 | '"$",0.0K' | $83.2K |
| 자동 단위 | '"$",0.0@' | 셀은 $83.2K, 총계는 $1.3M |
| 수량 | '#,##0" 개"' | 4,820 개 |
| 분기 비중 | '0.0%' | 12.3% |
값 필드에 numberFormat이 없으면 테이블의 numberFormat이, 비중 계열 showAs에는 percentFormat이 대신 적용됩니다.
코드로 지정하기
테이블 기본 서식은 table에, 필드별 서식은 table.fields.values의 각 항목에 지정합니다.
tables: {
numberFormat: '#,##0', // 값 필드에 numberFormat이 없을 때의 기본값
percentFormat: '0.00%', // 비중 계열 showAs의 기본값
fields: {
values: [
{ name: '기본 서식', measure: '주문금액' },
{ name: '통화', measure: '주문금액', numberFormat: '"$",#,##0.00' },
{ name: '천 단위', measure: '주문금액', numberFormat: '"$",0.0K' },
{ name: '자동 단위', measure: '주문금액', numberFormat: '"$",0.0@' },
{ name: '수량', measure: '주문수량', numberFormat: '#,##0" 개"' },
{ name: '분기 비중', measure: '주문금액', showAs: 'colPercent', numberFormat: '0.0%' },
],
},
}지정할 수 있는 값
| 요소 | 뜻 | 예 |
|---|---|---|
"..." · '...' (앞) | 앞에 붙일 문자열 | '"$",#,##0' → $1,234 |
"..." · '...' (뒤) | 뒤에 붙일 문자열 | '#,##0" 개"' → 1,234 개 |
, | 천 단위 구분 | '#,##0' → 1,234 |
0 | 반드시 표시할 자리 | '0.00' → 1.20 |
# | 있을 때만 표시할 소수 자리 | '0.##' → 1.2 |
% (마지막) | 100배 + % 붙임 | '0.0%' → 12.3% |
K M B T (마지막) | 천 · 백만 · 십억 · 조로 나눔 | '0.0M' → 1.2M |
@ (마지막) | 값 크기에 맞는 단위 자동 선택 | '0.0@' → 4.8K · 1.2M |
s | 양수에도 부호 표시 | 's0.0%' → +12.3% |
a | 부호 없이 절대값 | 'a#,##0' → 1,234 |
스케일 문자는 따옴표를 뺀 서식의 마지막 한 글자로만 인식됩니다. '"$",0.0M'처럼 접두사와 함께 사용할 수 있습니다.
숫자가 아닌 값에는 dateFormat(자료형 date) · textFormat(자료형 text)을 씁니다. 지정하지 않으면 테이블의 같은 이름 옵션이 설정됩니다.
더 자세한 내용은 필드 구성 가이드와 PivotValueFieldOptions에서 확인할 수 있습니다.
플레이그라운드를 불러오는 중…