書式設定関数
値を表示する形式に整える関数です。主にダッシュボードの式で使用できます。
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 | |||||||||
| 注意事項 | フロントエンドの式でのみ使用できます。 |
関連トピック
- 式の概要:すべての式関数。
プロセスをより良く設計し、つながりのあるアーキテクチャを構築して、管理を続けましょう。
クレジットカード不要、待ち時間なしですぐにご利用いただけます。組織の業務の進め方を、明確につながるプロセス設計として可視化します。
プロセスアーキテクチャを構築し、オーナーシップと統制を定め、あらゆる階層で役割と責任を明確にします。
無料トライアルを開始して、プロセスのガバナンス、管理、継続的な改善を支える信頼できる基盤を築きましょう。