格式化函数
用于格式化显示值的函数。这些函数主要用于仪表板表达式。
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)使用日期格式模式格式化时间戳。
| 参数 |
| ||||||
| 返回值 | 字符串 | ||||||
| 示例 | 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?)将毫秒时长格式化为易读的字符串。
| 参数 |
| ||||||
| 返回值 | 字符串 | ||||||
| 示例 | formatDuration(3600000) → 1 h formatDuration(90000, "s") → 90 s | ||||||
| 备注 | 仅适用于前端表达式。使用简短单位标签(s、m、h、d、mo、y)。 |
formatPercentage
(value)将小数格式化为百分比。
| 参数 |
| |||
| 返回值 | 字符串 | |||
| 示例 | formatPercentage(0.75) → 75% formatPercentage(1.5) → 150% | |||
| 备注 | 仅适用于前端表达式。 |
formatNumber
(value, decimals?)格式化数字,可选择小数位数。仅适用于前端。
| 参数 |
| ||||||
| 返回值 | 字符串 | ||||||
| 示例 | formatNumber(1234.5, 2) → 1,234.50 | ||||||
| 备注 | 仅适用于前端表达式。 |
formatCurrency
(value, currency, decimals?)将数字格式化为货币金额。仅适用于前端。
| 参数 |
| |||||||||
| 返回值 | 字符串 | |||||||||
| 示例 | formatCurrency(99.9, "EUR") → €99.90 | |||||||||
| 备注 | 仅适用于前端表达式。 |
相关主题
- 表达式概览:所有表达式函数。
优化流程,构建互联架构,掌控全局。
无需信用卡,也无需等待,即刻开始。将组织的实际工作方式转化为清晰、互联的流程设计。
构建流程架构,明确职责归属与管控措施,并在各层级统一角色分工。
开始免费试用,为流程治理、管理和持续改进建立可靠的统一基础。