值名称格式

用量

视图：view_name {
dimension: field_name {
value_format_name: format_name
}
}

层次结构 查看文件 view 字段类型 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 参数创建自己的已命名格式。

数字格式

数字字段类型的默认格式如下所示。它们以底层值“0.123456789”开头：

名称	示例
decimal_0	1234
decimal_1	1234.6
decimal_2	1234.57
decimal_3	1234568
decimal_4	1234.5679
usd_0	1,234 美元
usd	1,234.57 美元
gbp_0	£1234
gbp	£1234.57
eur_0	€1234
eur	1234.57 欧元
id	1234

对于数字字段类型，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 指定的格式之上。如需查看示例和了解详情，请参阅本地化数字格式文档页面。