PB系統(tǒng)函數(shù) 之
日期時間函數(shù)Day()
——————————————————————————-
功能得到日期型數(shù)據(jù)中的號數(shù)(1到31之間的整數(shù)值)。
語法Day ( date )
參數(shù)date:要得到號數(shù)的日期值返回值
Integer。函數(shù)執(zhí)行成功時返回號數(shù)(1到31之間的整數(shù)值)。如果date參數(shù)的值為NULL,則Day()函數(shù)返回NULL。
——————————————————————————–
DayName()
功能得到指定日期是一周中的星期幾(例如,Sunday, Monday…)。
語法DayName ( date )
參數(shù)date:date類型值或變量返回值String。函數(shù)執(zhí)行成功時返回指定日期的星期表示(例如,Sunday,
Monday…)。如果date參數(shù)的值為NULL,則DayName()函數(shù)返回NULL。
——————————————————————————–
DayNumber()
功能得到日期型數(shù)據(jù)是一星期中的第幾天(用1到7之間的整數(shù)表示,星期天為1,星期一為2,…)。
語法DayNumber ( date )
參數(shù)date:date類型值或變量返回值Integer。函數(shù)執(zhí)行成功時返回指定日期是一星期中的第幾天(用1~7表示,星期天為1,星期一為
2,…)。如果date參數(shù)的值為NULL,則DayNumber()函數(shù)返回NULL。
——————————————————————————–
DaysAfter()
功能得到兩個日期間的天數(shù)。
語法DaysAfter ( date1, date2 )
參數(shù)date1:date類型,指定起始日期date2:date類型,指定終止日期返回值Long。函數(shù)執(zhí)行成功時得到兩個日期之間的天數(shù)。如果
date2的日期在date1的前面,那么DaysAfter()函數(shù)返回負(fù)值。如果任何參數(shù)的值為NULL,則DaysAfter()函數(shù)返回
NULL。
——————————————————————————–
Hour()
功能得到時間值中的小時,采用24小時制。
語法Hour ( time )
參數(shù)time:time類型的值返回值Integer。函數(shù)執(zhí)行成功時得到time參數(shù)中的小時(00到23之間)。如果time參數(shù)的值為NULL,則
Hour()函數(shù)返回NULL。
——————————————————————————–
Minute()
功能得到時間值中的分鐘,有效值在00~59之間。
語法Minute ( time )
參數(shù)time:time類型的值返回值Integer。函數(shù)執(zhí)行成功時得到time參數(shù)中的分鐘(00到59之間)。如果time參數(shù)的值為NULL,則
Minute()函數(shù)返回NULL。
——————————————————————————–
Month()
功能得到日期值中的月份,有效值在1~12之間。
語法Month ( date )
參數(shù)date:date類型的值返回值Integer。函數(shù)執(zhí)行成功時得到date參數(shù)中的月份(1到12之間)。如果date參數(shù)的值為NULL,則
Month()函數(shù)返回NULL。
——————————————————————————–
Now()
功能得到客戶機的當(dāng)前系統(tǒng)時間,返回值為Time類型。
語法Now()返回值Time。該函數(shù)返回客戶機的當(dāng)前系統(tǒng)時間。
——————————————————————————–
RelativeDate()
功能得到指定日期前多少天或后多少天的日期。
語法RelativeDate(date,n)
參數(shù)date:Date類型,指定基準(zhǔn)日期n:integer類型,指定天數(shù)返回值Date。當(dāng)n的值大于0時返回參數(shù)date指定日期后第n天的日期;
當(dāng)n的值小于0時返回參數(shù)date指定日期前第n天的日期。如果任何參數(shù)的值為NULL,則RelativeDate()函數(shù)返回NULL。
——————————————————————————–
RelativeTime()
功能得到指定時間前多少秒或后多少秒的時間,采用24小時制。
語法RelativeTime ( time, n
)參數(shù)time:time類型,指定基準(zhǔn)時間n:long類型,指定秒數(shù)返回值Time。當(dāng)n的值大于0時返回參數(shù)time指定時間后第n秒的時間;當(dāng)n
的值小于0時返回參數(shù)time指定時間前第n秒的時間。如果任何參數(shù)的值為NULL,則RelativeTime()函數(shù)返回NULL。
——————————————————————————–
Second()
功能得到時間值中的秒,有效值在00~59之間。
語法Second ( time )
參數(shù)time:time類型的值返回值Integer。函數(shù)執(zhí)行成功時得到time參數(shù)中的秒(00到59之間)。如果time參數(shù)的值為NULL,則
Second()函數(shù)返回NULL。
——————————————————————————–
Today()
功能得到當(dāng)前系統(tǒng)日期,在某些情況下,同時得到當(dāng)前系統(tǒng)時間。
語法Today()返回值Date。該函數(shù)返回當(dāng)前系統(tǒng)日期。用法單獨調(diào)用Today()函數(shù)時,該函數(shù)總是返回當(dāng)前系統(tǒng)日期,但是,雖然Today()
函數(shù)的返回值類型為Date,在該函數(shù)用做某些函數(shù)的參數(shù)、而該參數(shù)要求DateTime類型的值時,Today()函數(shù)也能夠在返回當(dāng)前系統(tǒng)日期的同時
返回當(dāng)前系統(tǒng)時間。再如,Today()函數(shù)作為數(shù)據(jù)窗口控件SetItem()函數(shù)的參數(shù),該函數(shù)參數(shù)中指定的數(shù)據(jù)窗口列的數(shù)據(jù)類型為
DateTime,那么當(dāng)前系統(tǒng)日期和時間將同時設(shè)置到數(shù)據(jù)窗口指定項中。
——————————————————————————–
Year()
功能得到日期值中的年度(有效取值1000到3000)。
語法Year(date)
參數(shù)date:date類型的值返回值Integer。函數(shù)執(zhí)行成功時得到date參數(shù)中的年份(采用四位數(shù)字),發(fā)生錯誤時返回1900,如果date
參數(shù)的值為NULL,則Year()函數(shù)返回NULL。用法當(dāng)應(yīng)用程序把有兩位數(shù)字表示年份的字符串轉(zhuǎn)換成日期時,PowerBuilder根據(jù)下述規(guī)則
選擇世紀(jì):如果年份值在00到49之間,PowerBuilder將年份中的世紀(jì)(前兩位數(shù)字)當(dāng)作20;如果年份值在50到99之
間,PowerBuilder將年份中的世紀(jì)(前兩位數(shù)字)當(dāng)作19。比如,字符串”20-10-25″被PowerBuilder轉(zhuǎn)換為
2020-10-25;字符串”98-10-25″被PowerBuilder轉(zhuǎn)換為1998-10-25。因此,如果應(yīng)用程序中需要指定1950年之前
的日期,應(yīng)該使用四位數(shù)字表示年份,以避免引起歧義。PowerBuilder能夠處理的年份從1000到3000之間。