正文函式概述

CHAR(number)：根據指定數字程式碼傳回對應的字元。CHAR 函式可將計算機其他類型的數字程式碼轉換為字元。

Number：用於指定字元的數字，介於 1 和 65535 之間（包括 1 和 65535）。

範例：

CHAR(88) 等於“X”。

CHAR(45) 等於“-”。

1）概述

2）注意事項

單位可以為空，如果為空，則直接將 number 轉換為人民幣大寫，否則先將 number 與單位的進制相乘，然後再將相乘的結果轉換為人民幣大寫。

參數 number 超過十萬億，則不支援使用該函式。

參數 number 在轉換時只能將小數部分精確到分，若小數位超出精度範圍，則會在轉換前對 number 進行四捨五入並保留兩位小數。如 CNMONEY(12.346) 的回傳值為壹拾貳圓叄角伍分，如需精確到釐、毫，可參考 將數字轉換成中文大寫、人民幣大寫 。

3）範例

CODE(text)：計算正文串中第一個字元的數字程式碼。傳回的程式碼對應於計算機使用的字元集。

Text：需要計算第一個字元程式碼的正文或儲存格引用。

範例：

CODE("S") 等於 83。

CODE("Spreadsheet") 等於 83。

CONCATENATE(text1,text2,...)：將數個字串合併成一個字串。

Text1,text2,...：需要合併成單個正文的正文項，可以是字元，數字或是儲存格引用。

注： 也可以用"+"來代替 CONCATENATE 函式對正文項進行合併，"＋"對數字無法合併，只能直接加法計算。

範例：

CONCATENATE("Average ","Price") 等於“Average Price”。

CONCATENATE("1","2") 等於 12。

ENDWITH(str1,str2)：判斷字串 str1 是否以 str2 結束。 注： str1 和 str2 都是大小寫敏感的。

範例：

ENDWITH("FineReport","Report") 等於 true

ENDWITH("FineReport","Fine") 等於 false。

ENDWITH("FineReport","report") 等於 false。

ENMONEY(value)：將給定的 BigDemical 類型的數字轉換成英文金額字串。

範例：

ENMONEY(23.49) 等於 TWENTY THREE AND CENTS FORTY NINE。

注：僅支援 9 位數之內的計算。

ENNUMBER(value)：將給定的 BigDecimal 類型的數字（100 以內）取整後轉化成英文金額的字串。

範例：

ENNUMBER(23.49) 等於 TWENTY THREE。

注：若出現結果為空，需要將數字強制轉換為 BigDecimal 類型，例如：ENNUMBER(TOBIGDECIMAL(80))

EXACT(text1,text2)：檢查兩組正文是否相同。如果完全相同，EXACT 函式傳回 TRUE；否則，傳回 FALSE。EXACT 函式可以區分大小寫，但忽略格式的不同。同時也可以利用 EXACT 函式來檢查輸入文檔的文字。

Text1：需要比較的第一組正文。

Text2：需要比較的第二組正文。

範例：

EXACT("Spreadsheet","Spreadsheet") 等於 TRUE。

EXACT("Spreadsheet","S preadsheet") 等於 FALSE。

EXACT("Spreadsheet","spreadsheet") 等於 FALSE。

1）概述

2）注意事項

如果 start_num 不大於 0，FIND 函式傳回錯誤資訊 *VALUE!。 

如果 start_num 大於 within_text 的長度，FIND 函式回傳值為 0。

如果 find_text 是空白正文，FIND 函式將在搜尋串中匹配第一個字元（即編號為 start_num 或 1 的字元）。

3）範例

1）概述

2）注意事項

format 對日期的操作，日期的大小寫必須按照年份小寫 yy 或 yyyy，月份大寫 M 或 MM，日期小寫 d 或 dd。

format 對小數的舍入計算遵循奇進偶舍的規則。奇進偶舍是一種數值修約規則，也稱為“銀行家舍入法”或“四捨六入五成雙”。它的核心目的是減少在大量舍入操作中產生的系統性偏差。具體規則如下：

四捨六入：

• 當待捨去的部分 小於5 時，直接捨去。

• 當待捨去的部分 大於5 時，向前進位。

例如：FORMAT(14.4999,"0") ->  14，FORMAT(14.5001,"0") ->  15

五的情況：

• 當待捨去的部分 恰好是5 時，檢查前一位數位的同位。

• 若前一位是奇數，則進位（使其變為偶數）。

• 若前一位是偶數，則直接捨去（保持偶數）。

例如：FORMAT(12.5,"0") -> 12，FORMAT(13.5,"0")-> 14，FORMAT(14.5,"0") -> 14，FORMAT(15.5,"0")-> 16

3）範例

11.1 傳回字串指定位置字元

1）概述

2）注意事項

 index 是從 0 開始計數的。

3）範例

11.2 傳回陣列指定位置字元

1）概述

2）注意事項

index 是從 1 開始計數的。

