数式リファレンス（演算子・関数一覧）
テキストや表の列に 数式 を書くと、パラメータの値を計算・整形して表示できます。このページでは、数式の書き方と、使える演算子・関数をすべて説明します。
このページの使い方
- 数式の入れ方（パラメータの作り方・テキストへの埋め込み方）は 変数の基本 を先にお読みください。
- 「和暦で出したい」「明細の合計を出したい」など、目的から探す場合は テンプレートでできること が便利です。
数式を入力する場所
- テキストを選び、「テキスト編集」 を開きます。
- 上部のタブで 「変数・数式」 を選びます。
- 数式入力 欄に数式を書きます。入力中は 評価結果 に計算結果が表示されます。
- 「使用可能な関数・演算子を表示」 を開くと、主な関数と演算子の一覧と例を見られます。
表の列・グラフのラベルや値・チェックボックスの条件にも、同じ書き方の数式を使えます。表の列では、数式は行ごとに計算されます。
例の前提
このページの例は、パラメータに次の値が入っている場合の結果です。
| パラメータ | 値 |
|---|---|
@amount | 1234567 |
@price | 1200 |
@qty | 3 |
@name | 山田 太郎 |
@code | INV-2026-001 |
@invoiceDate | 2026-10-01 |
@paid | false |
@note | ''（空文字） |
書き方の基本
| 書くもの | 書き方 | 例 |
|---|---|---|
| パラメータ | @パラメータ名 | @price、@顧客名 |
| 表の列 | @表名.列名 | @明細.単価（表の列では、その行の値） |
| 文字列 | '...' または "..." | '様'、"円" |
| 数値 | 数字と小数点 | 100、0.1 |
| 真偽値 | true / false | true |
| 関数 | 関数名(引数, 引数, ...) | round(@price, 0) |
| 括弧 | ( ... ) | (1 + 2) * 3 |
- パラメータには必ず
@を付けます。priceのように@が無いとパラメータを参照しません。 - 関数名は 大文字・小文字を区別 します。
ifは使えますが、IFは「Unknown function: IF」というエラーになります。 - 数値は
1e3のような指数表記や、.5のように小数点から始まる書き方はできません（0.5と書きます）。 - 文字列の中で改行を入れるときは
\nと書きます。囲みと同じ引用符は\'/\"と書きます。 - 空白や改行は自由に入れられます。
演算子
| 種類 | 演算子 | 意味 | 例 → 結果 |
|---|---|---|---|
| 算術 | + | 足し算 | @price + 100 → 1300 |
| 算術 | - | 引き算（-@price のように符号にも使える） | @price - 200 → 1000 |
| 算術 | * | 掛け算 | @price * @qty → 3600 |
| 算術 | / | 割り算 | 10 / 4 → 2.5 |
| 算術 | % | 割り算の余り | 10 % 3 → 1 |
| 比較 | == / != | 等しい / 等しくない | @code == 'INV-2026-001' → true |
| 比較 | > < >= <= | 大小の比較 | @price > 1000 → true |
| 論理 | and | かつ | @price > 1000 and @qty < 5 → true |
| 論理 | or | または | @price > 5000 or @qty > 1 → true |
| 論理 | not | 否定 | not @paid → true |
気をつけたいところ
+は文字列をつなぎません。 両辺を数値として足します（'1' + '2'→3）。文字列をつなぐときはconcat()を使います。==/!=は型も比べます。 数値の1と文字列の'1'は等しくありません（1 == '1'→false）。><>=<=は数値として比べます（'10' > '9'→true）。- 0 で割ると空欄 になります（
10 / 0、10 % 0）。 - 数値にできない値の計算は
NaNと表示されます（'a' + 1→NaN）。 - 小数の計算では誤差が出ることがあります（
0.1 + 0.2→0.30000000000000004）。表示するときはround()で丸めてください。
計算の順番
先に計算されるものから順に並べます。同じ段のものは左から計算します。
- 括弧
( ... )、関数 - 符号
-、not */%+-- 比較
==!=><>=<= andor
and と or は同じ順番です多くのプログラミング言語と違い、and は or より先に計算されません。左から順に計算します。たとえば 1 or 0 and 0 は (1 or 0) and 0 と同じで、結果は false です。and と or を混ぜるときは、必ず括弧を付けてください。
@price > 1000 and (@qty == 0 or @qty > 10)
関数一覧
「一覧」の列は、エディタの 「使用可能な関数・演算子を表示」 に載っているかどうかです。載っていない関数も、数式入力欄に直接書けば使えます（入力欄の色分けでは、一覧に無い関数名は一覧外として表示されます）。
条件・論理
| 関数 | 書き方 | 説明 | 例 → 結果 | 一覧 |
|---|---|---|---|---|
if | if(条件, 真のとき, 偽のとき) | 条件で値を切り替える | if(@price > 1000, '高い', '安い') → 高い | あり |
and | and(値1, 値2, ...) | すべて真なら true | and(1, true) → true | なし |
or | or(値1, 値2, ...) | どれかが真なら true | or(0, '') → false | なし |
not | not(値) | 真偽を反転 | not(@paid) → true | なし |
isEmpty | isEmpty(値) | 値が無ければ true（型に関係なく判定） | if(isEmpty(@note), '特になし', @note) → 特になし | あり |
0、空文字、falseは偽として扱います。if()は 3 つの引数をすべて書いてください。偽のときの値を省略すると、条件が偽のときにエラーになります。何も表示したくないときは''を書きます。- 演算子の
and/or/notと同じ意味です。条件をつなぐ場合は演算子の形（@a > 0 and @b > 0）が読みやすくなります。
isEmpty が「値が無い」とみなすもの
| 値 | isEmpty の結果 |
|---|---|
| 値が入っていないパラメータ、存在しないパラメータ | true |
| 空文字、空白だけの文字（半角・全角の空白、改 行） | true |
0、false、'0'、文字のある文字列、日付 | false |
ifの条件では偽になる0やfalseも、isEmptyでは「値がある」とみなします。金額が0のときもfalseです。- 値があるかを判定するときは
not(isEmpty(@note))と書きます。 - 表の列（
@明細.備考）は、表の中では行ごとに判定します。表の外で使うと列の値をまとめて判定するため、明細が 1 行以上あれば（その値が空でも）false、明細が 0 行ならtrueになります。 - 表そのもの（
@明細）は判定できません。行があってもtrueになるので、明細が 0 行かの判定には使えません。
文字列
| 関数 | 書き方 | 説明 | 例 → 結果 | 一覧 |
|---|---|---|---|---|
concat | concat(値1, 値2, ...) | 文字をつなげる | concat(@name, ' 様') → 山田 太郎 様 | あり |
length | length(文字列) | 文字数 | length(@code) → 12 | あり |
left | left(文字列, 文字数) | 先頭から取り出す | left(@code, 3) → INV | なし |
right | right(文字列, 文字数) | 末尾から取り出す | right(@code, 3) → 001 | なし |
mid | mid(文字列, 開始位置, 文字数) | 途中から取り出す | mid(@code, 4, 4) → 2026 | なし |
trim | trim(文字列) | 前後の空白を取る | trim(' ABC ') → ABC | なし |
upper | upper(文字列) | 大文字にする | upper('abc') → ABC | なし |
lower | lower(文字列) | 小文字にする | lower('ABC') → abc | なし |
replace | replace(文字列, 探す文字, 置き換える文字) | 文字を置き換える | replace(@code, '-', '/') → INV/2026/001 | なし |
replaceAll | replaceAll(文字列, 探す文字, 置き換える文字) | replace と同じ | replaceAll(@code, '-', '') → INV2026001 | なし |
concat()は数値や真偽値もそのまま文字にしてつなぎます（concat('a', 1, true)→a1true）。mid()の開始位置は 0 から数えます（1 文字目が0）。right(文字列, 0)は文字列全体を返します。replace()は見つかった箇所を すべて 置き換えます。探す文字は文字そのものとして扱います（正規表現ではありません）。
数値
| 関数 | 書き方 | 説明 | 例 → 結果 | 一覧 |
|---|---|---|---|---|
comma | comma(数値) | 3 桁ごとにカンマを入れる | comma(@amount) → 1,234,567 | あり |
round | round(数値, 小数の桁数) | 四捨五入 | round(1234.567, 2) → 1234.57 | あり |
floor | floor(数値) | 切り捨て（小さい方の整数） | floor(1234.5) → 1234 | あり |
ceil | ceil(数値) | 切り上げ（大きい方の整数） | ceil(1234.1) → 1235 | あり |
abs | abs(数値) | 絶対値 | abs(-10) → 10 | あり |
max | max(数値1, 数値2, ...) | 最大値 | max(10, 20, 5) → 20 | あり |
min | min(数値1, 数値2, ...) | 最小値 | min(10, 20, 5) → 5 | あり |
comma()の小数は最大 3 桁で丸めます（comma(1234.5678)→1,234.568）。結果は文字列なので、そのあと計算には使えません。round()の桁数を省略すると整数に丸めます（round(1234.5)→1235）。桁数を負にすると十の位より上で丸めます（round(1234.5, -2)→1200）。round()で.5は大きい方に丸めます。負の数ではround(-2.5)→-2です。floor()/ceil()は整数に丸めます。負の数ではfloor(-3.2)→-4です。小数の位置で切り捨てたいときはfloor(@price * 100) / 100のように書きます。- 数値にできない値を渡すとエラーになります（
comma('abc')）。
型の変換
| 関数 | 書き方 | 説明 | 例 → 結果 | 一覧 |
|---|---|---|---|---|
text | text(値) | 文字列にする | text(123) → 123 | なし |
number | number(値) | 数値にする | number('12.5') + 1 → 13.5 | なし |
number()に数値にできない値を渡すとエラーになります。空文字は0になります。
日付
| 関数 | 書き方 | 説明 | 例 → 結果 | 一覧 |
|---|---|---|---|---|
dateFormat | dateFormat(日付, 書式, タイムゾーン) | 日付を書式どおりの文字にする | dateFormat(@invoiceDate, 'YYYY年M月D日') → 2026年10月1日 | あり |
dateAdd | dateAdd(日付, 量, 単位, タイムゾーン) | 日付を進める・戻す | dateFormat(dateAdd(@invoiceDate, 30, 'days'), 'YYYY年M月D日') → 2026年10月31日 | あり |
dateDiff | dateDiff(日付1, 日付2, 単位, タイムゾーン) | 2 つの日付の差（日付2 − 日付1） | dateDiff('2026-01-01', '2026-01-31', 'days') → 30 | あり |
now | now() | 計算した時点の日時 | dateFormat(now(), 'YYYY/MM/DD') | あり |
-
日付は
2026-10-01の形の文字列で渡します。時刻付き（2026-01-15T00:30:00Z）も使えます。 -
タイムゾーン は省略できます。省略するとワークスペースの設定、それも無ければ日本時間（
Asia/Tokyo）で計算します。指定するときは'UTC'、'America/New_York'のような名前で書きます。dateFormat('2026-01-15T00:30:00Z', 'YYYY-MM-DD HH:mm') → 2026-01-15 09:30
dateFormat('2026-01-15T00:30:00Z', 'YYYY-MM-DD HH:mm', 'UTC') → 2026-01-15 00:30 -
dateAdd()とnow()の結果は日付のままです。表示するときはdateFormat()で包んでください。 -
dateAdd()の量を負にすると日付を戻します（dateAdd(@invoiceDate, -1, 'years')→ 2025-10-01）。月末を越えるときは月末に合わせます（2026-01-31の 1 か月後は2026-02-28）。 -
dateDiff()の端数は切り捨てます（2026-01-31から2026-03-30はmonthsで1）。日付を逆にすると負の数になります。 -
dateFormat()に渡した日付が空のときは空欄になります。
単位
dateAdd() / dateDiff() の単位には days（日）、months（月）、years（年）、hours（時間）、minutes（分）を使えます。
書式の記号
| 記号 | 意味 | 2026-10-01 の場合 |
|---|---|---|
YYYY | 西暦 4 桁 | 2026 |
M / MM | 月 / 月（0 埋め） | 10 / 10 |
D / DD | 日 / 日（0 埋め） | 1 / 01 |
H / HH | 時（24 時間） / 時（0 埋め） | |
m / mm | 分 / 分（0 埋め） | |
GGGG | 元号 | 令和 |
G | 元号の頭文字 | R |
y / yy | 和暦の年 / 和暦の年（0 埋め） | 8 / 08 |
E | 曜日（短い形） | 木 |
EEEE | 曜日 | 木曜日 |
[...] | 囲んだ文字をそのまま出す | [発行日:] YYYY/MM/DD → 発行日: 2026/10/01 |
dateFormat(@invoiceDate, 'YYYY/MM/DD') → 2026/10/01
dateFormat(@invoiceDate, 'GGGGy年M月D日') → 令和8年10月1日
dateFormat(@invoiceDate, 'Gyy.MM.DD') → R08.10.01
dateFormat(@invoiceDate, 'M月D日(E)') → 10月1日(木)
和暦の詳しい扱い（改元日、「元年」表記）は テンプレートでできること「和暦」 をご覧ください。
ページ番号
| 関数 | 書き方 | 説明 | 一覧 |
|---|---|---|---|
currentPage | currentPage() | 今のページ番号 | なし |
page | page() | currentPage() と同じ | あり |
totalPages | totalPages() | 全ページ数 | なし |
maxPage | maxPage() | totalPages() と同じ | あり |
concat(currentPage(), ' / ', totalPages()) → 1 / 3（3 ページの 1 ページ目）
文字色
| 関数 | 書き方 | 説明 | 例 | 一覧 |
|---|---|---|---|---|
colored | colored(文字, 色) | 文字色を付ける | colored(@name, '#D32F2F') | あり |
coloredIf | coloredIf(条件, 文字, 真のときの色, 偽のとき の色) | 条件で文字色を切り替える | coloredIf(@balance < 0, @balance, '#D32F2F', '#000000') | あり |
- 色は
#RRGGBB（例:#D32F2F）または透明度付きの#RRGGBBAAで書きます。'red'のような色名はエラーになります。 coloredIf()は、使われない側の色も正しい形で書いてください。どちらかが正しくないとエラーになります。
エラーになる書き方
エディタでは、数式に誤りがあるとエラーが表示され、「確定」 を押せません。
| 書き方 | 理由 |
|---|---|
IF(@price > 1000, 'a', 'b') | 関数名の大文字・小文字が違う（if と書く） |
comma('abc') | 数値にできない値を数値の関数に渡している |
colored('A', 'red') | 色を #RRGGBB の形で書いていない |
max() | 引数が 1 つも無い |
1 = 1 | = という演算子は無い（等しいかの比較は ==） |
'閉じていない文字列 | 引用符が閉じていない |
price | パラメータに @ が付いていない |
できないこと
- 表の列をまとめて合計する関数（
SUM相当）はありません。合計値はパラメータとして渡してください（表の列の合計）。