UReport2 函數(shù)

UReport2教學(xué)視頻http://pan.baidu.com/s/1boWTxF5，密碼：98hj

       在前一小節(jié)中，我們介紹了表達(dá)式，實(shí)際上函數(shù)也是表達(dá)式的一種。在UReport2當(dāng)中提供了大量的內(nèi)置函數(shù)，通過這些內(nèi)置函數(shù)，可以實(shí)現(xiàn)各種各樣的報(bào)表計(jì)算功能。函數(shù)語法格式如下：

      函數(shù)名([表達(dá)式,表達(dá)式...])

      下面我們就來逐個(gè)介紹UReport2內(nèi)置的函數(shù)。

常用函數(shù)

count函數(shù)(統(tǒng)計(jì)數(shù)量)

        count函數(shù)是對(duì)給定的表達(dá)式在計(jì)算后對(duì)象數(shù)量進(jìn)行統(tǒng)計(jì)。

sum函數(shù)(累加)

       sum函數(shù)是對(duì)給定的表達(dá)式在計(jì)算后值進(jìn)行累加，sum函數(shù)要求各個(gè)表達(dá)式計(jì)算后的值必須是數(shù)字，否則將產(chǎn)生錯(cuò)誤。

avg函數(shù)(求平均值)

       avg函數(shù)是對(duì)給定的表達(dá)式在計(jì)算后值求平均值，avg函數(shù)要求各個(gè)表達(dá)式計(jì)算后的值必須是數(shù)字，否則將產(chǎn)生錯(cuò)誤。

max函數(shù)(求最大值)

       max函數(shù)是對(duì)給定的表達(dá)式在計(jì)算后值求其中的最大值，max函數(shù)要求各個(gè)表達(dá)式計(jì)算后的值必須是數(shù)字，否則將產(chǎn)生錯(cuò)誤。

min函數(shù)(求最小值)

       min函數(shù)是對(duì)給定的表達(dá)式在計(jì)算后值求其中的最小值，min函數(shù)要求各個(gè)表達(dá)式計(jì)算后的值必須是數(shù)字，否則將產(chǎn)生錯(cuò)誤。

row函數(shù)（取行號(hào)）

       取當(dāng)前單元格所在行的行號(hào)，這個(gè)函數(shù)比較簡單，它沒有參數(shù)。

column函數(shù)（取列號(hào)）

      取當(dāng)前單元格所在列的列號(hào)，這個(gè)函數(shù)比較簡單，它沒有參數(shù)。

order函數(shù)（排序）

       order函數(shù)需要兩個(gè)參數(shù)，第一個(gè)為要進(jìn)行排序的對(duì)象表達(dá)式，第二個(gè)是一個(gè)布爾值，用來設(shè)置排序方式，true正序，false為倒序。

list函數(shù)（羅列數(shù)據(jù)）

       取到表達(dá)式中定義所有數(shù)據(jù)，并以集合形式返回。

param函數(shù)（取參數(shù)）

       param函數(shù)用來獲取外部傳入的參數(shù)，它需要一個(gè)參數(shù)，用于指定要獲取的參數(shù)名稱。

emptyparam函數(shù)（判斷參數(shù)是否為空）

       emptyparam函數(shù)用于判斷指定的外部參數(shù)是否為null或空字符串，如果是返回true，否則返回false，該函數(shù)為2.2.3版本新增，如果要使用該函數(shù)，請注意您當(dāng)前使用的ureport版本。

       emptyparam函數(shù)一般用于SQL數(shù)據(jù)集SQL表達(dá)式里，比如下面的寫法：

${

   "select * from employee where 1=1 "+ (param("name")!=null && param("name")!="" ? "name=:name" : "")
} 

       上述的SQL判斷采用的是param函數(shù)，由于要同時(shí)判斷為null以及""，寫起來比較麻煩，如改用emptyparam函數(shù)就簡單多了。

${

   "select * from employee where 1=1 "+ (emptyparam("name")==false ? "and name=:name" : "")
} 

formatdate函數(shù)（格式化日期）

       對(duì)給定的日期參數(shù)進(jìn)行格式化，它至少需要一個(gè)參數(shù)，第一個(gè)參數(shù)是要格式化的日期類型的對(duì)象，第二個(gè)參數(shù)是可選的，用于定義格式化采用的模式，如不指定則用默認(rèn)的：yyyy-MM-dd HH:mm:ss來進(jìn)行格式化。

