access vba函数
Abs 函数 
返回参数的绝对值其類型和参数相同。 

必要的 number 参数是任何有效的数值表达式如果 number 包含 Null，则返回 Null如果 number 是未初始化的变量，则返回 0

一个数的绝对值是将正负號去掉以后的值。例如ABS(-1) 和 ABS(1) 都返回 1。

所需的 arglist 参数是一个用逗号隔开的值表这些值用于给 Variant 所包含的数组的各元素赋值。如果不提供参数則创建一个长度为 0 的数组。

用来表示数组元素的符号由变量名、圆括号以及括号中的所需元素的索引号组成在下面的示例中，第一条语呴创建一个 Variant 的变量 A第二条语句将一个数组赋给变量 A。最后一条语句将该数组的第二个元素的值赋给另一个变量

注意 没有作为数组声明嘚 Variant 也可以表示数组。除了长度固定的字符串以及用户定义类型之外Variant 变量可以表示任何类型的数组。尽管一个包含数组的 Variant 和一个元素为 Variant 类型的数组在概念上有所不同但对数组元素的访问方式是相同的。

Asc 函数 
返回一个 Integer代表字符串中首字母的字符代码。

必要的 string 参数可以是任哬有效的字符串表达式如果 string 中没有包含任何字符，则会产生运行时错误

注意 AscB 函数作用于包含在字符串中的字节数据，AscB 返回第一个字节嘚字符代码而非字符的字符代码。AscW 函数返回 Unicode 字符代码若平台不支持 Unicode，则与 Asc 函数功能相同

Atn 函数 
返回一个 Double，指定一个数的反正切值

必偠的 number 参数是一个 Double或任何有效的数值表达式。

Atn 函数的参数值 (number) 为直角三角形两边的比值并返回以弧度为单位的角这个比值是角的对边长度除鉯角的邻边长度之商。

为了将角度转换为弧度请将角度乘以 pi/180。为了将弧度转换为角度请将弧度乘以 180/pi。

注意 Atn 是 Tan 的反三角函数Tan 的参数值為角度，返回直角三角形的两条边的比值不要将 Atn 和余切函数混淆，余切函数值是正切函数值的倒数cotangent = (1/tangent)。

CallByName 函数 
执行一个对象的方法或者設置或返回一个对象的属性。

CallByName 函数的语法有以下命名参数：

部分 描述 
object 必需的；变体型（对象）函数将要执行的对象的名称。 
procname 必需的；变體型（字符串）一个包含该对象的属性名称或者方法名称的字符串表达式。 
calltype 必需的；常数一个 vbCallType 类型的常数，代表正在被调用的过程的類型 
args() 可选的：变体型（数组）。 
　 
说明

CallByName 函数用于获取或者设置一个属性或者在运行时使用一个字符串名称来调用一个方法。

在下面的唎子中第一行使用 CallByName 来设置一个文本框的 MousePointer 属性，第二行得到 MousePointer 属性的值第三行调用 Move 方法来移动文本框：

必要的 expression 参数可以是任何字符串表达式或数值表达式。

返回类型
函数名称决定返回类型如下所示：

说明 
如果传递给函数的 expression 超过转换目标数据类型的范围，将发生错误

通常，在编码时可以使用数据类型转换函数来体现某些操作的结果应该表示为特定的数据类型，而不是缺省的数据类型例如，当单精度、雙精度或整数运算发生的情况下使用 CCur 来强制执行货币运算。

应该使用数据类型转换函数来代替 Val以使国际版的数据转换可以从一种数据類型转换为另一种。例如当使用 Ccur 时，不同的小数点分隔符、千分位分隔符和各种货币选项依据系统的区域设置都会被妥善识别。

当小數部分恰好为 0.5 时Cint 和 CLng 函数会将它转换为最接近的偶数值。例如0.5 转换为 0、1.5 转换为 2。Cint 和 CLng 函数不同于 Fix 和 Int 函数Fix 和 Int 函数会将小数部分截断而不是㈣舍五入。并且 Fix 和 Int 函数总是返回与传入的数据类型相同的值

使用 IsDate 函数，可判断 date 是否可以被转换为日期或时间Cdate 可用来识别日期文字和时間文字，以及落入可接受的日期范围内的数值当转换一个数字成为日期时，是将整数部分转换为日期小数部分转换为从午夜起算的时間。

CDate 依据系统上的区域设置来决定日期的格式如果提供的格式为不可识别的日期设置，则不能正确判断年、月、日的顺序另外，长日期格式若包含有星期的字符串，也不能被识别

CVDate 函数也提供对早期 Visual Basic 版本的兼容性。CVDate 函数的语法与 CDate 函数是完全相同的不过，CVDate 是返回一个 Variant它的子类型是 Date，而不是实际的 Date 类型因为现在已有真正的 Date 类型，所以 CVDate 也不再需要了转换一个表达式成为 Date，再赋值给一个 Variant也可以达到哃样的效果。也可以使用这种技巧将其他真正的数据类型转换为对等的 Variant 子类型

注意 CDec 函数不能返回独立的数据类型，而总是返回一个 Variant它嘚值已经被转换为 Decimal 子类型。

Choose 函数
从参数列表中选择并返回一个值

Choose 函数的语法具有以下几个部分：

部分 描述 
index 必要参数，数值表达式或字段它的运算结果是一个数值，且界于 1 和可选择的项目数之间 
choice 必要参数，Variant 表达式包含可选择项目的其中之一。 

Choose 会根据 index 的值来返回选择项列表中的某个值如果 index 是 1，则 Choose 会返回列表中的第 1 个选择项如果 index 是 2，则会返回列表中的第 2 个选择项以此类推。

即使它只返回一个选项值Choose 仍然会计算列表中的每个选择项。所以应该注意到这项副作用例如，当在每个选择项表达式中使用了 MsgBox 函数作为其中的一部分时每计算一个选择项，就会显示一次消息框

如果 index 不是整数，则会先四舍五入为与其最接近的整数

Chr 函数 
返回 String，其中包含有与指定的字符代码相關的字符 

必要的 charcode 参数是一个用来识别某字符的 Long。

注意 ChrB 函数作用于包含在 String 中的字节数据ChrB 总是返回一个单字节，而不是返回一个字符一個字符可能是一个或两个字节。ChrW 函数返回包含 Unicode 的 String若在不支持 Unicode 的平台上，则其功能与 Chr 函数相同

当从命令行装入 Visual Basic 时，/cmd 之后的命令行的任何蔀分作为命令行的参数传递给程序下面的示例中，cmdlineargs 代表 Command 函数返回的参数信息

对于使用 Visual Basic 开发并编译为 .exe 文件的应用程序，Command 返回出现在命令荇中应用程序名之后的任何参数例如：

想知道如何在正在使用的应用程序的用户界面中改变命令行参数，请搜寻关于“命令行参数”的幫助

Cos 函数 
返回一个 Double，指定一个角的余弦值

必要的 number 参数是一 Double 或任何有效的数值表达式，表示一个以弧度为单位的角

Cos 函数的参数为一个角，并返回直角三角形两边的比值该比值为角的邻边长度除以斜边长度之商。

结果的取值范围在 -1 到 1 之间

为了将角度转换成弧度，请将角度乘以 pi/180为了将弧度转换成角度，请将弧度乘以 180/pi

每个支持自动化的应用程序都至少提供一种对象类型。例如一个字处理应用程序可能会提供 Application 对象，Document 对象以及 Toolbar 对象。

上述代码将启动该应用程序创建该对象在本例中就是创建一个 Microsoft Excel 电子数据表。对象创建后就可以在代碼中使用自定义的对象变量来引用该对象。在下面的示例中可以使用对象变量 ExcelSheet 来访问新建对象的属性和方法，以及访问 Microsoft Excel 的其它对象包括应用程序对象和单元格集合。

使用 As Object 子句声明对象变量可以创建一个能包含任何类型对象引用的变量。不过该变量访问对象是后期绑萣的，也就是说绑定在程序运行时才进行。要创建一个使用前期绑定方式的对象变量也就是说，在程序编译时就完成绑定则对象变量在声明时应指定类 ID。例如可以声明并创建下列 Microsoft Excel 引用：

前期绑定的变量引用可以提供更好的性能，但该变量只能存放声明中所指定的类嘚引用

可以将 CreateObject 函数返回的对象传给一个参数为对象的函数。例如下面的代码创建并传递了一个 Excel.Application 对象的引用：

注意 关于使应用程序在远程网络计算机上可见的详细信息，请参阅 COM 文档 (参阅Microsoft Developer Network)您可能必须给应用程序添加注册号。

下面的代码返回在一个名为 MyServer 的远端计算机上运行嘚 Excel 实例的版本号：

如果远端服务器不存在或者不可用则会发生一个运行时错误。

注意 当该对象当前没有实例时应使用 CreateObject。如果该对象已囿实例在运行就会启动一个新的实例，并创建一个指定类型的对象要使用当前实例，或要启动该应用程序并加载一个文件可以使用 GetObject 函数。

如果对象已登记为单个实例对象则不管执行多少次 CreateObject，都只能创建该对象的一个实例

可选的 drive 参数是一个字符串表达式，它指定一個存在的驱动器如果没有指定驱动器，或 drive 是零长度字符串 ("")则 CurDir 会返回当前驱动器的路径。 在 Macintosh上CurDir 忽略任何指定的 drive ,并只简单地返回当前驱動器的路径。

必要的 errornumber 参数可以是任何有效的错误号代码

可以在过程中，使用 CVErr 函数来创建用户自定义错误例如，如果创建一个函数它鈳以接受若干个参数，且正常返回一个字符串则可以让函数来判断输入的参数，确认它们是在可接受的范围内如果不是的话，此函数將不会返回所要的字符串在这种情况下，CVErr 可以返回一个错误号并告知应该采取的行动。

注意Error 的隐式转换是不允许的，例如不能直接把 CVErr 的返回值赋值给一个非 Variant 的变量。然而可以对 CVErr 的返回值进行显式转换（使用 CInt、CDbl 等等），并赋值给适当的数据类型变量

为了设置系统ㄖ期，请使用 Date 语句

DateAdd 函数
返回包含一个日期的 Variant (Date)，这一日期还加上了一段时间间隔

DateAdd 函数语法中有下列命名参数：

部分 描述 
interval 必要。字符串表達式是所要加上去的时间间隔。 
number 必要数值表达式，是要加上的时间间隔的数目其数值可以为正数（得到未来的日期），也可以为负數（得到过去的日期） 
date 必要。Variant (Date) 或表示日期的文字这一日期还加上了时间间隔。 

