Appearance
Are you an LLM? You can read better optimized documentation at /md/chart-options/value-formatter.md for this page in Markdown format
値の書式設定
概要
- チャートやテーブル内の値は、デフォルトではブラウザのロケール設定に応じて、最適化されます
- 必要に応じて
display_settingsでフォーマッタをカスタマイズすることもできます- フォーマッタをカスタマイズする場合、以下に示すルールに従います
フォーマッタの型定義
フォーマットする対象の値のデータ型によって、以下で設定された formatter_number または formatter_date が適用されます。
ts
type FormatterSettings = {
formatter_number?: string; // 以下の、数値フォーマッタを参照
formatter_date?: string; // 以下の、日付フォーマッタを参照
};数値フォーマッタ
数値のフォーマッタは、d3-formatの書式を利用してフォーマットします。
例えば、以下のように指定することができます。
| 設定値 | 数値 | フォーマット結果 |
|---|---|---|
.0f | 12345.6789 | 12346 |
,.1r | 12345.6789 | 10,000 |
-.1% | 0.5 | 50% |
また、d3-formatの書式を { と } で囲んで、前後にプレフィックスやサフィックスを指定することもできます。
(これはd3-formatの書式ではなく、独自拡張の書式です。詳細は以下の設定例を確認ください)
| 設定値 | 数値 | フォーマット結果 |
|---|---|---|
{,d}円 | 12345.6 | 12,346円 |
約{,d}% | 50 | 約50% |
日付フォーマッタ
日付のフォーマッタは、Day.jsの書式を利用してフォーマットします。
(数値フォーマッタと日付フォーマッタは、入力欄の左端にあるボタンで切り替え式になっている場合があります)
例えば、以下のように指定することができます。
| 設定値 | 日付 | フォーマット結果 |
|---|---|---|
YYYY-MM-DD | 2025-01-01 | 2025-01-01 |
YY/M/D | 2025-01-01 | 25/1/1 |
YYYY年M月 | 2025-01-01 | 2025年1月 |