转换及判断函数

isdate

函数说明:判定字符串是否具有转换成日期的合法格式

语法:isdate( string )

参数说明:

  1. string 字符串表达式

返回类型:布尔型

举例说明:

  1. 例1:isdate("2006-10-10") 返回:true
  2. 例2:isdate("2006-10-10 10:20:30") 返回:true
  3. 例3:isdate("20061010") 返回:false
  4. 例4:isdate("10:20:30") 返回:false

isEmpty

注:该函数支持excel公式导出、支持填报报表单元格自动计算

函数说明:判定表达式运算的结果列表中的元素个数是否为0,或者运算的结果是否为null

语法:isEmpty(exp)

参数说明:exp 表达式

返回值:布尔型

举例说明:例1:isempty(ds.select(订单ID)),如果数据集ds中订单ID个数为0或没找到符合条件的订单ID,则结果为true,否则为false

isinclude

函数说明:判断一个值是否在一个列表中

语法:isinclude( valueExp, ListExp)

参数说明:

valueExp 返回值的表达式,值可以是字符串、数值、日期、时间等

ListExp 返回同valueExp数据类型相同的数组。

返回值:布尔型

举例说明:例1:isinclude("北京",list("天津","上海","北京","重庆"))    返回:true

isnumber

注:该函数支持excel公式导出、支持填报报表单元格自动计算

函数说明:判定字符串是否具有转换成数值的合法格式

语法:isnumber( string )

参数说明:string 字符串表达式

返回值:布尔型

举例说明:

  1. 例1:isnumber("abc") 返回:false
  2. 例2:isnumber("1234") 返回:true

istime

函数说明:判定字符串是否具有转换成时间的合法格式

语法:istime( string )

参数说明:string 字符串表达式

返回值:布尔型

举例说明:

  1. 例1:istime("2006-10-10") 返回 false
  2. 例2:istime("2006-10-10 10:20:30") 返回 false
  3. 例3:istime("20061010") 返回 false
  4. 例4:istime("10:20:30") 返回 true

tobigint

注:该函数支持excel公式导出、支持填报报表单元格自动计算

函数说明:将字符串转换成大整数或对数值型数据取整返回大整数(BigInteger)

语法:tobigint(stringExp)/tobigint(numberExp)

参数说明:

stringExp   需要转化的字符串表达式

numberExp  需要取整的数值表达式,超过64位要用decimal类型,缺省为double类型

返回值:大整数BigInteger

tochn

函数说明:将一个数字(只支持小数点后两位)转化成汉字大写

语法:tochn( numExp{, abbrivateExp{, uppercaseExp }} )

参数说明:

numExp 整数表达式

abbrivateExp 为true时采用亿万千百十的写法,为false时采用一二三四五六七的写法,缺省为false

uppercaseExp 为false时采用零一二三四五六七八九十百千,为true时采用壹贰叁肆伍陆柒捌玖拾佰仟,缺省为false

返回值:字符型

举例说明:

  1. 例1:tochn(1234567,true) 返回:"一百二十三万四千五百六十七"
  2. 例2:tochn(1234567) 返回:"一二三四五六七"
  3. 例3:tochn(1234567,true,true) 返回:"壹佰贰拾叁万肆仟伍佰陆拾柒"

todate

函数说明:将字符串转换成日期型数据

语法:todate(string)

语法:todate(numExp)

参数说明:string  合法日期格式的字符串,如:‘yyyy-MM-dd’或‘yy-MM-dd’

参数说明:numExp  合法的数字,用于兼容Excel的日期算法(Excel日期的数字表示法:从‘1900-01-01’设置常规为‘1’起,到指定日期的天数)

返回值:日期类型

举例说明:

  1. 例1:todate('1999-8-6'),结果为1999-8-6 (这里调整显示格式为日期型)
  2. 例2:todate('99-8-6'),结果为99-8-6 (这里调整显示格式为日期型)
  3. 例3:todate(34191),结果为1993-08-11。表示从1900-01-01经过了34191天的日期 (这里调整显示格式为日期型)

todatetime

函数说明:将字符串转换成日期时间

语法:todatetime(string,{format})/todatetime(long)

参数说明:string     合法的日期格式的字符串,如‘yyyy-MM-dd HH:mm:ss’,‘yy-MM-dd HH:mm:ss’

format  可选参数,标明string参数的格式的格式串,如‘yyyy-MM-dd HH:mm:ss’,‘yy-MM-dd HH:mm:ss’,‘yyyy-MM-dd’ ,‘yy-MM-dd’,‘HH:mm:ss’等

long 以毫秒计的长整数

举例说明:

  1. 例1:todatetime ('1999-8-9 2:12:30'),结果为:1999-8-9 2:12:30(这里调整显示格式为日期时间型)
  2. 例2:todatetime ('99-8-9 2:12:30'),结果为: 8-9-99 2:12AM(这里调整显示格式为日期时间型)
  3. 例3:todatetime(12345),结果为:1970-1-1 8:00:12(这里调整显示格式为日期时间型)
  4. 例4:todatetime('1999-8-9 2:12:30', 'yyyy-MM-dd'),结果为:1999-8-9(这里调整显示格式为日期型)
  5. 例5:todatetime('1999-8-9 2:12:30', 'yy-MM-dd HH:mm:ss'),结果为:08-09-99 2:12AM (这里调整显示格式为日期时间型)
  6. 例6:todatetime('2:12:30', 'HH:mm:ss'),结果为:2:12:30(这里调整显示格式为时间型)

todecimal

