Net.Data 參考手冊

算術函數

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

UNIX、Windows NT 與 OS/2 的執行效能要訣：經由將 Net.Data 起始設定檔案或巨集檔中的 DTW_OPTIMIZE_MATH 架構值設定為 YES，您可以使算術函數達到最佳的執行效能。

當設定為 YES 時，Net.Data 使用 C 算術格式而使函數執行更快；但是，輸出格式則與無此變數者不同。小數點後的零都不顯示。
當 DTW_OPTIMIZE_MATH 設定為 NO，Net.Data 使用 REXX 算術格式。函數執行較慢，但其輸出格式則與前一版 Net.Data 所產生的輸出一樣。預設值是 NO。

請參閱 Net.Data 管理及程式設計手冊內的架構變數章節，以學習如何架構這些變數。

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

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

Web 伺服器上的「語言環境」設定

針對 OS/400 作業系統：

V4R2 或後續版次：由執行此處理的使用者設定檔所指定。
V4R1 或先前版次：從 QDECFMT 系統值取回。

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

DTW_ADD
DTW_DIVIDE
DTW_DIVREM
DTW_FORMAT
DTW_INTDIV
DTW_MULTIPLY
DTW_POWER
DTW_SUBTRACT

DTW_ADD

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

目的

加總兩個參數的值。

格式

@DTW_ADD(number1, number2, precision, result)

@DTW_ADD(number1, number2, result)

@DTW_rADD(number1, number2, precision)

@DTW_rADD(number1, number2)

值

表 40. DTW_ADD 參數

資料類型參數使用說明
浮點數 number1 IN 一個代表某個數字的變數或文字字串。
浮點數 number2 IN 一個代表某個數字的變數或文字字串。
整數 precision IN 一個代表指定結果之精確度之正整數的變數或文字字串。預設值是 9。
浮點數 result OUT 包含 number1 與 number2 總和的變數。

資料類型	參數	使用	說明
浮點數	`number1`	IN	一個代表某個數字的變數或文字字串。
浮點數	`number2`	IN	一個代表某個數字的變數或文字字串。
整數	`precision`	IN	一個代表指定結果之精確度之正整數的變數或文字字串。預設值是 9。
浮點數	`result`	OUT	包含 `number1` 與 `number2` 總和的變數。

範例

範例 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

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

目的

將第一個參數的值除以第二個參數的值。

格式

@DTW_DIVIDE(number1, number2, precision, result)

@DTW_DIVIDE(number1, number2, result)

@DTW_rDIVIDE(number1, number2, precision)

@DTW_rDIVIDE(number1, number2)

值

表 41. DTW_DIVIDE 參數

資料類型參數使用說明
浮點數 number1 IN 一個代表某個數字的變數或文字字串。
浮點數 number2 IN 一個代表某個數字的變數或文字字串。
整數 precision IN 一個代表指定結果之精確度之正整數的變數或文字字串。預設值是 9。
浮點數 result OUT 包含將 number1 除以 number2 之結果的變數。

資料類型	參數	使用	說明
浮點數	`number1`	IN	一個代表某個數字的變數或文字字串。
浮點數	`number2`	IN	一個代表某個數字的變數或文字字串。
整數	`precision`	IN	一個代表指定結果之精確度之正整數的變數或文字字串。預設值是 9。
浮點數	`result`	OUT	包含將 `number1` 除以 `number2` 之結果的變數。

範例

範例 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

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

目的

將第一個參數除以第二個參數並傳回餘數。如果餘數非零，則其正負號與第一個參數的正負號是相同的。

格式

@DTW_DIVREM(number1, number2, precision, result)

@DTW_DIVREM(number1, number2, result)

@DTW_rDIVREM(number1, number2, precision)

@DTW_rDIVREM(number1, number2)

值

表 42. DTW_DIVREM 參數

資料類型參數使用說明
浮點數 number1 IN 一個代表某個數字的變數或文字字串。
浮點數 number2 IN 一個代表某個數字的變數或文字字串。
整數 precision IN 一個代表指定結果之精確度之正整數的變數或文字字串。預設值是 9。
浮點數 result OUT 包含將 number1 除以 number2 之餘數的變數。