formatnumber函數(shù)（格式化數(shù)字）

       對(duì)給定的參數(shù)進(jìn)行格式化，它至少需要一個(gè)參數(shù)，第一個(gè)參數(shù)是要格式化的數(shù)字對(duì)象，要保證這個(gè)參數(shù)值取到后可以轉(zhuǎn)換成日期，否則將發(fā)生錯(cuò)誤；第二個(gè)參數(shù)是可選的，用于定義數(shù)字格式化采用的模式，如不定義，則采用默認(rèn)的#來進(jìn)行格式化。

get函數(shù)（獲取指定位置數(shù)據(jù)）

       get函數(shù)是2.1.2版本中新增的，它的作用是獲取數(shù)據(jù)集中指定位置的對(duì)象或?qū)ο蟮哪硞€(gè)屬性值。get函數(shù)可以有三個(gè)參數(shù)，第一個(gè)為目標(biāo)集合對(duì)象、第二個(gè)為數(shù)據(jù)位置、第三個(gè)是對(duì)象屬性，其中第一個(gè)參數(shù)是必須的，后面兩個(gè)參數(shù)為可選。

分頁相關(guān)函數(shù)

       所謂分頁相關(guān)函數(shù)，是指這些函數(shù)是在分頁的時(shí)候進(jìn)行計(jì)算，比如計(jì)算當(dāng)前頁有多少條記錄、當(dāng)前頁某個(gè)單元格值累加后是多少、平均值是多少、最大值是多少等等。

分頁相關(guān)函數(shù)使用一般來說，分頁相關(guān)函數(shù)多用在行類型為“重復(fù)表頭”或“重復(fù)表尾”的行中的單元格里。同時(shí)，需要注意的是，分頁相關(guān)函數(shù)只會(huì)在分頁預(yù)覽時(shí)顯示，這點(diǎn)需要注意。

pcount函數(shù)

       統(tǒng)計(jì)當(dāng)前頁下表達(dá)對(duì)應(yīng)值的數(shù)目，與count函數(shù)的使用方法基本一致，不同之處在于pcount只會(huì)統(tǒng)計(jì)當(dāng)前頁中對(duì)應(yīng)的表達(dá)式內(nèi)容的數(shù)目。

psum函數(shù)

        將當(dāng)前頁下表達(dá)式對(duì)應(yīng)的所有值進(jìn)行累加，與sum函數(shù)對(duì)應(yīng)，不同的是psum只針對(duì)當(dāng)前頁。

pmax函數(shù)

       比較當(dāng)前頁中，表達(dá)式對(duì)應(yīng)的值，找出其中最大的那個(gè)值，與max函數(shù)對(duì)應(yīng)，只是pmax只針對(duì)當(dāng)前頁。

pmin函數(shù)

       比較當(dāng)前頁中，表達(dá)式對(duì)應(yīng)的值，找出其中最小的那個(gè)值，與min函數(shù)對(duì)應(yīng)，只是pmin只針對(duì)當(dāng)前頁。

page函數(shù)

       輸出當(dāng)前所在頁的頁碼，該函數(shù)沒有參數(shù)。

pages函數(shù)

       輸出當(dāng)前報(bào)表一共有多少頁，該函數(shù)沒有參數(shù)。

pages函數(shù)的使用范圍pages函數(shù)目前僅能在頁眉頁腳中使用

數(shù)學(xué)函數(shù)

abs函數(shù)（絕對(duì)值）

       求參數(shù)的絕對(duì)值，參數(shù)值計(jì)算后數(shù)據(jù)類型必須是數(shù)字，否則會(huì)報(bào)錯(cuò)。

ceil函數(shù)（最小值）

       對(duì)參數(shù)值取最小值，如果參數(shù)值為小數(shù)將舍棄小數(shù)點(diǎn)后面的小數(shù)部分，參數(shù)值計(jì)算后數(shù)據(jù)類型必須是數(shù)字，否則會(huì)報(bào)錯(cuò)。

floor函數(shù)（最大值）

      對(duì)參數(shù)值取最大值，如果參數(shù)值為小數(shù)將四舍五入小數(shù)點(diǎn)后面的小數(shù)部分，參數(shù)值計(jì)算后數(shù)據(jù)類型必須是數(shù)字，否則會(huì)報(bào)錯(cuò)。

