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

灰太狼 2022-09-28 05:47 159阅读 0赞

函数作用： 该函数有两种用法，一种是进行类型转换，见语法格式二；另一种是进行类型转换的同时还进行数据格式的转换，见语法格式一。重点是格式一的学习和理解。  
函数语法： 格式一：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);\*\*\*\*;空”)