3）範例

LEFT(text,num_chars)：根據指定的字元數傳回正文串中的第一個或前幾個字元。

Text：包含需要選取字元的正文串或儲存格引用。

Num_chars：指定傳回的字串長度。

注： Num_chars 的值必須等於或大於 0。

如果 num_chars 大於整個正文的長度，LEFT 函式將傳回所有的正文。

如果省略 num_chars，則預設值為 1。

範例：

LEFT("Fine software",8) 等於“Fine sof”。

LEFT("Fine software") 等於“F”。

如果儲存格 A3 中含有“China”，則：

LEFT(A3,2) 等於“Ch”。

1）概述

2）範例

例如你需要對空值和非空值進行判斷，可以使用該函式，使用公式：if(LEN(A1)=0,"空值","非空")，如下圖所示：

得到如下結果：

LOWER(text)：將所有的大寫字母轉化為小寫字母。

Text：需要轉化為小寫字母的正文串。LOWER 函式不轉化正文串中非字母的字元。

範例：

LOWER("A.M.10:30") 等於“a.m.10:30”。

LOWER("China") 等於“china”。

MID(text,start_num,num_chars)：傳回正文串中從指定位置開始的一定數目的字元，該數目由使用者指定。

Text：包含要提取字元的正文串。

Start_num：正文中需要提取字元的起始位置。正文中第一個字元的 start_num為 1，依此類推。

Num_chars：傳回字元的長度。

注：

如果 start_num 大於正文長度，MID 函式傳回“”（空正文）。

如果 start_num 小於正文長度，並且 start_num 加上 num_chars 大於正文長度，MID 函式將從 start_num 指定的起始字元直至正文末的所有字元。

如果 start_num 小於 1，MID 函式傳回錯誤資訊 *VALUE!。

如果 num_chars 是負數，MID 函式傳回錯誤資訊 *VALUE!。

範例：

MID("Finemore software",10,8) 傳回“software”。

MID("Finemore software",30,5) 傳回“”（空正文）。

MID("Finemore software",0,8) 傳回 *VALUE!。

MID("Finemore software",5,-1) 傳回 *VALUE!。

NUMTO(number)：傳回 number 的中文表示。

範例：

NUMTO(2345) 等於二千三百四十五。

PROPER(text)：將正文中的【第一個字母】和【空格後】的第一個字母轉化成大寫，其他字母變為小寫。

Text：需要轉化為正文的公式、由雙引號引用的正文串或是儲存格引用。

範例：

PROPER("Finemore Integrated Office") 等於“Finemore Integrated Office”。

PROPER("100 percent") 等於“100 Percent”。

PROPER("SpreaDSheEt") 等於“Spreadsheet”。

18.1 用法一

1）概述

REGEXP(str, pattern)：

字串str是否與正則運算式 pattern 相匹配。

2）範例

REGEXP("aaaaac","a*c") 等於 true。

REGEXP("abc","a*c") 等於 false。

18.2 用法二

1）概述

REGEXP(str, pattern, intNumber)：字串 str 是否與具有給定模式 intNumber 的正則運算式 pattern 相匹配。

注：intNumber 的模式如下所示 

2）範例

REGEXP("Aaaaabbbbc","a*b*c", 3) 等於 true

REGEXP("Aaaaabbbbc","a*b*c", 1) 等於 false。

1）REPLACE(text, texttoreplace, replacetext)：根據指定正文，用其他正文來取代原始正文中的內容。【正文：指不含格式資訊的字元和字串】

text：原始正文或儲存格引用。

texttoreplace：被取代的正文。

replacetext：   取代的正文。

範例：

REPLACE("abcd", "a", "re")等於"rebcd"。即：將 abcd 中字元 a 用 re 來取代，形成新的字串 rebcd。

如果儲存格a1為【saasas】,則：

REPLACE(a1,"a","B")等於【sBBsBs】。

2）REPLACE(old_text,start_num,num_chars,new_text)：根據指定長度，用其他正文來取代原正文中指定位置和長度的內容。

Old_text：原始正文或儲存格引用。

Start_num：取代的起始位置。

Num_chars:  取代的長度，即被取代正文的字元數。

New_text：取代的正文。

範例：

REPLACE("0123456789",5,4,"*") 等於“0123*89”
REPLACE("1980",3,2,"99") 等於“1999”。

儲存格引用、代表位置和長度的數字不能帶引號；原始、取代和被取代的正文必須帶英文引號（不區分單，雙引號）。

第一種將取代所有符合條件的正文，第二種只取代指定位置的正文。

注：使用 REPLACE 函式傳參給下拉框元件時， 單次取數最多取代 500 個值。

REPEAT(text,number_times)： 根據指定的次數重複顯示正文。REPEAT 函式可用來顯示同一字串，並對儲存格進行填充。

Text：需要重複顯示的正文或包含正文的儲存格引用。

