WPForms Calculationsアドオンで数式を構築するのに役立ちます。数式作成に関する追加情報やヘルプについては、Calculationsアドオンのドキュメントを参照してください。
ルール
- 数値：小数点にはドット（.）のみが許可されます（例：5.20）。桁区切りにはカンマ（,）を使用しないでください。（例：12999.45）
- 文字列は引用符（‘）または二重引用符（“）で囲む必要があります。例：「こんにちは、世界！」、「私の名前はサリです」。
- 数式行の末尾にセミコロンを追加することは任意です。
- 以下にリストされている演算子、変数、条件分岐、関数のみが許可されます。
算術
| 演算子 | 説明 |
|---|---|
| + | 加算 |
| – | 減算 |
| * | 乗算 |
| / | 除算 |
| （ ） | 括弧。最初に計算する数式の一部を囲みます。 |
| % | 剰余。除算の余りを返します。 |
フィールド変数
他のフィールドの値を計算に使用します。
サポートされているフィールドタイプ：一行テキスト、段落テキスト、ドロップダウン、複数選択、チェックボックス、数値、名前、メール、数値スライダー、電話、住所、日付/時刻、ウェブサイト/URL、評価、非表示、チェックボックス項目、複数項目、ドロップダウン項目、単一項目、合計
| 変数パターン | 変数例 | 説明 | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| $FX | $F1 | ID #Xのフィールドの値（1）。 許可されているすべてのフィールドは、フィールドのメイン値を提供します。単純なフィールドは、入力要素の値を指定します。名前（ただし単純なものではない）、住所、チェックボックスなどの複合フィールドには、複合値が含まれます。たとえば、名前フィールドの場合、複合値は[名姓]「John Smith」になります。 注意：$FXに格納されている複合値は、エントリー表示ページに表示されるメインフィールドのエントリ値と同じ書式設定になります。 | ||||||||||
| $FX_subfield | $F1_first | ID #Xのフィールドのサブフィールドの値。 これは複合フィールドに適用されます：
| ||||||||||
| $FX_n | $F1_n | ID #Xのチェックボックスフィールドの選択肢nの値。 値：
これはチェックボックスフィールドおよび支払いチェックボックス項目フィールドにのみ適用されます。 動的選択肢が有効になっている場合、選択肢変数は利用できません。 | ||||||||||
| $FX_amount | $F12_amount | ID #Xの支払いフィールドの金額。 常に数値です。例：9.99。 これは、計算に使用できるすべての支払いフィールドに適用されます： payment-checkbox、payment-multiple、payment-select、payment-single、payment-total |
条件分岐
特定の条件が満たされた場合に異なる数式を使用するように、条件付きステートメントを使用します。
if/else
if ( $F1 > 10 ):
$F1 * 50
else:
0
endif;
if/elseif/else
if ( $F1 < 5.2 ):
$F1 * 50
elseif ( $F1 >= 16 ):
F1 * 25
else:
0
endif;
ヒント
必要なだけelseifステートメントを使用できます。
論理演算子
| 演算子 | 説明 |
|---|---|
| && | 論理積 |
| || | 論理和 |
| ! | 論理否定 |
条件演算子
| 演算子 | 説明 |
|---|---|
| == | 等しい |
| ≠ | 等しくない |
| > | より大きい |
| < | より小さい |
| >= | 以上 |
| <= | 以下 |
関数
数学関数
| 関数/使用法 | 説明 |
|---|---|
| abs( 値 ) | 数値の絶対値を返します |
| average( 値1, [値2, …] ) | 引数の平均値を返します |
| ceil( 値 ) | 数値を切り上げて最も大きい整数を返します |
| exp ( 値 ) | e^x を返します。ここで e はネイピア数、x は指定された引数です |
| floor( 値 ) | 数値以下の最大の整数を返します |
| ln( 値 ) | 底が e の数値の対数を返します |
| log( 値 ) | 底が 10 の数値の対数を返します |
| max( 値1, [値2, …] ) | 引数のリストの中で最大の値を返します |
| min( value1, [value2, …] ) | 引数のリストの中で最小の値を返します |
| pi() | 小数点以下20桁までのπ（パイ）を返します |
| pow( base, exponent ) | 底を指数で累乗した結果を返します |
| rand( min, max ) | ランダムな整数を生成します |
| round( value, precision ) | 数値を最も近い整数に丸めます |
| sqrt( value ) | 数値の平方根を返します |
文字列関数
| 関数/使用法 | 説明 |
|---|---|
| num( string, precision = 14 ) | 文字列を数値に変換します。
精度が指定されている場合、結果の値は小数点以下の指定された桁数に丸められます。 |
| trim( string ) | 文字列の先頭と末尾の空白（または他の文字）を削除します |
| truncate( string, length ) | 文字列の最初のlength文字を返します |
| concat( str1, [str2, …] ) | 引数 str1、str2 … strN をすべて1つの文字列に連結します |
| join( separator, str1, [str2, …] ) | 引数 str1、str2 … strN をセパレータを使用して1つの文字列に結合します |
| format_amount( amount ) | 金額を通貨記号でフォーマットします |
日付/時刻関数
| 関数/使用法 | 説明 |
|---|---|
| now( format = ‘ ‘ ) | 現在の日時を返します。formatはWPFormsの日時文字列形式です。空文字列（デフォルト値）はデフォルト形式d-m-y H:iを意味します。 |
| date_diff( start, end, units = ‘days’, format = ‘ ‘ ) | 時間範囲の長さを単位で計算します。単位：years、months、weeks、days、hours、minutes、seconds。formatはWPFormsの日時文字列形式です。空文字列は、適切な形式を自動的に判断しようとすることを意味します。 |
| years( start, end, format = ‘ ‘ ) | 年単位での期間の長さを計算します。formatはWPFormsの日時文字列フォーマットです。空の文字列は、適切なフォーマットを自動的に判断しようとすることを意味します。 |
| months()、weeks()、days()、hours()、minutes()、seconds() 関数 | 期間の長さを計算します。上記のyears()と同様です。 |
その他の関数
| 関数/使用法 | 説明 |
|---|---|
| debug( value1, [value2, … ] ) | デバッグデータをサーバーのデバッグログと、クライアントサイドで実行された場合にブラウザコンソールに出力します。 |