參考手冊

算術函數

這些函數可讓您作算術的計算。

算術函數的 NLS 考量： Net.Data 會根據執行 Net.Data 的 Web 伺服器上所指定的區域設定值， 來顯示數值中的小數點。例如，Web 伺服器上小數點若是指定為逗點 (,)， Net.Data 便使用逗點，格式化含小數的資料。Net.Data 使用下列設定值， 以決定哪個字元被指定為小數點。

針對 OS/390、Windows NT、OS/2 及 UNIX 作業系統：

Web 伺服器執行時的語言環境 (LOCALE)

針對 OS/400 作業系統：

• V4R2 或後續版次：由執行此處理的使用者設定檔所指定。

• V4R1 或先前版次：從 QDECFMT 系統值取回。

下列函數可讓您作算術的計算：

• DTW_ADD

• DTW_DIVIDE

• DTW_DIVREM

• DTW_FORMAT

• DTW_INTDIV

• DTW_MULTIPLY

• DTW_POWER

• DTW_SUBTRACT

DTW_ADD

目的

兩數相加。

格式

@DTW_ADD(number1, number2, precision, result)

@DTW_ADD(number1, number2, result)

@DTW_rADD(number1, number2, precision)

@DTW_rADD(number1, number2)

參數

表 57. DTW_ADD 參數

回覆碼

表 58. DTW_ADD 回覆碼

範例

範例 1：

@DTW_ADD(NUM1, NUM2, "2", result)

• 輸入：NUM1 = "105", NUM2 = "3"
• 傳回：result = "1.1E+2"

範例 2：

@DTW_rADD("12", NUM2, "5")

• 輸入：NUM2 = "7.00"
• 傳回："19.00"

DTW_DIVIDE

目的

一個數字除以另一個數字。

格式

@DTW_DIVIDE(number1, number2, precision, result)

@DTW_DIVIDE(number1, number2, result)

@DTW_rDIVIDE(number1, number2, precision)

@DTW_rDIVIDE(number1, number2)

參數

表 59. DTW_DIVIDE 參數

回覆碼

表 60. DTW_DIVIDE 回覆碼

範例

範例 1：

@DTW_DIVIDE("8.0", NUM2, result)

• 輸入：NUM2 = "2"
• 傳回：result = "4"

範例 2：

@DTW_rDIVIDE("1", NUM2, "5")

• 輸入："1", NUM2 = "3"
• 傳回："0.33333"

範例 3：

@DTW_rDIVIDE(NUM1, "2", "5")

• 輸入：NUM1 = "5"
• 傳回："2.5"

DTW_DIVREM

目的

將一個數字除以另一個數字，並傳回餘數。

格式

@DTW_DIVREM(number1, number2, precision, result)

@DTW_DIVREM(number1, number2, result)

@DTW_rDIVREM(number1, number2, precision)

@DTW_rDIVREM(number1, number2)

參數

表 61. DTW_DIVREM 參數

回覆碼

表 62. DTW_DIVIDEREM 回覆碼

用法注意事項

如果餘數非零，則其正負號與第一個參數的正負號是相同的。

範例

範例 1：

@DTW_DIVREM(NUM1, NUM2, result)

• 輸入：NUM1 = "2.1", NUM2 = "3"
• 傳回：result = "2.1"

範例 2：

@DTW_rDIVREM("10", NUM2)

• 輸入：NUM2 = "0.3"
• 傳回："0.1"

範例 3：

@DTW_rDIVREM("3.6", "1.3")

• 傳回："1.0"

範例 4：

@DTW_rDIVREM("-10", "3")

• 傳回："-1"

DTW_FORMAT

目的

自行設定數字的格式。

格式

@DTW_FORMAT(number, before, after, expp, expt, precision, result)

@DTW_FORMAT(number, before, after, expp, expt, result)

@DTW_FORMAT(number, before, after, expp, result)

@DTW_FORMAT(number, before, after, result)

@DTW_FORMAT(number, before, result)

@DTW_FORMAT(number, result)

@DTW_rFORMAT(number, before, after, expp, expt, precision)

@DTW_rFORMAT(number, before, after, expp, expt)

@DTW_rFORMAT(number, before, after, expp)

@DTW_rFORMAT(number, before, after)

@DTW_rFORMAT(number, before)

@DTW_rFORMAT(number)

參數

表 63. DTW_FORMAT 參數

回覆碼

表 64. DTW_FORMAT 回覆碼

用法注意事項

1. 如果只有指定 number 參數，則結果將會格式化成為 @DTW_rADD(number,"0") 執行後的結果。

2. before 和 after 參數將說明，有多少字元 會分別被用來作 result 參數中整數與 小數部份。如果您省略了這些參數中的一項或兩項， 則作為那部份的字元數與所需的一樣多。

3. 如果 before 參數不足以包含數字的 整數部份（加上負數之前的負號），則會產生錯誤的結果。 如果 before 參數大於該部分之所需，則 number 參數值將會以空白填補在左邊。 如果 after 參數的大小與 number 參數的小數部份不同時，則數字將被四捨五入（或以零填補）以適合其大小。 指定 0 會導致數字被四捨五入為整數。

4. expp 和 expt 參數可控制結果的指數部份。 expp 參數設定 指數部份位置的數量；預設值是使用與所需的一樣多 （可能是零）。 expt 參數設定使用指數表示法的觸發點。 預設值是 precision 參數的預設值。

