用途
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 は基になる小数値を取得し、それに 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 パラメータを定義する必要があります。
一般的な課題
number_format ユーザー属性で value_format_name を使用する
モデル内のフィールドの形式を設定するために value_format_name を使用する場合は、選択された number_format ユーザー属性は、value_format_name で指定された形式に加えて適用されます。例と詳細については、数値書式のローカライズのドキュメント ページをご覧ください。