型別轉換函式總表
| 函式 | 目標型別 | 適用範圍 / 行為 | 備註 |
CBool(expr) | Boolean | 數值 0→False,非 0→True;字串需可轉數值 | 字串 "True"/"False" 會報錯 |
CByte(expr) | Byte (0-255) | 超出範圍溢位錯誤 | 四捨五入 (銀行家算法) |
CInt(expr) | Integer (-32,768~32,767) | 小數四捨五入到整數 | .5 到偶數 |
CLng(expr) | Long (-2.14B~2.14B) | 同 CInt 但範圍大 | .5 到偶數 |
CSng(expr) | Single (單精度) | 7 位有效數字 | |
CDbl(expr) | Double (雙精度) | 15 位有效數字,預設數值型別 | 財務計算慎用 |
CCur(expr) | Currency (貨幣) | 固定 4 位小數,精確財務計算 | 範圍 ±922,337,203,685,477.5807 |
CDate(expr) | Date | 支援多種字串格式,依伺服器地區設定 | 建議配合 IsDate 先判斷 |
CStr(expr) | String | 任何型別轉字串,Null→"",日期→短日期格式 | 最常用 |
CVar(expr) | Variant | 轉為 Variant,子型別依內容決定 | 少用 |
CDec(expr) | Decimal (Variant 子型別) | 28 位精度,極大數值 | 回傳 Variant/Decimal |
關鍵行為差異:CInt/CLng vs Fix/Int
值 CInt/CLng (四捨五入到偶數) Fix (截斷向零) Int (向下取整)
1.5 → 2 → 1 → 1
2.5 → 2 → 2 → 2
-1.5 → -2 → -1 → -2
-2.5 → -2 → -2 → -3
記住: 財務四捨五入請用 FormatNumber(val, 2) 或自訂函式,不要依賴 CInt/CLng。
CDate 日期解析規則與地區設定陷阱
- 伺服器地區設定決定「年/月/日」順序:美式
MM/DD/YYYY vs 歐式 DD/MM/YYYY
- 安全做法:只餵 ISO 格式
YYYY-MM-DD 或 YYYY/MM/DD 給 CDate
- 數字轉日期:整數部份 = 從 1899/12/30 起算的天數,小數部份 = 時間
實用輔助函式:安全轉型
<%
' 安全轉整數,失敗回傳預設值
Function ToInt(val, def)
If IsNumeric(val) Then
ToInt = CLng(val) ' 用 CLng 避免溢位
Else
ToInt = def
End If
End Function
' 安全轉日期
Function ToDate(val, def)
If IsDate(val) Then
ToDate = CDate(val)
Else
ToDate = def
End If
End Function
' 安全轉布林 (支援 "true"/"false" 字串)
Function ToBool(val)
Dim s : s = LCase(Trim(CStr(val)))
If s = "true" Or s = "yes" Or s = "1" Or s = "on" Then
ToBool = True
ElseIf s = "false" Or s = "no" Or s = "0" Or s = "off" Or s = "" Then
ToBool = False
Else
Err.Raise vbObjectError + 1, "ToBool", "無法轉換: " & val
End If
End Function
%>
常見錯誤與除錯
| 錯誤訊息 | 原因 | 解決 |
| Type mismatch | 傳入 Null 或無法轉換的字串 | 先用 IsNull/IsNumeric/IsDate 判斷 |
| Overflow | 數值超出目標型別範圍 | 改用 CLng/CDbl/CCur |
| Invalid procedure call | CDate 解析失敗 | 統一 ISO 格式或用 DateSerial 組裝 |
最佳實務
- 輸入參數進入商業邏輯前,統一用安全轉型函式清洗
- 資料庫欄位型別與 VBScript 變數型別對應:
INT→CLng, DECIMAL→CCur, VARCHAR→CStr, DATETIME→CDate
- JSON 序列化時:
CStr 日期會產生地區相關格式,建議手動 FormatDT(dt, 9) 產生 ISO 字串