用量
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 指定的格式。如需範例及更多資訊，請參閱「本地化數字格式」說明文件頁面。