Skip to content

値の書式設定

概要

  • チャートやテーブル内の値は、デフォルトではブラウザのロケール設定に応じて、最適化されます
  • 必要に応じて display_settings でフォーマッタをカスタマイズすることもできます
    • フォーマッタをカスタマイズする場合、以下に示すルールに従います

フォーマッタの型定義

フォーマットする対象の値のデータ型によって、以下で設定された formatter_number または formatter_date が適用されます。

ts
type FormatterSettings = {
  formatter_number?: string;  // 以下の、数値フォーマッタを参照
  formatter_date?: string;  // 以下の、日付フォーマッタを参照
};

数値フォーマッタ

数値のフォーマッタは、d3-formatの書式を利用してフォーマットします。

例えば、以下のように指定することができます。

設定値数値フォーマット結果
.0f12345.678912346
,.1r12345.678910,000
-.1%0.550%

また、d3-formatの書式を {} で囲んで、前後にプレフィックスやサフィックスを指定することもできます。
(これはd3-formatの書式ではなく、独自拡張の書式です。詳細は以下の設定例を確認ください)

設定値数値フォーマット結果
{,d}円12345.612,346円
約{,d}%50約50%

日付フォーマッタ

日付のフォーマッタは、Day.jsの書式を利用してフォーマットします。
(数値フォーマッタと日付フォーマッタは、入力欄の左端にあるボタンで切り替え式になっている場合があります)

例えば、以下のように指定することができます。

設定値日付フォーマット結果
YYYY-MM-DD2025-01-012025-01-01
YY/M/D2025-01-0125/1/1
YYYY年M月2025-01-012025年1月