常用的PB時間函式彙總

tisnly發表於2008-01-14

Day()
功能得到日期型資料中的號數(1到31之間的整數值)。
語法Day ( date )
引數date:要得到號數的日期值返回值 Integer。函式執行成功時返回號數(1到31之間的整數值)。如果date引數的值為NULL,則Day()函式返回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之間。 

相關文章