このページの内容

書式設定関数

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

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)

日付書式パターンを使ってタイムスタンプを書式設定します。

パラメーター
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 ミリ秒単位の期間
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
注意事項

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

関連トピック

プロセスをより良く設計し、つながりのあるアーキテクチャを構築して、管理を続けましょう。

クレジットカード不要、待ち時間なしですぐにご利用いただけます。組織の業務の進め方を、明確につながるプロセス設計として可視化します。

プロセスアーキテクチャを構築し、オーナーシップと統制を定め、あらゆる階層で役割と責任を明確にします。

無料トライアルを開始して、プロセスのガバナンス、管理、継続的な改善を支える信頼できる基盤を築きましょう。