PB 常用函数与封装函数列表(二、日期时间相关)
二、日期时间相关
2.1 Year 函数
获取日期中的年份
语法
Year(date)
参数
date–> date类型的值
返回值
Integer
成功时得到date参数中的年份(四位数字),发生错误时返回1900;如果date参数的值为NULL,则函数返回null
PB能够处理的年份从1000到3000止;
2.2 Month 函数
获取日期中的月份
语法
Month ( date )
参数
date–> date类型的值
返回值
Integer
成功时得到date参数中的月份(1到12之间)
如果date参数的值为NULL,函数返回NULL
2.3 Day 函数
获取日期中的号数(1到31之间的整数值)
语法
Day (date)
参数
date–> date类型的值
返回值
Integer
成功时返回号数(1到31之间的整数值)
如果date参数的值为NULL,函数返回NULL
2.4 Hour 函数
获取时间值中的小时,采用24小时制
语法
Hour (time)
参数
time–>time类型的值
返回值
Integer
成功时得到time参数中的小时(00到23之间)
如果time参数的值为NULL,函数返回NULL
2.5 Minute 函数
获取时间值中的分钟,00~59之间
语法
Minute (time)
参数
time–>time类型的值
返回值
Integer
成功时得到time参数中的分钟(00到59之间)
如果time参数的值为NULL,函数返回NULL
2.6 Second 函数
获取时间值中的秒,在00~59之间
语法
Second (time)
参数
time–>time类型的值
返回值
Integer
成功时得到time参数中的秒(00到59之间)
如果time参数的值为NULL,函数返回NULL
2.7 Today 函数
获取当前系统日期,在某些情况下,同时得到当前系统时间
语法
Today()
参数
无
返回值
Date 当前系统日期
单独调用Today()函数时,返回当前系统日期,用做某些函数的参数、而该参数要求DateTime类型的值时,函数能够在返回当前系统日期的同时返回当前系统时间
2.8 Now 函数
获取客户机的当前系统时间
语法
Now()
参数
返回值:Time 客户机的当前系统时间
2.9 RelativeDate 函数
获取指定日期前多少天或后多少天的日期
语法
RelativeDate(date,n)
参数
date–>Date类型,指定基准日期
n–>integer类型,指定天数
返回值
Date
当n>0时返回指定日期后第n天的日期;
当n<0时返回指定日期前第n天的日期。
如果任何参数的值为NULL,函数返回NULL
2.10 RelativeTime 函数
获取指定时间前多少秒或后多少秒的时间,采用24小时制
语法
RelativeTime (time, n)
参数
time–> time类型,指定基准时间
n–> long类型,指定秒数
返回值
Time
当n>0时返回指定时间后第n秒的时间;
当n<0时返回指定时间前第n秒的时间。
如果任何参数的值为NULL,函数返回NULL
2.11 DaysAfter 函数
获取两个日期间的天数
语法
DaysAfter ( date1, date2 )
参数
date1–>date类型,指定开始日期
date2–>date类型,指定截止日期
返回值
Long
成功时得到两个日期之间的天数
如果date2的日期在date1的前面,函数返回负值。
如果任何参数的值为NULL,函数返回NULL
2.12 DayName 函数
获取指定日期是一周中的星期几(例如,Sunday, Monday…)
语法
DayName ( date )
参数
date–> date类型值或变量
返回值
String
成功时返回指定日期的星期表示(例如,Sunday, Monday…)
如果date参数的值为NULL,函数返回NULL
2.13 DayNumber
获取指定日期是一星期中的第几天(用1到7之间的整数表示,星期天为1,星期一为2,…)。
语法
DayNumber ( date )
参数
date–>date类型值或变量
返回值
Integer
成功时返回指定日期是一星期中的第几天(用1~7表示,星期天为1,星期一为2,…)
如果date参数的值为NULL,函数返回NULL