D07-00 常用函式集合

1. 安裝該插件後，一些常用的函式可以直接使用。

2. 插件安裝方式，可參考A11-18伺服器-插件管理。

3. 函式使用方式，可參考A05-03插入公式。

1

StringFind

1. 該函式用於查詢字串包含的字串索引，索引從0開始。

2. StringFind("String1","String2")傳回String2在String1中從左往右數，第一次出現的位置。

3. StringFind("String1","String2")若String2不存在於String1中，則傳回-1。

4. StringFind("String1","String2",false)傳回String2在String1中從右往左數，第一次出現的位置。

5. 例：StringFind("have a good time","a")=1，StringFind("have a good time","b")=-1，StringFind("have a good time","a",false)=5

2

GetIP

1. 該函式用於傳遞內建的 sessionID 參數，獲取 IP 地址。

3

ProcessErrorValue

1. 該函式用於在函式傳回值為錯誤值的時候，輸出自訂的值，其他值不變。

2. 直接使用SORT()，會傳回#ERROR_NAME。

3. 使用ProcessErrorValue(SQRT(), "錯誤的值")，預覽顯示【錯誤的值】。

4

HtmlFinder

1. 該函式用於HTML 頁面查詢元素對應的內容。

2. HtmlFinder(參數1,參數2)：參數1為要查詢的 HTML頁面的地址，參數2為查詢的DOM標記。

3. 例：HtmlFinder("http://www.finereport.com/tw", "a[href]")傳回所有超連結內容。

5

StringMatch

1. 該函式用於判斷字串是否符合字串的正則表示式，結果符合傳回 true，反之傳回 false。

2. 例：StringMatch("abcdefg", "(.*)abc(.*)")傳回true，StringMatch("abcdefg", "(.*)cb(.*)")傳回false。

6

StringReverse

1. 該函式用於反轉字串，StringReverse(參數)參數為需要被反轉的字串。

2. 例：StringReverse("abc")傳回cba。

7

StringSwapCase

1. 該函式用於交換字串中字母的大小寫，將原有字串中的大寫字母轉換成小寫字母，將小寫字母轉換成大寫字母。

2. 例：StringSwapCase("abcDeFg")：傳回ABCdEfG。

8

StringConditionConcat

1. 該函式用於根據條件拼接給定陣列中的符合條件的元素，內建參數 index 表示索引位置，item 表示元素值。

2. 例：StringConditionConcat(["帆軟", "b", "軟體", "asd", "公司"], index % 2 = 1)：傳回索引為0，2，4的字串並拼接，即傳回【帆軟軟體公司】。

9

StringFetch

1. 該函式用於根據正則表示式提取符合的字串，最終傳回一個數組，如果有第三個參數，則表示傳回陣列中第三個參數表示的索引位置的值。

2. 例：StringFetch("2012-08-12 2012-12 abcde 2012-08-23", "\\d{4}[ /-]{1}\\d{2}([ /-]{1}\\d{2})?")：傳回2012-08-12,2012-12,2012-08-23。

3. StringFetch("2012-08-12 2012-12 abcde 2012-08-23", "\\d{4}[ /-]{1}\\d{2}([ /-]{1}\\d{2})?", 2)：傳回2012-08-23。

10

ScriptEval

1. 該函式中支援JavaScript指令碼，避免巢狀各種 IF、SWITCH 函式的寫法。

2. ScriptEval（參數，參數名 1，參數值 1，參數名 2，參數值 2，……）：第一個參數需要是一個字串，字串中是一個合法的 JavaScript 表示式，後續的參數名和參數值必須成對出現。

3. 例：在A1儲存格中插入公式range(5)，在B1儲存格中插入公式ScriptEval('var r = [];origin.forEach(function(item, i){if(item % 2 == 0){r.push(item);}});return r;',"origin",A1)，傳回2,4。

11

JSONPathFinder