Number_times：指定正文重複的次數，且為正數。如果 number_times 為 0，REPEAT 函式將傳回“”（空正文）。如果 number_times 不是整數，將被取整。REPEAT 函式的最終結果通常不大於 32767 個字元。

注： 該函式可被用於在工作表中建立簡單的直方圖。

範例：

REPEAT("$",4) 等於“$$$$”。

如果儲存格 B10 的內容為“你好”，則：

REPEAT(B10,3) 等於“你好你好你好”。

RIGHT(text,num_chars)：根據指定的字元數從右開始傳回正文串中的最後一個或幾個字元。

Text：包含需要提取字元的正文串或儲存格引用。

Num_chars：指定 RIGHT 函式從正文串中提取的字元數。Num_chars 不能小於 0。

如果 num_chars 大於正文串長度，RIGHT函式將傳回整個正文。如果不指定 num_chars，則預設值為 1。

範例：

RIGHT("It is interesting",6) 等於“esting”。

RIGHT("Share Holder") 等於“r”。

RIGHT("Huge sale",4) 等於“sale”。

SPLIT(String1,String2)：傳回由 String2 分割 String1 組成的字串陣列。

String1：以雙引號表示的字串。

String2：以雙引號表示的分隔符。例如逗號","

注：

如果只有一個參數，則傳回一個錯誤。

如果有多個參數，則只有前兩個起作用。

範例：

SPLIT("hello,world,yes",",") = ["hello","world","yes"]。

SPLIT("this is very good"," ") = ["this","is","very","good"]。

STARTWITH(str1,str2)：判斷字串 str1 是否以 str2 開始。

注： str1 和 str2 都是大小寫敏感的。

範例：

STARTWITH("FineReport","Fine") 等於 true。

STARTWITH("FineReport","Report") 等於 false。

SUBSTITUTE(text,old_text,new_text,instance_num)：用new_text取代正文串中的old_text。

Text：需要被取代字元的正文，或含有正文的儲存格引用。

Old_text：需要被取代的部分正文。

New_text：用於取代 old_text 的正文。

Instance_num：指定用 new_text 來取代第幾次出現的 old_text。如果指定了 instance_num，則只有指定位置上的 old_text 被取代，否則文字串中出現的所有 old_text 都被 new_text 取代。

範例：

SUBSTITUTE("data base","base","model") 等於“data model”。

SUBSTITUTE("July 28, 2000","2","1",1) 等於“July 18, 2000”。

SUBSTITUTE("July 28, 2000","2","1") 等於“July 18, 1000”。

SUBSTITUTE("July 28, 2000","2","1",2) 等於“July 28, 1000”。

TODOUBLE(text)：將正文轉換成 Double 物件。

Text：需要轉換的正文。

範例：

TODOUBLE("123.21") 等於 new Double(123.21)。

TOINTEGER(text)：將正文轉換成 Integer 物件。

Text：需要轉換的正文。

範例：

TOINTEGER("123") 等於 123。

TRIM(text)：清除正文首尾所有的空格、分離字元。

Text：需要清除的正文。

範例：

TRIM(" Monthly Report") 等於 Monthly Report。

UPPER(text)：將正文中所有的字元轉化為大寫。

Text：需要轉化為大寫字元的正文，或是包含正文的儲存格引用。

範例：

UPPER("notes") 等於“NOTES”。

如果儲存格E5的值為“Examples”，則：

UPPER(E5)等於“EXAMPLES”。

1）概述

2）注意事項

無

3）範例

NUMTOZH(1234) 等於 一千二百三十四

NUMTOZH(1234,1) 等於 一千二百三十四

NUMTOZH(1234,2) 等於 壹仟貳佰叄拾肆

NUMTOZH(1234,3) 等於 一二三四

1）概述

2）注意事項

11.0.5 以及之後的版本支援使用。

3）範例

• ENBYSTRNUM("帆軟軟體有限公司",4) 等於

帆軟軟體

有限公司

• ENBYSTRNUM("帆軟軟體有限公司",2) 等於

帆軟

軟體

有限

公司

1）概述

2）注意事項

若字串中沒有數字時，傳回null

11.0.5 以及之後的版本支援使用。

3）範例

TEXTGETNUM(asf2d45g6r7742e) 等於 24567742

TEXTGETNUM(asfwddfgyruurwe) 等於 null

1）概述

2）注意事項

需要尋找的字串在目標字串中匹配不到時，直接傳回0

11.0.5 以及之後的版本支援使用。

3）範例

GETCHARNUM("2021-03-23",-) 等於 2

GETCHARNUM("abccccccccdef","cc") 等於 4

GETCHARNUM("abccccccccdef","ccc") 等於 2

1）概述

2）注意事項

11.0.4 以及之後的版本支援使用。

3）範例

MIDCHAR("1234666", '6') 等於 "66"

MIDCHAR("1234666", '6',1,true) 等於 "66"

MIDCHAR("1234666", '6',1,false) 等於 "1234"