內置函式

程式語言中預先定義的函式。

具體：嵌入到主調函式中的函式稱為內置函式，又稱內嵌函式。 作用是提高程式的執行效率，大多程式語言都有自己的內置函式，如javascript內置函式等。 內置函式的存在極大的提升了程式設計師的效率和程式的閱讀。

基本介紹

• 中文名：內置函式
• 適用範圍：JavaScript C C++ Pascal Smarty

函式定義

一組預定義的函式，這些函式作為 Transact-SQL 和多維表達式 (MDX) 語言的部分而提供。

JavaScript

1.數學函式

abs 方法 返回一個數的絕對值。

acos 方法 返回一個數的反餘弦。

anchor 方法 在對象的指定文本兩端加上一個帶 NAME 屬性的 HTML 錨點。

asin 方法 返回一個數的反正弦。

atan 方法 返回一個數的反正切。

atan2 方法 返回從 X 軸到點 （y,x）的角度（以弧度為單位）。

cos 方法 返回一個數的餘弦。

sin 方法 返回一個數的正弦。

sqrt 方法 返回一個數的平方根。

tan 方法 返回一個數的正切。

round 方法 將一個指定的數值表達式捨入到最近的整數並將其返回。

random 方法 返回一個 0 和 1 之間的偽隨機數。

parseFloat 方法 返回從字元串轉換而來的浮點數。

parseInt 方法 返回從字元串轉換而來的整數。

pow 方法 返回一個指定冪次的底表達式的值。

2.字元串函式

atEnd 方法 返回一個表明枚舉運算元是否處於集合結束處的 Boolean 值。

big 方法 在String 對象的文本兩端加入 HTML 的<BIG>標識。

blink 方法 將 HTML 的<BLINK> 標識添加到 String 對象中的文本兩端。

bold 方法 將 HTML 的 <B> 標識添加到String 對象中的文本兩端。

ceil 方法 返回大於或等於其數值參數的最小整數。

charAt 方法 返回位於指定索引位置的字元。

charCodeAt 方法 返回指定字元的 Unicode 編碼。

compile 方法 將一個正則表達式編譯為內部格式。

concat 方法（Array） 返回一個由兩個數組合併組成的新數組。

concat 方法（String） 返回一個包含給定的兩個字元串的連線的 String 對象。

dimensions 方法 返回 VBArray 的維數。

escape 方法 對 String 對象編碼，以便在所有計算機上都能閱讀。

eval 方法 對 JScript 代碼求值然後執行之。

exec 方法 在指定字元串中執行一個匹配查找。

exp 方法 返回 e （自然對數的底） 的冪。

fixed 方法 將 HTML 的<TT> 標識添加到String 對象中的文本兩端。

floor 方法 返回小於或等於其數值參數的最大整數。

fontcolor 方法 將 HTML 帶 COLOR 屬性的<FONT>；標識添加到 String 對象中的文本兩端。

fontsize 方法 將 HTML 帶 SIZE 屬性的<FONT>；標識添加到 String 對象中的文本兩端。

fromCharCode 方法 返回 Unicode 字元值的字元串。

indexOf 方法 返回在 String 對象中第一次出現子字元串的字元位置。

slice 方法 （Array） 返回數組的一個片段。

slice 方法 （String） 返回字元串的一個片段。

small 方法 將 HTML 的<SMALL>；標識添加到 String 對象中的文本兩端。

sort 方法 返回一個元素被排序了的 Array 對象。

split 方法 將一個字元串分割為子字元串，然後將結果作為字元串數組返回。strike 方法 將 HTML 的<STRIKE> 標識添加到String 對象中的文本兩端。

sub 方法 將 HTML 的 <SUB> 標識放置到 String 對象中的文本兩端。

substr 方法 返回一個從指定位置開始並具有指定長度的子字元串。

substring 方法 返回位於 String 對象中指定位置的子字元串。

sup 方法 將 HTML 的 <SUP> 標識放置到 String 對象中的文本兩端。

unescape 方法 對用escape 方法編碼的 String 對象進行解碼。

UTC 方法 返回 1970年1月1日零點的全球標準時間 （UTC）（或 GMT）與指定日期之間的毫秒數.

valueOf 方法 返回指定對象的原始值。

toLocaleString 方法 返回一個轉換為使用當地時間的字元串的日期。

toLowerCase 方法 返回一個所有的字母字元都被轉換為小寫字母的字元串。

toString 方法 返回一個對象的字元串表示。

toUpperCase 方法 返回一個所有的字母字元都被轉換為大寫字母的字元串。

toUTCString 方法 返回一個轉換為使用全球標準時間（UTC）的字元串的日期。

ubound 方法 返回在 VBArray 的指定維中所使用的最大索引值。

test 方法 返回一個 Boolean 值，表明在被查找的字元串中是否存在某個模式。

toArray 方法 返回一個從 VBArray 轉換而來的標準 JScript 數組。

3.日期函式

getDate 方法 使用當地時間返回 Date 對象的月份日期值。

getDay 方法 使用當地時間返回 Date 對象的星期幾。

getFullYear 方法 使用當地時間返回 Date 對象的年份。

getHours 方法 使用當地時間返回 Date 對象的小時值。

getItem 方法 返回位於指定位置的項。

getMilliseconds 方法 使用當地時間返回 Date 對象的毫秒值。

getMinutes 方法 使用當地時間返回 Date 對象的分鐘值。

getMonth 方法 使用當地時間返回 Date 對象的月份。

getSeconds 方法 使用當地時間返回 Date 對象的秒數。

getTime 方法 返回 Date 對象中的時間。

getTimezoneOffset 方法 返回主機的時間和全球標準時間（UTC）之間的差（以分鐘為單位）。