5. 如果 expp 是 0，則不提供指數，且數字將以簡單格式表示， 如有必要的話會再加上零。如果 expp 沒有大到足夠包含指數， 則會產生錯誤。

6. 如果整數或小數部份所需位置的數量分別超出 expt 或二倍的 expt，請使用指數表示法。 如果 expt 是 0，則一定會使用指數表示法， 除非指數是 0。（如果 expp 是 0，則會置換 expt 的一個 0 值。） 如果當 expp 被指定一個非零的值而指數是 0， 則 expp+2 的空白提供作為結果的指數部份。如果指數是 0 且未指定 expp，則將使用簡單格式。

範例

範例 1：

@DTW_FORMAT(NUM, BEFORE, result)

• 輸入：NUM = "3", BEFORE = "4"
• 傳回：result= " 3"

範例 2：

@DTW_FORMAT("1.73", "4", "0", result)

• 傳回：result = " 2"

範例 3：

@DTW_FORMAT("1.73", "4", "3", result)

• 傳回：result = " 1.730"

範例 4：

@DTW_FORMAT(" - 12.73", "", "4", result)

• 傳回：result = "-12.7300"

範例 5：

@DTW_FORMAT("12345.73", "", "", "2", "2", result)

• 傳回：result = "1.234573E+04"

範例 6：

@DTW_FORMAT("1.234573", "", "3", "", "0", result)

• 傳回：result = "1.235"

範例 7：

@DTW_rFORMAT(" - 12.73")

• 傳回：" - 12.73"

範例 8：

@DTW_rFORMAT("0.000")

• 傳回："0"

範例 9：

@DTW_rFORMAT("12345.73", "", "", "3", "6")

• 傳回："12345.73"

範例 10：

@DTW_rFORMAT("1234567e5", "", "3", "0")

• 傳回："123456700000.000"

範例 11：

@DTW_rFORMAT("12345.73", "", "3", "", "0")

• 傳回："1.235E+4"

DTW_INTDIV

目的

將一個數字除以另一個數字，並傳回結果的整數部份。

格式

@DTW_INTDIV(number1, number2, precision, result)

@DTW_INTDIV(number1, number2, result)

@DTW_rINTDIV(number1, number2, precision)

@DTW_rINTDIV(number1, number2)

參數

表 65. DTW_INTDIV 參數

回覆碼

表 66. DTW_INTDIV 回覆碼

範例

範例 1：

@DTW_INTDIV(NUM1, NUM2, result)

• 輸入：NUM1 = "10", NUM2 = "3"
• 傳回：result = "3"

範例 2：

@DTW_rINTDIV("2", NUM2)

• 輸入：NUM2 = "3"
• 傳回："0"

DTW_MULTIPLY

目的

兩個數字相乘。

格式

@DTW_MULTIPLY(number1, number2, precision, result)

@DTW_MULTIPLY(number1, number2, result)

@DTW_rMULTIPLY(number1, number2, precision)

@DTW_rMULTIPLY(number1, number2)

參數

表 67. DTW_MULTIPLY 參數

回覆碼

表 68. DTW_MULTIPLY 回覆碼

範例

範例 1：

@DTW_MULTIPLY(NUM1, NUM2, result)

• 輸入：NUM1 = "4", NUM2 = "5"
• 傳回：result = "20"

範例 2：

@DTW_rMULTIPLY("0.9", NUM2)

• 輸入：NUM2 = "0.8"
• 傳回："0.72"

DTW_POWER

目的

將整數升冪成整數次方。

格式

@DTW_POWER(number1, number2, precision, result)

@DTW_POWER(number1, number2, result)

@DTW_rPOWER(number1, number2, precision)

@DTW_rPOWER(number1, number2)

參數

表 69. DTW_POWER 參數

回覆碼

表 70. DTW_POWER 回覆碼

範例

範例 1：

@DTW_POWER(NUM1, NUM2, result)

• 輸入：NUM1 = "2", NUM2 = "-3"
• 傳回：result = "0.125"

範例 2：

@DTW_rPOWER("1.7", NUM2, precision)

• 輸入：NUM2 = "8", precision = "5"
• 傳回："69.758"

DTW_SUBTRACT

目的

一個數字減另一個數字。

格式

@DTW_SUBTRACT(number1, number2, precision, result)

@DTW_SUBTRACT(number1, number2, result)

@DTW_rSUBTRACT(number1, number2, precision)

@DTW_rSUBTRACT(number1, number2)

參數

表 71. DTW_SUBTRACT 參數

回覆碼

表 72. DTW_SUBTRACT 回覆碼

範例

範例 1：

@DTW_SUBTRACT(NUM1, NUM2, comp)
%IF(comp > "0")
<P>$(NUM1) 大於 $(NUM2)。
%ENDIF
 

• 輸入：NUM2 = "2.07"
• 傳回："-0.77"

這個範例顯現一個比較數值的方式，其 為 Net.Data 中的字串。

範例 2：

@DTW_SUBTRACT(NUM1, NUM2, result)

• 輸入：NUM1 = "1.3"，NUM2 = "1.07"
• 傳回：result = "0.23"

範例 3：

@DTW_rSUBTRACT("1.3", NUM2)

• 輸入：NUM2 = "2.07"
• 傳回："-0.77"