当前位置:文档之家› PB函数常用

PB函数常用

Max()功能求两个数中的最大值。

语法Max ( x, y )参数x:数值型变量或表达式,参加比较的第一个数y :数值型变量或表达式,参加比较的第二个数返回值以x、y中数据类型更精确的数据类型作为该函数的返回值数据类型。

函数执行成功时返回参数比较的两个数中更大者。

如果任何参数的值为NULL,Max()函数返回NULL。

Min()功能求两个数中的最小值。

语法Min( x, y )参数x:数值型变量或表达式,参加比较的第一个数y :数值型变量或表达式,参加比较的第二个数返回值以x、y中数据类型更精确的数据类型作为该函数的返回值数据类型。

函数执行成功时返回参数比较的两个数中较小者。

如果任何参数的值为NULL,Min()函数返回NULL。

Mod()功能求余数。

语法Mod ( x, y )参数x:数值型变量或表达式,被除数y :数值型变量或表达式,除数返回值以x、y中数据类型更精确的数据类型作为该函数的返回值数据类型。

函数执行成功时返回x除以y所得的余数。

如果任何参数的值为NULL,Mod()函数返回NULL。

Round()功能将x四舍五入到n位。

语法Round ( x, n )参数x:要四舍五入的数值型数据n:整数类型,指定从哪个小数位上四舍五入x。

有效值在0到18之间返回值Decimal。

函数执行成功时返回将x四舍五入到小数点后第n位的数值,如果函数执行失败或任何参数的值为NULL,Round()函数返回NULL。

Truncate()功能截断数值到指定的小数位。

语法Truncate ( x, n )参数x:要截断的数值型数据n:整数类型,指定从哪个小数位上截断x。

有效值在0到18之间返回值Decimal。

函数执行成功时返回将x截断到小数点后第n位的数值,如果函数执行失败或任何参数的值为NULL,Truncate()函数返回NULL。

所谓截断就是舍弃指定位之后的数值。

Asc()功能得到字符串第一个字符的ASCII码整数值。

语法Asc ( string )参数string:要得到第一个字符ASCII值的字符串返回值Integer。

函数执行成功时返回string 参数第一个字符的ASCII值,如果string参数的值为NULL,则Asc()函数返回NULL。

Char()功能将字符串的第一个字符、Blob变量的第一个值、或一个整数转换成字符。

语法Char ( n )参数n:字符串、Blob变量或整数,也可以是包含上述类型数据的Any类型变量返回值Char。

返回参数n的第一个字符。

如果n参数的值为NULL,则Char()函数返回NULL。

Dec()功能将字符串或Blob值转换成Decimal类型的值。

Long()功能将其它类型的数据转换为Long类型的值。

该函数有两种语法格式:语法一、将两个无符号整数组合成一个长整数值;语法二、将字符串或Blob值转换成Long类型的值。

下面分别予以介绍:语法一、将两个无符号整数组合成一个长整数值语法Long ( lowword, highword )参数lowword:UnsignedInteger类型,指定长整数中的低位值highword:UnsignedInteger类型,指定长整数中的高位值返回值Long。

函数执行成功时返回由低位值和高位值组合后的长整数值,发生错误时返回-1。

如果任何参数的值为NULL,则Long()函数返回NULL。

语法二、将字符串或Blob值转换成Long类型的值语法Long ( stringorblob )参数stringorblob:string类型变量或Blob类型变量。

Blob类型变量时,把该变量第一个值转换为Long类型的值,其余部分被忽略。

stringorblob参数也可以是包含上述类型数据的Any类型变量返回值Long。

函数执行成功时返回相应的Long类型值。

如果stringorblob参数中的值不是有效的PowerScript数字或数据类型不兼容,那么Long()函数返回0。

如果stringorblob参数的值为NULL,则Long()函数返回NULL。

Date()功能将其它类型的数据转换为Date类型的数据。

该函数有三种语法格式:语法一、将DateTime类型或第一个值是DateTime或Date的Blob值转换成Date类型的值;语法二、将其值是个有效日期的字符串转换成Date类型的值;语法三、将三个整数组合成一个日期。

下面分别予以介绍:语法一、将DateTime类型或第一个值是DateTime或Date的Blob值转换成Date类型的值语法Date ( datetime )参数datetime:DateTime类型的值或第一个值是DateTime或Date的Blob类型的值。

当该参数是Blob类型变量时,把该变量第一个值转换为Date类型的值,其余部分被忽略。

datetime 参数也可以是包含上述类型数据的Any类型变量返回值Date。

函数执行成功时返回相应的Date类型值。

