PB 常用的日期时间函数列表

获取日期在星期几的两种格式

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。

获取指定日期或指定事件的值

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。

计算两个日期之间的差值

DaysAfter()

功能：得到两个日期间的天数。

语法：DaysAfter ( date1, date2 )

参数date1：date类型，指定起始日期date2：date类型，指定终止日期返回值Long。函数执行成功时得到两个日期之间的天数。如果date2的日期在date1的前面，那么DaysAfter()函数返回负值。如果任何参数的值为NULL，则DaysAfter()函数返回NULL。

获取当前系统日期或时间

Now()

功能：得到客户机的当前系统时间，返回值为Time类型。

语法：Now()返回值Time。

该函数返回客户机的当前系统时间。

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之间。 

Month()

功能：得到日期值中的月份，有效值在1～12之间。

语法：Month ( date )

参数date：date类型的值返回值Integer。

函数执行成功时得到date参数中的月份（1到12之间）。如果date参数的值为NULL，则Month()函数返回NULL。

Day()

功能：得到日期型数据中的天(1到31之间的整数值)。

语法：Day ( date )

参数date：要得到号数的日期值返回值 Integer。函数执行成功时返回号数(1到31之间的整数值)。如果date参数的值为NULL，则Day()函数返回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。

Second()

功能：得到时间值中的秒，有效值在00～59之间。

语法：Second ( time )

参数time：time类型的值返回值Integer。

函数执行成功时得到time参数中的秒（00到59之间）。如果time参数的值为NULL，则Second()函数返回NULL。

 您阅读本篇文章共花了：