PB 数据类型检查与转换函数

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类型的值。
语法：Dec ( stringorblob )
参数：stringorblob：string类型变量或Blob类型变量。Blob类型变量时，把该变量第一个值转换为Decimal类型的值，其余部分被忽略。stringorblob参数也可以是包含上述类型数据的Any类型变量

返回值：Decimal。函数执行成功时返回相应的Decimal类型值。如果stringorblob参数中的值不是有效的PowerScript数字或数据类型不兼容，那么Dec()函数返回0。如果stringorblob参数的值为NULL，则Dec()函数返回NULL。

 

Double()

功能：将字符串或Blob值转换成Double类型的值。
语法：Double(stringorblob)
参数：stringorblob：string类型变量或Blob类型变量。Blob类型变量时，把该变量第一个值转换为Double类型的值，其余部分被忽略。stringorblob参数也可以是包含上述类型数据的Any类型变量

返回值：Double。函数执行成功时返回相应的Double类型值。如果stringorblob参数中的值不是有效的PowerScript数字或数据类型不兼容，那么Double()函数返回0。如果stringorblob参数的值为NULL，则Double()函数返回NULL。

 

Integer()

功能：将字符串或Blob值转换成Integer类型的值。
语法：Integer ( stringorblob )
参数：stringorblob：string类型变量或Blob类型变量。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 )
参数：stringorblob：string类型变量或Blob类型变量。Blob类型变量时，把该变量第一个值转换为Long类型的值，其余部分被忽略。stringorblob参数也可以是包含上述类型数据的Any类型变量

返回值：Long。函数执行成功时返回相应的Long类型值。如果stringorblob参数中的值不是有效的PowerScript数字或数据类型不兼容，那么Long()函数返回0。如果stringorblob参数的值为NULL，则Long()函数返回NULL。

 

Real()

功能：将字符串或Blob值转换成Real类型的值。
语法：Real ( stringorblob )
参数：stringorblob：string类型变量或Blob类型变量。当该参数是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：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到9999
　　　month：integer类型，指定日期中的月份，用一位或两位数字表示，从1到12
　　　day：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到23
　　　minute：integer类型，指定时间中的分钟，从0到59
　　　second：integer类型，指定时间中的秒，从0到59
　　　microsecond：integer类型，可选项，指定时间中的微秒，从0到32767

返回值：Time。函数执行成功时返回由hour、minute、second、microsecond 四个参数确定的时间。如果这四个参数中任何一个参数使用了无效值（比如小时指定为44），则Time()函数返回NULL。