getUTCDate 方法 使用全球標準時間（UTC）返回 Date 對象的日期值。

getUTCDay 方法 使用全球標準時間（UTC）返回 Date 對象的星期幾。

getUTCFullYear 方法 使用全球標準時間（UTC）返回 Date 對象的年份。

getUTCHours 方法 使用全球標準時間（UTC）返回Date 對象的小時數。

getUTCMilliseconds 方法 使用全球標準時間（UTC）返回Date 對象的毫秒數。

getUTCMinutes 方法 使用全球標準時間（UTC）返回 Date 對象的分鐘數。

getUTCMonth 方法 使用全球標準時間（UTC）返回 Date 對象的月份值。

getUTCSeconds 方法 使用全球標準時間（UTC）返回Date對象的秒數。

getVarDate 方法 返回 Date 對象中的 VT_DATE。

getYear 方法 返回 Date 對象中的年份。

isFinite 方法 返回一個 Boolean 值，表明某個給定的數是否是有窮的。

isNaN 方法 返回一個 Boolean 值，表明某個值是否為保留值 NaN （不是一個數）。

italics 方法 將 HTML的 <I> 標識添加到 String 對象中的文本兩端。

item 方法 返回集合中的當前項。

join 方法 返回一個由數組中的所有元素連線在一起的 String 對象。

lastIndexOf 方法 返回在 String 對象中子字元串最後出現的位置。

lbound 方法 返回在 VBArray 中指定維數所用的最小索引值。

link 方法 將帶 HREF 屬性的 HTML 錨點添加到 String 對象中的文本兩端。

log 方法 返回某個數的自然對數。

match 方法 使用給定的正則表達式對象對字元串進行查找，並將結果作為數組返回。

max 方法 返回給定的兩個表達式中的較大者。

min 方法 返回給定的兩個數中的較小者。

moveFirst 方法 將集合中的當前項設定為第一項。

moveNext 方法 將當前項設定為集合中的下一項。

parse 方法 對包含日期的字元串進行分析，並返回該日期與1970年1月1日零點之間相差的毫秒數。

replace 方法 返回根據正則表達式進行文字替換後的字元串的拷貝。

reverse 方法 返回一個元素反序的 Array 對象。

search 方法 返回與正則表達式查找內容匹配的第一個子字元串的位置。

setDate 方法 使用當地時間設定 Date 對象的數值日期。

setFullYear 方法 使用當地時間設定 Date 對象的年份。

setHours 方法 使用當地時間設定 Date 對象的小時值。

setMilliseconds 方法 使用當地時間設定 Date 對象的毫秒值。

setMinutes 方法 使用當地時間設定 Date 對象的分鐘值。

setMonth 方法 使用當地時間設定 Date 對象的月份。

setSeconds 方法 使用當地時間設定 Date 對象的秒值。

setTime 方法 設定 Date 對象的日期和時間。

setUTCDate 方法 使用全球標準時間（UTC）設定 Date 對象的數值日期。

setUTCFullYear 方法 使用全球標準時間（UTC）設定 Date 對象的年份。

setUTCHours 方法 使用全球標準時間（UTC）設定 Date 對象的小時值。

setUTCMilliseconds 方法 使用全球標準時間（UTC）設定 Date 對象的毫秒值。

setUTCMinutes 方法 使用全球標準時間（UTC）設定 Date 對象的分鐘值。

setUTCMonth 方法 使用全球標準時間（UTC）設定 Date 對象的月份。

setUTCSeconds 方法 使用全球標準時間（UTC）設定 Date 對象的秒值。

setYear 方法 使用 Date 對象的年份。

toGMTString 方法 返回一個轉換為使用格林威治標準時間（GMT）的字元串的日期。

VB

Abs(number)

返回參數的絕對值，其類型和參數相同。

必要的 number 參數是任何有效的數值表達式，如果 number 包含 Null，則返回 Null，如果 number 是未初始化的變數，則返回 0。

