PB一个简单函数(String函数)的复杂解释

sunwy

函数作用： 该函数有两种用法，一种是进行类型转换，见语法格式二；另一种是进行类型转换的同时还进行数据格式的转换，见语法格式一。重点是格式一的学习和理解。
函数语法： 格式一：String ( data, { format } )
   格式二：String ( Blob )
data：要进行类型和格式转换的数据；可以是date、DateTime、数字类型、time或者string类型。
format：格式串，用来指定参数data的显示格式。根据参数data的数据类型的不同而不同。当参数data为String类型时，该参数是必需的，否则就没有必要使用该函数了。
返 回 值： String。函数执行成功时返回以字符串方式表示的指定数据，如果data参数的数据类型与format参数指定的格式不匹配、format参数指定的格式无效、或data参数不是前面提到的适宜数据类型时，String()函数返回空字符串（""）。
使用说明：format是个用掩码表示的字符串，参数data的类型不同有不同的用法：
对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）类型的情况来说，语法格式为：
正常日期时间格式；日期时间为空值时的格式
日期时间类型使用的掩码就是把日期掩码和时间掩码结合起来即可。
代码实例：
例1、下面的语句将指定日期转换为： Jan 1,1998的格式：
string(1998-01-31,”mmmm dd,yyyy”)
例2、下面的语句把DateTime类型的值转换为：Jan 1,1998 6 hrs and 8 min的字符串：
string(DateTime(1998-01-31,06:08:00),’mmmm dd,yyyy h “hrs and” m ”min”’)  
例3、下面的语句把string1设置为0123：
integer li_num = 123  
string ls_temp
ls_temp = string(li_num,”0000;(000);****;空”)  
例4、下面的语句把string1设置为123：
integer li_num = -123
string ls_temp
ls_temp = string(li_num,”000;(000);****;空”)
例5、下面的语句把string1设置为****：
integer li_num = 0  
string ls_temp
ls_temp = string(li_num,”0000;(000);****;空”)
例6、下面的语句把string1设置为空：
integer li_num
string ls_temp
SetNull(li_num)
ls_temp = string(li_num,”0000;(000);****;空”)