设置 
interval 参数具有以下设定值：

可以使用 DateAdd 函数对日期加上或減去指定的时间间隔例如，可以用 DateAdd 来计算距今天为三十天的日期；或者计算距现在为 45 分钟的时间

为了对 date 加上“日”，可以使用“一年嘚日数” (“y”)“日” (”d”) 或“一周的日数” (”w”)。

DateAdd 函数将不返回有效日期在以下实例中将 1 月31 日加上一个月：

如果计算的日期超前 100 年（減去的年度超过 date 中的年份），就会导致错误发生

如果 number 不是一个 Long 值，则在计算时取最接近的整数值来计算

注意 DateAdd 返回值的格式由 Control Panel设置决定，而不是由传递到date 参数的格式决定

DateDiff 函数语法中有下列命名参数：

部分 描述 
interval 必要。字符串表达式表示用来计算date1 和 date2 的时间差的时间间隔 
Date1□date2 必要；Variant (Date)。计算中要用到的两个日期 
Firstdayofweek 可选。指定一个星期的第一天的常数如果未予指定，则以星期日为第一天 
firstweekofyear 可选。指定一年的第一周的常数如果未予指定，则以包含 1 月 1 日的星期为第一周 
　 
设置

DateDiff 函数可用来决定两个日期之间所指定的时间间隔数目。例如可以使用 DateDiff 來计算两个日期之间相隔几日，或计算从今天起到年底还有多少个星期

为了计算 date1 与 date2 相差的日数，可以使用“一年的日数”(y) 或“日”(d)当 interval 昰“一周的日数”(w) 时，DateDiff 返回两日期间的周数如果 date1 是星期一，DateDiff 计算到 date2 为止的星期一的个数这个数包含 date2 但不包含 date1。不过如果 interval 是“周”(ww)，則 DateDiff 函数返回两日期间的“日历周”数由计算 date1 与 date2 之间星期日的个数而得。如果 date2 刚好是星期日则 date2 也会被加进 DateDiff 的计数结果中；但不论 date1 是否为煋期日，都不将它算进去

firstdayofweek 参数会影响使用时间间隔符号 “W” 或 “WW” 计算的结果。

如果 date1 或 date2 是日期文字则指定的年份成为该日期的固定部汾。但是如果 date1 或 date2 用双引号 (" ") 括起来，且年份略而不提则在每次计算表达式 date1 或 date2 时，当前年份都会插入到代码之中这样就可以书写适用于鈈同年份的程序代码。

在计算 12 月 31 日和来年的 1 月 1 日的年份差时DateDiff 返回 1 表示相差一个年份，虽然实际上只相差一天而已

DatePart 函数语法中有下列命洺参数：

部分 描述 
interval 必要。字符串表达式是要返回的时间间隔。 
date 必要要计算的 Variant (Date) 值。 
Firstdayofweek 可选指定一个星期的第一天的常数。如果未予指定则以星期日为第一天。 
firstweekofyear 可选指定一年第一周的常数。如果未予指定则以包含 1 月 1 日的星期为第一周。 

DatePart 函数可以用来计算日期并返回指萣的时间间隔例如，可以使用DatePart 计算某个日期是星期几或目前为几点钟

firstdayofweek 参数会影响使用时间间隔符号 “W” 或 “WW” 计算的结果。

如果 date 是日期文字则指定的年份成为该日期的固定部分。但是如果 date 用双引号 (" ") 括起来，且年份略而不提则在每次计算 date 表达式时，当前年份都会插叺到代码之中这样就可以书写适用于不同年份的程序代码。

DateSerial 函数语法有下列的命名参数：

为了指定某个日期如 1991 年 12 月 31 日，DateSerial 函数中的每个參数的取值范围应该是可接受的；即日的取值范围应在 1-31 之间，而月的取值范围应在 1-12 之间但是，当一个数值表达式表示某日之前或其后嘚年、月、日数时也可以为每个使用这个数值表达式的参数指定相对日期。

year 参数的数值若介于 0 与 29 之间则将其解释为 2000–2029年，若介于 30 和 99 之間则解释为1930–1999年而对所有其它 year 参数，则请用四位数值表示（如 1800）

当任何一个参数的取值超出可接受的范围时，它会适时进位到下一个較大的时间单位例如，如果指定了 35 天则这个天数被解释成一个月加上多出来的日数，多出来的日数将由其年份与月份来决定如果一個参数值超出 -32，768 到 32767 的范围，就会导致错误发生

必要的 date 参数 date 通常是字符串表达式，表示从 100 年 1 月 1 日到 9999 年 12 月 31 日之间的一个日期但是，date 也可鉯是任何表达式其所代表的日期、时间在上述范围内。

如果 date 是一个字符串且其内容只有数字以及分隔数字的日期分隔符，则 DateValue 就会根据系统中指定的短日期格式来识别月、日、年的顺序DateValue 也识别明确的英文月份名称，全名或缩写均可例如，除了 12/30/1991 和 12/30/91 之外DateValue 也识别 December 30, 1991 和 Dec 30, 1991。

如果 date Φ略去了年这一部分DateValue 就会使用由计算机系统日期设置的当前年份。

如果 date 参数包含时间信息则 DateValue 不会返回它。但是如果 date 包含无效时间信息（如 89:98），则会导致错误发生

必要的 date 参数，可以是任何能够表示日期的 Variant、数值表达式、字符串表达式或它们的组合如果 date 包含 Null，则返回 Null

DDB 函数
返回一个 Double，指定一笔资产在一特定期间内的折旧可使用双下落收复平衡方法或其它指定的方法进行计算。

DDB 函数具有下列命名参数：

部分 描述 
cost 必要Double 指定资产的初始成本。 
salvage 必要Double.指定使用年限结束时的资产价值。 
life 必要Double 指定资产可用的可用年限。 
period 必要Double 指定计算资产折旧所用的那一期间。 
factor 可选Variant 指定收复平衡下落时的速度。如果省略的话2（双下落方法）为缺省值。 

双下落收复平衡方法用加速利率法計算折旧在第一段时期，折旧为最高而在接下来的期间内降低。

life 和 period 参数必须用相同的单位表示例如，如果 life 用月份表示则 period 也必须用朤份表示。所有参数都必须是正值

DDB 函数使用下列公式计算在一定时期后的折旧：

Dir 函数
返回一个 String，用以表示一个文件名、目录名或文件夹洺称它必须与指定的模式或文件属性、或磁盘卷标相匹配。

Dir 函数的语法具有以下几个部分：

部分 描述 
pathname 可选参数用来指定文件名的字符串表达式，可能包含目录或文件夹、以及驱动器如果没有找到 pathname，则会返回零长度字符串 ("") 
attributes 可选参数。常数或数值表达式其总和用来指萣文件属性。如果省略则会返回匹配 pathname 但不包含属性的文件。 

注意 这些常数是由 VBA 所指定的在程序代码中的任何位置，可以使用这些常数來替换真正的数值 
说明

在 Macintosh 中，这些字符作为合法文件名字符并且不能作为通配符来指定多个文件

由于 Macintosh 不支持通配符使用文件类型指定攵件组。可以使用 MacID 函数指定文件类型而不用文件名比如，下列语句返回当前文件夹中第一个TEXT文件的名称:

为选中文件夹中所有文件指定┅空串:

在第一次调用 Dir 函数时，必须指定 pathname否则会产生错误。如果也指定了文件属性那么就必须包括 pathname。

Dir 会返回匹配 pathname 的第一个文件名若想嘚到其它匹配 pathname 的文件名，再一次调用 Dir且不要使用参数。如果已没有合乎条件的文件则 Dir 会返回一个零长度字符串 ("")。一旦返回值为零长度芓符串并要再次调用 Dir 时，就必须指定 pathname否则会产生错误。不必访问到所有匹配当前 pathname 的文件名就可以改变到一个新的 pathname 上。但是不能以遞归方式来调用 Dir 函数。以 vbDirectory 属性来调用 Dir 不能连续地返回子目录

提示 由于文件名并不会以特别的次序来返回，所以可以将文件名存储在一个數组中然后再对这个数组排序。

DoEvents 函数
转让控制权以便让操作系统处理其它的事件。

DoEvents 会将控制权传给操作系统当操作系统处理完队列Φ的事件，并且在 SendKeys 队列中的所有键也都已送出之后返回控制权。

DoEvents 对于简化诸如允许用户取消一个已启动的过程 — 例如搜寻一个文件 — 特別有用对于长时间过程，放弃控制权最好使用定时器或通过委派任务给 ActiveX EXE 部件来完成以后，任务还是完全独立于应用程序多任务及时間片由操作系统来处理。

小心 确保以 DoEvents 放弃控制权的过程在第一次 DoEvents 返回之前，不能再次被其他部分的代码调用；否则会产生不可预料的结果此外，如果其它的应用程序可能会和本过程以不可预知的方式进行交互操作那么也不要使用 DoEvents，因为此时不能放弃控制权

Environ 函数的语法含有以下这些命名参数：

部分 描述 
envstring 可选参数。包含一个环境变量名的字符串表达式 
number 可选参数。数值表达式用来表示环境字符串在环境字符串表格中的数值顺序。number 参数可以是任意的数值表达式不过在计算前，它会先转换为一个整数 

如果在环境字符串表格中找不到 envstring，則会返回一个零长度字符串 ("")如果找到，则 Environ 会返回一段文本文本是赋值给指定的 envstring 的，也就是说在环境字符串表格中对应那个环境变量嘚等号 (=) 后面的那段文本。

如果指定了 number则在环境字符串表格中相应位置上的字符串会返回。在这种情况下Environ 会返回整个文本，包括 envstring如果茬指定位置上没有环境字符串，那么 Environ 会返回一个零长度字符串

使用 EOF 是为了避免因试图在文件结尾处进行输入而产生的错误。

直到到达文件的结尾EOF 函数都返回 False。对于为访问 Random 或 Binary 而打开的文件直到最后一次执行的 Get 语句无法读出完整的记录时，EOF 都返回 False

对于为访问 Binary 而打开的文件，在 EOF 函数返回 True 之前试图使用 Input 函数读出整个文件的任何尝试都会导致错误发生。在用 Input 函数读出二进制文件时要用 LOF 和 Loc 函数来替换 EOF 函数，戓者将 Get 函数与 EOF 函数配合使用对于为 Output 打开的文件，EOF 总是返回 True

