格式化函数
用于格式化显示值的函数。这些函数主要适用于仪表板表达式。
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)使用日期格式模式格式化时间戳。
| 参数 |
| ||||||
| 返回值 | 字符串 | ||||||
| 示例 | 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 | |||||||||
| 备注 | 仅可用于前端表达式。 |
相关主题
- 表达式概览:所有表达式函数。