1. 該函式用於根據JSON查詢語句從給定的JSON內容中查詢出結果。

2. JSONPathFinder("參數1","參數2")，參數1為JSON格式的資料來源，參數2為JSON查詢語句。

3. 例：JSONPathFinder("http://fine-doc.oss-cn-shanghai.aliyuncs.com/book.json","$.store.book[?(@.price<10)].title")

4. 符合條件的書共有兩本，傳回一個數組：Sayings of the Century,Moby Dick。

12

MathGeometricMean

1. 該函式用於求陣列中元素的算術平均數。

2. 例：MathMean(1,1,2,4,5)：傳回2.6。

13

MathSumOfSquares

1. 該函式用於求陣列中元素的平方和。

2. 例：MathSumOfSquares(1,1,2,4,5)： 傳回47。

14

MathMean

1. 該函式用於求陣列中元素的幾何平均數。

2. 例：MathGeometricMean(1,1,2,4,5)：傳回2.0912791051825463。

15

MathPopulationStandardDeviation

1. 該函式用於求陣列中元素的總體標準差。

2. 例：MathPopulationStandardDeviation(1,2,3,4,5)：傳回1.4142135623730951。

16

MathFrequency

1. 該函式用於統計單詞出現的次數和頻率。

2. MathFrequency(陣列,參數1)傳回參數1在陣列中出現的次數，MathFrequency(陣列,參數1,參數2)參數2可以為任意值，當出現參數2時則傳回參數1在陣列中出現的頻率而非次數。

3. 例：MathFrequency([1, 3, 2, 4, 2], 3)：傳回1，表示陣列中3只出現了一次。MathFrequency([1, 3, 2, 4, 2], 3,3)：傳回0.2，表示3出現的頻率為 0.2。

17

MathStandardDeviation

1. 該函式用於求陣列中元素的標準差。

2. 例：MathStandardDeviation(1,2,3,4,5)：傳回1.5811388300841898。

18

MathVariance

1. 該函式用於求陣列中元素的方差。

2. 例：MathVariance(1,1,2,4,5) ：傳回3.3。

19

NumberToEnglish

1. 該函式用於將數字翻譯成英文。

2. 例：NumberToEnglish("1234567")：傳回One Million, Two Hundred And Thirty-Four Thousand, Five Hundred And Sixty-Seven。

20

EncryptShaHex

1. 該函式用於SHA 加密。

2. EncryptShaHex(abc)：加密結果為da39a3ee5e6b4b0d3255bfef95601890afd80709。

21

EncryptSha256Hex

1. 該函式用於SHA256加密。

2. 例：EncryptSha256Hex(abc)：加密結果為e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855。

22

EncryptSha384Hex

1. 該函式用於SHA384加密。

2. 例：EncryptSha384Hex(abc)：加密結果為[B@175d5041。

23

EncryptSha512Hex

1. 該函式用於SHA512加密。

2. 例：EncryptSha512Hex(abc)：

3. 加密結果為cf83e1357eefb8bdf1542850d66d8007d620e4050b5715dc83f4a921d36ce9ce47d0d13c5d85f2b0ff8318d2877eec2f63b931bd47417a81a538327af927da3e。

24

EncryptMD5Hex

1. 該函式用於MD5加密。

2. 例：EncryptMd5Hex(abc)：加密結果為d41d8cd98f00b204e9800998ecf8427e。

25

EncryptDes

1. 該函式用於DES加密，EncryptDes(參數1,參數2)：第一個參數為要加密的文字，第二個參數為加密的 key。

2. 例：EncryptDes("123","12345678")：傳回LDiFUdf0iew=，金鑰需為8位的隨機不固定字串。

26

DecryptDes

1. 該函式用於DES解密，DecryptDes(參數1,參數2)：第一個參數為要解密的文字，第二個參數為解密所需要的 key。

2. 例：DecryptDes("LDiFUdf0iew=","12345678")：傳回123。