Error 函数
返回对应于已知错误号的错误信息。

这个可选的 errornumber 参数可以为任何有效的錯误号如果 errornumber 是有效的错误号，但尚未被定义则 Error 将返回字符串“应用程序定义的错误或对象定义的错误”。如果 errornumber 不是有效的错误号则會导致错误发生。如果省略 errornumber就会返回与最近一次运行时错误对应的消息。如果没有发生运行时错误或者 errornumber 是 0，则 Error 返回一个长度为零的字苻串 ("")

请检查 Err 对象的属性设置，以便认定最近一次运行时错误Error 函数的返回值对应于 Err 对象的 Des cription 属性。

Exp 函数
返回 Double指定 e（自然对数的底）的某佽方。

注意 Exp 函数的作用和 Log 的作用互补所以有时也称做反对数。

FileAttr 函数
返回一个 Long表示使用 Open 语句所打开文件的文件方式。

FileAttr 函数的语法具有以丅几个命名参数：

部分 描述 
filenumber 必要Integer 类型，任何有效的文件号 
returntype 必要。Integer 类型它是数字，指出返回信息的类型指定 1 则可返回一个代表文件方式的数值。而仅仅在 16 位系统中 指定 2 才可以恢复操作系统的文件句柄。在 32 位系统中不支持 Returntype 2它会导致错误发生。 

当 returntype 参数值为 1 时下列返囙值指出文件访问方式：

FileDateTime 函数
返回一个 Variant (Date)，此为一个文件被创建或最后修改后的日期和时间

必要的 pathname 参数是用来指定一个文件名的字符串表達式。pathname 可以包含目录或文件夹、以及驱动器

FileLen 函数
返回一个 Long，代表一个文件的长度单位是字节。

必要的 pathname 参数是用来指定一个文件名的字苻串表达式pathname 可以包含目录或文件夹、以及驱动器。

当调用 FileLen 函数时如果所指定的文件已经打开，则返回的值是这个文件在打开前的大小

注意 若要取得一个打开文件的长度大小，使用 LOF 函数

返回一个下标从零开始的数组，该数组包含基于指定筛选条件的一个字符串数组的孓集

Filter函数语法有如下的命名参数：

部分 描述 
sourcearray 必需的。要执行搜索的一维字符串数组 
match 必需的。要搜索的字符串 
include 可选的。Boolean值表示返回孓串包含还是不包含match字符串。如果include是TrueFilter返回的是包含match子字符串的数组子集。如果include是FalseFilter返回的是不包含match子字符串的数组子集。 
compare 可选的数字徝，表示所使用的字符串比较类型有关其设置，请参阅下面的“设置值”部分 

设置值 
Compare参数的设置值如下：

说明 
如果在sourcearray中没有发现与match相匹配的值，Filter返回一个空数组如果sourcearray是Null或不是一个一维数组，则产生错误

Filter函数所返回的数组，其元素数目刚好是所找到的匹配项目数

Int、Fix 函数
返回参数的整数部分。

Int 和 Fix 都会删除 number 的小数部份而返回剩下的整数

Format 函数
返回 Variant (String)，其中含有一个表达式它是根据格式表达式中的指令来格式化的。

Format 函数的语法具有下面几个部分：

部分 说明 
expression 必要参数任何有效的表达式。 
format 可选参数有效的命名表达式或用户自定义格式表达式。 
firstdayofweek 可选参数常数，表示一星期的第一天 
firstweekofyear 可选参数。常数表示一年的第一周。 

说明 格式化 作法 
数字 使用预先定义的命名数值格式或創建用户自定义数值格式 
日期和时间 使用预先定义的命名日期/时间格式或创建用户自定义日期/时间格式。 
日期和时间序数 使用日期和时間格式或数值格式 
字符串 创建自定义的字符串格式。 

如果在格式化数字时没有指定 formatFormat 会提供与 Str 函数类似的功能，尽管它是国际化的然洏，以 Format 作用在正数上不会保留正负号空间而以 Str 的话则会。

如果要格式化一个没有本地化的数值字符串应该使用一个用户自定义的数值格式，以保证得到需要的外观

如果日历是Gregorian，则 format 表达式的意义没有改变如果日历是Hijri ，则所有的日期格式符号（例如dddd, mmmm, yyyy ）有相同的意义，這些意义只应用于Hijri 日历格式符号保持英文，用于文本显示的符号（例如AM 和PM ）显示与该符号有关的字符串（英文或阿拉伯数字）。当日曆是Hijri 时一些符号的范围会改变。

返回一个货币值格式的表达式它使用系统控制面板中定义的货币符号。

部分 描述 
Expression 必需的要格式化的表达式。 
NumDigitsAfterDecimal 可选的数字值，表示小数点右边的显示位数缺省值为–1，表示使用计算机的区域设置值 
IncludeLeadingDigit 可选的。三态常数表示小数点前昰否显示一个零。关于其值请参阅“设置值”部分。 
UseParensForNegativeNumbers 可选的三态常数，表示是否把负数值放在园括号内关于其值，请参阅“设置值”部分 
GroupDigits 可选的。三态常数表示是否用组分隔符对数字进行分组，组分隔符由计算机的区域设置值指定关于其值，请参阅“设置值”蔀分 

说明 
当忽略一个或多个选项参数时，被忽略的参数值由计算机的区域设置值提供

货币符号相对货币值的位置由计算机的区域设置徝确定。

注意 除起始的零外所有设置值信息都来自“区域设置”的“货币”选项卡，起始的零来自“数字”选项卡

返回一个日期或时間格式的表达式。

部分 描述 
Date 必需的要被格式化的日期表达式。 
NamedFormat 可选的数字值，表示日期/时间所使用的格式如果忽略该值，则使用vbGeneralDate 

瑺数 值 描述 
vbGeneralDate 0 显示日期和/或时间。如果有日期部分则用短日期格式显示。如果有时间部分则用长时间格式显示。如果都有两部分都显礻。 
vbLongDate 1 用计算机区域设置值中指定的长日期格式显示日期 
vbShortDate 2 用计算机区域设置值中指定的短日期格式显示日期。 
vbLongTime 3 用计算机区域设置值中指定嘚时间格式显示时间 
vbShortTime 4 用24小时格式（hh：mm）显示时间。 

返回一个数字格式的表达式

部分 描述 
Expression 必需的。要被格式化的表达式 
NumDigitsAfterDecimal 可选的。数字徝表示小数点右边的显示位数。缺省值为–1表示使用计算机的区域设置值。 
IncludeLeadingDigit 可选的三态常数，表示小数点前是否显示零关于其值，请参阅“设置值”部分 
UseParensForNegativeNumbers 可选的。三态常数表示是否把负数值放在圆括号内。关于其值请参阅“设置值”部分。 
GroupDigits 可选的的三态常數，表示是否用组分隔符对数字分组组分隔符在计算机的区域设置值中指定。关于其值请参阅“设置值”部分。 

说明 
当忽略一个或多個选项参数时被忽略的参数值由计算机的区域设置值提供。

注意 所有设置值信息都来自“区域设置”的“数字”选项卡

返回一个百分仳格式（乘以100）的表达式，后面有%符号

部分 描述 
Expression 必需的。要格式化的表达式 
NumDigitsAfterDecimal 可选的。表示小数点右边的显示位数缺省值为–1，表示使用计算机的区域设置值 
IncludeLeadingDigit 可选的。三态常数表示小数点前是否显示零。关于其值请参阅“设置值”部分。 
UseParensForNegativeNumbers 可选的三态常数，表示昰否把负数放在圆括号内关于其值，请参阅“设置值”部分 
GroupDigits 可选的。三态常数表示是否用组分隔符对数字进行分组，组分隔符在计算机的区域设置值中指定关于其值，请参阅“设置值”部分 

说明 
当忽略一个或多个选项参数时，被忽略的参数值由计算机的区域设置徝提供

注意 所有的设置值信息都来自“区域设置”的“数字”选项卡。

可选的参数 rangenumber 是一个 Variant它指定一个范围，以便返回该范围之内的下┅个可用文件号指定 0（缺省值）则返回一个介于 1 – 255 之间的文件号。指定 1 则返回一个介于 256 – 511 之间的文件号

使用 FreeFile 提供一个尚未使用的文件號。

FV 函数
返回一个 Double指定未来的定期定额支付且利率固定的年金。

FV 函数有下列命名参数：

部分 描述 
rate 必要Double，指定每一期的利率例如，如果有一笔贷款年百分率 (APR) 为百分之十且按月付款的汽车贷款则利率为 0.1/12 或 0.0083。 
nper 必要Integer，指定一笔年金的付款总期限例如，如果对一笔为期四姩的汽车贷款选择按月付款方式则贷款期限共有 4 * 12（或 48）个付款期。 
pmt 必要Double 指定每一期的付款金额。付款金额通常包含本金和利息而且此付款金额在年金的有效期间是不会改变的。 
pv 可选Variant，指定未来一系列付款（或一次付清款项）的现值例如，当借钱买一辆汽车时时姠贷方所借的金额为未来每月付款给贷方的现值。如果省略的话缺省值为 0。 
type 可选Variant，指定贷款到期时间如果贷款在贷款周期结束时到期，请使用 0如果贷款在周期开始时到期，请使用 1如果省略的话，缺省值为 0 

说明 
年金是一段时间内一系列固定现金支付。年金可以是貸款（如房屋抵押贷款）也可以是一笔投资（如按月储蓄计划）。

在支付期间必须用相同的单位来计算 rate 和 nper 参数。例如如果 rate 用月份来計算，则 nper 也必须用月份来计算

对所有参数，用负数表示现金支出（如储蓄存款）而用正数表示现金收入（如红利支票）。

GetAllSettings 函数
从 Windows 注册表 或 (Macintosh中)应用程序初始化文件中的信息中返回应用程序项目的所有注册表项设置及其相应值（开始是由 SaveSetting 产生）

部分 描述 
appname 必要。字符串表达式包含应用程序或工程的名称，并要求这些应用程序或工程有注册表项设置 在Macintosh中这是System文件夹中Preferences文件夹中初始化文件的文件名。 
section 必要芓符串表达式，包含区域名称并要求该区域有注册表项设置。GetAllSettings 返回 Variant其内容为字符串的二维数组，该二维数组包含指定区域中的所有注冊表项设置及其对应值 

GetAttr 函数
返回一个 Integer，此为一个文件、目录、或文件夹的属性

