使用欄位參考、常值、運算子和函數來建置 Adobe Acrobat Sign 中計算欄位的公式。
在設定為「值類型 > 計算」的欄位的「公式」屬性中輸入公式。此參考說明可用於建置這些公式的運算式語法。
若要設定欄位本身，請參閱建立計算欄位。
建置公式
公式可以包含一個或多個這些元素：
| 元素 | 使用於 | 範例 |
|---|---|---|
| 欄位參考 | 使用其他欄位的值 | price * quantity |
| 常值 | 包含固定數字、文字值或日期 | total * 0.10 |
| 運算子 | 執行算術、比較或文字操作 | subtotal + tax |
| 函數 | 執行預先定義的計算或邏輯操作 | max(value1, value2) |
公式也可以參考其他計算欄位。
依名稱參考欄位
使用欄位名稱在公式中引用其值。
例如：
price * quantity
使用名為price和quantity的欄位值。
如果欄位名稱包含空格，請將完整名稱括在方括弧中：
[Unit price] * quantity
使用有意義且唯一的欄位名稱，讓公式在表單變更時保持易於理解。
請參閱表單欄位屬性以了解欄位名稱需求。
使用常值
常值是直接包含在公式中的固定值。
例子包括：
- 數字：10
- 文字：「已核准」
- 支援的日期函數所使用的日期
將文字字串用單引號或雙引號括起來。
例如：
「已核准」
常值可與欄位、運算子和函數結合使用。
支援的運算子
使用運算子執行計算、結合文字或比較值。
| 運算子 | 運算 |
|---|---|
| + | 新增 |
| - | 減去 |
| / | 分割 |
| * | 色彩增值 |
| & | 結合文字字串 |
| = | 等於 |
| != | 不等於 |
| < | 小於 |
| <= | 小於或等於 |
| > | 大於 |
| >= | 大於或等於 |
| % | 傳回除法後的餘數 |
| ^ | 將值提升至指定次方 |
比較運算子傳回真或假結果，可在邏輯函數內使用。
例如：
total >= 1000
評估 total 的值是否至少為 1000。
數學函數
| 函數 | 結果 |
|---|---|
| abs(number1) | 傳回數字的絕對值。 |
| roundUp(number1) | 將數字向上四捨五入。 |
| roundDown(number1) | 將數字向下四捨五入。 |
| round(number1) | 將數字四捨五入至最接近的整數。 |
| min(number1, number2) | 傳回兩個數字中較小的數字。 |
| max(number1, number2) | 傳回兩個數字中較大的數字。 |
範例
max(Amount1, Amount2)
傳回兩個欄位值中較大的值。
日期函數
| 函數 | 結果 |
|---|---|
| datePart(part, date) | 以整數形式傳回日期的指定部分。 |
| dateAdd(part, date, addition) | 將指定數量的日期部分新增至日期。使用負值來進行減法。 |
| dateDiff(part, date1, date2) | 使用指定的日期部分，回傳兩個日期之間的差異。 |
| daysIn(part, date) | 回傳日期指定部分的天數。 |
| date(string) | 將代表日期的文字值轉換為其他函數可使用的日期值。 |
| now() | 當公式進行評估時，會傳回日期和時間。 |
日期部分的值
在支援的日期函數中，將這些值用於 part 引數：
| 值 | 日期或時間部分 |
|---|---|
| y | 年 |
| q | 季 |
| m | 月 |
| d | 日 |
| h | 小時 |
| n | 分 |
| s | 秒 |
範例
dateAdd("d", StartDate, 30)
將 30 天新增至 StartDate 欄位的值。
使用負數來計算較早的日期：
dateAdd("d", StartDate, -7)
邏輯函數
當計算值取決於一個或多個條件時，請使用邏輯函數。
| 函數 | 結果 |
|---|---|
| if(logical_test, value_if_true, value_if_false) | 當測試為真時回傳一個值，為假時回傳另一個值。 |
| and(logical1, logical2, ...) | 只有在所有指定條件都為真時才回傳真。 |
| or(logical1, logical2, ...) | 當至少一個指定條件為真時回傳真。 |
| not(logical) | 反轉真或假結果。 |
| lookup(sourceField, values, default_value) | 回傳與來源欄位相關聯的值，或在找不到符合項目時回傳預設值。 |
使用 if 在結果之間選擇
例如：
if(Total >= 1000, "Approval required", "Approved")
當 Total 至少為 1000 時傳回一個文字值，否則傳回另一個文字值。
真和假的結果本身可包含運算式。
結合邏輯測試 (and、or、not)
當每個條件都必須為真時，請使用 and ：
and(Age >= 18, Consent = "Yes")
當任何條件均可為真時使用 or ：
or(State = "CA", State = "OR")
當您需要條件的相反時，使用 not：
not(Status = "Closed")
使用查詢將一個值對應到另一個值
當來源值應傳回對應值時使用 lookup。
例如：
lookup(State, "CA=California,UT=Utah,WA=Washington", "Other")
當符合存在時傳回對應的州名，不符合時傳回 Other。
當來源值來自已定義的選取項目集合時（例如下拉式或選項按鈕欄位），這會很有用。
公式範例
計算金額
quantity * [Unit price]
將數量乘以單位價格。
新增數個值
subtotal + tax + shipping
新增來自三個欄位的值。
計算百分比
subtotal * taxRate
將一個欄位乘以儲存在另一個欄位中的費率。
有條件地傳回值
if(quantity >= 10, [Unit price] * 0.9, [Unit price])
當數量達到定義的臨界值時傳回折扣值。
計算未來日期
dateAdd("m", StartDate, 12)
傳回一個比 StartDate 晚 12 個月的日期。
結合文字
RecipientName & " - " & Company
將欄位值與常值文字結合成一個結果。
建置更容易維護的公式
使用描述性的欄位名稱，並盡量讓相關計算保持簡單。
審閱公式時，請確認：
- 每一個參考的欄位都存在。
- 欄位名稱符合公式中使用的名稱。
- 包含空格的欄位須以方括號括住。
- 文字常值須以引號括住。
- 函數包含必要的引數。
- 計算欄位會為預期的收件人輸入產生預期的值。
如需設定計算欄位與格式化數字結果的相關資訊，請參閱建立計算欄位。
