value_format_name

用量

view: 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
}

注意： value_format_name 仅影响字段值在 Looker 内容中的显示方式。value_format_name 不会更改或影响数据库中的值。

默认格式名称

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 用户属性中选择的数字格式。如需查看示例并了解详情，请参阅本地化数字格式文档页面。