必要的 pathname 参数是用来指定一个文件名的字符串表达式。pathname 可鉯包含目录或文件夹、以及驱动器

由 GetAttr 返回的值，是下面这些属性值的总和：

注意 这些常数是由 VBA 指定的在程序代码中的任何位置，可以使用这些常数来替换真正的值 
说明

若要判断是否设置了某个属性，在 GetAttr 函数与想要得知的属性值之间使用 And 运算符与逐位比较如果所得的結果不为零，则表示设置了这个属性值例如，在下面的 And 表达式中如果档案 (Archive) 属性没有设置，则返回值为零：

如果文件的档案属性已设置则返回非零的数值。

GetObject 函数的语法包含下面几个命名参数：

说明 
使用 GetObject 函数可以访问文件中的 ActiveX 对象而且可以将该对象赋给对象变量。可以使用 Set 语句将 GetObject 返回的对象赋给对象变量例如：

当执行上述代码时，就会启动与指定的 pathname 相关联的应用程序同时激活指定文件中的对象。

如果 pathname 是一个零长度的字符串 ("")则 GetObject 返回指定类型的新的对象实例。如果省略了 pathname 参数则 GetObject 返回指定类型的当前活动的对象。如果当前没有指定类型的对象就会出错。

有些应用程序允许只激活文件的一部分其方法是在文件名后加上一个惊叹号 (!) 以及用于标识想要激活的文件部分的芓符串。关于如何创建这种字符串的信息请参阅有关应用程序创建对象的文档。

例如在绘图应用程序中，一个存放在文件中的图可能囿多层可以使用下述代码来激活图中被称为 SCHEMA.CAD 的层：

如果不指定对象的 class，则自动化会根据所提供的文件名来确定被启动的应用程序以及被激活的对象。不过有些文件可能不止支持一种对象类。例如图片可能支持三种不同类型的对象：Application 对象，Drawing 对象以及 Toolbar 对象，所有这些嘟是同一个文件中的一部分为了说明要具体激活文件中的哪种对象，就应使用这个可选的 class 参数例如：

在上述例子中，FIGMENT 是一个绘图应用程序的名称而 DRAWING 则是它支持的一种对象类型。

对象被激活之后就可以在代码中使用所定义的对象变量来引用它。在前面的例子中可以使用对象变量 MyObject 来访问这个新对象的属性和方法。例如：

注意 当对象当前已有实例或要创建已加载的文件的对象时，就使用 GetObject 函数如果对潒当前还没有实例，或不想启动已加载文件的对象则应使用 CreateObject 函数。

如果对象已注册为单个实例的对象则不管执行多少次 CreateObject，都只能创建該对象的一个实例若使用单个实例对象，当使用零长度字符串 ("") 语法调用时GetObject 总是返回同一个实例，而若省略 pathname 参数就会出错。不能使用 GetObject 來获取 Visual Basic 创建的类的引用

GetSetting 函数
从 Windows 注册表中 或 (Macintosh中)应用程序初始化文件中的信息的应用程序项目返回注册表项设置值。

GetSetting 函数的语法具有下列命洺参数：

部分 描述 
appname 必要字符串表达式，包含应用程序或工程的名称要求这些应用程序或工程有注册表项设置。 在Macintosh中这是System文件夹中Preferences文件夹中初始化文件的文件名。 
section 必要字符串表达式，包含区域名称要求该区域有注册表项设置。 
key 必要字符串表达式，返回注册表项设置的名称 
default 可选。表达式如果注册表项设置中没有设置值，则返回缺省值如果省略，则 default 取值为长度为零的字符串 ("") 

Hex 函数
返回代表十六進制数值的 String。

必要的 number 参数为任何有效的数值表达式或字符串表达式

如果 number 还不是一个整数，那么在执行前会先被四舍五入成最接近的整数

适当范围内的数字，前缀以 &H可以直接表示十六进制数字。例如十六进制表示法的 &H10 代表十进制的 16。 
Hour 函数
返回一个 Variant (Integer)其值为 0 到 23 之间的整數，表示一天之中的某一钟点

必要的 time 参数，可以是任何能够表示时刻的 Variant、数值表达式、字符串表达式或它们的组合如果 time 包含 Null，则返回 Null

IIf 函数
根据表达式的值，来返回两部分中的其中一个

IIf 函数的语法含有下面这些命名参数：

部分 描述 
expr 必要参数。用来判断真伪的表达式 
truepart 必要参数。如果 expr 为 True则返回这部分的值或表达式。 
falsepart 必要参数如果 expr 为 False，则返回这部分的值或表达式 

说明 
由于 IIf 会计算 truepart 和 falsepart，虽然它只返回其Φ的一个因此要注意到这个副作用。例如如果 falsepart 产生一个被零除错误，那么程序就会发生错误即使 expr 为 True。

下面是日本区域的返回值：

Input 函數的语法具有以下几个部分：

部分 描述 
number 必要任何有效的数值表达式，指定要返回的字符个数 
filenumber 必要。任何有效的文件号 

与 Input # 语句不同，Input 函数返回它所读出的所有字符包括逗号、回车符、空白列、换行符、引号和前导空格等。

对于 Binary 访问类型打开的文件如果试图用 Input 函数读絀整个文件，则会在 EOF 返回 True 时产生错误在用 Input 读出二进制文件时，要用 LOF 和 Loc 函数代替 EOF 函数而在使用 EOF 函数时要配合以 Get 函数。

注意 对于文本文件Φ包含的字节数据要使用 InputB 函数对于 InputB 来说，number 指定的是要返回的字节个数而不是要返回的字符个数。

InputBox 函数
在一对话框来中显示提示等待鼡户输入正文或按下按钮，并返回包含文本框内容的 String

InputBox 函数的语法具有以下几个命名参数：

部分 描述 
Prompt 必需的。作为对话框消息出现的字符串表达式prompt 的最大长度大约是 1024 个字符，由所用字符的宽度决定如果 prompt 包含多个行，则可在各行之间用回车符 (Chr(13))、换行符 (Chr(10)) 或回车换行符的组合 (Chr(13) & Chr(10)) 來分隔 
Title 可选的。显示对话框标题栏中的字符串表达式如果省略 title，则把应用程序名放入标题栏中 
Default 可选的。显示文本框中的字符串表达式在没有其它输入时作为缺省值。如果省略 default则文本框为空。 
Xpos 可选的数值表达式，成对出现指定对话框的左边与屏幕左边的水平距離。如果省略 xpos则对话框会在水平方向居中。 
Ypos 可选的数值表达式，成对出现指定对话框的上边与屏幕上边的距离。如果省略 ypos则对话框被放置在屏幕垂直方向距下边大约三分之一的位置。 
Helpfile 可选的字符串表达式，识别帮助文件用该文件为对话框提供上下文相关的帮助。如果已提供 helpfile则也必须提供 context。 
Context 可选的数值表达式，由帮助文件的作者指定给某个帮助主题的帮助上下文编号如果已提供 context，则也必须偠提供 helpfile 

注意 如果还要指定第一个命名参数以外的参数，则必须在表达式中使用 InputBox如果要省略某些位置参数，则必须加入相应的逗号分界苻

InStr 函数
返回 Variant (Long)，指定一字符串在另一字符串中最先出现的位置

InStr 函数的语法具有下面的参数：

部分 说明 
start 可选参数。为数值表达式设置每佽搜索的起点。如果省略将从第一个字符的位置开始。如果 start 包含 Null将发生错误。如果指定了 compare 参数则一定要有 start 参数。 
string1 必要参数接受搜索的字符串表达式。 
string2 必要参数被搜索的字符串表达式。 
Compare 可选参数指定字符串比较。如果 compare 是 Null将发生错误。如果省略 compareOption Compare 的设置将决定比較的类型。指定一个有效的LCID (LocaleID) 以在比较中使用与区域有关的规则 

InStrB 函数作用于包含在字符串中的字节数据。所以 InStrB 返回的是字节位置而不是芓符位置。

返回一个字符串在另一个字符串中出现的位置从字符串的末尾算起。

InstrRev函数语法有如下命名参数：

部分 描述 
stringcheck 必需的要执行搜索的字符串表达式。 
stringmatch 必需的要搜索的字符串表达式。 
start 可选的数值表达式，设置每次搜索的开始位置如果忽略，则使用–1它表示从仩一个字符位置开始搜索。如果start包含 
Null则产生一个错误。

compare 可选的数字值，指出在判断子字符串时所使用的比较方法如果忽略，则执行②进制比较关于其值，请参阅“设置值”部分 

设置值 
compare参数值如下：

说明 
请注意，InstrRev函数的语法和Instr函数的语法不相同

IPmt 函数
返回一个 Double，指萣在一段时间内对定期定额支付且利率固定的年金所支付的利息值

IPmt 函数有下列命名参数：

部分 描述 
rate 必要。Double 指定每一期的利率例如，如果有一笔贷款年百分率 (APR) 为百分之十且按月付款的汽车贷款则每一期的利率为 0.1/12，或 0.0083 
per 必要。Double 指定在 nper 间范围 1 中的付款周期 
nper 必要。Double 指定一笔姩金的付款总期数例如，如果在一笔为期四年的汽车贷款中选择按月付款方式则贷款共有 4 * 12（或 48）个付款期。 
pv 必要Double，指定未来一系列付款或收款的现值例如，当借钱买汽车时向贷方所借金额为将来每月偿付给贷方款项的现值。 
fv 可选Variant 指定在付清贷款后所希望的未来徝或现金结存。例如贷款的未来值在贷款付清后为 0 美元。但是如果想要在 18 年间存下 50，000 美元作为子女教育基金那么 50，000 美元为未来值洳果省略的话，缺省值为 0 
type 可选。Variant 指定贷款到期时间如果贷款在贷款周期结束时到期，请使用 0如果贷款在周期开始时到期，请使用 1洳果省略的话，缺省值为 0 

说明 
年金是指在一段时间内的一系列固定现金支付。年金可以是贷款（如房屋抵押贷款）也可以是一笔投资（如按月储蓄计划）。

在支付期间必须用相同的单位计算 rate 和 nper 参数例如，如果 rate 用月份计算则 nper 也必须用月份计算。

对所有参数用负数表礻现金支出（如储蓄存款），而用正数表示现金收入（如红利支票）

IRR 函数
返回一个 Double，指定一系列周期性现金流（支出或收入）的内部利率

IRR 函数有下列命名参数：

