本页内容

格式化函数

用于格式化显示值的函数。这些函数主要适用于仪表板表达式。

info

格式化函数可用于前端表达式(仪表板、显示内容),但不适用于服务器端计算属性。

常见模式

  • 显示日期:

    formatDate(StartTime, "yyyy-MM-dd")         // 2024-03-15
    formatDate(StartTime, "MMM d, yyyy")        // Mar 15, 2024
    formatDate(StartTime, "HH:mm:ss")           // 14:30:45
    formatDate(StartTime, "EEEE, MMMM d")       // Friday, March 15
  • 格式化时长:

    formatDuration(3600000)                     // "1 h"
    formatDuration(90000, "s")                  // "90 s"
    formatDuration(86400000, "d")               // "1 d"
  • 显示百分比:

    formatPercentage(0.75)                      // "75%"
    formatPercentage(0.333)                     // "33.3%"

日期格式模式

使用date-fns格式模式。formatDate的常用格式 token:

  • 年份:

    yyyy   4-digit year      2024
    yy     2-digit year      24
  • 月份:

    MM     Month (2 digits)  03
    MMM    Month (short)     Mar
    MMMM   Month (full)      March
  • 日期:

    dd     Day (2 digits)    15
    d      Day               15
    EEEE   Day name (full)   Friday
    EEE    Day name (short)  Fri
  • 时间:

    HH     Hour (24h)        14
    hh     Hour (12h)        02
    mm     Minutes           30
    ss     Seconds           45
    a      AM/PM             PM

时长单位

仅适用于前端表达式。使用简短的单位标签:

ms     Milliseconds
s      Seconds
m      Minutes
h      Hours
d      Days
mo     Months
y      Years

formatDate

(timestamp, format)

使用日期格式模式格式化时间戳。

参数
timestamp number 要格式化的时间戳
format string 格式模式,例如'yyyy-MM-dd'或'HH:mm'
返回值 字符串
示例
formatDate(StartTime, "yyyy-MM-dd") 2024-03-18
formatDate(StartTime, "HH:mm") 14:30
备注

支持的标记在前端和Athena中保持一致:yyyy、MM、dd、HH、mm、ss;格式化还支持M、d、H、m、s以及MMM、MMMM、EEE、EEEE。格式化采用UTC语义。

formatDuration

(duration, unit?)

将毫秒表示的时长格式化为易读字符串。

参数
duration number 以毫秒为单位的Duration
unit (可选) string 显示单位:'ms'、's'、'm'、'h'、'd'、'mo'、'y'
返回值 字符串
示例
formatDuration(3600000) 1 h
formatDuration(90000, "s") 90 s
备注

仅可用于前端表达式。使用简短单位标签(s、m、h、d、mo、y)。

formatPercentage

(value)

将小数值格式化为百分比。

参数
value number 小数值(0.5=50%)
返回值 字符串
示例
formatPercentage(0.75) 75%
formatPercentage(1.5) 150%
备注

仅可用于前端表达式。

formatNumber

(value, decimals?)

格式化数字,可选小数位数。仅限前端使用。

参数
value number 要格式化的数字
decimals (可选) number 小数位数
返回值 字符串
示例
formatNumber(1234.5, 2) 1,234.50
备注

仅可用于前端表达式。

formatCurrency

(value, currency, decimals?)

将数字格式化为货币。仅限前端使用。

参数
value number 要格式化的数字
currency string ISO 4217货币代码,例如EUR或USD
decimals (可选) number 小数位数
返回值 字符串
示例
formatCurrency(99.9, "EUR") €99.90
备注

仅可用于前端表达式。

相关主题