マークアップページの式

式で使える関数と書式を説明します。式の書き方と書ける場所は、記法の「式」を参照してください。

関数

関数	内容
`size(x: list): number`	要素の数を返します（`size(rows)`・`size(param_…)`）。比較には使えますが、計算には使えません。計算に使う数は、SQL で列として返します
`formatNumber(value: number): string`	閲覧者の言語設定の既定の書式で、文字列に変換します
`formatNumber(value: number, "d3", format: string): string`	d3-format の書式で、文字列に変換します
`formatNumber(value: number, "compact", options?: map): string`	省略した形の文字列に変換します（1.2万、12K など）
`formatDate(value: string, "dayjs", format: string): string`	日付・日時を、Day.js の書式で文字列に変換します

第 2 引数（書式の種類）と第 3 引数（書式）には、列や変数を使えません。"d3"・".1%" のように、値を直接書きます。

formatNumber()・formatDate() は、値が NULL のときは空の文字列を返します。

例の結果は、言語設定が日本語のときの値です。

d3-format の書式です。チャートの数値のフォーマッタ（formatter_number）と同じです。

Intl.NumberFormat の compact 表記で、閲覧者の言語設定に合わせて省略した形で表示します。

用途	式	結果
言語設定に合わせて省略	`formatNumber(row.sales, "compact")`	1.2億
省略して小数 1 桁	`formatNumber(row.sales, "compact", {"maximumFractionDigits": 1})`	1.2万

Day.js の書式です。書式の書き方は、チャートの日付のフォーマッタ（formatter_date）と同じです。

ddd・MMM などの名前は、閲覧者の表示言語に従います（Tue / 火）。どの言語でも同じ文字を表示するときは、数字（YYYY/M/D）か [ ] で囲んだ文字を使います
タイムスタンプは、閲覧者のタイムゾーンで表示します。日付と日時は変換しません

用途	式	結果
年と月	`formatDate(row.month, "dayjs", "YYYY年M月")`	2026年9月

param_<パラメータの ID> で参照したときの型です。

パラメータの種類	式での型
テキスト入力（`TEXT_INPUT`）、テキスト選択（`TEXT_SELECT`）	文字列
テキスト複数入力（`TEXT_MULTI_INPUT`）、テキスト複数選択（`TEXT_MULTI_SELECT`）	文字列の配列。`'JP' in param_…`、`size(param_…)` で参照する
数値入力（`NUMBER_INPUT`）、数値選択（`NUMBER_SELECT`）	数値
日付入力（`DATE_INPUT`）	文字列（`YYYY-MM-DD`。文字列として比較すると前後を判定できる）
日付範囲（`DATE_RANGE`）	開始と終了の文字列を、`[0]`（開始）と `[1]`（終了）で参照する
チェックボックス（`CHECKBOX`）	真偽値

env.<名前> で参照します。モバイル表示への切り替えなどで値が変わると、表示し直します。

書き方	型	内容
`env.mobile`	真偽値	モバイル表示かどうか。編集画面でモバイル表示に切り替えたときを含む
`env.print`	真偽値	画像・PDF に出力しているかどうか
`env.dark`	真偽値	ダークモードかどうか
`env.lang`	文字列	画面の表示言語。`'ja'` か `'en'`