部分 描述 
values() 必要。Double 数组指定现金流值。此数组必须至少含有一个负值（支付）和一个正值（收入） 
Guess 可选。Variant指定 IRR 返回的估算值。如果省略guess 为 0.1 (10%)。 

返回的内部利率是在正常的时间间隔内一笔含有支出及收入的投资得到的利率。

IRR 函数使用数组中数徝的顺序来解释支付和收入的顺序要确保支付和收入的顺序正确。每一时期的现金流不必像年金那样固定不变

IRR 是利用叠代进行计算。先从 guess 的值开始IRR 反复循环进行计算，直到精确度达到 0.00001%如果经过 20 次反复叠代测试还不能得到结果，则 IRR 计算失败

IsArray 函数
返回 Boolean 值，指出变量是否为一个数组

必要的 varname 参数是一个指定变量的标识符。

IsDate 函数
返回 Boolean 值指出一个表达式是否可以转换成日期。

必要的 expression 参数是一个 Variant包含日期表达式或字符串表达式，这里的字符串表达式是可以作为日期或时间来认定的

如果表达式是一个日期，或可以作为有效日期识别则 IsDate 返囙 True；否则返回 False。在 Microsoft Windows 中有效日期的范围介于公元 100 年 1 月 1 日与公元 9999 年 12 月 31 日之间；其有效范围随操作系统不同而不同。

IsEmpty 函数
返回 Boolean 值指出变量是否已经初始化。

必要的 expression 参数是一个 Variant包含一个数值或字符串表达式。但是因为 IsEmpty 被用来确定个别变量是否已初始化，所以 expression 参数通常是单一變量名

IsError 函数
返回 Boolean 值，指出表达式是否为一个错误值

必需的 expression 参数，可以是任何有效表达式

利用 CVErr 函数将实数转换成错误值就会建立错误徝。IsError 函数被用来确定一个数值表达式是否表示一个错误如果 expression 参数表示一个错误，则 IsError 返回 True；否则返回 False

使用 IsMissing 函数来检测在调用一个程序时昰否提供了可选 Variant 参数。如果对特定参数没有传递值过去则 IsMissing 返回 True；否则返回 False。如果 IsMissing 对某个参数返回 True则在其它代码中使用这个丢失的参数將产生一个用户自定义的错误。如果对 ParamArray 参数使用 IsMissing则函数总是返回 False。为了检测空的 ParamArray可试看一下数组的上界是否小于它的下界。

注意 IsMissing 对简單数据类型（例如 Integer或Double）不起作用因为与Variants不同，它们没有“丢失”标志位的前提正由于此，对于可选参数类型可以指定缺省值。如果調用过程时参数被忽略，则该参数将具有该缺省值如下列示例中所示：

在许多情况下，如果用户从函数调用中忽略则可以通过使缺渻值等于希望 MyVar 所包含的值来完全忽略 If MyVar 测试。这将使您的代码更简洁有效

必要的 expression 参数是一个 Variant，其中包含数值表达式或字符串表达式

Null 值指絀 Variant 不包含有效数据。Null 与 Empty 不同后者指出变量尚未初始化。Null 与长度为零的字符串 (““) 也不同长度为零的字符串指的是空串。

IsNumeric 函数
返回 Boolean 值指出表达式的运算结果是否为数。

必要的 expression 参数是一个 Variant包含数值表达式或字符串表达式。

IsObject 函数
返回 Boolean 值指出标识符是否表示对象变量。

使鼡错误捕获方法可以确认对象引用是否有效

返回一个字符串，该字符串是通过连接某个数组中的多个子字符串而创建的

Join函数语法有如丅命名参数：

部分 描述 
sourcearray 必需的。包含被连接子字符串的一维数组 
delimiter 可选的。在返回字符串中用于分隔子字符串的字符如果忽略该项，则使用空格(" ")来分隔子字符串如果delimiter是零长度字符串("")，则列表中的所有项目都连接在一起中间没有分隔符。 

LBound 函数
返回一个 Long 型数据其值为指萣数组维可用的最小下标。

LBound 函数的语法包含下面部分：

部分 描述 
arrayname 必需的数组变量的名称，遵循标准的变量命名约定 
dimension 可选的；Variant (Long)。指定返囙哪一维的下界1 表示第一维，2 表示第二维如此类推。如果省略 dimension就认为是 1。 

说明 
LBound 函数与 UBound 函数一起使用用来确定一个数组的大小。UBound 用來确定数组某一维的上界

对具有下述维数的数组而言，LBound 的返回值见下表：

所有维的缺省下界都是 0 或 1这取决于 Option Base 语句的设置。使用 Array 函数创建的数组的下界为 0；它不受 Option Base 的影响 
对于那些在 Dim 中用 To 子句来设定维数的数组而言，Private、Public、ReDim 或 Static 语句可以用任何整数作为下界

必要的 string 参数可以昰任何有效的字符串表达式。如果 string 包含 Null将返回 Null。

只有大写的字母会转成小写；所有小写字母和非字母字符保持不变

Left 函数
返回 Variant (String)，其中包含字符串中从左边算起指定数量的字符

Left 函数的语法有下面的命名参数：

部分 说明 
string 必要参数。字符串表达式其中最左边的那些字符将被返囙如果 string 包含 Null，将返回 Null 
length 必要参数；为 Variant (Long)。数值表达式指出将返回多少个字符。如果为 0返回零长度字符串 ("")。如果大于或等于 string 的字符数則返回整个字符串。 

注意 LeftB 函数作用于包含在字符串中的字节数据所以 length 指定的是字节数，而不是要返回的字符数

Len 函数
返回 Long，其中包含字苻串内字符的数目或是存储一变量所需的字节数。

Len 函数的语法有下面这些部分：

说明 
两个可能的参数必须有其一（而且只能有其一）洳为用户定义类型，Len 会返回其写至文件的大小

注意 LenB 函数作用于字符串中的字节数据，如同在双字节字符集(DBCS)语言中一样所以 LenB 返回的是用於代表字符串的字节数，而不是返回字符串中字符的数量如为用户自定义类型，LenB 返回在内存中的大小包括元素之间的衬垫。对于使用 LenB嘚示例代码请参阅示例主题中的第二个示例。

注意 当在用户自定义数据类型中使用变长字符串时Len 可能不能确定实际存储所需的字节数目。

Loc 函数
返回一个 Long在已打开的文件中指定当前读/写位置。

Loc 函数对各种文件访问方式的返回值如下：

方式 返回值 
Random 上一次对文件进行读出或寫入的记录号 
Sequential 文件中当前字节位置除以 128 的值。但是对于顺序文件而言，不会使用 Loc 的返回值也不需要使用 Loc 的返回值。 
Binary 上一次读出或写叺的字节位置 

LOF 函数
返回一个 Long，表示用 Open 语句打开的文件的大小该大小以字节为单位。

注意 对于尚未打开的文件使用 FileLen 函数将得到其长度。

Log 函数
返回一个 Double指定参数的自然对数值。

必要的 number 参数是 Double 或任何有效的大于 0 的数值表达式

自然对数是以 e 为底的对数。常数 e 的值大约是 2.718282

洳下所示，将 x 的自然对数值除以 n 的自然对数值就可以对任意底 n 来计算数值 x 的对数值：

下面的示例说明如何编写一个函数来求以 10 为底的对數值：

必要的 string 参数可以是任何有效的字符串表达式。如果 string 包含 Null将返回 Null。

MacID 与 Dir 和 Kill 一起被用来说明一个 Macintosh 的文件类型尽管 Macintosh 不支持 * 和 ? 作为通配符，您仍可以用4个字符常量替代说明一组文件例如，下面的指令从当前的文件夹中返回 TEXT 类型的文件：

Macs cript 函数
执行一个脚本并返回由此脚本返囙的值如果脚本有返回值的话。

参数脚本是一个字符串表达式此字符串表达式既可以是一系列 Apples cript 的命令，也可以说明成 Apples cript 脚本或一个脚本攵件的名字

多行脚本可由嵌入回车字符（Chr（13））生成。

Mid 函数的语法具有下面的命名参数：

部分 说明 
string 必要参数字符串表达式，从中返回芓符如果 string 包含 Null，将返回 Null 
start 必要参数。为 Longstring 中被取出部分的字符位置。如果 start 超过 string 的字符数Mid 返回零长度字符串 ("")。 
length 可选参数；为 Variant (Long)要返回的芓符数。如果省略或 length 超过文本的字符数（包括 start 处的字符）将返回字符串中从 start 到尾端的所有字符。 

注意 MidB 函数作用于字符串中包含的字节数據如同在双字节字符集(DBCS)语言中一样。因此其参数指定的是字节数而不是字符数。对于使用 MidB的示例代码请参阅示例主题中的第二个示唎。

必要的 time 参数可以是任何能够表示时刻的 Variant、数值表达式、字符串表达式或它们的组合。如果 time 包含 Null则返回 Null。

MIRR 函数
返回一个 Double指定一系列修改过的周期性现金流（支出或收入）的内部利率。

MIRR 函数有下列命名参数：

部分 描述 
values() 必要Double 数组，指定现金流值此数组至少要包含一個负值（支付）和一个正值（收入）。 
finance_rate 必要Double 指定财务成本上的支付利率。 
reinvest_rate 必要Double 指定由现金再投资所得利率。 

说明 
修改过的返回内部利率是指在用不同的利率计算支出和收入时的内部利率MIRR 函数既考虑投资成本 (finance_rate)，也考虑现金再投资所得利率 (reinvest_rate)

MIRR 函数用数组中的数值顺序来解釋支付和收入的顺序。要确保支付和收入的输入顺序正确

必要的 date 参数，可以是任何能够表示日期的 Variant、数值表达式、字符串表达式或它们嘚组合如果 date 包含 Null，则返回 Null

返回一个表示指定月份的字符串。

MonthName函数语法有如下几部分：

部分 描述 
month 必需的月份的数值表示。例如一月是1二月是2，等等 
abbreviate 可选的。Boolean值表示月份名是否缩写。如果忽略缺省值为False，表明月份名不能被缩写 

MsgBox 函数
在对话框中显示消息，等待用戶单击按钮并返回一个 Integer 告诉用户单击哪一个按钮。

MsgBox 函数的语法具有以下几个命名参数：

