前言
VBScript 提供豐富的內建函式,但官方文件早已停止維護。本手冊將常用函式依功能分類,附上語法、參數說明與實戰範例,方便 ASP 開發者快速查閱。
一、型別轉換函式
| 函式 | 用途 | 範例 | 結果 |
CStr(expr) | 轉為字串 | CStr(123) | "123" |
CInt(expr) | 轉為整數(四捨五入) | CInt(3.6) | 4 |
CLng(expr) | 轉為長整數 | CLng(30000) | 30000 |
CDbl(expr) | 轉為雙精度浮點數 | CDbl("3.14") | 3.14 |
CSng(expr) | 轉為單精度浮點數 | CSng(1.23) | 1.23 |
CBool(expr) | 轉為布林值 | CBool(1) | True |
CDate(expr) | 轉為日期 | CDate("2024/12/25") | 2024/12/25 |
CByte(expr) | 轉為位元組 (0-255) | CByte(256) | 錯誤(溢位) |
CCur(expr) | 轉為貨幣型別 | CCur(123.456) | 123.456 |
注意: CInt/CLng 對 .5 會四捨五入到最近的偶數(銀行家算法),若需單純截斷請用 Fix 或 Int。
二、字串處理函式
| 函式 | 語法 | 說明 | 範例 |
| Len | Len(str) | 回傳字串長度 | Len("ABC")=3 |
| Left | Left(str, n) | 取左邊 n 字元 | Left("ABCDE",2)="AB" |
| Right | Right(str, n) | 取右邊 n 字元 | Right("ABCDE",2)="DE" |
| Mid | Mid(str, start[, len]) | 取子字串 | Mid("ABCDE",2,2)="BC" |
| InStr | InStr([start,] str1, str2[, compare]) | 由左往右搜尋位置 | InStr("abcde","cd")=3 |
| InStrRev | InStrRev(str1, str2[, start[, compare]]) | 由右往左搜尋位置 | InStrRev("abcda","a")=5 |
| Replace | Replace(str, find, repl[, start[, count[, compare]]]) | 取代字串 | Replace("a b c"," ","-")="a-b-c" |
| Split | Split(str[, delim[, count[, compare]]]) | 分割成陣列 | Split("a,b,c",",") → Array("a","b","c") |
| Join | Join(arr[, delim]) | 陣列合併為字串 | Join(Array("a","b"),"-")="a-b" |
| LCase/UCase | LCase(str)/UCase(str) | 大小寫轉換 | UCase("abc")="ABC" |
| Trim/LTrim/RTrim | Trim(str) | 移除首尾/左/右空白 | Trim(" a ")=="a" |
| Space | Space(n) | 產生 n 個空白 | Space(3)=" " |
| String | String(n, char) | 重複字元 n 次 | String(3,"*")="***" |
| StrReverse | StrReverse(str) | 反轉字串 | StrReverse("abc")="cba" |
三、日期時間函式
| 函式 | 語法 | 說明 | 範例 |
| Date | Date() | 系統日期 | 2024-12-25 |
| Time | Time() | 系統時間 | 14:30:00 |
| Now | Now() | 日期+時間 | 2024-12-25 14:30:00 |
| Year/Month/Day | Year(dt) 等 | 取年/月/日 | Month(#2024-12-25#)=12 |
| Hour/Minute/Second | Hour(tm) 等 | 取時/分/秒 | Second(#14:30:05#)=5 |
| Weekday | Weekday(dt[, firstDay]) | 星期幾 (1=週日) | Weekday(#2024-12-25#)=4 |
| DateAdd | DateAdd(interval, num, dt) | 日期加減 | DateAdd("d",7,Date()) 一週後 |
| DateDiff | DateDiff(interval, dt1, dt2[, ...]) | 日期差值 | DateDiff("d",dt1,dt2) 天數差 |
| DatePart | DatePart(interval, dt[, ...]) | 取日期部分 | DatePart("q",dt) 季度 |
| DateSerial | DateSerial(y,m,d) | 建立日期 | DateSerial(2024,12,25) |
| TimeSerial | TimeSerial(h,m,s) | 建立時間 | TimeSerial(14,30,0) |
| FormatDateTime | FormatDateTime(dt, fmt) | 格式化輸出 | FormatDateTime(Now(),vbShortDate) |
Interval 代碼對照: yyyy=年, q=季, m=月, y=年積日, d=日, w=週日, ww=週, h=時, n=分, s=秒
四、數學函式
| 函式 | 說明 | 範例 |
| Abs | 絕對值 | Abs(-5)=5 |
| Sgn | 正負號 (-1/0/1) | Sgn(-3)=-1 |
| Int/Fix | 取整數部份 (負數處理不同) | Int(-5.6)=-6, Fix(-5.6)=-5 |
| Rnd | 亂數 (0~1) | Randomize: Int(Rnd*100)+1 1~100 |
| Sqr | 平方根 | Sqr(16)=4 |
| Sin/Cos/Tan | 三角函數 (弧度) | Sin(1.5708)≈1 |
| Atn | 反正切 | Atn(1)=0.785... |
| Exp/Log | 自然指數/對數 | Exp(1)=2.718... |
| Hex/Oct | 轉 16/8 進位字串 | Hex(255)="FF" |
五、陣列與資料檢查函式
| 函式 | 用途 | 範例 |
| IsArray | 是否為陣列 | IsArray(Array(1,2))=True |
| IsDate | 可否轉日期 | IsDate("2024/12/25")=True |
| IsEmpty | 未初始化 | Dim x: IsEmpty(x)=True |
| IsNull | Null 值 | IsNull(Null)=True |
| IsNumeric | 是否數值 | IsNumeric("123")=True |
| IsObject | 是否物件 | IsObject(Server)=True |
| VarType | 回傳型別代碼 | VarType("abc")=8 (vbString) |
| TypeName | 回傳型別名稱 | TypeName(123)="Integer" |
| Array | 建立陣列 | Array("a","b","c") |
| Filter | 陣列篩選 | Filter(arr,"key") |
六、常用常數
vbCrLf = Chr(13) & Chr(10) ' 換行
vbCr = Chr(13) ' CR
vbLf = Chr(10) ' LF
vbTab = Chr(9) ' Tab
vbNullChar = Chr(0) ' Null
vbNullString = "" ' 空字串
vbTrue = True
vbFalse = False
' 比較模式
vbBinaryCompare = 0
vbTextCompare = 1
' 日期格式
vbGeneralDate = 0
vbLongDate = 1
vbShortDate = 2
vbLongTime = 3
vbShortTime = 4
七、實用小技巧
- 安全取值:
val = Trim(Request("param") & "") 避免 Null 錯誤。
- 判斷空值:
If IsEmpty(v) Or IsNull(v) Or Trim(v)="" Then。
- 日期比對:直接用
If dt1 > dt2 Then,VBScript 日期可直接比大小。
- 陣列是否為空:
If IsArray(arr) And UBound(arr) >= 0 Then。