Appearance
マークアップページの式
式で使える関数と書式を説明します。式の書き方と書ける場所は、記法の「式」を参照してください。
関数
| 関数 | 内容 |
|---|---|
size(x: List): number | 要素の数を返します(size(rows)・size(param_…)・size(g.groups)) |
abs(x: number): number | 絶対値を返します(abs(r.mom))。NULL を渡すと NULL です |
least(a: number, b: number, …): number | 最も小さい値を返します(least(r.sales, r.target))。引数に NULL があると NULL です |
greatest(a: number, b: number, …): number | 最も大きい値を返します(greatest(r.sales, r.target))。引数に NULL があると NULL です |
sum(rows: Rows, column: string): number | 列の合計を返します(sum(rows, 'sales')) |
avg(rows: Rows, column: string): number | 列の平均を返します(avg(rows, 'sales')) |
min(rows: Rows, column: string): number | string | 列の最小値を返します(min(rows, 'month'))。数値・日付・日時・文字列の列に使えます |
max(rows: Rows, column: string): number | string | 列の最大値を返します(max(rows, 'rate'))。数値・日付・日時・文字列の列に使えます |
coalesce(a, b, …) | NULL でない最初の値を返します(coalesce(r.owner, '未設定'))。引数はすべて同じ型にします |
search(text: string, columns: string[]): boolean | 文字列が、いずれかの列に含まれるかを返します(search(view.q, [r.name, r.category])) |
inRange(value: number, range: [number, number]): boolean | 数値が範囲に入るか(下限以上・上限以下か)を返します(inRange(r.price, view.price)) |
formatNumber(value: number): string | 閲覧者の言語設定の既定の書式で、文字列に変換します |
formatNumber(value: number, "d3", format: string): string | d3-format の書式で、文字列に変換します |
formatNumber(value: number, "compact", options?: object): string | 省略した形の文字列に変換します(1.2万、12K など) |
formatDate(value: string, "dayjs", format: string): string | 日付・日時を、Day.js の書式で文字列に変換します |
formatNumber()・formatDate()- 第 2 引数(書式の種類)と第 3 引数(書式)には、列や変数を使えません。
"d3"・".1%"のように、値を直接書きます - 値が NULL のときは、空の文字列を返します
- 第 2 引数(書式の種類)と第 3 引数(書式)には、列や変数を使えません。
least()・greatest()・coalesce()の引数は、最大 5 個まで指定できますsum()・avg()・min()・max()- 1 つ目の引数は
rowsか、グループのrows(g.rowsなど)です。2 つ目は列の名前です - 受け取ったすべての行を集計します。
<For>のwhereや<Paginator>のページには左右されません。<ParameterPaginator>の中では、表示中のページの行を集計します - 列の値が NULL の行は除きます。行がないときや、値がすべて NULL のときは NULL を返します
min()・max()は、数値のほかに、日付や文字列の列にも使えます- 結果には表の書式が適用されないため、
formatNumber()などで文字列に変換します - SQL の実行結果が 1,000 行を超えるときは、実行時エラーになります。その場合は、SQL のウィンドウ関数(
SUM(sales) OVER ()など)で列を作ります
- 1 つ目の引数は
search()<TextInput>に入力した文字で一覧を絞り込むときは、<For>のwhereに書きます- 列は、1 つでもリストで書きます(
[r.name])。最大 10 列まで指定できます - 空白で区切って複数の語を書くと、すべての語がいずれかの列に含まれれば、
trueを返します。語ごとに別の列に含まれていてもかまいません - 大文字と小文字、全角と半角は区別しません
- 検索する文字列が空か空白だけのときは、
trueを返します - 探せるのは文字列の列だけです。数値の列は、SQL で文字列に変換します(
CAST(code AS STRING)など)。NULL の列は、空の文字列として扱います
inRange()<RangeSlider>で選んだ範囲に一覧を絞り込むときは、<For>のwhereに書きます- 2 つ目の引数には、
<RangeSlider>の範囲(view.<名前>)を書きます - 範囲が未選択(NULL)のときは、
trueを返します - 値が NULL のときは、
falseを返します
書式の種類
例の結果は、言語設定が日本語のときの値です。
d3
d3-format の書式です。チャートの数値のフォーマッタ(formatter_number)と同じです。
{ }で囲むと、前後に文字を追加できます%は値を 100 倍します。値がすでにパーセントのときは{.1f}%を使います- Excel の書式(
#,##0)は使えません
| 用途 | 式 | 結果 |
|---|---|---|
| 比率(0.123)をパーセントに | formatNumber(row.cvr, "d3", ".1%") | 12.3% |
| すでにパーセントの値(12.3)に % を付ける | formatNumber(row.cvr_pct, "d3", "{.1f}%") | 12.3% |
| 桁区切りと単位 | formatNumber(row.sales, "d3", "{,d}円") | 12,345円 |
| 小数 2 桁 | formatNumber(row.price, "d3", ",.2f") | 1,234.50 |
| 符号を必ず付ける | formatNumber(row.diff, "d3", "+,d") | +120 |
| 万の単位 | formatNumber(row.sales / 10000, "d3", "{,.0f}万円") | 2,594万円 |
compact
Intl.NumberFormat の compact 表記で、閲覧者の言語設定に合わせて省略した形で表示します。
optionsに指定できるのは、{"maximumFractionDigits": 1}のような小数の桁数(0〜3)だけです
| 用途 | 式 | 結果 |
|---|---|---|
| 言語設定に合わせて省略 | formatNumber(row.sales, "compact") | 1.2億 |
| 省略して小数 1 桁 | formatNumber(row.sales, "compact", {"maximumFractionDigits": 1}) | 1.2万 |
dayjs
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 に出力しているかどうか。ブラウザの印刷では false |
env.dark | 真偽値 | ダークモードかどうか |
env.lang | 文字列 | 画面の表示言語。'ja' か 'en' |