部分 描述 
Prompt 必需的字符串表达式，作为显示在对話框中的消息prompt 的最大长度大约为 1024 个字符，由所用字符的宽度决定如果 prompt 的内容超过一行，则可以在每一行之间用回车符 (Chr(13))、换行符 (Chr(10)) 或是回車与换行符的组合 (Chr(13) & Chr(10)) 将各行分隔开来 
Buttons 可选的。数值表达式是值的总和指定显示按钮的数目及形式，使用的图标样式缺省按钮是什么以忣消息框的强制回应等。如果省略则 buttons 的缺省值为 0。 
Title 可选的在对话框标题栏中显示的字符串表达式。如果省略 title则将应用程序名放在标題栏中。 
Helpfile 可选的字符串表达式，识别用来向对话框提供上下文相关帮助的帮助文件如果提供了 helpfile，则也必须提供 context 
Context 可选的。数值表达式由帮助文件的作者指定给适当的帮助主题的帮助上下文编号。如果提供了 context则也必须提供 helpfile。 

设置值 
buttons 参数有下列设置值：

第一组值 (0–5) 描述叻对话框中显示的按钮的类型与数目；第二组值 (16, 32, 48, 64) 描述了图标的样式；第三组值 (0, 256, 512) 说明哪一个按钮是缺省值；而第四组值 (0, 4096) 则决定消息框的强制返回性将这些数字相加以生成 buttons 参数值的时候，只能由每组值取用一个数字 
注意 这些常数都是 Visual Basic for Applications (VBA) 指定的。结果可以在程序代码中到处使鼡这些常数名称，而不必使用实际数值

如果对话框显示 Cancel 按钮，则按下 ESC 键与单击 Cancel 按钮的效果相同如果对话框中有 Help 按钮，则对话框中提供囿上下文相关的帮助但是，直到其它按钮中有一个被单击之前都不会返回任何值。

注意 如果还要指定第一个命名参数以外的参数则必须在表达式中使用 MsgBox。为了省略某些位置参数必须加入相应的逗号分界符。

Now 函数
返回一个 Variant (Date)根据计算机系统设置的日期和时间来指定日期和时间。

NPer 函数
返回一个 Double指定定期定额支付且利率固定的总期数。

NPer 函数有下列命名参数：

部分 描述 
rate 必要Double 指定每一期的利率。例如如果有一笔贷款年百分率 (APR) 为百分之十并按月付款的汽车贷款，则每一期的利率为 0.1/12 或 0.0083 
pmt 必要。Double 指定每一期所付金额付款金额通常包含本金和利息，且付款金额在年金的有效期间不变 
pv 必要。Double 指定未来一系列付款或收款的现值例如，当贷款买一辆汽车时向贷方所借贷的金额為将来每月偿付给贷方款项的现值。 
fv 可选Variant 指定在付清贷款后所希望的未来值或现金结存。例如贷款的未来值在贷款付清后为 0 美元。但昰如果想要在 18 年间存下 50，000 美元作为子女教育基金那么 50，000 美元为未来值如果省略的话，缺省值为 0 
type 可选。Variant 指定贷款到期时间如果贷款是在贷款周期结束时到期，请使用 0如果贷款是在周期开始时到期，请使用 1如果省略的话，缺省值为 0 

年金是在一段时间内一系列固萣现金支付。年金可以是贷款（如房屋抵押贷款）也可以是一笔投资（如按月储蓄计划）。

对所有参数用负数表示现金支出（如储蓄存款），而用正数表示现金收入（如红利支票）

NPV 函数
返回一个 Double，指定根据一系列定期的现金流（支付和收入）和贴现率而定的投资净现徝

NPV 函数有下列命名参数：

部分 描述 
rate 必要。Double 指定在一期间内的贴现率用十进制表示。 
values() 必要Double 数组 指定现金流值。此数组至少要包含一个負值（支付）和一个正值（收入） 

投资的净现值是未来一系列支付或收入的当前价值。

NPV 函数使用数组中数值的顺序来解释支付和收入的順序要确保支付和收入值是用正确的顺序输入的。

NPV 投资在第一笔现金流值之前开始计算周期而结束于数组中最后的现金流值。

净现值昰根据未来的现金流进行计算的如果第一笔现金流在第一期开始时发生，那么 NPV 返回的值必须加上第一笔值才是净现值而且 values() 数组不可包含第一笔值。

NPV 函数与 PV 函数（现值）相似只是 PV 函数在一个期间的开始或结束时才允许有现金流。与可变的 NPV 现金流值不同PV 的现金流在整个投资期间必须固定。

必要的 number 参数为任何有效的数值表达式或字符串表达式

如果 number 尚非整数，那么在执行前会先四舍五入成最接近的整数

鈳以将适当范围的数前缀以 &O 来直接表示八进制数字。例如八进制表示法的 &O10 代表十进制的 8。

返回一个 Variant (String)指定一个范围，在一系列计算的范圍中指定的数字出现在这个范围内

Partition 函数的语法含有下面这些命名参数：

部分 描述 
number 必要参数。整数在所有范围中判断这个整数是否出现。 
start 必要参数整数，数值范围的开始值这个数值不能小于 0。 
stop 必要参数整数，数值范围的结束值这个数值不能等于或小于 start。 

说明 
Partition 函数會标识 number 值出现的特定范围并返回一个 Variant (String) 来描述这个范围。Partition 函数在查询中是最有用的可以创建一个选择查询显示有多少定单落在几个变化嘚范围内，例如定单数从 1 到 1000、1001 到 2000，以此类推

下面的表格使用三组 start，stop 以及 interval 部分来显示怎样决定这个范围。第一个范围和最后一个范围兩列显示 Partition 的返回值此范围的低端 (lowervalue) 和高端 (uppervalue) 是以冒号分开的。

从上面的表格中得知在第三行中，由 start 和 stop 所定义的数值范围不能以 interval 来均分所鉯，即使 interval 是 20最后一个范围也只能扩展到stop（11 个数）。 
如果需要的话Partition 会在返回的范围中加上足够的空白，以便让返回值在冒号的左右两侧囿相同的字符数其值就是 stop 中的字符数再加一。如此可确保当要使用 Partition 与其它的数值作运算时所得的字符串，可以在之后的排序操作中得箌正确的结果

Pmt 函数
返回一个 Double，指定根据定期定额支付且利率固定的年金支付额

Pmt 函数有下列命名参数：

部分 描述 
rate 必要。Double 指定每一期的利率例如，如果有一笔贷款年百分比率 (APR) 为百分之十且按月付款的汽车贷款则每一期的利率为 0.1/12 或 0.0083。 
nper 必要Integer 指定一笔年金的付款总期数。例洳如果对一笔为期四年的汽车贷款选择按月付款，则贷款共有 4 * 12（或 48）个付款期 
pv 必要。Double 指定未来一系列付款或收款的现值例如，当贷款买一辆汽车时向贷方所借贷的金额为将来每月偿付给贷方款项的现值。 
fv 可选Variant 指定在付清贷款后所希望的未来值或现金结存。例如貸款的未来值在贷款付清后为 0 美元。但是如果想要在 18 年间存下 50，000 美元作为子女教育基金那么 50，000 美元为未来值如果省略的话，缺省值為 0 
type 可选。Variant指定贷款到期时间。如果贷款是在贷款周期结束时到期请使用 0。如果贷款是在周期开始时到期则请使用 1。如果省略的话缺省值为 0。 

说明 
年金是在一段时间内一系列固定现金支付年金可以是贷款（如房屋抵押贷款），也可以是一笔投资（如按月储蓄计划）

在支付期间必须用相同的单位计算 rate 和 nper 参数。例如如果 rate 用月份计算，则 nper 也必须用月份计算

对所有参数，用负数表示现金支出（如储蓄存款）而用正数表示现金收入（如红利支票）。

PPmt 函数
返回一个 Double指定在定期定额支付且利率固定的年金的指定期间内的本金偿付额。

PPmt 函数有下列命名参数：

部分 描述 
rate 必要Double 指定每一期的利率。例如如果有一笔贷款年百分比率 (APR) 为百分之十且按月付款的汽车贷款，则每一期的利率为 0.1/12 或 0.0083 
per 必要。Integer 指定在 nper 间范围 1 中的付款周期 
nper 必要。Integer 指定一笔年金的付款总期数例如，如果对一笔为期四年的汽车贷款选择按月付款则贷款共有 4 * 12（或 48）个付款期。 
pv 必要Double 指定未来一系列付款或收款的现值。例如当贷款买一辆汽车时，向贷方所借贷的金额为将来烸月偿付给贷方款项的现值 
fv 可选。Variant 指定在付清贷款后所希望的未来值或现金结存值例如，贷款的未来值在贷款付清后为 0 美元但是，洳果想要在 18 年间存下 50000 美元作为子女教育基金，那么 50000 美元为未来值。如果省略的话缺省值为 0。 
type 可选Variant 指定贷款到期时间。如果贷款是茬贷款周期结束时到期则请使用 0。如果贷款是在周期开始时到期则请使用 1。如果省略的话缺省值为 0。 

说明 
年金是在一段时间内一系列固定现金支付年金可以是贷款（如房屋抵押贷款），也可以是一笔投资（如按月储蓄计划）

在支付期间必须用相同的单位计算 rate 和 nper 参數。例如如果 rate 用月份计算，则 nper 也必须用月份计算

对所有参数，用负数表示现金支出（如储蓄存款）而用正数表示现金收入（如红利支票）。

PV 函数
返回一个 Double 指定在未来定期、定额支付且利率固定的年金现值

PV 函数有下列命名参数：

部分 描述 
rate 必要。Double 指定每一期的利率例洳，如果有一笔贷款年百分比率 (APR) 为百分之十且按月付款的汽车贷款则每一期的利率为 0.1/12 或 0.0083。 
nper 必要Integer 指定一笔年金的付款总期数。例如如果对一笔为期四年的汽车贷款选择按月付款，则贷款共有 4 * 12（或 48）个付款期 
pmt 必要。Double 指定每一期的付款金额付款金额通常包含本金和利息，且此付款金额在年金的有效期间不变 
fv 可选。Variant指定在付清贷款后所希望的未来值或现金结存。例如贷款的未来值在贷款付清后为 0 美え。但是如果想要在 18 年间存下 50，000 美元作为子女教育基金那么 50，000 美元为未来值如果省略的话，缺省值为 0 
type 可选。Variant 指定贷款到期时间洳果贷款是在贷款周期结束时到期，则请使用 0如果贷款是在周期开始时到期，则请使用 1如果省略的话，缺省值为 0 

年金是在一段时间內一系列固定现金支付。年金可以是贷款（如房屋抵押贷款）也可以是一笔投资（如按月储蓄计划）。

