常用pb函数
Open()功能
打开窗口。
该函数有两种语法格式：
语法一、打开编程时已知数据类型的窗口对象；
语法二、打开程序运行后才能确定数据类型的窗口对象。
下面分别予以介绍：
语法一、打开编程时已知数据类型的窗口对象语法Open ( windowvar {, parent } )
参数
windowvar：要打开窗口的窗口名，可以使用窗口画笔定义的窗口对象名，也可以使用该窗口对象的某个变量。Open()函数把打开窗口的引用放置到windowvar变量中
parent：可选项，指定要打开窗口的父窗口，要打开窗口成为父窗口的子窗口，只有当要打开窗口需要成为某个窗口的子窗口时才需要指定该参数。如果应用程序使用Open()函数打开某个子窗口或弹出窗口而又省略了该参数，那么当前活动窗口成为被打开窗口的父窗口
返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，Open()函数返回NULL。
语法二、打开程序运行后才能确定数据类型的窗口对象语法Open ( windowvar, windowtype {, parent } )
参数
windowvar：指定窗口变量名，Open()函数把打开窗口的引用放置到该变量中
windowtype：string类型，指定要打开窗口的数据类型，该参数指定的窗口数据类型必须与windowvar参数的类型相同或是windowvar类型的后继对象
parent：可选项，指定要打开窗口的父窗口，要打开窗口成为父窗口的子窗口，只有当要打开窗口需要成为某个窗口的子窗口时才需要指定该参数。如果应用程序使用Open()函数打开某个子窗口或弹出窗口而又省略了该参数，那么当前活动窗口成为被打开窗口的父窗口
返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，Open()函数返回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()功能
得到当前系统日期，在某些情况下，同时得到当前系统时间。
语法Today()
返回值Date。该函数返回当前系统日期。
用法
单独调用Today()函数时，该函数总是返回当前系统日期，但是，虽然Today()函数的返回值类型为Date，在该函数用做某些函数的参数、而该参数要求DateTime类型的值时，Today()函数也能够在返回当前系统日期的同时返回当前系统时间。再如，Today()函数作为数据窗口控件SetItem()函数的参数，该函数参数中指定的数据窗口列的数据类型为DateTime，那么当前系统日期和时间将同时设置到数
据窗口指定项中。
Year()功能
得到日期值中的年度(有效取值1000到3000)。
语法Year(date)
参数date：date类型的值
返回值Integer。函数执行成功时得到date参数中的年份（采用四位数字），发生错误时返回1900，如果date参数的值为NULL，则Year()函数返回NULL。
用法
当应用程序把有两位数字表示年份的字符串转换成日期时，PowerBuilder根据下述规则选择世纪：如果年份值在00到49之间，PowerBuilder将年份中的世纪（前两位数字）当作20；如果年份值在50到99之间，PowerBuilder将年份中的世纪（前两位数字）当作19。比如，字符串"20-10-25"被PowerBuilder转换为2020-10-25；字符串"98-10-25"被PowerBuilder转换为1998-10-25。因此，如果应用程序中需要指定1950年之前的日期，应该使用四位数字表示年份，以避免引起歧义。PowerBuilder能够处理的年份从1000到3000之间。
FileClose()功能
关闭先前用FileOpen()函数打开的文件。
语法FileClose ( fileno )
参数fileno：integer，指定要关闭文件的文件句柄，该句柄使用FileOpen()函数打开文件时得到
返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果fileno参数的值为NULL，那么FileClose()函数返回NULL。
FileDelete()功能
删除指定的文件。
语法FileDelete ( filename )
参数filename：string类型，指定要删除文件的文件名，其中可以包含路径
返回值Boolean。函数执行成功时返回TRUE，发生错误时返回FALSE。如果filename参数的值为NULL，那么FileDelete()函数返回NULL。
FileExists()功能
检查指定的文件是否存在。
语法FileExists ( filename )
参数filename：string类型，指定要检查存在性的文件的文件名，其中可以包含路径
返回值Boolean。如果指定文件存在时返回TRUE，不存在时返回FALSE。如果filename参数的值为NULL，那么FileExists()函数返回NULL。
用法
如果filename参数指定的文件被另一个应用加锁锁住，那么FileExists()函数也将返回FALSE。
FileLength()功能
得到指定文件的长度（以字节为单位）。
语法FileLength ( filename )
参数filename：string类型，指定要得到其长度的文件的文件名，其中可以包含路径
返回值Long。函数执行成功时返回指定文件的长度（以字节为单位）。如果指定的文件不存在，函数返回-1。如果filename参数的值为NULL，那么FileLength()函数返回NULL。
FileOpen()功能
以指定的读写方式打开指定的文件，同时返回该文件的句柄。
语法FileOpen(filename{,filemode{,fileaccess{,filelock{,writemode,{creator,filetype}}}}})
参数
filename：string类型，指定要打开文件的名称，其中可以包含路径
filemode：FileMode枚举类型，可选项，指定文件打开方式。
有效取值为： LineMode! - 缺省值，行模式； StreamMode! - 流模式
fileaccess：FileAccess枚举类型，可选项，指定文件访问方式。有效取值为： Read! - 缺省值，只读方式，这样打开的文件只能进行读操作； Write! - 只写方式，这样打开的文件只能进行写操作
filelock：FileLock枚举类型，可选项，指定文件加锁方式。有效取值为： LockReadWrite! - 缺省值，只有打开该文件的用户能够访问该文件，其它用户对该文件的访问均被拒绝； LockRead! - 只有打开该文件的用户能够读该文件，但其它任何用户均可写该文件； LockWrite! - 只有打开该文件的用户能够写该文件，但其它任何用户均可读该文件； Shared! - 所有用户均可读写该文件
writemode：WriteMode枚举类型，可选项，当fileaccess参数指定为Write!时，该参数指定在指定文件已经存在时数据的添加方式。有效取值为： Append! - 缺省值，将数据添加到原文件尾部； Replace! - 覆盖原有数据
creator：可选项，用于Macintosh机，使用四个字符的字符串指定文件的创建者。指定该参数后，必须同时指定filetype参数
filetype：可选项，用于Macintosh机，使用四个字符的字符串指定文件类型
返回值Integer。函数执行成功时返回打开文件的句柄，随后的文件操作函数利用该句柄完成对文件的操作。发生错误时函数返回-1。如果任何参数的值为NULL，那么FileOpen()函数返回NULL。
用法
当文件以行模式打开时，每执行一次FileRead()函数读取一行数据；
每执行一次FileWrite()函数，该函数自动在写出的字符串末尾增加一个回车（CR）换行（LF）符（这是应用程序在Windows 系统中运行时的情况，在UNIX下只加一个换行字符）。当文件以流模式打开时，执行一次FileRead()函数读取32,765个字节的数据，如果余下数据没有这么多，那么FileRead()函数就读取所有余下的数据；执行一次FileWrite()函数时，最多可写入32,765个字节的数据，并且不添加回车换行字符。当文件以写方式使用FileOpen()函数打开时，如果指定的文件不存在，那么FileOpen()函数创建该文件。
FileRead()功能
从指定文件中读取数据。
语法FileRead ( fileno, variable )
参数
fileno：integer类型，指定文件句柄（由FileOpen()函数得到）
variable：string或blob类型的变量，用于保存读取的数据
返回值Integer。函数执行成功时返回读取的字符数或字节数；如果在读取任何字符前读到了文件结束符（EOF），则FileRead()函数返回-100；当指定文件以行模式打开时，如果在读取任何字符之前遇到了回车（CR）或换行（LF）字符，则FileRead()函数返回0。如果发生其它错误，FileRead()函数返回-1。如果任何参数的值为NULL，
那么FileRead()函数返回NULL。
用法
当指定文件以行模式（Line Mode）打开时，FileRead()函数一次读取一行数据，并把它保存到参数variable中，然后跳过行结束符（回车换行符，操作系统不同，使用的字符也不同），把文件指针移动到下一行的起始位置。当文件以流模式（Stream Mode）打开时，FileRead()函数或一直读取到文件结尾，或读取32,765字节的数据，决定于两者哪个数据长度更短些。
FileSeek()功能
将文件指针移动到指定位置。读写文件时相应函数会自动移动文件指针。
语法FileSeek ( fileno, position, origin )
参数
fileno：integer类型，指定文件句柄（由FileOpen()函数得到）
position：long类型，指定相对于origin参数指定位置的新位置偏移量，以字节为单位
origin：SeekType枚举类型，指定从哪里开始移动文件指针，即指针移动的基准。有效取值为： FromBeginning! - 缺省值，从文件开头移动指针； FromCurrent! - 从当前位置移动文件指针； FromEnd! - 从文件结尾处移动文件指针
返回值Long。函数执行成功时返回指针移动后的指针位置。如果任何参数的值为NULL，那么FileSeek()函数返回NULL.