資料類型	參數	使用	說明
浮點數	`number1`	IN	一個代表某個數字的變數或文字字串。
浮點數	`number2`	IN	一個代表某個數字的變數或文字字串。
整數	`precision`	IN	一個代表指定結果之精確度之正整數的變數或文字字串。預設值是 9。
浮點數	`result`	OUT	包含將 `number1` 除以 `number2` 之餘數的變數。

範例

範例 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

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

目的

自行設定數字的格式。如果只有指定 number 參數，則結果將會格式化成 @DTW_rADD(number,"0") 已執行的樣子。如果指定了任何其他的選項，則會依據下列的規則來對數字進行格式化：

before 和 after 參數將說明，有多少字元會分別被用來作 result 參數中整數與小數部份。如果您省略了這些參數中的一項或兩項，則作為那部份的字元數與所需的一樣多。
如果 before 參數不足以包含數字的整數部份（加上負數之前的負號），則會產生錯誤的結果。如果 before 參數大於該部分之所需，則 number 參數值將會以空白填補在左邊。如果 after 參數的大小與 number 參數的小數部份不同時，則數字將被四捨五入（或以零填補）以適合其大小。指定 0 會導致數字被四捨五入為整數。
此外，expp 和 expt 參數會控制結果的指數部份。expp 參數設定指數部份位置的數量；預設值是使用與所需的一樣多（可能是零）。expt 參數設定使用指數表示法的觸發點。預設值是 precision 參數的預設值。
如果 expp 是 0，則不提供指數，且數字將以簡單格式表示，如有必要的話會再加上零。如果 expp 沒有大到足夠包含指數，則會產生錯誤。
如果整數或小數部份所需位置的數量分別超出 expt 或二倍的 expt，請使用指數表示法。如果 expt 是 0，則一定會使用指數表示法，除非指數是 0。（如果 expp 是 0，則會置換 expt 的一個 0 值。）如果當 expp 被指定一個非零的值而指數是 0，則 expp+2 的空白提供作為結果的指數部份。如果指數是 0 且未指定 expp，則將使用簡單格式。

格式

@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)

值

表 43. DTW_FORMAT 參數

資料類型參數使用說明
浮點數 number IN 一個代表某個數字的變數或文字字串。
整數 before IN 一個代表正完整數字的變數或文字字串。這是一個可選用的參數。您必須輸入一個空字串（""）以擁有額外的參數。
整數 after IN 一個代表正完整數字的變數或文字字串。這是一個可選用的參數。您必須輸入一個空字串（""）以設定額外的參數。
整數 expp IN 一個代表正完整數字的變數或文字字串。您必須設定一個空字串（""）以設定額外的參數。
整數 expt IN 一個代表正完整數字的變數或文字字串。您必須輸入一個空字串（""）以設定額外的參數。
整數 precision IN 一個代表指定結果之精確度之正整數的變數或文字字串。預設值是 9。
浮點數 result OUT 一個含所指定之整數化和格式化之數字的值。

資料類型	參數	使用	說明
浮點數	`number`	IN	一個代表某個數字的變數或文字字串。
整數	`before`	IN	一個代表正完整數字的變數或文字字串。這是一個可選用的參數。您必須輸入一個空字串（""）以擁有額外的參數。
整數	`after`	IN	一個代表正完整數字的變數或文字字串。這是一個可選用的參數。您必須輸入一個空字串（""）以設定額外的參數。
整數	`expp`	IN	一個代表正完整數字的變數或文字字串。您必須設定一個空字串（""）以設定額外的參數。
整數	`expt`	IN	一個代表正完整數字的變數或文字字串。您必須輸入一個空字串（""）以設定額外的參數。
整數	`precision`	IN	一個代表指定結果之精確度之正整數的變數或文字字串。預設值是 9。
浮點數	`result`	OUT	一個含所指定之整數化和格式化之數字的值。

範例

範例 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

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

目的

將第一個參數除以第二個參數，並傳回結果的整數部分。

格式

@DTW_INTDIV(number1, number2, precision, result)

@DTW_INTDIV(number1, number2, result)

@DTW_rINTDIV(number1, number2, precision)

@DTW_rINTDIV(number1, number2)

值

表 44. DTW_INTDIV 參數