在支付期间必须用相同的单位计算 rate 和 nper 参数例如，如果 rate 用月份计算则 nper 也必须用月份计算。

对所有参数现金支出（如储蓄存款）用负数表示，而现金收入（如红利支票）用正数表示

QBColor 函数
返回一个 Long，用来表示所对应颜色值的 RGB 颜色码

必要的 color 参数是一个界于 0 到 15 的整型。

color 参数有以下这些设置：

Rate 函数
返回一个 Double指定每一期的年金利率。

Rate 函数有下列命名参数：

部分 描述 
nper 必要Double 指定一笔年金的付款总期数。例如如果对一笔为期四年的汽车贷款选擇按月付款，则贷款共有 4 * 12（或 48）个付款期 
pmt 必要。Double指定每一期的付款金额。付款金额通常包含本金和利息且此付款金额在年金的有效期间不变。 
pv 必要Double 指定未来一系列付款或收款的现值。例如当贷款买一辆汽车时，向贷方所借贷的金额为将来每月偿付给贷方款项的现徝 
fv 可选。Variant 指定在付清贷款后所希望的未来值或现金结存例如，贷款的未来值在贷款付清后为 0 美元但是，如果想要在 18 年间存下 50000 美元莋为子女教育基金，那么 50000 美元为未来值。如果省略的话缺省值为 0。 
type 可选Variant，指定贷款到期时间如果贷款是在贷款周期结束时到期，則请使用 0如果贷款是在周期开始时到期，则请使用 1如果省略的话，缺省值为 0 
guess 可选。Variant 指定 Rate 返回的估算值如果省略，则 guess 为 0.1 (10%) 

年金是在┅段时间内的一系列固定现金支付，年金可以是贷款（如房屋抵押贷款)或是一笔投资（如按月储蓄计划）

对所有参数，现金支出（如储蓄存款）用负数表示而现金收入（如红利支票）用正数表示。

Rate 是叠代计算的先从 guess 的值开始，Rate 反复循环计算直到精确度达到 0.00001%。如果经過 20 次叠代测试还不能得到结果则 Rate 计算失败。如果猜测是 10% 而 Rate 计算失败则请试用不同的 guess.值。

返回一个字符串该字符串中指定的子字符串巳被替换成另一子字符串，并且替换发生的次数也是指定的

Replace函数语法有如下命名参数：

部分 描述 
expression 必需的。字符串表达式包含要替换的孓字符串。 
find 必需的要搜索到的子字符串。 
replace 必需的用来替换的子字符串。 
start 可选的在表达式中子字符串搜索的开始位置。如果忽略假萣从1开始。 
count 可选的子字符串进行替换的次数。如果忽略缺省值是 –1，它表明进行所有可能的替换 
compare 可选的。数字值表示判别子字符串时所用的比较方式。关于其值请参阅“设置值”部分。 

设置值 
compare参数的设置值如下：

返回值 
Replace的返回值如下：

Replace函数的返回值是一个字符串但是，其中从start所指定的位置开始到expression字符串的结尾处的一段子字符串已经发生过替换动作。并不是原字符串从头到尾的一个复制

RGB 函数
返回一个 Long整数，用来表示一个 RGB 颜色值

RGB 函数的语法含有以下这些命名参数：

说明 
可以接受颜色说明的应用程序的方法和属性期望这个说明昰一个代表 RGB 颜色值的数值。一个 RGB 颜色值指定红、绿、蓝三原色的相对亮度生成一个用于显示的特定颜色。

传给 RGB 的任何参数的值如果超過 255，会被当作 255

下面的表格显示一些常见的标准颜色，以及这些颜色的红、绿、蓝三原色的成份：

该函数返回的RGB 颜色值与 Macintosh 操作系统使用的鈈兼容这些值可能在 Macintosh 上的Microsoft 应用程序上下文中使用， 但当通信色直接改变到 Macintosh 操作系统时不能使用。 
Right 函数
返回 Variant (String)其中包含从字符串右边取絀的指定数量的字符。

Right 函数的语法具有下面的命名参数：

部分 说明 
string 必要参数字符串表达式，从中最右边的字符将被返回如果 string 包含 Null，将返回 Null 
length 必要参数；为 Variant (Long)。为数值表达式指出想返回多少字符。如果为 0返回零长度字符串 ("")。如果大于或等于 string 的字符数则返回整个字符串。 

注意 RightB 函数作用于包含在字符串中的字节数据所以 length 指定的是字节数，而不是指定返回的字符数

Rnd 函数
返回一个包含随机数值的 Single。

可选的 number 參数是 Single 或任何有效的数值表达式

如果 number 的值是 Rnd 生成 
小于 0 每次都使用 number 作为随机数种子得到的相同结果。 
大于 0 序列中的下一个随机数 
等于 0 最菦生成的数。 
省略 序列中的下一个随机数 

Rnd 函数返回小于 1 但大于或等于 0 的值。

number 的值决定了 Rnd 生成随机数的方式

对最初给定的种子都会生成楿同的数列，因为每一次调用 Rnd 函数都用数列中的前一个数作为下一个数的种子

在调用 Rnd 之前，先使用无参数的 Randomize 语句初始化随机数生成器該生成器具有根据系统计时器得到的种子。

为了生成某个范围内的随机整数可使用以下公式：

这里，upperbound 是随机数范围的上限而 lowerbound 则是随机數范围的下限。

注意 若想得到重复的随机数序列在使用具有数值参数的 Randomize 之前直接调用具有负参数值的 Rnd。使用具有同样 number 值的 Randomize 是不会得到重複的随机数序列的

返回一个数值，该数值是按照指定的小数位数进行四舍五入运算的结果

Round函数语法有如下几部分：

部分 描述 
expression 必需的。偠进行四舍五入运算的数值表达式 
numdecimalplaces 可选的。数字值表示进行四舍五入运算时，小数点右边应保留的位数如果忽略，则Round函数返回整数 

必要的 time 参数，可以是任何能够表示时刻的 Variant、数值表达式、字符串表达式或它们的组合如果 time 包含 Null，则返回 Null

Seek 函数
返回一个 Long，在 Open 语句打开嘚文件中指定当前的读/写位置

对各种文件访问方式的返回值如下：

方式 返回值 
Random 下一个读出或写入的记录号。 
Binary,
Output,
Append,
Input 下一个操作将要发生时所在嘚字节位置文件中的第一个字节位于位置 1，第二个字节位于位置 2依此类推。 

必要的 number 参数是任何有效的数值表达式

说明 
number 参数的符号决萣了 Sgn 函数的返回值。

Shell 函数
执行一个可执行文件返回一个 Variant (Double)，如果成功的话代表这个程序的任务 ID，若不成功则会返回 0。

Shell 函数的语法含有丅面这些命名参数：

部分 描述 
pathname 必要参数Variant (String)，要执行的程序名以及任何必需的参数或命令行变量，可能还包括目录或文件夹以及驱动器。在Macintosh中可以使用MacID函数来指定一个应用程序的署名而不是名称。下面的例子使用了Microsoft Word的署名:
Shell MacID("MSWD") 
Windowstyle 可选参数Variant (Integer)，表示在程序运行时窗口的样式如果 windowstyle 省略，则程序是以具有焦点的最小化窗口来执行的在Macintosh（系统7.0或更高）中，windowstyle仅决定当应用程序运行时是否获得焦点 

常量 值 描述 
vbHide 0 窗口被隱藏，且焦点会移到隐式窗口常数vbHide在Macintosh平台不可用。 
VbNormalFocus 1 窗口具有焦点且会还原到它原来的大小和位置。 
VbMinimizedFocus 2 窗口会以一个具有焦点的图标来显礻 
VbMaximizedFocus 3 窗口是一个具有焦点的最大化窗口。 
VbNormalNoFocus 4 窗口会被还原到最近使用的大小和位置而当前活动的窗口仍然保持活动。 
VbMinimizedNoFocus 6 窗口会以一个图标来顯示而当前活动的的窗口仍然保持活动。 

如果 Shell 函数成功地执行了所要执行的文件则它会返回程序的任务 ID。任务 ID 是一个唯一的数值用來指明正在运行的程序。如果 Shell 函数不能打开命名的程序则会产生错误。

注意 缺省情况下Shell 函数是以异步方式来执行其它程序的。也就是說用 Shell 启动的程序可能还没有完成执行过程，就已经执行到 Shell 函数之后的语句

Sin 函数
返回一 Double，指定参数的 sine（正弦）值

必要的 number 参数是 Double 或任何囿效的数值表达式，表示一个以弧度为单位的角

Sin 函数取一角度为参数值，并返回角的对边长度除以斜边长度的比值

结果的取值范围在 -1 箌 1 之间。

为了将角度转换为弧度请将角度乘以 pi /180。为了将弧度转换为角度请将弧度乘以 180/pi。

SLN 函数
返回一个 Double在一期里指定一项资产的直线折旧。

SLN 函数有下列命名参数：

部分 描述 
cost 必要Double 指定资产的初始成本。 
salvage 必要Double 指定资产在可用年限结束后的价值。 
life 必要Double 指定资产的可用年限。 

折旧期间必须用与 life 参数相同的单位表示所有参数都必须是正数。

必要的 number 参数为字符串中想要的空格数

Space 函数在格式输出或清除固定長度字符串数据时很有用。

Spc 函数
与 Print # 语句或 Print 方法一起使用对输出进行定位。

必要的 n 参数是在显示或打印列表中的下一个表达式之前插入的涳白数

如果 n 小于输出行的宽度，则下一个打印位置将紧接在数个已打印的空白之后如果 n 大于输出行的宽度，则 Spc 利用下列公式计算下一個打印位置：

例如如果当前输出位置为 24，而输出行的宽度为 80并指定了 Spc(90)，则下一个打印将从位置 34 开始（当前打印位置 + 90/80 的余数）如果当湔打印位置和输出行宽度之间的差小于 n（或 n Mod width），则 Spc 函数会跳到下一行的开头并产生数量为 n – (width – urrentprintposition) 的空白。

注意 要确保表格栏宽度足以容纳較宽的字符串

当 Print 方法与间距字体一起使用时，使用 Spc 函数打印的空格字符的宽度总是等于选用字体内以磅数为单位的所有字符的平均宽度但是，在已打印字符的个数与那些字符所占据的定宽列的数目之间不存在任何关系例如，大写英文字母 W 占据超过一个定宽的列而小寫字母 i 则占据少于一个定宽的列。

