PB函数常用.docx
- 文档编号:17949025
- 上传时间:2023-08-05
- 格式:DOCX
- 页数:19
- 大小:23.89KB
PB函数常用.docx
《PB函数常用.docx》由会员分享,可在线阅读,更多相关《PB函数常用.docx(19页珍藏版)》请在冰点文库上搜索。
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类型,其值包括一个有效的以字符串形式表示的日期(比如January1,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代表每个零都要显示。
另外,货币符号($或¥)、百分号(%)、小数点(.)、逗号(,)等字符也可以出现在格式字符串中,但是,除小数点(.)、逗号(,)能够出现在格式字符#和0之间外,其它字符只能放置在格式串的前面或后面,例如,###,###$###是个错误的格式串,¥###,###,###是个正确的格式串。
省略format参数时,String()函数使用PowerBuilder缺省格式。
注意,如果显示格式有多个部分,各部分之间的分号(;)不能省略。
其它字符也可以出现在显示格式字符串中(只能放在格式串的开头和末尾),但它们没有特殊意义,系统只是照原样显示。
例如,用显示格式字符串“收入##”格式化数值12时,显示结果为“收入12”。
对data参数为字符串(String)类型的情况来说,format参数的语法格式为:
正常字符串格式;空值时格式在“正常字符串格式”中,@代表字符串中的任意字符,除此之外的任何字符照原样显示,例如,如果定义了下面的格式:
(@@)@@@@-@@@@则字符串0166767593显示为:
(01)6676-7593对data参数为日期(Date)类型的情况来说,format参数的语法格式为:
正常日期格式;日期为空值时的格式日期格式中格式字符意义如下:
d棗开头不带0的日数(如8)dd棗开头带0的日数(如08)ddd棗星期的英文缩写(如Mon、Tue)dddd棗星期的英文全称(如Monday、Tuesday)m棗开头不带0的月份(如8)mm棗开头带0的月份(如08)mmm棗月份的英文缩写(如Jan、Feb)mmmm棗月份的英文全称(如January、February)yy棗两位数字表示的年份(如97)yyyy棗四位数字表示的年份(如1997)另外,还可以使用下面的关键字作为日期的显示格式:
[General]Windows系统中定义的短日期格式[LongDate]Windows系统中定义的长日期格式[ShortDate]Windows系统中定义的短日期格式对data参数为时间(Time)类型的情况来说,语法格式为:
正常时间格式;时间为空值时的格式时间格式中格式字符意义如下:
h开头不带0的小时(比如6)hh棗开头带0的小时(比如06)m棗开头不带0的分钟(比如6)mm棗开头带0的分钟(比如06)s棗开头不带0的秒(比如6)ss棗开头带0的秒(比如06)f棗开头不带0的微秒,可以指定1~6个f,每个f代表一部分微秒AM/PM棗用AM/PM显示上、下午时间,12小时制am/pm棗用am/pm显示上、下午时间,12小时制A/P棗用A/P显示上、下午时间,12小时制a/p棗用a/p显示上、下午时间,12小时制另外,显示格式中还可以使用关键字[Time],它表示按当前Windows系统定义的格式显示时间。
对data参数为日期时间(DateTime)类型的情况来说,语法格式为:
正常日期时间格式;日期时间为空值时的格式日期时间类型使用的掩码就是把日期掩码和时间掩码结合起来即可。
Time()
功能把其它类型的数据转换为Time类型的值。
该函数有三种语法格式:
语法一、将DateTime类型或第一个值是DateTime或Time的Blob值转换成Time类型的值;语法二、将其值是个有效时间的字符串转换成Time类型的值;语法三、将表示时、分、秒、以及微秒的整数组合成一个时间值。
下面分别予以介绍:
语法一、将DateTime类型或第一个值是DateTime或Time的Blob值转换成Time类型的值
语法Time(datetime)
参数datetime:
DateTime类型的值或第一个值是DateTime或Time的Blob类型的值。
当该参数是Blob类型变量时,把该变量第一个值转换为Time类型的值,其余部分被忽略。
datetime参数也可以是包含上述类型数据的Any类型变量返回值Time。
函数执行成功时返回相应的Time类型值。
如果datetime参数中的值不是有效的PowerScript时间或数据类型不兼容,那么Time()函数返回00:
00:
00.000000。
如果datetime参数的值为NULL,则Time()函数返回NULL。
语法二、将其值是个有效时间的字符串转换成Time类型的值
语法Time(string)
参数string:
string类型,其值包括一个有效的以字符串形式表示的时间(比如9am或10:
25),string参数也可以是包含时间类型数据的Any类型变量返回值Time。
函数执行成功时返回相应的Time类型值。
如果string参数中的值不是有效的PowerScript时间或数据类型不兼容,那么Time()函数返回00:
00:
00.000000。
如果string参数的值为NULL,则Time()函数返回NULL。
语法三、将表示时、分、秒、以及微秒的整数组合成一个时间值
语法Time(hour,minute,second{,microsecond})
参数hour:
integer类型,指定时间中的小时,从0到23minute:
integer类型,指定时间中的分钟,从0到59second:
integer类型,指定时间中的秒,从0到59microsecond:
integer类型,可选项,指定时间中的微秒,从0到32767返回值Time。
函数执行成功时返回由hour、minute、second、microsecond四个参数确定的时间。
如果这四个参数中任何一个参数使用了无效值(比如小时指定为44),则Time()函数返回NULL。
RGB()
功能将代表红、绿、蓝三原色的三个整数组合成一个表示颜色的长整数。
语法RGB(red,green,blue)
参数red:
integer类型,指定颜色中的红色分量强度,有效值在0到255之间green:
integer类型,指定颜色中的绿色分量强度,有效值在0到255之间blue:
integer类型,指定颜色中的蓝色分量强度,有效值在0到255之间返回值Long。
函数执行成功时返回由指定分量确定的颜色,用长整数表示。
发生错误时返回-1。
如果任何参数的值为NULL,RGB()函数返回NULL。
用法RGB()函数使用下述公式计算表示颜色的长整数:
65536*Blue+256*Green+Red其中,Blue代表蓝色分量,Green代表绿色分量,Red代表红色分量。
各分量中,数值越小,亮度越低,数值越大,亮度越高。
例如,RGB(0,0,0)为黑色(亮度最低),RGB(255,255,255)为白色(亮度最高)。
SetNull()
功能将指定变量的值设置为NULL。
这里的变量可以是除数组、结构、自动实例化对象之外的任何数据类型。
语法SetNull(anyvariable)
参数anyvariable:
要将其值设置为NULL的变量返回值Integer。
函数执行成功时返回1,发生错误时返回-1。
如果任何参数的值为NULL,SetNull()函数返回NULL。
用法PowerBuilder应用程序在说明变量时,并不自动地将其初值设置为NULL,而是根据类型的不同而设置不同的初值,比如,数值类型的变量自动初始化为0,字符串型变量自动初始化为空字符串("")。
因此,如果需要将某个变量的值设置为NULL,就需要使用SetNull()函数来完成任务了。
一般来说,NULL值往往应用在数据库值未确定的列上。
Len()
功能得到Blob类型变量的数据长度,以字节为单位。
语法Len(blob)
参数blob:
Blob类型变量返回值Long。
函数执行成功时返回blob变量的长度,发生错误时返回-1。
如果任何参数的值为NULL,则Len()函数返回NULL。
用法如果在说明Blob类型的变量时指定了变量长度,那么对该变量来说,Len()函数得到的就是这个指定的长度。
如果在变量说明时未指定变量长度,那么PowerBuilder在赋值时调整长度,未赋值Blob类型变量的长度为0。
String()
功能将Blob类型变量的值转换成字符串类型。
如果Blob类型变量的值不是文本型数据,String()函数将其值解释成字符。
语法String(blob)
参数blob:
要对其值进行类型转换的Blob类型变量返回值String。
函数执行成功时返回转换后的数据,失败时返回空字符串("")。
如果blob变量中包含的数据不是字符串类型的数据,那么String()函数尽可能把数据解释为字符,并返回字符串类型数据。
如果blob参数的值为NULL,则String()函数返回NULL。
Day()
功能得到日期型数据中的号数(1到31之间的整数值)。
语法Day(date)
参数date:
要得到号数的日期值返回值Integer。
函数执行成功时返回号数(1到31之间的整数值)。
如果date参数的值为NULL,则Day()函数返回NULL。
DayName()
功能得到指定日期是一周中的星期几(例如,Sunday,Monday...)。
语法DayName(date)
参数date:
date类型值或变量返回值String。
函数执行成功时返回指定日期的星期表示(例如,Sunday,Monday...)。
如果date参数的值为NULL,则DayName()函数返回NULL。
DayNumber()
功能得到日期型数据是一星期中的第几天(用1到7之间的整数表示,星期天为1,星期一为2,...)。
语法DayNumber(date)
参数date:
date类型值或变量返回值Integer。
函数执行成功时返回指定日期是一星期中的第几天(用1~7表示,星期天为1,星期一为2,...)。
如果date参数的值为NULL,则DayNumber()函数返回NULL。
DaysAfter()
功能得到两个日期间的天数。
语法DaysAfter(date1,date2)
参数date1:
date类型,指定起始日期date2:
date类型,指定终止日期返回值Long。
函数执行成功时得到两个日期之间的天数。
如果date2的日期在date1的前面,那么DaysAfter()函数返回负值。
如果任何参数的值为NULL,则DaysAfter()函数返回NULL。
Hour()
功能得到时间值中的小时,采用24小时制。
语法Hour(time)
参数time:
time类型的值返回值Integer。
函数执行成功时得到time参数中的小时(00到23之间)。
如果time参数的值为NULL,则Hour()函数返回NULL。
Minute()
功能得到时间值中的分钟,有效值在00~59之间。
语法Minute(time)
参数time:
time类型的值返回值Integer。
函数执行成功时得到time参数中的分钟(00到59之间)。
如果time参数的值为NULL,则Minute()函数返回NULL。
Month()
功能得到日期值中的月份,有效值在1~12之间。
语法Month(date)
参数date:
date类型的值返回值Integer。
函数执行成功时得到date参数中的月份(1到12之间)。
如果date参数的值为NULL,则Month()函数返回NULL。
Now()
功能得到客户机的当前系统时间,返回值为Time类型。
语法Now()返回值Time。
该函数返回客户机的当前系统时间。
RelativeDate()
功能得到指定日期前多少天或后多少天的日期。
语法RelativeDate(date,n)
参数date:
Date类型,指定基准日期n:
integer类型,指定天数返回值Date。
当n的值大于0时返回参数date指定日期后第n天的日期;当n的值小于0时返回参数date指定日期前第n天的日期。
如果任何参数的值为NULL,则RelativeDate()函数返回NULL。
RelativeTime()
功能得到指定时间前多少秒或后多少秒的时间,采用24小时制。
语法RelativeTime(time,n)参数time:
time类型,指定基准时间n:
long类型,指定秒数返回值Time。
当n的值大于0时返回参数time指定时间后第n秒的时间;当n的值小于0时返回参数time指定时间前第n秒的时间。
如果任何参数的值为NULL,则RelativeTime()函数返回NULL。
Second()
功能得到时间值中的秒,有效值在00~59之间。
语法Second(time)
参数time:
time类型的值返回值Integer。
函数执行成功时得到time参数中的秒(00到59之间)。
如果time参数的值为NULL,则Second()函数返回NULL。
Today()
功能得到当前系
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- PB 函数 常用