書式設定関数
表示用に値を書式設定する関数です。主にダッシュボードの式で使用できます。
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でよく使う書式トークンは次のとおりです。
-
年:
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 | |||||||||
| 注記 | フロントエンドの式でのみ利用できます。 |
関連トピック
- 式の概要:すべての式関数。