函数说明:将字符串或对数值型转换成大浮点数(BigDecimal)

语法:todecimal(stringExp)/todecimal(numberExp)

参数说明:

stringExp    需要转换的字符串表达式

numberExp   数值表达式,只能少于等于64位,超过64位要用字符串

举例说明:例1:=todecimal("12345e6789") 返回:1.2345E+6793

todouble

注:该函数支持excel公式导出、支持填报报表单元格自动计算

函数说明:将字符串或数字转换成64位的双精度浮点数

语法:

todouble( string )

todouble( number )

参数说明:

string 需要转换的字符串表达式

number 数字

返回值:64位的双精度浮点数

举例说明:

  1. 例1:todouble("1234567") 返回:1234567.0
  2. 例2:todouble(1234567) 返回:1234567.0

tofloat

注:该函数支持excel公式导出、支持填报报表单元格自动计算

函数说明:将字符串或数字转换成32位浮点数

语法:

tofloat( string )

tofloat ( number )

参数说明:

string 需要转换的字符串表达式

number 需要转换的数字

返回值:32位浮点数

举例说明:

  1. 例1:tofloat('123'),结果为:123.0
  2. 例2:tofloat(123),结果为:123.0

toint

注:该函数支持excel公式导出、支持填报报表单元格自动计算

函数说明:将字符串或数字转换成整数

语法:

toint( string )

toint( number )

参数说明:

string 需要转换的字符串表达式

number 数字,如果带有小数位,转换后小数位被截掉

返回值:32位整数

举例说明:

  1. 例1:toint( "100" ) 返回:100
  2. 例2:toint( 100.1 ) 返回:100

tojson

函数说明:将数据集或表达式转换成JSON串

语法:

tojson( exp,objName )

参数说明:

exp 数据集或表达式

objName js对象名称(可选参数),默认为"result"

返回值:JSON串

举例说明:

  1. 例1:tojson(10,'age') 返回 {"age":10}
  2. 例2:tojson(ds1.group(#1)) 返回:{"result":["华北","华南","华东","西南"]}
  3. 例3:tojson(ds1) 返回:{"result":[{"地区":"西南","城市":"重庆","数量":80.0},{"地区":"华南","城市":"深圳","数量":12.0}]}

tolong

注:该函数支持excel公式导出、支持填报报表单元格自动计算

函数说明:将字符串或数字转换成64位长整数

语法:

tolong( string )

tolong( number )

参数说明:

string 需要转换的字符串表达式

number 数字,如果带有小数,则小数部分被截掉

返回值:64位长整数

举例说明:

  1. 例1:tolong("1234567") 返回:1234567
  2. 例2:tolong(1234567.789) 返回:1234567

tolunar

函数说明:将公历转换为中国农历

语法:

tolunar(dateExp[,flag])

tolunar(StringExp[,flag])

参数说明:

dateExp 表达式,其结果必须为日期

StringExp 表达式,其结果为中国日期格式的字符串

flag 表达式,表示是否输出为传统的干支纪年法,true表示是,默认是false

返回类型:字符串

举例说明:

  1. 例1:tolunar(now()),结果为2012年二月廿八
  2. 例2:tolunar(now(),true),结果为:壬辰年癸卯月庚辰日
  3. 例3:tolunar("2012-4-20") ,结果为:2012年三月卅十
  4. 例4:tolunar("2012-4-20",true),结果为:壬辰年甲辰月辛亥日

tonumber

注:该函数支持excel公式导出、支持填报报表单元格自动计算

函数说明:将字符串转换成相应的32位整数、64位整数、或者64位符点数

语法:tonumber( string )

参数说明:string 需要转换的字符串表达式

返回值:32位整数、64位整数、或者64位符点数

举例说明:

  1. 例1:tonumber("123") 返回:123
  2. 例2:tonumber("1234567890") 返回:1234567890
  3. 例3:tonumber("12345.7891") 返回:12345.7891

tormb

函数说明:将浮点数(只支持小数点后两位)转换人民币大写格式

语法:tormb( numberExp )

参数说明:numberExp 数据值表达式

返回类型:字符串

举例说明:例1:tormb(123456.89) 返回:"壹拾贰万叁仟肆佰伍拾陆圆捌角玖分"

toroman

函数说明:将一个正整数转换成罗马数字格式

语法:toroman(numberExp)

参数说明:numberExp 数据值表达式

举例说明:

  1. 例1:toroman(1) 返回:"Ⅰ"
  2. 例2:toroman(2) 返回:"Ⅱ"

tostr

函数说明:将对象转换成字符型,转换过程中可以进行格式化

语法:tostr(expression{, format})

参数说明:

expression  需要转换成字符串的常数对象或表达式

format 转换过程中进行格式化的格式串 (yyyy-MM-dd HH:mm:ss、#,###.#、¥或$)

举例说明:

  1. 例1:tostr(now(),"yyyy-MM-dd HH:mm:ss") ,now()是当前时间,返回:“2013-04-24 15:32:32"
  2. 例2:tostr(1234.56,"#,###.#")返回:1,234.6
  3. 例3:tostr(1234.56,"$#.#")返回:$1234.6

 

totime

函数说明:将字符串转换成时间型数据

语法:totime(string)

参数说明:string  合法时间格式的字符串,如:‘HH:mm:ss’

举例说明:

  1. 例1:totime('22:50:30'),结果为:22:50:30(这里调整显示格式为时间型)
  2. 例2:totime('03:50:30'),结果为:3:50:30(这里调整显示格式为时间型)