pb函數庫之數據類型檢查與轉換函數

Asc()
功能得到字符串第一個字符的ASCII碼整數值。
語法Asc ( string )
參數string:要得到第一個字符ASCII值的字符串返回值Integer。函數執行成功時返回string參數第一個字符的ASCII值,如果string參數的值爲NULL,則Asc()函數返回NULL。
Char()
功能將字符串的第一個字符、Blob變量的第一個值、或一個整數轉換成字符。
語法Char ( n )
參數n:字符串、Blob變量或整數,也可以是包含上述類型數據的Any類型變量返回值Char。返回參數n的第一個字符。如果n參數的值爲NULL,則Char()函數返回NULL。
Dec()
功能將字符串或Blob值轉換成Decimal類型的值。
語法Dec ( stringorblob )
參數stringorblob:string類型變量或Blob類型變量。Blob類型變量時,把該變量第一個值轉換爲Decimal類型的值,其餘部分被忽略。stringorblob參數也可以是包含上述類型數據的Any類型變量返回值Decimal。函數執行成功時返回相應的Decimal類型值。如果stringorblob參數中的值不是有效的PowerScript數字或數據類型不兼容,那麼Dec()函數返回0。如果stringorblob參數的值爲NULL,則Dec()函數返回NULL。
Double()
功能將字符串或Blob值轉換成Double類型的值。
語法Double(stringorblob)
參數stringorblob:string類型變量或Blob類型變量。Blob類型變量時,把該變量第一個值轉換爲Double類型的值,其餘部分被忽略。stringorblob參數也可以是包含上述類型數據的Any類型變量返回值Double。函數執行成功時返回相應的Double類型值。如果stringorblob參數中的值不是有效的PowerScript數字或數據類型不兼容,那麼Double()函數返回0。如果stringorblob參數的值爲NULL,則Double()函數返回NULL。
Integer()
功能 將字符串或Blob值轉換成Integer類型的值。
語法Integer ( stringorblob )
參數stringorblob:string類型變量或Blob類型變量。Blob類型變量時,把該變量第一個值轉換爲Integer類型的值,其餘部分被忽略。stringorblob參數也可以是包含上述類型數據的Any類型變量返回值Integer。函數執行成功時返回相應的Integer類型值。如果stringorblob參數中的值不是有效的PowerScript數字或數據類型不兼容,那麼Integer()函數返回0。如果stringorblob參數的值爲NULL,則Integer()函數返回NULL。
Long()
功能將其它類型的數據轉換爲Long類型的值。該函數有兩種語法格式:
語法一、將兩個無符號整數組合成一個長整數值;
語法二、將字符串或Blob值轉換成Long類型的值。下面分別予以介紹:
語法一、將兩個無符號整數組合成一個長整數值
語法Long ( lowword, highword )
參數lowword:UnsignedInteger類型,指定長整數中的低位值highword:UnsignedInteger類型,指定長整數中的高位值返回值Long。函數執行成功時返回由低位值和高位值組合後的長整數值,發生錯誤時返回-1。如果任何參數的值爲NULL,則Long()函數返回NULL。
語法二、將字符串或Blob值轉換成Long類型的值
語法Long ( stringorblob )
參數stringorblob:string類型變量或Blob類型變量。Blob類型變量時,把該變量第一個值轉換爲Long類型的值,其餘部分被忽略。stringorblob參數也可以是包含上述類型數據的Any類型變量返回值Long。函數執行成功時返回相應的Long類型值。如果stringorblob參數中的值不是有效的PowerScript數字或數據類型不兼容,那麼Long()函數返回0。如果stringorblob參數的值爲NULL,則Long()函數返回NULL。
Real()
功能將字符串或Blob值轉換成Real類型的值。
語法Real ( stringorblob )
參數stringorblob:string類型變量或Blob類型變量。當該參數是Blob類型變量時,把該變量第一個值轉換爲Real類型的值,其餘部分被忽略。stringorblob參數也可以是包含上述類型數據的Any類型變量返回值Real。函數執行成功時返回相應的Real類型值。如果stringorblob參數中的值不是有效的PowerScript數字或數據類型不兼容,那麼Real()函數返回0。如果stringorblob參數的值爲NULL,則Real()函數返回NULL。
Date()功能 將其它類型的數據轉換爲Date類型的數據。該函數有三種語法格式:
語法一、將DateTime類型或第一個值是DateTime或Date的Blob值轉換成Date類型的值;
語法二、將其值是個有效日期的字符串轉換成Date類型的值;
語法三、將三個整數組合成一個日期。下面分別予以介紹:
語法一、將DateTime類型或第一個值是DateTime或Date的Blob值轉換成Date類型的值
語法Date ( datetime )
參數datetime:DateTime類型的值或第一個值是DateTime或Date的Blob類型的值。當該參數是Blob類型變量時,把該變量第一個值轉換爲Date類型的值,其餘部分被忽略。datetime參數也可以是包含上述類型數據的Any類型變量返回值Date。函數執行成功時返回相應的Date類型值。如果datetime參數中的值不是有效的PowerScript日期或數據類型不兼容,那麼Date()函數返回1900-01-01。如果datetime參數的值爲NULL,則Date()函數返回NULL。
語法二、將其值是個有效日期的字符串轉換成Date類型的值
語法Date ( string )
參數string:string類型,其值包括一個有效的以字符串形式表示的日期(比如January 1, 1998或12-31-99),string參數也可以是包含字符串類型數據的Any類型變量返回值Date。函數執行成功時返回相應的Date類型值。如果string參數中的值不是有效的PowerScript日期或數據類型不兼容,那麼Date()函數返回1900-01-01。如果string參數的值爲NULL,則Date()函數返回NULL。
語法三、將三個表示年、月、日的整數組合成一個日期
語法Date ( year, month, day )
參數year:integer類型,指定日期中的年份,用四位數字表示,從0到9999month:integer類型,指定日期中的月份,用一位或兩位數字表示,從1到12day:integer類型,指定日期中的號數,用一位或兩位數字表示,從1到31返回值Date。函數執行成功時返回由year、month、day三個參數確定的日期。如果這三個參數中任何一個參數使用了無效值(比如月份指定爲14),則Date()函數返回1900-01-01。如果任何參數的值爲NULL,則Date()函數返回NULL。
DateTime()
功能 將其它類型的數據轉換爲DateTime類型的數據。該函數有兩種語法格式:語法一、把日期和時間值組合成DateTime類型的值;語法二、將Blob類型的值轉換成DateTime類型的值。下面分別予以介紹:
語法一、把日期和時間值組合成DateTime類型的值
語法DateTime ( date {, time } )
參數date:Date類型的日期值time:可選參數,Time類型的時間值,省略該參數時,PowerBuilder把時間設置爲午夜(00:00:00.000000)。當指定該參數時,可以僅僅指定小時值返回值DateTime。函數執行成功時返回日期和時間組合而成的DateTime類型的值。如果任何參數的值爲NULL,則DateTime()函數返回NULL。
語法二、將Blob類型的值轉換成DateTime類型的值
語法DateTime ( blob )
參數blob:Blob類型變量,把該變量第一個值轉換爲DateTime類型的值,其餘部分被忽略。blob參數也可以是包含blob類型數據的Any類型變量返回值DateTime。函數執行成功時返回相應的DateTime類型值。如果blob參數的值爲NULL,則DateTime()函數返回NULL。
IsDate()
功能檢測指定的字符串是否包含有效的日期。
語法IsDate ( datevalue )
參數datevalue:string類型,指定要檢測的字符串返回值Boolean。如果datevalue包含了有效的日期,則IsDate()函數返回TRUE,否則返回FALSE。如果datevalue參數的值爲NULL,則IsDate()函數返回NULL。
IsNull()
功能測試變量或表達式的值是否是NULL。
語法IsNull ( any )
參數any:要測試的變量或表達式返回值Boolean:如果any的值爲NULL,函數返回TRUE,否則函數返回FALSE。
IsNumber()
功能測試字符串是否是有效的數值。
語法IsNumber ( string )
參數string:string類型,要測試的字符串返回值Boolean:如果string的值爲有效的PowerScript數字,函數返回TRUE,否則函數返回FALSE。如果string參數的值爲NULL,則IsNumber()函數返回NULL。
IsTime()
功能測試字符串的值是否是有效的時間。
語法IsTime ( timevalue )
參數timevalue:string類型,要測試的字符串返回值Boolean:如果timevalue的值爲有效的時間,函數返回TRUE,否則函數返回FALSE。如果timevalue 參數的值爲NULL,則IsTime()函數返回NULL。
String()
功能按指定格式將數據轉換成字符串。String()可以把Date、DateTime、數值類型、Time、String類型的數據轉換成指定格式的字符串。
語法String(data,{format})
參數data:指定要轉換格式的數據,其數據類型可以是Date、DateTime、數值類型、Time、String,也可以是包含上述類型數據的Any類型變量format:可選項,string類型,其值指定數據格式。如果data參數的類型爲string,則必須指定format參數返回值String。函數執行成功時返回以字符串方式表示的指定數據,如果data參數的數據類型與format參數指定的格式不匹配、format參數指定的格式無效、或data參數不是前面提到的適宜數據類型時,String()函數返回空字符串("")。
用法:
format是個用掩碼錶示的字符串,對data參數爲數值類型的情況來說,格式爲:正數格式;負數格式;零的顯示格式;空的顯示格式除第一部分必須提供外,其它部分可以省略。數值型顯示格式中使用兩個掩碼字符:#和0,其中,使用#代表0~9之間的任意數字,0代表每個零都要顯示。另外,貨幣符號($或¥)、百分號(%)、小數點(.)、逗號(,)等字符也可以出現在格式字符串中,但是,除小數點(.)、逗號(,)能夠出現在格式字符#和0之間外,其它字符只能放置在格式串的前面或後面,例如,###,###$###是個錯誤的格式串,¥###,###,###是個正確的格式串。省略format參數時,String()函數使用PowerBuilder缺省格式。注意,如果顯示格式有多個部分,各部分之間的分號(;)不能省略。其它字符也可以出現在顯示格式字符串中(只能放在格式串的開頭和末尾),但它們沒有特殊意義,系統只是照原樣顯示。例如,用顯示格式字符串“收入##”格式化數值12時,顯示結果爲“收入12”。對data參數爲字符串(String)類型的情況來說,format參數的語法格式爲:正常字符串格式;空值時格式在“正常字符串格式”中,@代表字符串中的任意字符,除此之外的任何字符照原樣顯示,例如,如果定義了下面的格式:(@@)@@@@-@@@@則字符串0166767593顯示爲:(01)6676-7593對data參數爲日期(Date)類型的情況來說,format參數的語法格式爲:正常日期格式;日期爲空值時的格式日期格式中格式字符意義如下:d棗開頭不帶0的日數(如8)dd棗開頭帶0的日數(如08)ddd棗星期的英文縮寫(如Mon、Tue)dddd棗星期的英文全稱(如Monday、Tuesday)m棗開頭不帶0的月份(如8)mm棗開頭帶0的月份(如08)mmm棗月份的英文縮寫(如Jan、Feb)mmmm棗月份的英文全稱(如January、February)yy棗兩位數字表示的年份(如97)yyyy棗四位數字表示的年份(如1997)另外,還可以使用下面的關鍵字作爲日期的顯示格式:[General] Windows系統中定義的短日期格式[LongDate] Windows系統中定義的長日期格式[ShortDate] Windows系統中定義的短日期格式對data參數爲時間(Time)類型的情況來說,語法格式爲:正常時間格式;時間爲空值時的格式時間格式中格式字符意義如下:h開頭不帶0的小時(比如6)hh棗開頭帶0的小時(比如06)m棗開頭不帶0的分鐘(比如6)mm棗開頭帶0的分鐘(比如06)s棗開頭不帶0的秒(比如6)ss棗開頭帶0的秒(比如06)f棗開頭不帶0的微秒,可以指定1~6個f,每個f代表一部分微秒AM/PM棗用AM/PM顯示上、下午時間,12小時制am/pm棗用am/pm顯示上、下午時間,12小時制A/P棗用A/P顯示上、下午時間,12小時制a/p棗用a/p顯示上、下午時間,12小時制另外,顯示格式中還可以使用關鍵字[Time],它表示按當前Windows系統定義的格式顯示時間。對data參數爲日期時間(DateTime)類型的情況來說,語法格式爲:正常日期時間格式;日期時間爲空值時的格式日期時間類型使用的掩碼就是把日期掩碼和時間掩碼結合起來即可。
Time()
功能 把其它類型的數據轉換爲Time類型的值。該函數有三種語法格式:語法一、將DateTime類型或第一個值是DateTime或Time的Blob值轉換成Time類型的值;語法二、將其值是個有效時間的字符串轉換成Time類型的值;語法三、將表示時、分、秒、以及微秒的整數組合成一個時間值。下面分別予以介紹:
語法一、將DateTime類型或第一個值是DateTime或Time的Blob值轉換成Time類型的值
語法Time ( datetime )
參數datetime:DateTime類型的值或第一個值是DateTime或Time的Blob類型的值。當該參數是Blob類型變量時,把該變量第一個值轉換爲Time類型的值,其餘部分被忽略。datetime參數也可以是包含上述類型數據的Any類型變量返回值Time。函數執行成功時返回相應的Time類型值。如果datetime參數中的值不是有效的PowerScript時間或數據類型不兼容,那麼Time()函數返回00:00:00.000000。如果datetime參數的值爲NULL,則Time()函數返回NULL。
語法二、將其值是個有效時間的字符串轉換成Time類型的值
語法Time ( string )
參數string:string類型,其值包括一個有效的以字符串形式表示的時間(比如9am或10:25),string參數也可以是包含時間類型數據的Any類型變量返回值Time。函數執行成功時返回相應的Time類型值。如果string參數中的值不是有效的PowerScript時間或數據類型不兼容,那麼Time()函數返回00:00:00.000000。如果string參數的值爲NULL,則Time()函數返回NULL。
語法三、將表示時、分、秒、以及微秒的整數組合成一個時間值
語法Time ( hour, minute, second {, microsecond } )
參數hour:integer類型,指定時間中的小時,從0到23minute:integer類型,指定時間中的分鐘,從0到59second:integer類型,指定時間中的秒,從0到59microsecond:integer類型,可選項,指定時間中的微秒,從0到32767返回值Time。函數執行成功時返回由hour、minute、second、microsecond 四個參數確定的時間。如果這四個參數中任何一個參數使用了無效值(比如小時指定爲44),則Time()函數返回NULL。 
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章