資料類型參數使用說明
浮點數 number1 IN 一個代表某個數字的變數或文字字串。
浮點數 number2 IN 一個代表某個數字的變數或文字字串。
整數 precision IN 一個代表指定結果之精確度之正整數的變數或文字字串。預設值是 9。
浮點數 result OUT 包含 number1 除以 number2 所得商的整數部份的變數。

資料類型	參數	使用	說明
浮點數	`number1`	IN	一個代表某個數字的變數或文字字串。
浮點數	`number2`	IN	一個代表某個數字的變數或文字字串。
整數	`precision`	IN	一個代表指定結果之精確度之正整數的變數或文字字串。預設值是 9。
浮點數	`result`	OUT	包含 `number1` 除以 `number2` 所得商的整數部份的變數。

範例

範例 1：

@DTW_INTDIV(NUM1, NUM2,
result)

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

範例 2：

@DTW_rINTDIV("2",
NUM2)

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

DTW_MULTIPLY

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

目的

兩個參數相乘，並傳回結果。

格式

@DTW_MULTIPLY(number1, number2, precision, result)

@DTW_MULTIPLY(number1, number2, result)

@DTW_rMULTIPLY(number1, number2, precision)

@DTW_rMULTIPLY(number1, number2)

值

表 45. DTW_MULTIPLY 參數

資料類型參數使用說明
浮點數 number1 IN 一個代表某個數字的變數或文字字串。
浮點數 number2 IN 一個代表某個數字的變數或文字字串。
整數 precision IN 一個代表指定結果之精確度之正整數的變數或文字字串。預設值是 9。
浮點數 result OUT 包含 number1 與 number2 乘積的變數。

資料類型	參數	使用	說明
浮點數	`number1`	IN	一個代表某個數字的變數或文字字串。
浮點數	`number2`	IN	一個代表某個數字的變數或文字字串。
整數	`precision`	IN	一個代表指定結果之精確度之正整數的變數或文字字串。預設值是 9。
浮點數	`result`	OUT	包含 `number1` 與 `number2` 乘積的變數。

範例

範例 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

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

目的

將第二個參數作為第一個參數的次方，並傳回結果。

格式

@DTW_POWER(number1, number2, precision, result)

@DTW_POWER(number1, number2, result)

@DTW_rPOWER(number1, number2, precision)

@DTW_rPOWER(number1, number2)

值

表 46. DTW_POWER 參數

資料類型參數使用說明
浮點數 number1 IN 一個代表某個數字的變數或文字字串。
浮點數 number2 IN 一個代表某個數字的變數或文字字串。
整數 precision IN 一個代表指定結果之精確度之正整數的變數或文字字串。預設值是 9。
浮點數 result OUT 包含 number1 的 number2 次方結果的變數。

資料類型	參數	使用	說明
浮點數	`number1`	IN	一個代表某個數字的變數或文字字串。
浮點數	`number2`	IN	一個代表某個數字的變數或文字字串。
整數	`precision`	IN	一個代表指定結果之精確度之正整數的變數或文字字串。預設值是 9。
浮點數	`result`	OUT	包含 `number1` 的 `number2` 次方結果的變數。

範例

範例 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

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

目的

將第二個參數的值從第一個參數的值中減去，並傳回結果。

格式

@DTW_SUBTRACT(number1, number2, precision, result)

@DTW_SUBTRACT(number1, number2, result)

@DTW_rSUBTRACT(number1, number2, precision)

@DTW_rSUBTRACT(number1, number2)

值

表 47. DTW_SUBTRACT 參數

資料類型參數使用說明
浮點數 number1 IN 一個代表某個數字的變數或文字字串。
浮點數 number2 IN 一個代表某個數字的變數或文字字串。
整數 precision IN 一個代表指定結果之精確度之正整數的變數或文字字串。預設值是 9。
浮點數 result OUT 包含 number1 與 number2 差的變數。

資料類型	參數	使用	說明
浮點數	`number1`	IN	一個代表某個數字的變數或文字字串。
浮點數	`number2`	IN	一個代表某個數字的變數或文字字串。
整數	`precision`	IN	一個代表指定結果之精確度之正整數的變數或文字字串。預設值是 9。
浮點數	`result`	OUT	包含 `number1` 與 `number2` 差的變數。

範例

範例 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"

[ 頁面頂端 | 前一頁 | 下一頁 | 目錄 | 索引 ]