用法
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 参数。
常见挑战
将 value_format_name 与 number_format 用户属性搭配使用
如果您使用 value_format_name 设置模型中字段的格式，则在 number_format 用户属性中选择的数字格式将应用于使用 value_format_name 给定的格式之上。如需查看示例并了解详情，请参阅本地化数字格式设置文档页面。