chn函數(shù)（數(shù)字轉(zhuǎn)中文）

       將一個(gè)數(shù)字轉(zhuǎn)化成中文，參數(shù)值計(jì)算后數(shù)據(jù)類型必須是數(shù)字，否則會(huì)報(bào)錯(cuò)。

chn函數(shù)使用注意事項(xiàng)chn函數(shù)轉(zhuǎn)換數(shù)字即可是整數(shù)，也可是小數(shù)，如果是小數(shù)支持后面最多兩位小數(shù)，如果實(shí)際小數(shù)過多，chn函數(shù)會(huì)先進(jìn)行四舍五入，然后再進(jìn)行轉(zhuǎn)換。

rmb函數(shù)（數(shù)字轉(zhuǎn)換為大寫的人民幣金額）

         將一個(gè)數(shù)字轉(zhuǎn)換成中文大寫的人民幣金額，參數(shù)值計(jì)算后數(shù)據(jù)類型必須是數(shù)字，否則會(huì)報(bào)錯(cuò)。

rmb函數(shù)使用注意事項(xiàng)rmb函數(shù)轉(zhuǎn)換數(shù)字即可是整數(shù)，也可是小數(shù)，如果是小數(shù)支持后面最多兩位小數(shù)，如果實(shí)際小數(shù)過多，rmb函數(shù)會(huì)先進(jìn)行四舍五入，然后再進(jìn)行轉(zhuǎn)換。

cos函數(shù)（求余弦）

       求參數(shù)的余弦值，參數(shù)值計(jì)算后數(shù)據(jù)類型必須是數(shù)字，否則會(huì)報(bào)錯(cuò)。

sin函數(shù)（正弦）

       求參數(shù)的正弦值，參數(shù)值計(jì)算后數(shù)據(jù)類型必須是數(shù)字，否則會(huì)報(bào)錯(cuò)。

tan函數(shù)（正切）

      求參數(shù)的正切值，參數(shù)值計(jì)算后數(shù)據(jù)類型必須是數(shù)字，否則會(huì)報(bào)錯(cuò)。

exp函數(shù)（方法用于返回自然數(shù)底數(shù)e的參數(shù)次方）

       求參數(shù)的自然數(shù)底數(shù)e的參數(shù)次方，參數(shù)值計(jì)算后數(shù)據(jù)類型必須是數(shù)字，否則會(huì)報(bào)錯(cuò)。

log10函數(shù)（返回以10為底的對(duì)數(shù)值）

       求參數(shù)以10為底的對(duì)數(shù)值，參數(shù)值計(jì)算后數(shù)據(jù)類型必須是數(shù)字，否則會(huì)報(bào)錯(cuò)。

log函數(shù)（自然對(duì)數(shù)）

       求參數(shù)自然對(duì)數(shù)值，參數(shù)值計(jì)算后數(shù)據(jù)類型必須是數(shù)字，否則會(huì)報(bào)錯(cuò)。

median函數(shù)（中位數(shù)）

        求一組數(shù)據(jù)的中位數(shù)，參數(shù)值計(jì)算后數(shù)據(jù)類型必須是數(shù)字，否則會(huì)報(bào)錯(cuò)。

mode函數(shù)（眾數(shù)）

        求一組數(shù)據(jù)的眾數(shù)，參數(shù)值計(jì)算后數(shù)據(jù)類型必須是數(shù)字，否則會(huì)報(bào)錯(cuò)。

vara函數(shù)（方差）

        求一組數(shù)據(jù)的方差，參數(shù)值計(jì)算后數(shù)據(jù)類型必須是數(shù)字，否則會(huì)報(bào)錯(cuò)。

stdevp函數(shù)（標(biāo)準(zhǔn)差）

        求一組數(shù)據(jù)的標(biāo)準(zhǔn)差，參數(shù)值計(jì)算后數(shù)據(jù)類型必須是數(shù)字，否則會(huì)報(bào)錯(cuò)。

pow函數(shù)（返回第一個(gè)參數(shù)的第二個(gè)參數(shù)次方）

pow函數(shù)需要兩個(gè)參數(shù)，第一個(gè)為需要計(jì)算的數(shù)字或表達(dá)式，第二個(gè)為具體的次方。

