PB系統函數 之
日期時間函數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之間。