如果datetime参数中的值不是有效的PowerScript日期或数据类型不兼容,那么Date()函数返回1900-01-01。

如果datetime参数的值为NULL,则Date()函数返回NULL。

语法二、将其值是个有效日期的字符串转换成Date类型的值语法Date ( string )参数string:string类型,其值包括一个有效的以字符串形式表示的日期(比如January 1, 1998或12-31-99),string参数也可以是包含字符串类型数据的Any类型变量返回值Date。

函数执行成功时返回相应的Date类型值。

如果string参数中的值不是有效的PowerScript日期或数据类型不兼容,那么Date()函数返回1900-01-01。

如果string参数的值为NULL,则Date()函数返回NULL。

语法三、将三个表示年、月、日的整数组合成一个日期语法Date ( year, month, day )参数year:integer类型,指定日期中的年份,用四位数字表示,从0到9999month:integer 类型,指定日期中的月份,用一位或两位数字表示,从1到12day:integer类型,指定日期中的号数,用一位或两位数字表示,从1到31返回值Date。

函数执行成功时返回由year、month、day三个参数确定的日期。

如果这三个参数中任何一个参数使用了无效值(比如月份指定为14),则Date()函数返回1900-01-01。

如果任何参数的值为NULL,则Date()函数返回NULL。

DateTime()功能将其它类型的数据转换为DateTime类型的数据。

该函数有两种语法格式:语法一、把日期和时间值组合成DateTime类型的值;语法二、将Blob类型的值转换成DateTime类型的值。

下面分别予以介绍:语法一、把日期和时间值组合成DateTime类型的值语法DateTime ( date {, time } )参数date:Date类型的日期值time:可选参数,Time类型的时间值,省略该参数时,PowerBuilder把时间设置为午夜(00:00:00.000000)。

当指定该参数时,可以仅仅指定小时值返回值DateTime。

函数执行成功时返回日期和时间组合而成的DateTime类型的值。

如果任何参数的值为NULL,则DateTime()函数返回NULL。

语法二、将Blob类型的值转换成DateTime类型的值语法DateTime ( blob )参数blob:Blob类型变量,把该变量第一个值转换为DateTime类型的值,其余部分被忽略。

blob参数也可以是包含blob类型数据的Any类型变量返回值DateTime。

函数执行成功时返回相应的DateTime类型值。

如果blob参数的值为NULL,则DateTime()函数返回NULL。

IsDate()功能检测指定的字符串是否包含有效的日期。

语法IsDate ( datevalue )参数datevalue:string类型,指定要检测的字符串返回值Boolean。

如果datevalue包含了有效的日期,则IsDate()函数返回TRUE,否则返回FALSE。

如果datevalue参数的值为NULL,则IsDate()函数返回NULL。

IsNull()功能测试变量或表达式的值是否是NULL。

语法IsNull ( any )参数any:要测试的变量或表达式返回值Boolean:如果any的值为NULL,函数返回TRUE,否则函数返回FALSE。

IsNumber()功能测试字符串是否是有效的数值。

语法IsNumber ( string )参数string:string类型,要测试的字符串返回值Boolean:如果string的值为有效的PowerScript 数字,函数返回TRUE,否则函数返回FALSE。

如果string参数的值为NULL,则IsNumber()函数返回NULL。

IsTime()功能测试字符串的值是否是有效的时间。

语法IsTime ( timevalue )参数timevalue:string类型,要测试的字符串返回值Boolean:如果timevalue的值为有效的时间,函数返回TRUE,否则函数返回FALSE。

如果timevalue 参数的值为NULL,则IsTime()函数返回NULL。

String()功能按指定格式将数据转换成字符串。

String()可以把Date、DateTime、数值类型、Time、String类型的数据转换成指定格式的字符串。

语法String(data,{format})参数data:指定要转换格式的数据,其数据类型可以是Date、DateTime、数值类型、Time、String,也可以是包含上述类型数据的Any类型变量format:可选项,string类型,其值指定数据格式。

如果data参数的类型为string,则必须指定format参数返回值String。

函数执行成功时返回以字符串方式表示的指定数据,如果data参数的数据类型与format参数指定的格式不匹配、format参数指定的格式无效、或data参数不是前面提到的适宜数据类型时,String()函数返回空字符串("")。

用法:format是个用掩码表示的字符串,对data参数为数值类型的情况来说,格式为:正数格式;负数格式;零的显示格式;空的显示格式除第一部分必须提供外,其它部分可以省略。

数值型显示格式中使用两个掩码字符:#和0,其中,使用#代表0~9之间的任意数字,0代表每个零都要显示。

相关主题