为字段添加自定义格式

对于 Looker 开发者:本页中显示的格式与 value_format LookML 参数使用的格式相同,但 value_format 参数要求格式字符串用英文双引号括起来。

通过自定义格式,您可以更好地控制数字数据在 Looker 结果集中的显示方式。借助自定义格式,您可以将 Excel 样式的格式选项应用于可视化图表中显示的数字数据,或由自定义字段或表计算生成的数字数据。

在可视化图表中使用自定义格式

对可视化图表应用自定义格式的步骤会有所不同,具体取决于您使用的是默认探索界面还是传统版探索。

在默认的“探索”界面中使用自定义格式

在“探索”中,您可以在配置面板的样式标签页中设置值的格式,方法是使用基本格式预设(包括紧凑数字)或输入高级自定义格式字符串。

如需在样式标签页中访问值格式设置选项,请展开可视化图表类型对应的部分:

  • 对于单值图表,请展开样式部分。
  • 对于柱形图、条形图、折线图、散点图、面积图和瀑布图,请展开值部分,然后启用值标签。
  • 对于表格图表,请展开系列部分,然后在自定义部分中展开要设置格式的列。

配置基本格式

在值格式部分(或表格图表的格式部分)中,您可以配置以下任何基本格式选项:

  • 紧凑数字:使用标准度量后缀缩写 1,000 或更大的数字:K 表示千,M 表示百万,B 表示十亿,T 表示万亿。默认情况下,此选项处于停用状态。
  • 小数精度:指定要显示的小数位数(Default、0 或 1 到 8)。启用紧凑数字后,默认会显示两位小数(例如,1,845 会显示为 1.85K)。选择 0 会将值四舍五入为整数(例如 2K)。
  • 显示格式:应用标准显示预设:
    • 默认:使用底层数据源的默认格式显示数值。
    • 数字:将值显示为带有千位分隔符的标准数字。
    • 百分比:将值显示为带百分号 (%) 的百分比。
    • 财务:显示带有本地货币符号(例如 $)的值。

配置高级格式

如需应用 Excel 样式的自定义格式字符串(而非基本预设),请按以下步骤操作:

  1. 在值格式部分(或表格图表的格式部分)中,点击切换到高级格式。
  2. 在自定义格式规则字段中,输入自定义格式字符串。

如需返回基本格式控件,请点击切换到基本格式。您选择的任何基本格式选项都会覆盖您的自定义格式规则。

在传统版“探索”中使用自定义格式

如需在传统版探索中对柱形图、条形图、折线图、散点图、面积图、瀑布图、单值图或时间表图应用自定义格式,请按以下步骤操作:

  1. 选择可视化栏上的修改菜单。
  2. 选择值标签页(对于单值图和时间表图,请选择样式标签页)。
  3. 在值格式字段中,输入自定义格式字符串。

如需在传统版“探索”中对表格可视化图表应用自定义格式,请按以下步骤操作:

  1. 选择可视化栏上的修改菜单。
  2. 选择系列图书标签页。
  3. 在自定义部分,选择格式下拉菜单,然后选择自定义…。

选择自定义…后,系统会显示一个新的空白字段。在空白字段中输入自定义格式字符串。

将自定义格式与表计算和自定义字段搭配使用

创建或修改表计算或自定义字段时,请在格式下拉菜单中选择自定义选项,然后在空白字段中输入自定义格式。

自定义格式设置示例

您可以参阅 Excel 的数字格式代码文档页面,了解如何指定这些格式,也可以使用第三方工具(例如 Custom Formats Builder)构建自定义格式。

下表列出了一些最常见的格式设置选项。如果数字的位数少于代码中指定的位数,则使用 0 的格式代码会要求显示非有效零。使用 # 的格式代码仅显示有效数字,即使数字位数少于代码中指定的位数也是如此。

某些特殊字符(例如国际货币符号)必须视为字符串,并用英文双引号括起来。

格式结果
0整数 (123)
00#整数,用零填充至 3 位 (001)
0 "String"整数后跟字符串 (123 String)

(“String”可替换为任意文本字符串)
0.##最多 2 位小数的数字(1.、1.2 或 1.23)
0.00数字(小数点后正好 2 位,例如 1.23)
00#.00数字用零填充到 3 位,且正好有 2 位小数 (001.23)
#,##0千位分隔符为英文逗号的数字 (1,234)
#,##0.00数字,千位分隔符为英文逗号,小数点后 2 位 (1,234.00)
0.000,, "M"以百万为单位的数字,小数点后 3 位 (1.234 M)

系统会自动除以 100 万
0.000, "K"以千为单位的数字,保留 3 位小数 (1.234 K)

系统会自动除以 1,000
$0美元,不带小数位 ($123)
$0.00美元(小数点后 2 位,例如 $123.00)
"€"0欧元,不带小数 (€123)
$#,##0.00美元,千位分隔符为英文逗号,保留 2 位小数 ($1,234.00)
$#.00;($#.00)美元,保留 2 位小数,正值正常显示,负值用括号括起来
0\%显示为百分比,不带小数(1 变为 1%)
0.00\%显示为百分比,保留 2 位小数(1 变为 1.00%)
0%转换为不带小数的百分比(.01 变为 1%)
0.00%转换为保留 2 位小数的百分比(.01 变为 1.00%)

自定义千位分隔符和条件格式

Looker 使用 Excel 样式的格式设置规则。虽然 Looker 会将英文逗号识别为千位分隔符,但会将其他字符(例如用于瑞士法郎 [CHF] 的单引号)视为字面量字符。

如果您直接使用单引号作为千位分隔符(例如 "CHF "#'##0.00),格式设置引擎会将单引号视为字面量字符,并强制将其放入输出字符串中,即使值小于 1,000 也是如此(例如 CHF '20.00,而不是 CHF 20.00)。

如需仅对 1,000 及以上的数字应用自定义千位分隔符,请在格式字符串中使用条件格式。您可以为大于或等于 1,000 的数字和小于 1,000 的数字指定不同的格式规则,并用分号分隔:

[>=1000]"CHF "#'##0.00;[<1000]"CHF "0.00

对于在 LookML 中使用 value_format 参数的 Looker 开发者,请用英文双引号将格式字符串括起来,并对内部英文双引号进行转义:

value_format: "[>=1000]\"CHF \"#'##0.00;[<1000]\"CHF \"0.00"

图表的时间格式

如果图表的 X 轴上有时间维度,您可以使用可视化选项的 X 标签页中的时间标签格式设置来更改 X 轴标签的格式。您可以使用图表的时间格式设置页面上的语法来设置时间值的格式。