本页内容

格式化函数

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

info

formatDuration、formatPercentage、formatNumber和formatCurrency仅适用于前端表达式(仪表板、显示内容)。formatDate同时适用于前端表达式和服务器端计算属性。

常见用法

  • 显示日期:

    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支持以下标记:

  • 年:

    yyyy   4-digit year      2024
  • 月:

    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
    mm     Minutes           30
    ss     Seconds           45

时长单位

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

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 毫秒时长
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
备注

仅适用于前端表达式。

相关主题

优化流程,构建互联架构,掌控全局。

无需信用卡,也无需等待,即刻开始。将组织的实际工作方式转化为清晰、互联的流程设计。

构建流程架构,明确职责归属与管控措施,并在各层级统一角色分工。

开始免费试用,为流程治理、管理和持续改进建立可靠的统一基础。