java報表工具FineReport常用函數(shù)的用法總結(jié)（文本函數(shù)）

杰華園

文本函數(shù)
CHAR

CHAR(number):根據(jù)指定數(shù)字返回對應(yīng)的字符。CHAR函數(shù)可將計算機其他類型的數(shù)字代碼轉(zhuǎn)換為字符。

Number:用于指定字符的數(shù)字，介于1Number:用于指定字符的數(shù)字，介于165535之間（包括1和65535）。

示例:

CHAR(8等于“X”。

CHAR(45)等于“-”。



CODE

CODE(text):計算文本串中第一個字符的數(shù)字代碼。返回的代碼對應(yīng)于計算機使用的字符集。

Text:需要計算第一個字符代碼的文本或單元格引用。

示例:

CODE("S"等于83。

CODE("Spreadsheet"等于83。



CONCATENATE

CONCATENATE(text1,text2,...):將數(shù)個字符串合并成一個字符串。

Text1,text2,...:需要合并成單個文本的文本項，可以是字符，數(shù)字或是單元格引用。

備注:

也可以用“&”來代替CONCATENATE函數(shù)對文本項進(jìn)行合并。

示例:

CONCATENATE("Average ","rice"等于“Average Price”，這相當(dāng)于“Average”&“ ”&“Price”。

CONCATENATE("1","2"等于12。



ENDWITH

ENDWITH(str1，str2):判斷字符串str1是否以str2結(jié)束。 備注: str1和str2都是大小寫敏感的。

示例:

ENDWITH("FineReport","Report"等于true

ENNUMBER。ENDWITH("FineReport","Fine"等于false。 ENDWITH("FineReport"，"report"ENNUMBER

ENNUMBER(value):將給定的BigDecimal類型的數(shù)字轉(zhuǎn)化成英文金額的字符串。



ENMONEY

ENMONEY(value):將給定的BigDemical類型的數(shù)字轉(zhuǎn)換成英文金額字符串。

示例：

ENMONEY(23.49)等于TWENTY。



ENNUMER

ENNUMBER(value):將給定的BigDecimal類型的數(shù)字轉(zhuǎn)化成英文金額的字符串。



EXACT

EXACT(text1,text2):檢測兩組文本是否相同。如果完全相同，EXACT函數(shù)返回TRUE；否則，返回FALSE。EXACT函數(shù)可以區(qū)分大小寫，但忽略格式的不同。同時也可以利用EXACT函數(shù)來檢測輸入文檔的文字。

Text1:需要比較的第一組文本。

Text2:需要比較的第二組文本。

示例:

EXACT("Spreadsheet","Spreadsheet"等于TRUE。

EXACT("Spreadsheet","S preadsheet"等于FALSE。

EXACT("Spreadsheet","spreadsheet"等于FALSE。



FIND

FIND(find_text,within_text,start_num):在文本串中查找另一文本串，并且從within_text中的第一個字符開始返回到find_text的起始位置編號。也可以使用SEAERCH函數(shù)在文本串中查找另一文本串，所不同的是FIND函數(shù)能區(qū)分大小寫，但不允許使用通配符。

Find_text:需要查找的文本或包含文本的單元格引用。

Within_text:包含需要查找文本的文本或單元格引用。

Start_num:指定進(jìn)行查找字符的起始位置。在within_text中起始位置字符編號為1。如果省略start_num，則假設(shè)值為1。

備注:

如果find_text不在within_text中，F(xiàn)IND函數(shù)返回錯誤信息*VALUE!。

如果start_num不大于0，F(xiàn)IND函數(shù)返回錯誤信息*VALUE!。

如果start_num大于within_text的長度，F(xiàn)IND函數(shù)返回錯誤信息*VALUE!。

如果find_text是空白文本，F(xiàn)IND函數(shù)將在搜索串中匹配第一個字符（即編號為start_num或1的字符）。

示例:

FIND("I","Information"等于1。

FIND("i","Information")等于9。

FIND("o","Information",2)等于4。

FIND("o","Information",12)等于*VALUE!。



INDEXOF

INDEXOF(str1，index):返回字符串str1在index位置上的字符。

備注:

index是從0開始計數(shù)的。

示例:

INDEXOF("FineReport",0)等于'F'。

INDEXOF("FineReport",2)等于'n'。

INDEXOF("FineReport"，9)等于't'。



LEFT

LEFT(text,num_chars):根據(jù)指定的字符數(shù)返回文本串中的第一個或前幾個字符。

Text:包含需要選取字符的文本串或單元格引用。

Num_chars:指定返回的字符串長度。

備注:

Num_chars的值必須等于或大于0。

如果num_chars大于整個文本的長度，LEFT函數(shù)將返回所有的文本。

如果省略num_chars，則默認(rèn)值為1。

示例:

LEFT("Fine software",等于“Fine sof”。

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

如果單元格A3中含有“China”，則LEFT(A3,2)等于“Ch”。



LEN

LEN(text):返回文本串中的字符數(shù)。

Text:需要求其長度的文本，空格也計為字符。

示例:

LEN("Evermore software")等于17。

LEN(" ")等于1。



LOWER

LOWER(text):將所有的大寫字母轉(zhuǎn)化為小寫字母。

Text:需要轉(zhuǎn)化為小寫字母的文本串。LOWER函數(shù)不轉(zhuǎn)化文本串中非字母的字符。

示例:

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

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



MID

MID(text,start_num,num_chars):返回文本串中從指定位置開始的一定數(shù)目的字符，該數(shù)目由用戶指定。

Text:包含要提取字符的文本串。

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

Num_chars:返回字符的長度。

備注:

如果start_num大于文本長度，MID函數(shù)返回“”（空文本）。

如果start_num小于文本長度，并且start_num加上num_chars大于文本長度，MID函數(shù)將從start_num指定的起始字符直至文本末的所有字符。

如果start_num小于1，MID函數(shù)返回錯誤信息*VALUE!。

如果num_chars是負(fù)數(shù)，MID函數(shù)返回錯誤信息*VALUE!。

示例:

MID("Finemore software",10,返回“software”。

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

MID("Finemore software",0,返回*VALUE!。

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



NUMTO

NUMTO(number):返回number的中文表示。

示例：NUMTO(2345)等于二三四五。



PROPER

PROPER(text):將文本中的第一個字母和所有非字母字符后的第一個字母轉(zhuǎn)化成大寫，其他字母變?yōu)樾�寫�?br />
Text:需要轉(zhuǎn)化為文本的公式、由雙引號引用的文本串或是單元格引用。

示例:

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

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

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



REGEXP

REGEXP(str, pattern):字符串str是否與正則表達(dá)式pattern相匹配。

示例：

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

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

REGEXP(str, pattern, intNumber):字符串str是否與具有給定模式 intNumber的正則表達(dá)式pattern相匹配。

備注：

CASE_INSENSITIVE = 0啟用不區(qū)分大小寫的匹配。

標(biāo)志連同此標(biāo)志來啟用 Unicode感知的、不區(qū)分大小寫的匹配。 默認(rèn)情況下，不區(qū)分大小寫的匹配假定僅匹配 US-ASCII字符集中的字符。可以通過指定 UNICODE_CASE

MULTILINE = 1啟用多行模式。

DOTALL = 2啟用 dotall模式。

在 dotall模式中，表達(dá)式 可以匹配任何字符，包括行結(jié)束符。默認(rèn)情況下，此表達(dá)式不匹配行結(jié)束符。

UNICODE_CASE = 3啟用 Unicode感知的大小寫折疊

指定此標(biāo)志后，由CASE_INSENSITIVE標(biāo)志啟用時，不區(qū)分大小寫的匹配將以符合 Unicode Standard的方式完成。

CANON_EQ = 4啟用規(guī)范等價。

指定此標(biāo)志后，當(dāng)且僅當(dāng)其完整規(guī)范分解匹配時，兩個字符才可視為匹配。

UNIX_LINES = 5啟用 Unix行模式。

在此模式中，.、^和 $的行為中僅識別 '\n'行結(jié)束符。

LITERAL = 6啟用模式的字面值解析。

指定此標(biāo)志后，指定模式的輸入字符串就會作為字面值字符序列來對待。輸入序列中的元字符或轉(zhuǎn)義序列不具有任何特殊意， 標(biāo)志 CASE_INSENSITIVE和 UNICODE_CASE在與此標(biāo)志一起使用時將對匹配產(chǎn)生影，其他標(biāo)志都變得多余了。

COMMENTS = 7模式中允許空白和注釋。

此模式將忽略空白和在結(jié)束行之前以 #開頭的嵌入式注釋。

示例：

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

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



REPLACE

REPLACE(old_text,start_num,num_chars,new_text):根據(jù)指定的字符數(shù)，用其他文本串來替換某個文本串中的部分內(nèi)容。

Old_text:需要被替換部分字符的文本或單元格引用。

Start_num:需要用new_text來替換old_text中字符的起始位置。

Num_chars:需要用new_text來替換old_text中字符的個數(shù)。

New_text:需要替換部分舊文本的文本。

示例:

REPLACE("0123456789",5,4,"*")等于“0123*89”。

REPLACE("1980",3,2,"99")等于“1999”。



REPT

REPT(text,number_times):根據(jù)指定的次數(shù)重復(fù)顯示文本。REPT函數(shù)可用來顯示同一字符串，并對單元格進(jìn)行填充。如果number_times為0，REPT函數(shù)將返回“”（空文本）。如果number_times不是整數(shù)，將被取整。REPT函數(shù)的最終結(jié)果通常不大于32767個字符。

Text:需要重復(fù)顯示的文本或包含文本的單元格引用。

Number_times:指定文本重復(fù)的次數(shù)，且為正數(shù)。

備注:

該函數(shù)可被用于在工作表中創(chuàng)建簡單的直方圖。

示例:

REPT("$",4)等于“$$$$”。

如果單元格B10的內(nèi)容為“你好”，REPT(B10,3.6)等于“你好你好你好”。



RIGHT

RIGHT(text,num_chars):根據(jù)指定的字符數(shù)從右開始返回文本串中的最后一個或幾個字符。

Text:包含需要提取字符的文本串或單元格引用。

Num_chars:指定RIGHT函數(shù)從文本串中提取的字符數(shù)。Num_chars不能小于0。

如果num_chars大于文本串長度，RIGHT函數(shù)將返回整個文本。如果不指定num_chars，則默認(rèn)值為1。

示例:

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

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

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



SPLIT

SPLIT(String1,String2)：返回由String2分割String1組成的字符串?dāng)?shù)組。

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

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

備注:

如果只有一個參數(shù)，則返回一個錯誤。

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

示例:

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

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

STARTWITH

STARTWITH(str1，str2):判斷字符串str1是否以str2開始。

備注:

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

示例:

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

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

STARTWITH("FineReport"，"Fine")等于false。



SUBSTITUTE

SUBSTITUTE(text,old_text,new_text,instance_num):用new_text替換文本串中的old_text。

Text:需要被替換字符的文本，或含有文本的單元格引用。

Old_text:需要被替換的部分文本。

New_text:用于替換old_text的文本。

Instance_num:指定用new_text來替換第幾次出現(xiàn)的old_text。如果指定了instance_num，則只有指定位置上的old_text被替換，否則文字串中出現(xiàn)的所有old_text都被new_text替換。

備注:

如果需要替換文本串中的指定文本，則使用SUBSTITUTE函數(shù)；如果需要替換文本串中指定位置上的任意文本，則使用REPLACE函數(shù)。

示例:

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

TODOUBLE(text):將文本轉(zhuǎn)換成Double對象。

Text:需要轉(zhuǎn)換的文本。

示例:

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

TOINTEGER

TOINTEGER(text):將文本轉(zhuǎn)換成Integer對象。

Text:需要轉(zhuǎn)換的文本。

示例:

TOINTEGER("123")等于 new Integer(123)。



TRIM

TRIM(text):清除文本中所有空格，單詞間的單個空格除外，也可用于帶有不規(guī)則空格的文本。

Text:需要清除空格的文本。

示例:

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



TOIMAGE

TOIMAGE(path):返回path路徑下的image。



UPPER

UPPER(text):將文本中所有的字符轉(zhuǎn)化為大寫。

Text:需要轉(zhuǎn)化為大寫字符的文本，或是包含文本的單元格引用。

示例:

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

如果單元格E5的值為“Examples”，則UPPER(E5)等于“EXAMPLES”。