一個數的絕對值是將正負號去掉以後的值。例如，ABS(-1） 和 ABS⑴ 都返回 1。

Array(arglist)

返回一個包含數組的 Variant。

所需的 arglist 參數是一個用逗號隔開的值表，這些值用於給 Variant 所包含的數組的各元素賦值。如果不提供參數，則創建一個長度為 0 的數組。

用來表示數組元素的符號由變數名、圓括弧以及括弧中的所需元素的索引號組成。在下面的示例中，第一條語句創建一個 Variant 的變數 A。第二條語句將一個數組賦給變數 A。最後一條語句將該數組的第二個元素的值賦給另一個變數。

Dim A As Variant

A = Array（10,20,30）

B = A⑵

使用 Array 函式創建的數組的下界受 Option Base 語句指定的下界的決定，除非 Array 是由類型庫（例如 VBA.Array）名稱限定。如果是由類型庫名稱限定，則 Array 不受 Option Base 的影響。

注意 沒有作為數組聲明的 Variant 也可以表示數組。除了長度固定的字元串以及用戶定義類型之外，Variant 變數可以表示任何類型的數組。儘管一個包含數組的 Variant 和一個元素為 Variant 類型的數組在概念上有所不同，但對數組元素的訪問方式是相同的。

Asc(string)

返回一個 Integer，代表字元串中首字母的字元代碼。

必要的 string 參數可以是任何有效的字元串表達式。如果 string 中沒有包含任何字元，則會產生運行時錯誤。

在非 DBCS 系統下，返回值範圍為 0 – 255。在 DBCS 系統下，則為 -32768 – 32767。

注意 AscB 函式作用於包含在字元串中的位元組數據，AscB 返回第一個位元組的字元代碼，而非字元的字元代碼。AscW 函式返回 Unicode 字元代碼，若平台不支持 Unicode，則與 Asc 函式功能相同。

Atn(number)

返回一個 Double，指定一個數的反正切值。

必要的 number 參數是一個 Double或任何有效的數值表達式。

Atn 函式的參數值 (number) 為直角三角形兩邊的比值並返回以弧度為單位的角。這個比值是角的對邊長度除以角的鄰邊長度之商。

值的範圍在 -pi/2 和 pi/2 弧度之間。

為了將角度轉換為弧度，請將角度乘以 pi/180。為了將弧度轉換為角度，請將弧度乘以 180/pi。

注意 Atn 是 Tan 的反三角函式，Tan 的參數值為角度，返回直角三角形的兩條邊的比值。不要將 Atn 和餘切函式混淆，餘切函式值是正切函式值的倒數，cotangent = （1/tangent）。

CallByName(object,procedurename,calltype,[arguments()])

執行一個對象的方法，或者設定或返回一個對象的屬性。

object 必需的；變體型（對象）。函式將要執行的對象的名稱。

procedurename 必需的；變體型（字元串）。一個包含該對象的屬性名稱或者方法名稱的字元串表達式。

calltype 必需的；常數。一個 vbCallType 類型的常數，代表正在被調用的過程的類型。

arguments() 可選的：變體型（數組）。

CallByName 函式用於獲取或者設定一個屬性，或者在運行時使用一個字元串名稱來調用一個方法。

在下面的例子中，第一行使用 CallByName 來設定一個文本框的 MousePointer 屬性，第二行得到 MousePointer 屬性的值，第三行調用 Move 方法來移動文本框：

CallByName Text1,"MousePointer",vbLet,vbCrosshair

Result = CallByName (Text1,"MousePointer",vbGet)

CallByName Text1,"Move",vbMethod,100,100

Choose(index,choice-1[,choice-2,... [,choice-n]])

從參數列表中選擇並返回一個值。

Choose 函式的語法具有以下幾個部分：

index 必要參數，數值表達式或欄位，它的運算結果是一個數值，且界於 1 和可選擇的項目數之間。

choice 必要參數，Variant 表達式，包含可選擇項目的其中之一。

Choose 會根據 index 的值來返回選擇項列表中的某個值。如果 index 是 1，則 Choose 會返回列表中的第 1 個選擇項。如果 index 是 2，則會返回列表中的第 2 個選擇項，以此類推。

可以使用 Choose 來查閱一個列表中的項目。例如，如果 index 所指定的值為 3，而 choice-1 = "one"、choice-2 = "two"、且 choice-3 = "three"，那么 Choose 將返回 "three"。當 index 代表一選項組中的值時，則這項功能將會特別有用。

即使它只返回一個選項值，Choose 仍然會計算列表中的每個選擇項。所以應該注意到這項副作用。例如，當在每個選擇項表達式中使用了 MsgBox 函式作為其中的一部分時，每計算一個選擇項，就會顯示一次訊息框。

當 index小於 1 或大於列出的選擇項數目時，Choose 函式返回 Null。

如果 index 不是整數，則會先四捨五入為與其最接近的整數。

Chr(charcode)

返回 String，其中包含有與指定的字元代碼相關的字元。

Command

返回命令行的參數部分，該命令行用於裝入 Microsoft Visual Basic 或 Visual Basic 開發的可執行程式。

當從命令行裝入 Visual Basic 時，/cmd 之後的命令行的任何部分作為命令行的參數傳遞給程式。下面的示例中，cmdlineargs 代表 Command 函式返回的參數信息。

VB /cmd cmdlineargs

對於使用 Visual Basic 開發並編譯為 .exe 檔案的應用程式，Command 返回出現在命令行中應用程式名之後的任何參數。例如：

MyApp cmdlineargs

Cos(number)

返回一個 Double，指定一個角的餘弦值。

CreateObject(class,[servername])

創建並返回一個對 ActiveX 對象的引用。

每個支持自動化的應用程式都至少提供一種對象類型。例如，一個字處理應用程式可能會提供 Application 對象，Document 對象，以及 Toolbar 對象。

要創建 ActiveX 對象，只需將 CreateObject 返回的對象賦給一個對象變數：

'聲明一個對象變數來存放該對象

'的引用。Dim as Object 採用後期綁定方式。

Dim ExcelSheet As Object

Set ExcelSheet = CreateObject("Excel.Sheet")

上述代碼將啟動該應用程式創建該對象，在本例中就是創建一個 Microsoft Excel 電子數據表。對象創建後，就可以在代碼中使用自定義的對象變數來引用該對象。在下面的示例中，可以使用對象變數 ExcelSheet 來訪問新建對象的屬性和方法，以及訪問 Microsoft Excel 的其它對象，包括應用程式對象和單元格集合。

'設定 Application 對象使 Excel 可見

ExcelSheet.Application.Visible = True

'在表格的第一個單元中寫些文本

ExcelSheet.Cells（1,1）.Value = "This is column A,row 1"

'將該表格保存到 C:\test.doc 目錄

ExcelSheet.SaveAs "C:\ TEST.DOC"

'使用應用程式對象的 Quit 方法關閉 Excel。

ExcelSheet.Application.Quit

'釋放該對象變數

Set ExcelSheet = Nothing

使用 As Object 子句聲明對象變數，可以創建一個能包含任何類型對象引用的變數。不過，該變數訪問對象是後期綁定的，也就是說，綁定在程式運行時才進行。要創建一個使用前期綁定方式的對象變數，也就是說，在程式編譯時就完成綁定，則對象變數在聲明時應指定類 ID。例如，可以聲明並創建下列 Microsoft Excel 引用：

Dim xlApp As Excel.Application

Dim xlBook As Excel.Workbook

Dim xlSheet As Excel.WorkSheet

Set xlApp = CreateObject("Excel.Application")

Set xlBook = xlApp.Workbooks.Add

Set xlSheet = xlBook.Worksheets⑴

前期綁定的變數引用可以提供更好的性能，但該變數只能存放聲明中所指定的類的引用。

可以將 CreateObject 函式返回的對象傳給一個參數為對象的函式。例如，下面的代碼創建並傳遞了一個 Excel.Application 對象的引用：

Call MySub (CreateObject("Excel.Application"))

可以在一個遠端連網的計算機上創建一個對象，方法是把計算機的名稱傳遞給 CreateObject 的 servername 參數。這個名稱與共享名稱的機器名部份相同：對於一個共享名稱為 "\\\\MyServer\\Public," 的 servername 參數是 "MyServer"。

下面的代碼返回在一個名為 MyServer 的遠端計算機上運行的 Excel 實例的版本號：

Dim xlApp As Object

Set xlApp = CreateObject("Excel.Application","MyServer")

Debug.Print xlApp.Version

如果遠端伺服器不存在或者不可用，則會發生一個運行時錯誤。

注意 當該對象當前沒有實例時，應使用 CreateObject。如果該對象已有實例在運行，就會啟動一個新的實例，並創建一個指定類型的對象。要使用當前實例，或要啟動該應用程式並載入一個檔案，可以使用 GetObject 函式。

如果對象已登記為單個實例對象，則不管執行多少次 CreateObject，都只能創建該對象的一個實例。

CurDir[(drive)]

返回一個 Variant (String），用來代表當前的路徑。

可選的 drive 參數是一個字元串表達式，它指定一個存在的驅動器。如果沒有指定驅動器，或 drive 是零長度字元串 ("")，則 CurDir 會返回當前驅動器的路徑。

CVErr(errornumber)

返回 Error 子類型的 Variant，其中包含指定的錯誤號。

必要的 errornumber 參數可以是任何有效的錯誤號代碼。

可以在過程中，使用 CVErr 函式來創建用戶自定義錯誤。例如，如果創建一個函式，它可以接受若干個參數，且正常返回一個字元串，則可以讓函式來判斷輸入的參數，確認它們是在可接受的範圍內。如果不是的話，此函式將不會返回所要的字元串。在這種情況下，CVErr 可以返回一個錯誤號，並告知應該採取的行動。

注意，Error 的隱式轉換是不允許的，例如，不能直接把 CVErr 的返回值賦值給一個非 Variant 的變數。然而，可以對 CVErr 的返回值進行顯式轉換（使用 CInt、CDbl 等等），並賦值給適當的數據類型變數。

Date

返回包含系統日期的 Variant (Date）。

DateAdd(interval,number,date)

返回包含一個日期的 Variant (Date），這一日期還加上了一段時間間隔。

DateAdd 函式語法中有下列命名參數：

interval 必要。字元串表達式，是所要加上去的時間間隔。

number 必要。數值表達式，是要加上的時間間隔的數目。其數值可以為正數（得到未來的日期），也可以為負數（得到過去的日期）。

date 必要。Variant (Date) 或表示日期的文字，這一日期還加上了時間間隔。

interval 參數具有以下設定值：

yyyy 年

q 季

m 月

y 一年的日數

d 日

w 一周的日數

ww 周

h 時

n 分鐘

s 秒

可以使用 DateAdd 函式對日期加上或減去指定的時間間隔。例如，可以用 DateAdd 來計算距今天為三十天的日期；或者計算距現在為 45 分鐘的時間。

為了對 date 加上“日”，可以使用“一年的日數” （“y”），“日” （”d”） 或“一周的日數” （”w”）。

DateAdd 函式將不返回有效日期。在以下實例中將 1 月31 日加上一個月：

DateAdd(m,1,31-Jan-95）

上例中，DateAdd 返回 1995 年 2 月 28 日，而不是 1995 年 2 月 31 日。如果 date 是 1996 年 1 月 31 日，則由於 1996 年是閏年，返回值是 1996 年 2 月 29 日。

如果計算的日期超前 100 年（減去的年度超過 date 中的年份），就會導致錯誤發生。

如果 number 不是一個 Long 值，則在計算時取最接近的整數值來計算。

注意 DateAdd 返回值的格式由 Control Panel設定決定，而不是由傳遞到date 參數的格式決定。

DateDiff(interval,date1,date2[,firstdayofweek[,firstweekofyear]])

返回 Variant (Long) 的值，表示兩個指定日期間的時間間隔數目。

interval設定同上

firstdayofweek 參數的設定值如下：

常數 值 描述

vbUseSystem 0 使用 NLS API 設定。

vbSunday 1 星期日（預設值）

vbMonday 2 星期一

vbTuesday 3 星期二

vbWednesday 4 星期三

vbThursday 5 星期四

vbFriday 6 星期五

vbSaturday 7 星期六

常數 值 描述

vbUseSystem 0 用 NLS API 設定。

vbFirstJan1 1 從包含 1 月 1 日的星期開始（預設值）。

vbFirstFourDays 2 從第一個其大半個星期在新的一年的一周開始。

vbFirstFullWeek 3 從第一個無跨年度的星期開始。

DatePart(interval,date[,firstdayofweek[,firstweekofyear]])

返回一個包含已知日期的指定時間部分的 Variant (Integer）。

DatePart 函式可以用來計算日期並返回指定的時間間隔。例如，可以使用DatePart 計算某個日期是星期幾或目前為幾點鐘。

firstdayofweek 參數會影響使用時間間隔符號 “W” 或 “WW” 計算的結果。

如果 date 是日期文字，則指定的年份成為該日期的固定部分。但是，如果 date 用雙引號 (" ") 括起來，且年份略而不提，則在每次計算 date 表達式時，當前年份都會插入到代碼之中。這樣就可以書寫適用於不同年份的程式代碼。

DateSerial(year,month,day)

返回包含指定的年、月、日的 Variant (Date）。

為了指定某個日期，如 1991 年 12 月 31 日，DateSerial 函式中的每個參數的取值範圍應該是可接受的；即，日的取值範圍應在 1-31 之間，而月的取值範圍應在 1-12 之間。但是，當一個數值表達式表示某日之前或其後的年、月、日數時，也可以為每個使用這個數值表達式的參數指定相對日期。

以下示例中使用了數值表達式代替絕對日期。這裡，DateSerial 函式返回 1990 年 8 月 1 日的 十 年 （1990 - 10） 零兩個月 （8 - 2） 又一天 （1 - 1） 之前的日期；換句話說，就是 1980 年 5 月 31 日。

DateSerial（1990 - 10,8 - 2,1 - 1）

year 參數的數值若介於 0 與 29 之間，則將其解釋為 2000–2029年，若介於 30 和 99 之間則解釋為1930–1999年。而對所有其它 year 參數，則請用四位數值表示（如 1800）。

當任何一個參數的取值超出可接受的範圍時，它會適時進位到下一個較大的時間單位。例如，如果指定了 35 天，則這個天數被解釋成一個月加上多出來的日數，多出來的日數將由其年份與月份來決定。如果一個參數值超出 -32，768 到 32，767 的範圍，就會導致錯誤發生。

DateValue(date)

返回一個 Variant (Date）。

Day(date)

返回一個 Variant (Integer），其值為 1 到 31 之間的整數，表示一個月中的某一日。

DDB(cost,salvage,life,period[,factor])

返回一個 Double，指定一筆資產在一特定期間內的折舊。可使用雙下落收復平衡方法或其它指定的方法進行計算。

Dir[(pathname[,attributes])]

返回一個 String，用以表示一個檔案名稱、目錄名或資料夾名稱，它必須與指定的模式或檔案屬性、或磁碟卷標相匹配。

Dir 函式的語法具有以下幾個部分：

部分 描述

pathname 可選參數。用來指定檔案名稱的字元串表達式，可能包含目錄或資料夾、以及驅動器。如果沒有找到 pathname，則會返回零長度字元串 ("")。

attributes 可選參數。常數或數值表達式，其總和用來指定檔案屬性。如果省略，則會返回匹配 pathname 但不包含屬性的檔案。

attributes 參數的設定可為：

常數 值 描述

vbNormal 0 （預設） 指定沒有屬性的檔案。

vbReadOnly 1 指定無屬性的唯讀檔案

vbHidden 2 指定無屬性的隱藏檔案

VbSystem 4 指定無屬性的系統檔案

vbVolume 8 指定卷標檔案；如果指定了其它屬性，則忽略vbVolume

vbDirectory 16 指定無屬性檔案及其路徑和資料夾。

注意 這些常數是由 VBA 所指定的，在程式代碼中的任何位置，可以使用這些常數來替換真正的數值。

Dir 支持多字元 (*) 和單字元 (?) 的通配符來指定多重檔案。

由於 Macintosh 不支持通配符，使用檔案類型指定檔案組。可以使用 MacID 函式指定檔案類型而不用檔案名稱。比如，下列語句返回當前資料夾中第一個TEXT檔案的名稱：

Dir("SomePath",MacID("TEXT"))

為選中資料夾中所有檔案，指定一空串：

Dir("")

在 Microsoft Windows 中，如果在Dir函式中使用MacID函式，將產生錯誤。

任何大於256的attribute值都被認為是MacID 函式的值。

在第一次調用 Dir 函式時，必須指定 pathname，否則會產生錯誤。如果也指定了檔案屬性，那么就必須包括 pathname。

Dir 會返回匹配 pathname 的第一個檔案名稱。若想得到其它匹配 pathname 的檔案名稱，再一次調用 Dir，且不要使用參數。如果已沒有合乎條件的檔案，則 Dir 會返回一個零長度字元串 ("")。一旦返回值為零長度字元串，並要再次調用 Dir 時，就必須指定 pathname，否則會產生錯誤。不必訪問到所有匹配當前 pathname 的檔案名稱，就可以改變到一個新的 pathname 上。但是，不能以遞歸方式來調用 Dir 函式。以 vbDirectory 屬性來調用 Dir 不能連續地返回子目錄。

提示 由於檔案名稱並不會以特別的次序來返回，所以可以將檔案名稱存儲在一個數組中，然後再對這個數組排序。

DoEvents()

轉讓控制權，以便讓作業系統處理其它的事件。

Environ({envstring | number})

返回 String，它關連於一個作業系統環境變數。在 Macintosh 中不可用

如果在環境字元串表格中找不到 envstring，則會返回一個零長度字元串 ("")。如果找到，則 Environ 會返回一段文本，文本是賦值給指定的 envstring 的，也就是說，在環境字元串表格中對應那個環境變數的等號 (=) 後面的那段文本。

如果指定了 number，則在環境字元串表格中相應位置上的字元串會返回。在這種情況下，Environ 會返回整個文本，包括 envstring。如果在指定位置上沒有環境字元串，那么 Environ 會返回一個零長度字元串。

EOF(filenumber)

返回一個 Integer，它包含 Boolean 值 True，表明已經到達為 Random 或順序 Input 打開的檔案的結尾。

Error[(errornumber)]

返回對應於已知錯誤號的錯誤信息。

Exp(number)

返回 Double，指定 e（自然對數的底）的某次方。

FileAttr(filenumber,returntype)

返回一個 Long，表示使用 Open 語句所打開檔案的檔案方式。

FileAttr 函式的語法具有以下幾個命名參數：

filenumber 必要。Integer 類型，任何有效的檔案號。

returntype 必要。Integer 類型。它是數字，指出返回信息的類型。指定 1 則可返回一個代表檔案方式的數值。而僅僅在 16 位系統中， 指定 2 才可以恢復作業系統的檔案句柄。在 32 位系統中不支持 Returntype 2，它會導致錯誤發生。

當 returntype 參數值為 1 時，下列返回值指出檔案訪問方式：

方式 值

Input 1

Output 2

Random 4

Append 8

Binary 32

FileDateTime(pathname)

返回一個 Variant (Date），此為一個檔案被創建或最後修改後的日期和時間。

FileLen(pathname)

返回一個 Long，代表一個檔案的長度，單位是位元組。

Filter(InputStrings,Value[,Include[,Compare]])

返回一個下標從零開始的數組，該數組包含基於指定篩選條件的一個字元串數組的子集。

Filter函式語法有如下幾部分：

InputStrings 必需的。要執行搜尋的一維字元串數組。

Value 必需的。要搜尋的字元串。

Include 可選的。Boolean值，表示返回子串包含還是不包含Value字元串。如果Include是True，Filter返回的是包含Value子字元串的數組子集。如果Include是False，Filter返回的是不包含Value子字元串的數組子集。

Compare 可選的。數字值，表示所使用的字元串比較類型。有關其設定，請參閱下面的“設定值”部分。

Compare參數的設定值如下：

常數 值 描述

vbUseCompareOption –1 使用Option Compare語句的設定值來執行比較。

vbBinaryCompare 0 執行二進制比較。

vbTextCompare 1 執行文字比較。

vbDatabaseCompare 2 只用於Microsoft Access。基於您的資料庫信息來執行比較。

如果在InputStrings中沒有發現與Value相匹配的值，Filter返回一個空數組。如果InputStrings是Null或不是一個一維數組，則產生錯誤。

Filter函式所返回的數組，其元素數目剛好是所找到的匹配項目數。

Format(expression[,format[,firstdayofweek[,firstweekofyear]]])

返回 Variant (String），其中含有一個表達式，它是根據格式表達式中的指令來格式化的。

expression 必要參數。任何有效的表達式。

format 可選參數。有效的命名表達式或用戶自定義格式表達式。

firstdayofweek 可選參數。常數，表示一星期的第一天。

firstweekofyear 可選參數。常數，表示一年的第一周。

設定值

firstdayofweek 參數有下面設定：

常數 值 說明

vbUseSystem 0 使用 NLS API 設定。

VbSunday 1 星期日（預設）

vbMonday 2 星期一

vbTuesday 3 星期二

vbWednesday 4 星期三

vbThursday 5 星期四

vbFriday 6 星期五

vbSaturday 7 星期六

firstweekofyear 參數有下面設定：

常數 值 說明

vbUseSystem 0 使用 NLS API 設定。

vbFirstJan1 1 從包含一月一日的那一周開始（預設）。

vbFirstFourDays 2 從本年第一周開始，而此周至少有四天在本年中。

VbFirstFullWeek 3 從本年第一周開始，而此周完全在本年中。

說明

格式化 作法

數字 使用預先定義的命名數值格式或創建用戶自定義數值格式。

日期和時間 使用預先定義的命名日期/時間格式或創建用戶自定義日期/時間格式。

日期和時間序數 使用日期和時間格式或數值格式。

字元串 創建自定義的字元串格式。

如果在格式化數字時沒有指定 format，Format 會提供與 Str 函式類似的功能，儘管它是國際化的。然而，以 Format 作用在正數上不會保留正負號空間，而以 Str 的話則會。

FormatCurrency(Expression[,NumDigitsAfterDecimal [,IncludeLeadingDigit [,UseParensForNegativeNumbers [,GroupDigits]]]])

返回一個貨幣值格式的表達式，它使用系統控制臺中定義的貨幣符號。

Expression 必需的。要格式化的表達式。

NumDigitsAfterDecimal 可選的。數字值，表示小數點右邊的顯示位數。預設值為–1，表示使用計算機的區域設定值。

IncludeLeadingDigit 可選的。三態常數，表示小數點前是否顯示一個零。關於其值，請參閱“設定值”部分。

UseParensForNegativeNumbers 可選的。三態常數，表示是否把負數值放在園括弧內。關於其值，請參閱“設定值”部分。

GroupDigits 可選的。三態常數，表示是否用組分隔設定對數字進行分組，組分隔設定由計算機的區域設定值指定。關於其值，請參閱“設定值”部分。

設定值

IncludeLeadingDigit、UseParensForNegativeNumbers 和 GroupDigits參數的設定值如下：

常數 值 描述

TristateTrue –1 True

TristateFalse 0 False

TristateUseDefault –2 使用計算機區域設定中的設定值。

說明

當忽略一個或多個選項參數時，被忽略的參數值由計算機的區域設定值提供。

貨幣符號相對貨幣值的位置由計算機的區域設定值確定。

注意 除起始的零外，所有設定值信息都來自“區域設定”的“貨幣”選項卡，起始的零來自“數字”選項卡。

FormatDateTime(Date[,NamedFormat])

返回一個日期或時間格式的表達式。

FormatDateTime函式語法有如下幾部分：

部分 描述

Date 必需的。要被格式化的日期表達式。

NamedFormat 可選的。數字值，表示日期/時間所使用的格式。如果忽略該值，則使用vbGeneralDate。

設定值

NamedFormat參數的設定值如下：

常數 值 描述

vbGeneralDate 0 顯示日期和/或時間。如果有日期部分，則用短日期格式顯示。如果有時間部分，則用長時間格式顯示。如果都有，兩部分都顯示。

vbLongDate 1 用計算機區域設定值中指定的長日期格式顯示日期。

vbShortDate 2 用計算機區域設定值中指定的短日期格式顯示日期。

vbLongTime 3 用計算機區域設定值中指定的時間格式顯示時間。

vbShortTime 4 用24小時格式（hh：mm）顯示時間。

FormatNumber(Expression[,NumDigitsAfterDecimal [,IncludeLeadingDigit [,UseParensForNegativeNumbers [,GroupDigits]]]])

返回一個數字格式的表達式。

FormatNumber函式語法有如下幾部分：

部分 描述

Expression 必需的。要被格式化的表達式。

NumDigitsAfterDecimal 可選的。數字值，表示小數點右邊的顯示位數。預設值為–1，表示使用計算機的區域設定值。

IncludeLeadingDigit 可選的。三態常數，表示小數點前是否顯示零。關於其值，請參閱“設定值”部分。

UseParensForNegativeNumbers 可選的。三態常數，表示是否把負數值放在圓括弧內。關於其值，請參閱“設定值”部分。

GroupDigits 可選的。的三態常數，表示是否用組分隔設定對數字分組，組分隔設定在計算機的區域設定值中指定。關於其值，請參閱“設定值”部分。

設定值

IncludeLeadingDigit、UseParensForNegativeNumbers和GroupDigits參數的設定值如下：

常數 值 描述

TristateTrue –1 True

TristateFalse 0 False

TristateUseDefault –2 用計算機區域設定值中的設定值。

說明

當忽略一個或多個選項參數時，被忽略的參數值由計算機的區域設定值提供。

注意 所有設定值信息都來自“區域設定”的“數字”選項卡。

FormatPercent(Expression[,NumDigitsAfterDecimal [,IncludeLeadingDigit [,UseParensForNegativeNumbers [,GroupDigits]]]])

返回一個百分比格式（乘以100）的表達式，後面有%符號。

FormatPercent函式語法有如下幾部分：

部分 描述

Expression 必需的。要格式化的表達式。

NumDigitsAfterDecimal 可選的。表示小數點右邊的顯示位數。預設值為–1，表示使用計算機的區域設定值。

IncludeLeadingDigit 可選的。三態常數，表示小數點前是否顯示零。關於其值，請參閱“設定值”部分。

UseParensForNegativeNumbers 可選的。三態常數，表示是否把負數放在圓括弧內。關於其值，請參閱“設定值”部分。

GroupDigits 可選的。三態常數，表示是否用組分隔設定對數字進行分組，組分隔設定在計算機的區域設定值中指定。關於其值，請參閱“設定值”部分。

設定值

IncludeLeadingDigit、UseParensForNegativeNumbers和GroupDigits參數的設定值如下：

常數 值 描述

TristateTrue –1 True

TristateFalse 0 False

TristateUseDefault –2 使用計算機區域設定值中的設定值。

說明

當忽略一個或多個選項參數時，被忽略的參數值由計算機的區域設定值提供。

注意 所有的設定值信息都來自“區域設定”的“數字”選項卡。

FreeFile[(rangenumber)]

返回一個 Integer，代表下一個可供 Open 語句使用的檔案號。

FV(rate,nper,pmt[,pv[,type]])

返回一個 Double，指定未來的定期定額支付且利率固定的年金。

GetAllSettings(appname,section)

從 Windows 註冊表中返回應用程式項目的所有註冊表項設定及其相應值（開始是由 SaveSetting 產生）。

GetAttr(pathname)

返回一個 Integer，此為一個檔案、目錄、或資料夾的屬性。

由 GetAttr 返回的值，是下面這些屬性值的總和：

vbNormal 0 常規

vbReadOnly 1 唯讀

vbHidden 2 隱藏

vbSystem 4 系統檔案

vbDirectory 16 目錄或資料夾

vbArchive 32 上次備份以後，檔案已經改變

vbalias 64 指定的檔案名稱是別名。

注意 這些常數是由 VBA 指定的，在程式代碼中的任何位置，可以使用這些常數來替換真正的值。

若要判斷是否設定了某個屬性，在 GetAttr 函式與想要得知的屬性值之間使用 And 運算符與逐位比較。如果所得的結果不為零，則表示設定了這個屬性值。例如，在下面的 And 表達式中，如果檔案 (Archive) 屬性沒有設定，則返回值為零：

Result = GetAttr(FName) And vbArchive

如果檔案的檔案屬性已設定，則返回非零的數值。

object.GetAutoServerSettings([progid],[clsid])

返回關於 ActiveX 部件的註冊狀態的信息。

GetObject([pathname] [,class])

返回檔案中的 ActiveX 對象的引用。

GetSetting(appname,section,key[,default])

從 Windows 註冊表中的應用程式項目返回註冊表項設定值。

Hex(number)

返回代表十六進制數值的 String。

Hour(time)

返回一個 Variant (Integer），其值為 0 到 23 之間的整數，表示一天之中的某一鐘點。

Ⅱf(expr,truepart,falsepart)

根據表達式的值，來返回兩部分中的其中一個。

IMEStatus

返回一個 Integer，用來指定當前 Microsoft Windows 的輸入法 (IME) 方式；只對東亞區版本有效。

下面是日本國別的返回值：

常數 值 描述

vbIMEModeNoControl 0 不控制IME（預設）

vbIMEModeOn 1 打開 IME

vbIMEModeOff 2 關閉 IME

vbIMEModeDisable 3 IME 無效

vbIMEModeHiragana 4 完整寬度 Hiragana 模式

vbIMEModeKatakana 5 完整寬度 Katakana 片假名模式

vbIMEModeKatakanaHalf mode 6 半寬 Katakana 模式

vbIMEModeAlphaFull mode 7 完整寬度 Alphanumeric 模式

vbIMEModeAlpha mode 8 半寬 Alphanumeric 模式

下面是韓國地區的返回值：

常數 值 描述

vbIMEModeAlphaFull 7 完整寬度 Alphanumeric 模式

vbIMEModeAlpha 8 半寬 Alphanumeric 模式

vbIMEModeHangulFull 9 完整寬度 Hangul 模式

vbIMEModeHangul 10 半寬 Hangul 模式

下面是中文地區的返回值：

常數 值 描述

vbIMEModeNoControl 0 不控制IME（預設）

vbIMEModeOn 1 打開 IME

vbIMEModeOff 2 關閉 IME

Input(number,[#]filenumber)

返回 String，它包含以 Input 或 Binary 方式打開的檔案中的字元。

InputBox(prompt[,title] [,default] [,xpos] [,ypos] [,helpfile,context])

在一對話框來中顯示提示，等待用戶輸入正文或按下按鈕，並返回包含文本框內容的 String。

InStr([start,]string1,string2[,compare])

返回 Variant (Long），指定一字元串在另一字元串中最先出現的位置。

InstrRev(string1,string2[,start[,compare]])

返回一個字元串在另一個字元串中出現的位置，從字元串的末尾算起。

Int(number）或Fix(number)

返回參數的整數部分。

IPmt(rate,per,nper,pv[,fv[,type]])

返回一個 Double，指定在一段時間內對定期定額支付且利率固定的年金所支付的利息值。

IRR(values()[,guess])

返回一個 Double，指定一系列周期性現金流（支出或收入）的內部利率。

數學函式公式：

Secant（正割） Sec(X) = 1 / Cos(X)

Cosecant（餘割） Cosec(X) = 1 / Sin(X)

Cotangent（餘切） Cotan(X) = 1 / Tan(X)

Inverse Sine

（反正弦）

Arcsin(X) = Atn(X / Sqr(-X * X + 1））

Inverse Cosine

（反餘弦）

Arccos(X) = Atn(-X / Sqr(-X * X + 1）） + 2 * Atn⑴

Inverse Secant

（反正割）

Arcsec(X) = Atn(X / Sqr(X * X - 1）） + Sgn((X) - 1） * （2 * Atn⑴）

Inverse Cosecant

（反餘割）

Arccosec(X) = Atn(X / Sqr(X * X - 1）） + (Sgn(X) - 1） * （2 * Atn⑴）

Inverse Cotangent

（反餘切）

Arccotan(X) = Atn(X) + 2 * Atn⑴

Hyperbolic Sine

（雙曲正弦）

HSin(X) = (Exp(X) - Exp(-X)) / 2

Hyperbolic Cosine

（雙曲餘弦）

HCos(X) = (Exp(X) + Exp(-X)) / 2

Hyperbolic Tangent

（雙曲正切）

HTan(X) = (Exp(X) - Exp(-X)) / (Exp(X) + Exp(-X))

Hyperbolic Secant

（雙曲正割）

HSec(X) = 2 / (Exp(X) + Exp(-X))

Hyperbolic Cosecant（雙曲餘割） HCosec(X) = 2 / (Exp(X) - Exp(-X))

Hyperbolic Cotangent（雙曲餘切） HCotan(X) = (Exp(X) + Exp(-X)) / (Exp(X) - Exp(-X))

Inverse Hyperbolic Sine（反雙曲正弦） HArcsin(X) = Log(X + Sqr(X * X + 1））

Inverse Hyperbolic Cosine（反雙曲餘弦） HArccos(X) = Log(X + Sqr(X * X - 1））

Inverse Hyperbolic Tangent（反雙曲正切） HArctan(X) = Log（（1 + X) / （1 - X)) / 2

Inverse Hyperbolic Secant（反雙曲正割） HArcsec(X) = Log((Sqr(-X * X + 1） + 1） / X)

Inverse Hyperbolic Cosecant HArccosec(X) = Log((Sgn(X) * Sqr(X * X + 1） + 1） / X)

Inverse Hyperbolic Cotangent

（反雙曲餘切）

HArccotan(X) = Log((X + 1） / (X - 1）） / 2

以 N 為底的對數 LogN(X) = Log(X) / Log(N)

Abs(number)

返回參數的絕對值，其類型和參數相同。

必要的 number 參數是任何有效的數值表達式，如果 number 包含 Null，則返回 Null，如果 number 是未初始化的變數，則返回 0。

一個數的絕對值是將正負號去掉以後的值。例如，ABS(-1） 和 ABS⑴ 都返回 1。

Array(arglist)

返回一個包含數組的 Variant。

所需的 arglist 參數是一個用逗號隔開的值表，這些值用於給 Variant 所包含的數組的各元素賦值。如果不提供參數，則創建一個長度為 0 的數組。

用來表示數組元素的符號由變數名、圓括弧以及括弧中的所需元素的索引號組成。在下面的示例中，第一條語句創建一個 Variant 的變數 A。第二條語句將一個數組賦給變數 A。最後一條語句將該數組的第二個元素的值賦給另一個變數。

內置函式舉例：JavaScript內置函式，smarty內置函式等。