用法
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 设置模型中字段的格式，系统会在 value_format_name 指定的格式之上应用 number_format 用户属性中选择的数字格式。如需查看示例并了解详情，请参阅本地化数字格式文档页面。