用途
view: view_name {
dimension: field_name {
value_format_name: format_name
}
}
|
階層
value_format_name |
使用可能なフィールドタイプ
ディメンション、メジャー
許可
このドキュメント ページに記載されているデフォルトの値の形式のいずれか、または named_value_format パラメータで作成した形式の名前
|
定義
value_format_name パラメータを使用すると、Looker に組み込まれた形式や、再利用可能な独自のカスタム形式を使用して、データ値を書式設定できます。Excel スタイルの形式を固有のフィールドに直接適用する場合は、代わりに value_format を使用します。
value_format_name パラメータは、ディメンションとメジャーの両方で使用できます。次に例を示します。
measure: total_order_amount {
type: sum
sql: ${order_amount} ;;
value_format_name: usd
}
デフォルトの形式名
Looker には、次の表に示すデフォルトの形式があります。デフォルトの形式のいずれかを使用する場合、Looker は値を切り捨てるのではなく、数値を丸めて桁を削除します。メジャーでデフォルトの形式名を使用すると、メジャーが集計された後に丸めが行われます。
named_value_format パラメータを使用して、独自の名前付き形式を作成することもできます。
数値形式
数値フィールド タイプのデフォルトの形式を次の表に示します。基になる値「1234.56789」から始まります。
| 名前 | 例 |
|---|---|
decimal_0 |
1,235 |
decimal_1 |
1,234.6 |
decimal_2 |
1,234.57 |
decimal_3 |
1,234.568 |
decimal_4 |
1,234.5679 |
usd_0 |
$1,235 |
usd |
$1,234.57 |
gbp_0 |
£1,235 |
gbp |
£1,234.57 |
eur_0 |
€1,235 |
eur |
€1,234.57 |
id |
1235 |
数値フィールド タイプの場合、
idは 16 桁以下の数値にのみ使用してください。16 桁を超えると、idで結果が丸められることがあります。16 桁を超える数値の場合は、文字列としてキャストし、文字列フィールド タイプでidを使用します。
パーセント形式
パーセント形式の場合、Looker は基になる 10 進値を 100 倍してパーセントを取得します。次の例は、基になる値「0.123456」から始まります。
| 名前 | 例 |
|---|---|
percent_0 |
12% |
percent_1 |
12.3% |
percent_2 |
12.35% |
percent_3 |
12.346% |
percent_4 |
12.3456% |
知っておくべきこと
フィールドに value_format_name を適用するには、そのフィールドに type パラメータを定義する必要があります。
一般的な課題
value_format_name を number_format ユーザー属性で使用する
value_format_name を使用してモデル内のフィールドの形式を設定する場合、number_format ユーザー属性で選択した数値形式が、value_format_name で指定した形式に加えて適用されます。例と詳細については、数値書式のローカライズに関するドキュメント ページをご覧ください。