このドキュメントは、WPForms Calculations アドオンで数式を作成するのに役立ちます。その他の情報や計算式の作成については、Calculationsアドオンのドキュメントを参照してください。
ルール
- 数字：小数点として使用できる記号はドット(.)のみです（例：5.20）。千の位にはカンマ（,）を使用しないでください。(例：12999.45)
- 文字列は引用符（'）または二重引用符（"）で囲む。例私の名前はサリーです。
- 計算式の行末にセミコロンを付けるのは任意である。
- 以下の演算子、変数、条件文、関数のみが使用可能です。
算術
| オペレーター | 説明 |
|---|---|
| + | 追加 |
| - | 引く |
| * | 乗算 |
| / | 分割する |
| ( ) | 括弧；最初に計算する式の一部を囲む |
| % | Modulo; 除算の余りを返す。 |
フィールド変数
他のフィールドの値を計算に使用する。
サポートされるフィールドタイプ： Single Line Text, Paragraph Text, Dropdown, Multiple Choice, Checkboxes, Number, Name, Email, Number Slider, Phone, Address, Date / Time, Website / URL , Rating, Hidden, Checkbox Items, Multiple Items, Dropdown Items, Single Item, Total
| 可変パターン | 変数の例 | 説明 | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ドルFX | $F1 | ID#X(#1) を持つフィールドの値。 許可されたフィールドはすべて、そのフィールドの主な値を提供する。単純なフィールドは入力要素の値を提供します。名前（ただし単純なものではない）、住所、チェックボックスなどのような複合フィールドは、複合値を持ちます。例えば、Nameフィールドの場合、複合値は[first last] "John Smith "です。 注意:$FXに格納される複合値は、エントリービューページに表示されるメインフィールドの入力値と同じフォーマットを持っています。 | ||||||||||
| FX_サブフィールド | F1_ファースト | の値である。 サブフィールド ID#を持つフィールドのX. これは複合フィールドに適用される：
| ||||||||||
| FX_n | F1_n | の値である。 選択肢 というIDを持つチェックボックスフィールドのX. 価値だ：
これはCheckboxesフィールドとPayment Checkbox Itemsフィールドにのみ適用されます。 ダイナミックチョイスが有効になっている場合、選択変数は使用できません。 | ||||||||||
| FX_金額 | F12_金額 | 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 必要に応じて
論理演算子
| オペレーター | 説明 |
|---|---|
| && | 論理 AND |
| || | 論理OR |
| ! | 論理的NOT |
条件演算子
| オペレーター | 説明 |
|---|---|
| == | 同等 |
| != | 同等ではない |
| > | より大きい |
| < | 未満 |
| >= | 以上 |
| <= | 以下 |
機能
数学関数
| 機能/用途 | 説明 |
|---|---|
| abs( 値 ) | 数値の絶対値を返す |
| 平均( value1, [value2, ...] ) | 引数の平均値を返す |
| ceil( 値 ) | 数値を次の最大の整数に丸める。 |
| exp ( 値 ) | e^x を返す。e はオイラー数、x は与えられた引数。 |
| floor( 値 ) | 数値以下の最大の整数を返します。 |
| ln( 値 ) | eを底とする数値の対数を返します。 |
| ログ( 値 ) | 底10の数値の対数を返します。 |
| max( 値1, [値2, ...] ) | 引数のリストの中で最大の値を返す |
| min( 値1, [値2, ...] ) | 引数のリストの中で最小の値を返す |
| π() | π関数は、円周率（π）を小数点以下20桁まで返します。 |
| pow( 基数, 指数 ) | 指数を累乗した底を返す。 |
| ランド( min, max ) | ランダムな整数を生成する |
| ラウンド( 値, 精度 ) | 数値を最も近い整数に丸める |
| sqrt( 値 ) | 数値の平方根を返す |
文字列関数
| 機能/用途 | 説明 |
|---|---|
| num( 文字列、精度 = 14 ) | 文字列を数値に変換する。
precisionが指定された場合、結果の値は小数点以下の指定された桁数に丸められます。 |
| trim( 文字列 ) | 文字列の先頭と末尾から空白（またはその他の文字）を取り除く。 |
| 切り捨て( 文字列, 長さ ) | 最初の length 文字列 |
| 連結( str1, [str2, ...] ) | すべての引数 str1, str2 ... strN を1つの文字列に連結する。 |
| join( separator, str1, [str2, ...] ) | 引数str1, str2 ... strNをセパレータを使って1つの文字列に結合する。 |
| format_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 の日付文字列フォーマットです。空の文字列は、正しいフォーマットを自動的に決定しようとすることを意味します。 |
| 月()、週()、日()、時()、分()、秒()関数 | 時間範囲の長さを計算する。以下と同様 years() 以上。 |
その他の機能
| 機能/用途 | 説明 |
|---|---|
| debug( value1, [value2, ... ] ) | クライアント側で実行された場合、デバッグデータをサーバー上のデバッグログとブラウザのコンソールに出力する。 |