このページの内容

書式設定関数

表示用に値を書式設定する関数です。主にダッシュボードの式で使用できます。

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)

日付フォーマットパターンを使ってタイムスタンプを整形します。

パラメーター
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 ミリ秒単位のDuration
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
注記

フロントエンドの式でのみ利用できます。

関連トピック