random函數(shù)（隨機(jī)數(shù)）

生成一個(gè)隨機(jī)數(shù)，可以有一個(gè)數(shù)字類型的參數(shù)或表達(dá)式，如果有參數(shù)，那么以這個(gè)參數(shù)作為生成隨機(jī)數(shù)字的種子，如果沒有則生成一個(gè)0~1之間的隨機(jī)數(shù)。

round函數(shù)（四舍五入）

對(duì)一個(gè)小數(shù)進(jìn)行四舍五入，它需要兩個(gè)參數(shù)，第一個(gè)參數(shù)要進(jìn)行四舍五入的小數(shù)或表達(dá)式，第二個(gè)為

一個(gè)可選的

要保留的小數(shù)位數(shù)，如果沒有，則不保留小數(shù)。

sqrt函數(shù)（平方根）

求一個(gè)數(shù)字或表達(dá)式計(jì)算后值的平方根，參數(shù)值計(jì)算后數(shù)據(jù)類型必須是數(shù)字，否則會(huì)報(bào)錯(cuò)。

日期函數(shù)

date函數(shù)（日期）

輸出日期，date函數(shù)可以有一個(gè)參數(shù)，就是日期格式，如果沒有則采用yyyy-MM-dd HH:mm:ss格式輸出日期。

day函數(shù)（天）

輸出當(dāng)前在月份中的天，該函數(shù)沒有參數(shù)。

month函數(shù)（月） 

輸出當(dāng)前月份，該函數(shù)沒有參數(shù)。 

week函數(shù)（星期）

輸出當(dāng)前是星期幾，該函數(shù)沒有參數(shù)。

year函數(shù)（年） 

輸出當(dāng)前年份，該函數(shù)沒有參數(shù)

字符串函數(shù)

indexOf函數(shù)(位置)

      用于返回一個(gè)字符串，在目標(biāo)字符串中的位置，該函數(shù)至少需要兩個(gè)參數(shù)，第一個(gè)為目標(biāo)字符串，第二個(gè)為要查找的字符串，如果有三個(gè)參數(shù)，那么第三個(gè)就是開始查找的位置信息，第三個(gè)參數(shù)必須是一定大于等于0的數(shù)字。

length函數(shù)（長度）

       求目標(biāo)字符串長度，該函數(shù)必須要有一個(gè)參數(shù)。

lower函數(shù)（轉(zhuǎn)小寫）

  將參數(shù)中英文全部轉(zhuǎn)為小寫，該函數(shù)必須要有一個(gè)參數(shù)。

upper函數(shù)（轉(zhuǎn)大寫）

  將參數(shù)中英文全部轉(zhuǎn)為大寫，該函數(shù)必須要有一個(gè)參數(shù)。

replace函數(shù)（替換字符串）

這個(gè)函數(shù)需要有三個(gè)參數(shù)，第一個(gè)是目標(biāo)字符串，第二個(gè)是要被替換的字符串，第三個(gè)是要替換的字符串。

substring函數(shù)（子字符串）

       該函數(shù)允許有三個(gè)參數(shù)，第一個(gè)是目標(biāo)字符串，第二個(gè)為開始截取的位置，第三個(gè)為截取結(jié)束的位置。

trim函數(shù)（去空格）

       去除目標(biāo)字符串兩邊空格，該函數(shù)要求必須要有一個(gè)參數(shù)。

json函數(shù)（解析JSON字符串）

      json函數(shù)是2.1.3版本新增的，該函數(shù)可以解析指定的目標(biāo)JSON字符串，并取出指定的屬性值。json函數(shù)需要有兩個(gè)參數(shù)，第一個(gè)是目標(biāo)JSON字符串對(duì)象，第二個(gè)是要取出的屬性名。

對(duì)JSON字符串的要求json函數(shù)在解析JSON字符串時(shí)，要求必須是標(biāo)準(zhǔn)的JSON字符串，比如下面這樣的：{"name":"superman","age":32,"company":{"name":"bstek","address":"SHANGHAI CHINA"}}也就是key屬性也需要用“”包裹的，如果是下面這種類型的JSON字符串就解析時(shí)就會(huì)產(chǎn)生錯(cuò)誤：{name:"superman",age:32,company:{name:"bstek",address:"SHANGHAI CHINA"}}