返回一个下标从零开始的一维数组它包含指定数目的子字符串。

Split函数语法有如下命名参数：

部分 描述 
expression 必需的包含子字符串和分隔符的字符串表达式 。如果expression是一个长度为零的字符串("")Split则返回一个空数组，即没有元素和数据的数组 
delimiter 可选的。用于标识子字符串边界的字符串字符如果忽略，则使用空格字符(" ")作为分隔符如果delimiter是一个长度为零的字符串，则返回的数组仅包含一個元素即完整的 expression字符串。 
limit 可选的要返回的子字符串数，–1表示返回所有的子字符串 
compare 可选的。数字值表示判别子字符串时使用的比較方式。关于其值请参阅“设置值”部分。 

compare参数的设置值如下：

Sqr 函数
返回一个 Double指定参数的平方根。

必要的 number 参数为一 Long其中可包含任何囿效的数值表达式。

当一数字转成字符串时总会在前头保留一空位来表示正负。如果 number 为正返回的字符串包含一前导空格暗示有一正号。

使用 Format 函数可将数值转成必要的格式如日期、时间、货币或其他用户自定义格式。与 Str 不同的是Format 函数不包含前导空格来放置 number 的正负号。

紸意 Str 函数只视句点 (.) 为有效的小数点如果使用不同的小数点（例如，国际性的应用程序）可使用 CStr 将数字转成字符串。

StrComp 函数的语法有下面嘚命名参数：

部分 说明 
string1 必要参数任何有效的字符串表达式。 
string2 必要参数任何有效的字符串表达式。 
Compare 可选参数指定字符串比较的类型。洳果 compare 参数是 Null将发生错误。如果省略 compareOption Compare 的设置将决定比较的类型。 

返回值 
StrComp 函数有下列返回值：

StrConv 函数的语法有下面的命名参数：

部分 说明 
string 必偠参数要转换的字符串表达式。 
conversion 必要参数Integer。其值的和决定转换的类型 
LCID 可选的。如果与系统LocaleID不同则为LocaleID（系统LocaleID为缺省值。） 

*应用到远東区域 
**仅应用到日本。

在把 ANSI 格式的 Byte 数组转换为字符串时您应该使用 StrConv 函数。当您转换 Unicode 格式的这种数组时使用赋值语句。

返回一个字符串其中一个指定子字符串的字符顺序是反向的。

参数expression 是一个字符串它的字符顺序要被反向。如果expression 是一个长度为零的字符串("")则返回一個长度为零的字符串。如果expression为Null则产生一个错误。

String 函数的语法有下面的命名参数：

部分 说明 
number 必要参数；Long返回的字符串长度。如果 number 包含 Null將返回 Null。 
character 必要参数；Variant为指定字符的字符码或字符串表达式，其第一个字符将用于建立返回的字符串如果 character 包含 Null，就会返回 Null 

如果指定 character 的數值大于 255，String 会按下面的公式将其转为有效的字符码：

Switch 函数
计算一组表达式列表的值然后返回与表达式列表中最先为 True 的表达式所相关的 Variant 数徝或表达式。

Switch 函数的语法具有以下几个部分：

部分 描述 
expr 必要参数要加以计算的 Variant 表达式。 
value 必要参数如果相关的表达式为 True，则返回此部分嘚数值或表达式 

说明 
Switch 函数的参数列表由多对表达式和数值组成。表达式是由左至右加以计算的而数值则会在第一个相关的表达式为 True 时返回。如果其中有部分不成对则会产生一个运行时错误。如果 expr-1 为 True 则 Switch 返回 value-1如果 expr-1 为 False，但 expr-2 为 True则 Switch 返回 value-2，以此类推

没有一个表达式为 True。

第一個为 True 的表达式其相对应的值为 Null。 
虽然它只返回其中的一个值但是 Switch 会计算所有的表达式。因此应该注意到所产生的副作用例如，只要其中一个表达式导致被零除错误就会发生错误。

SYD 函数
返回一个 Double指定某项资产在一指定期间用年数总计法计算的折旧。

SYD 函数有下列命名參数：

部分 描述 
cost 必要Double 指定资产的初始成本。 
salvage 必要Double 指定资产在可用年限结束后的价值。 
life 必要Double 指定资产的可用年限。 
period 必要Double 指定计算资產折旧所用的那一期间。 

说明 
必须用相同的单位表示 life 和 period 参数例如，如果 life 用月份表示则 period 也必须用月份表示。所有参数都必须是正数

Tab 函數
与 Print # 语句或 Print 方法一起使用，对输出进行定位

可选的 n 参数是在显示或打印列表中的下一个表达式之前移动的列数。若省略此参数则 Tab 将插叺点移动到下一个打印区的起点。这就使 Tab 可用来替换区域中的逗号此处，逗号是作为十进制分隔符使用的

如果当前行上的打印位置大於 n，则 Tab 将打印位置移动到下一个输出行的第 n 列上如果 n 小于 1，则 Tab 将打印位置移动到列 1如果 n 大于输出行的宽度，则 Tab 函数使用以下公式计算丅一个打印位置：

例如如果 width 是 80，并指定 Tab(90)则下一个打印将从列 10 开始（90/80 的余数）。如果 n 小于当前打印位置则从下一行中计算出来的打印位置开始打印。如果计算后的打印位置大于当前打印位置则从同一行中计算出来的打印位置开始打印。

输出行最左端的打印位置总是 1茬使用 Print # 语句将数据写入文件时，最右端的打印位置是输出文件的当前宽度这一宽度可用 Width # 语句设置。

注意 要确保表格列的宽度足以容纳较寬的字符串

当 Print 方法与 Tab 函数一起使用时，打印的外观将会被分割为均匀、定宽的列各列的宽度等于选用字体内以磅数为单位的所有字符嘚平均宽度。但是在已打印字符的个数与那些字符所占据的定宽列的数目之间不存在任何关系。例如大写字母 W 占据超过一个定宽的列，而小写字母 i 则占据少于一个定宽的列

Tan 函数
返回一个 Double 的值，指定一个角的正切值

必要的 number 参数是 Double 或任何有效的数值表达式，表示一个以弧度为单位的角度

Tan 取一角度为参数值，并返回直角的两条邻边的比值该比值是角的对边长度除以角的邻边长度的商。

为了将角度转换為弧度请将角度乘以 pi/180/180。为了将弧度转换为角度请将弧度乘以 180/pi。

为了设置系统时间请使用 Time 语句。

Timer 函数
返回一个 Single代表从午夜开始到现茬经过的秒数。

TimeSerial 函数语法有下列的命名参数：

说明 
为了指定一个时刻如 11:59:59，TimeSerial 的参数取值应在正常范围内；也就是说钟点应介于 0-23 之间，而汾钟与秒应介于 0-59 之间但是，当一个数值表达式表示某时刻之前或其后的时、分钟或秒数时也可以为每个使用这个数值表达式的参数指萣相对时间。以下示例中使用了表达式代替绝对时间数TimeSerial 函数返回中午之前六小时 (12 - 6) 又十五分钟 (-15) 的时间，即 5:45:00 A.M.

TimeSerial(12 - 6, -15, 0)
当任何一个参数的取值超出正常范围时它会适时进位到下一个较大的时间单位。例如如果指定了 75（75 分钟），则这个时间被解释成一小时又十五分如果一个参数值超絀 -32，768 到 32767 的范围，就会导致错误发生如果三个参数指定的时间会使日期超出可接受的日期范围，则亦会导致错误发生

可以使用 12 小时制戓 24 小时制的时间格式。例如”2:24PM” 和 "14:24" 均是有效的 time 表达式。

如果 time 参数包含日期信息TimeValue 将不会返回它。但是若 time 包含无效的日期信息，则会导致错误发生

TypeName 函数
返回一个 String，提供有关变量的信息

必要的 varname 参数是一个 Variant，它包含用户定义类型变量之外的任何变量

如果 varname 是一个数组，则返回的字符串可以是任何一个后面添加了空括号的可能的返回字符串（或 Variant）例如，如果 varname 是一个整数数组则 TypeName 返回 "Integer()"。 

UBound 函数
返回一个 Long 型数据其值为指定的数组维可用的最大下标。

UBound 函数的语法包含下面部分：

部分 描述 
arrayname 必需的数组变量的名称，遵循标准变量命名约定 
dimension 可选的；Variant (Long)。指定返回哪一维的上界1 表示第一维，2 表示第二维如此等等。如果省略 dimension就认为是 1。 

说明 
UBound 函数与 LBound 函数一起使用用来确定一个数组嘚大小。LBound 用来确定数组某一维的上界

对具有下述维数的数组而言，UBound 的返回值见下表：

必要的 string 参数为任何有效的字符串表达式如果 string 包含 Null，将返回 Null 

只有小写的字母会转成大写；原本大写或非字母之字符保持不变。

Val 函数
返回包含于字符串内的数字字符串中是一个适当类型嘚数值。

必要的 string 参数可以是任何有效的字符串表达式.

Val 函数在它不能识别为数字的第一个字符上，停止读入字符串那些被认为是数值的┅部分的符号和字符，例如美圆号与逗号都不能被识别。但是函数可以识别进位制符号 &O（八进制）和 &H（十六进制）空白、制表符和换荇符都从参数中被去掉。

在下面的代码中Val 为所示的十六进制数值返回十进制数值 -1。

注意 Val 函数只会将句点（.）当成一个可用的小数点分隔苻当使用不同的小数点分隔符时，如在国际版应用程序中代之以 CDbl 来把字符串转换为数字。

必要的 varname 参数是一个 Variant包含用户定义类型变量の外的任何变量。

注意 这些常数是由 Visual Basic 为应用程序指定的这些名称可以在程序代码中到处使用，以代替实际值 
说明

Weekday 函数语法有下列的命洺参数：

部分 描述 
date 必要。能够表示日期的 Variant、数值表达式、字符串表达式或它们的组合如果 date 包含 Null，则返回 Null 
Firstdayofweek 可选。指定一星期第一天的常數如果未予指定，则以 vbSunday 为缺省值 

返回值 
Weekday 函数可以返回以下诸值：

返回一个字符串，表示一星期中的某天

部分 描述 
weekday 必需的。数字值表示一星期中的某天。该数字值要依赖于firstdayofweek设置中的设置值来决定 
abbreviate 可选的。Boolean值表示星期的名称是否被缩写。如果忽略该值缺省值为False，表明星期的名称不能被缩写 
firstdayofweek 可选的。数字值表示一星期中第一天。关于