PB函数大全Word格式.docx
《PB函数大全Word格式.docx》由会员分享，可在线阅读，更多相关《PB函数大全Word格式.docx（43页珍藏版）》请在冰豆网上搜索。
功能得到小于等于n的最大整数。
语法Int（n）
数值型变量或表达式返回值Integer。
函数执行成功时返回小于等于n的最大整数。
如果n的值太小或太大，超过了整数的表示范围，则函数返回0。
如果参数n的值为NULL，Int（）函数返回NULL。
∙Log（）
功能计算n的自然对数。
语法Log（n）
数值型变量或表达式，其值必须大于0返回值Double。
函数执行成功时返回n的自然对数。
如果n小于等于0，将导致运行错误。
如果参数n的值为NULL，Log（）函数返回NULL。
∙LogTen（）
功能计算n的常用对数（以10为底）。
语法LogTen（n）
函数执行成功时返回n的常用对数。
如果参数n的值为NULL，LogTen（）函数返回NULL。
∙Max（）
功能求两个数中的最大值。
语法Max（x,y）
参数x：
数值型变量或表达式，参加比较的第一个数y：
数值型变量或表达式，参加比较的第二个数返回值以x、y中数据类型更精确的数据类型作为该函数的返回值数据类型。
函数执行成功时返回参数比较的两个数中更大者。
如果任何参数的值为NULL，Max（）函数返回NULL。
∙Min（）
功能求两个数中的最小值。
语法Min（x,y）
函数执行成功时返回参数比较的两个数中较小者。
如果任何参数的值为NULL，Min（）函数返回NULL。
∙Mod（）
功能求余数。
语法Mod（x,y）
数值型变量或表达式，被除数y：
数值型变量或表达式，除数返回值以x、y中数据类型更精确的数据类型作为该函数的返回值数据类型。
函数执行成功时返回x除以y所得的余数。
如果任何参数的值为NULL，Mod（）函数返回NULL。
∙Pi（）
功能计算n与Pi（3.14159265358979323...）的乘积。
语法Pi（n）
函数执行成功时返回n与Pi（3.14159265358979323...）的乘积。
发生错误时返回-1。
如果参数n的值为NULL，Pi（）函数返回NULL。
∙Rand（）
功能得到1与n之间的一个伪随机数。
语法Rand（n）
数值型变量或表达式，指定要产生的伪随机数的上界。
有效值在1到32,767之间返回值与n的数据类型相同。
函数执行成功时返回1与n之间的一个伪随机数，包括1和n在内。
如果参数n的值为NULL，Rand（）函数返回NULL。
Randomize（）
功能初始化伪随机数发生器，这样让应用程序每次使用不同的伪随机数序列。
语法Randomize（n）
数值型变量或表达式，指定伪随机数生成器使用的起始值，不同的起始值可以生成不同的伪随机数序列。
当n的值为0时，该函数把系统时钟作为伪随机数生成器的起始值，这样可以生成不可重复的伪随机数序列。
当n的值不为0时，可以产生不同的伪随机数序列，但是，如果两次使用相同的伪随机数生成器起始值，那么两次生成的伪随机数序列相同。
n的值在0到32,767之间返回值Integer。
极少使用该函数的返回值。
Round（）
功能将x四舍五入到n位。
语法Round（x,n）参数x：
要四舍五入的数值型数据n：
整数类型，指定从哪个小数位上四舍五入x。
有效值在0到18之间返回值Decimal。
函数执行成功时返回将x四舍五入到小数点后第n位的数值，如果函数执行失败或任何参数的值为NULL，Round（）函数返回NULL。
Sign（）
功能确定n是整数、负数还是零。
语法Sign（n）
数值型变量或表达式，指定要测试符号的值返回值Integer。
当n大于0时返回1；
当n小于0时返回-1；
当n等于0时返回0。
如果参数n的值为NULL，Sign（）函数返回NULL。
Sin（）
功能计算正弦，其中参数以弧度为单位。
语法Sin（n）
函数执行成功时返回n的正弦。
如果参数n的值为NULL，Sin（）函数返回NULL。
Sqrt（）
功能计算平方根。
语法Sqrt（n）
数值型变量或表达式，指定要计算平方根的数据返回值Double。
函数执行成功时返回n的平方根。
如果n是负数，则执行该函数时引发运行错误。
如果参数n的值为NULL，Sqrt（）函数返回NULL。
Tan（）
功能计算正切，其中参数以弧度为单位。
语法Tan（n）
函数执行成功时返回n的正切。
如果参数n的值为NULL，Tan（）函数返回NULL。
∙Truncate（）
功能截断数值到指定的小数位。
语法Truncate（x,n）
要截断的数值型数据n：
整数类型，指定从哪个小数位上截断x。
函数执行成功时返回将x截断到小数点后第n位的数值，如果函数执行失败或任何参数的值为NULL，Truncate（）函数返回NULL。
所谓截断就是舍弃指定位之后的数值。
Asc（）
功能得到字符串第一个字符的ASCII码整数值。
语法Asc（string）
参数string：
要得到第一个字符ASCII值的字符串返回值Integer。
函数执行成功时返回string参数第一个字符的ASCII值，如果string参数的值为NULL，则Asc（）函数返回NULL。
Char（）
功能将字符串的第一个字符、Blob变量的第一个值、或一个整数转换成字符。
语法Char（n）
字符串、Blob变量或整数，也可以是包含上述类型数据的Any类型变量返回值Char。
返回参数n的第一个字符。
如果n参数的值为NULL，则Char（）函数返回NULL。
Dec（）
功能将字符串或Blob值转换成Decimal类型的值。
语法Dec（stringorblob）
参数stringorblob：
string类型变量或Blob类型变量。
Blob类型变量时，把该变量第一个值转换为Decimal类型的值，其余部分被忽略。
stringorblob参数也可以是包含上述类型数据的Any类型变量返回值Decimal。
函数执行成功时返回相应的Decimal类型值。
如果stringorblob参数中的值不是有效的PowerScript数字或数据类型不兼容，那么Dec（）函数返回0。
如果stringorblob参数的值为NULL，则Dec（）函数返回NULL。
Double（）
功能将字符串或Blob值转换成Double类型的值。
语法Double（stringorblob）
Blob类型变量时，把该变量第一个值转换为Double类型的值，其余部分被忽略。
stringorblob参数也可以是包含上述类型数据的Any类型变量返回值Double。
函数执行成功时返回相应的Double类型值。
如果stringorblob参数中的值不是有效的PowerScript数字或数据类型不兼容，那么Double（）函数返回0。
如果stringorblob参数的值为NULL，则Double（）函数返回NULL。
Integer（）
功能将字符串或Blob值转换成Integer类型的值。
语法Integer（stringorblob）
Blob类型变量时，把该变量第一个值转换为Integer类型的值，其余部分被忽略。
stringorblob参数也可以是包含上述类型数据的Any类型变量返回值Integer。
函数执行成功时返回相应的Integer类型值。
如果stringorblob参数中的值不是有效的PowerScript数字或数据类型不兼容，那么Integer（）函数返回0。
如果stringorblob参数的值为NULL，则Integer（）函数返回NULL。
Long（）
功能将其它类型的数据转换为Long类型的值。
该函数有两种语法格式：
语法一、将两个无符号整数组合成一个长整数值；
语法二、将字符串或Blob值转换成Long类型的值。
下面分别予以介绍：
语法一、将两个无符号整数组合成一个长整数值
语法Long（lowword,highword）
参数lowword：
UnsignedInteger类型，指定长整数中的低位值highword：
UnsignedInteger类型，指定长整数中的高位值返回值Long。
函数执行成功时返回由低位值和高位值组合后的长整数值，发生错误时返回-1。
如果任何参数的值为NULL，则Long（）函数返回NULL。
语法二、将字符串或Blob值转换成Long类型的值
语法Long（stringorblob）
Blob类型变量时，把该变量第一个值转换为Long类型的值，其余部分被忽略。
stringorblob参数也可以是包含上述类型数据的Any类型变量返回值Long。
函数执行成功时返回相应的Long类型值。
如果stringorblob参数中的值不是有效的PowerScript数字或数据类型不兼容，那么Long（）函数返回0。
如果stringorblob参数的值为NULL，则Long（）函数返回NULL。
Real（）
功能将字符串或Blob值转换成Real类型的值。
语法Real（stringorblob）
当该参数是Blob类型变量时，把该变量第一个值转换为Real类型的值，其余部分被忽略。
stringorblob参数也可以是包含上述类型数据的Any类型变量返回值Real。
函数执行成功时返回相应的Real类型值。
如果stringorblob参数中的值不是有效的PowerScript数字或数据类型不兼容，那么Real（）函数返回0。
如果stringorblob参数的值为NULL,则Real（）函数返回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类型，其值包括一个有效的以字符串形式表示的日期（比如January1,1998或12-31-99），string参数也可以是包含字符串类型数据的Any类型变量返回值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类型，要测试的字符串返回值Boolean：
如果string的值为有效的PowerScript数字，函数返回TRUE，否则函数返回FALSE。
如果string参数的值为NULL，则IsNumber（）函数返回NULL。
IsTime（）
功能测试字符串的值是否是有效的时间。
语法IsTime（timevalue）
参数timevalue：
如果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或Time的Blob类型的值。
当该参数是Blob类型变量时，把该变量第一个值转换为Time类型的值，其余部分被忽略。
datetime参数也可以是包含上述类型数据的Any类型变量返回值Time。
函数执行成功时返回相应的Time类型值。
如果datetime参数中的值不是有效的PowerScript时间或数据类型不兼容，那么Time（）函数返回00:
00.000000。
如果datetime参数的值为NULL，则Time（）函数返回NULL。
语法二、将其值是个有效时间的字符串转换成Time类型的值
语法Time（string）
string类型，其值包括一个有效的以字符串形式表示的时间（比如9am或10:
25），string参数也可以是包含时间类型数据的Any类型变量返回值Time。
如果string参数中的值不是有效的PowerScript时间或数据类型不兼容，那么Time（）函数返回00:
如果string参数的值为NULL，则Time（）函数返回NULL。
语法三、将表示时、分、秒、以及微秒的整数组合成一个时间值
语法Time（hour,minute,second{,microsecond}）
参数hour：
integer类型，指定时间中的小时，从0到23minute：
integer类型，指定时间中
升级会员 