按键精灵函数介绍.doc

按字母顺序排列: A = Abs 函数 返回参数的绝对值，其类型和参数相同。 语法 Abs(number) 必要的 number 参数是任何有效的数值表达式，如果 number 包含 Null，则返回 Null，如果 number 是未初始化的变量，则返回 0。 说明 一个数的绝对值是将正负号去掉以后的值。例如，ABS(-1) 和 ABS(1) 都返回 1。 - Abs 函数示例 本示例使用 Abs 函数计算数的绝对值。 Dim MyNumber MyNumber = Abs(50.3) 返回 50.3。 MyNumber = Abs(-50.3) 返回 50.3。 = Array 函数 返回一个包含数组的 Variant。 语法 Array(arglist) 所需的 arglist 参数是一个用逗号隔开的值表，这些值用于给 Variant 所包含的数组的各元素赋值。如果不提供参数，则创建一个长度为 0 的数组。 说明 用来表示数组元素的符号由变量名、圆括号以及括号中的所需元素的索引号组成。在下面的示例中，第一条语句创建一个 Variant 的变量 A。 第二条语句将一个数组赋给变量 A。最后一条语句将该数组的第二个元素的值赋给另一个变量。 Dim A A = Array(10,20,30) B = A(2) 使用 Array 函数创建的数组的下界受 Option Base 语句指定的下界的决定, 除非 Array 是由类型库（例如 VBA.Array )名称限定。如果是由 类型库名称限定，则 Array 不受 Option Base 的影响。 注意 没有作为数组声明的 Variant 也可以表示数组。除了长度固定的字符串以及用户定义类型之外，Variant 变量可以表示任何类型的数组 。尽管一个包含数组的 Variant 和一个元素为 Variant 类型的数组在概念上有所不同，但对数组元素的访问方式是相同的。 - Array 函数示例 该示例使用 Array 函数来返回一个包含 Variant 的数组。 Dim MyWeek, MyDay MyWeek = Array(Mon, Tue, Wed, Thu, Fri, Sat, Sun) 返回值假设下界的设置为 1（使用 Option Base 语句）。 MyDay = MyWeek(2) MyDay 的值为 Tue。 MyDay = MyWeek(4) MyDay 的值为 Thu。 = Asc 函数 返回一个 Integer，代表字符串中首字母的字符代码。 语法 Asc(string) 必要的 string 参数可以是任何有效的字符串表达式。如果 string 中没有包含任何字符，则会产生运行时错误。 说明 在非 DBCS 系统下，返回值范围为 0 255 。在 DBCS 系统下，则为 -32768 32767。 注意 AscB 函数作用于包含在字符串中的字节数据，AscB 返回第一个字节的字符代码，而非字符的字符代码。AscW 函数返回 Unicode 字 符代码，若平台不支持 Unicode，则与 Asc 函数功能相同。 - Asc 函数示例 本示例使用 Asc 函数返回字符串首字母的字符值（ASCII 值）。 Dim MyNumber MyNumber = Asc(A) 返回 65。 MyNumber = Asc(a) 返回 97。 MyNumber = Asc(Apple) 返回 65。 = Atn 函数 返回一个 Double，指定一个数的反正切值。 语法 Atn(number) 必要的 number 参数是一个 Double或任何有效的数值表达式。 说明 Atn 函数的参数值 (number) 为直角三角形两边的比值并返回以弧度为单位的角。这个比值是角的对边长度除以角的邻边长度之商。 值的范围在 -pi/2 和 pi/2 弧度之间。 为了将角度转换为弧度，请将角度乘以 pi/180。为了将弧度转换为角度，请将弧度乘以 180/pi。 注意 Atn 是 Tan 的反三角函数，Tan 的参数值为角度，返回直角三角形的两条边的比值。不要将 Atn 和余切函数混淆，余切函数值是正切 函数值的倒数，cotangent = (1/tangent)。 - Atn 函数示例 本示例使用 Atn 函数计算圆周率。 Dim pi pi = 4 * Atn(1) 计算圆周率。按字母顺序排列: C = CBool 函数 描述 返回表达式，此表达式已转换为 Boolean 子类型的 Variant。 语法 CBool(expression) expression 是任意有效的表达式。 说明 如果 expression 是零，则返回 False；否则返回 True。如果 expression 不能解释为数值，则将发生运行时错误。 下面的示例使用 CBool 函数将一个表达式转变成 Boolean 类型。如果表达式所计算的值非零，则 CBool 函数返回 True；否则返回 False。 - 示例: Dim A, B, Check A = 5: B = 5 初始化变量。 Check = CBool(A = B) 复选框设为 True 。 A = 0 定义变量。 Check = CBool(A) 复选框设为 False 。 = CByte 函数 描述 返回表达式，此表达式已被转换为 Byte 子类型的 Variant。 语法 CByte(expression) expression 参数是任意有效的表达式。 说明 通常，可以使用子类型转换函数书写代码，以显示某些操作的结果应被表示为特定的数据类型，而不是默认类型。例如，在出现货币、单精度、双精度或整数运算的情况下，使用 CByte 强制执行字节运算。 CByte 函数用于进行从其他数据类型到 Byte 子类型的的国际公认的格式转换。例如对十进制分隔符（如千分符）的识别，可能取决于系统的区域设置。 如果 expression 在 Byte 子类型可接受的范围之外，则发生错误。下面的示例利用 CByte 函数把 expression 转换为 byte: - 示例: Dim MyDouble, MyByte MyDouble = 125.5678 MyDouble 是一个双精度值。 MyByte = CByte(MyDouble) MyByte 包含 126 。 = CCur 函数 描述 返回表达式，此表达式已被转换为 Currency 子类型的 Variant。 语法 CCur(expression) expression 参数是任意有效的表达式。 说明 通常，您可以使用子类型数据转换函数书写代码，以显示某些操作的结果应当被表达为特定的数据类型，而非默认的数据类型。例如在整数运算的情况下，使用 CCur 函数强制进行货币计算。 CCur 函数用于进行从其他数据类型到 Currency 子类型的国际公认的格式转换。例如，对十进制分隔符和千位分隔符的识别取决于系统的区域设置。 下面的示例使用 CCur 函数将一个表达式转换成 Currency 类型: - 示例: Dim MyDouble, MyCurr MyDouble = 543.214588 MyDouble 是双精度的。 MyCurr = CCur(MyDouble * 2) 把 MyDouble * 2 (1086.429176) 的结果转换为 Currency (1086.4292)。 = CDate 函数 描述 返回表达式，此表达式已被转换为 Date 子类型的 Variant。 语法 CDate(date) date 参数是任意有效的日期表达式。 说明 IsDate 函数用于判断 date 是否可以被转换为日期或时间。CDate 识别日期文字和时间文字，以及一些在可接受的日期范围内的数字。在将数字转换为日期时，数字的整数部分被转换为日期，分数部分被转换为从午夜开始计算的时间。 CDate 根据系统的区域设置识别日期格式。如果数据的格式不能被日期设置识别，则不能判断年、月、日的正确顺序。另外，如果长日期格式包含表示星期几的字符串，则不能被识别。 下面的示例使用 CDate 函数将字符串转换成日期类型。一般不推荐使用硬件译码日期和时间作为字符串（下面的例子已体现）。而使用时间和日期文字 (如 #10/19/1962#, #4:45:23 PM#)。 - 示例: MyDate = October 19, 1962 定义日期。 MyShortDate = CDate(MyDate) 转换为日期数据类型。 MyTime = 4:35:47 PM 定义时间。 MyShortTime = CDate(MyTime) 转换为日期数据类型。 = CDbl 函数 描述 返回表达式，此表达式已被转换为 Double 子类型的 Variant。 语法 CDbl(expression) expression 参数是任意有效的表达式。 说明 通常，您可以使用子类型数据转换函数书写代码，以显示某些操作的结果应当被表达为特定的数据类型，而非默认的数据类型。例如在出现货币或整数运算的情况下，使用 CDbl 或 CSng 函数强制进行双精度或单精度算术运算。 CDbl 函数用于进行从其他数据类型到 Double 子类型的国际公认的格式转换。例如，十进制分隔符和千位分隔符的识别取决于系统的区域设置。 下面的示例利用 CDbl 函数把 expression 转换为 Double。 - 示例: Dim MyCurr, MyDouble MyCurr = CCur(234.456784) MyCurr 是 Currency 型 (234.4567)。 MyDouble = CDbl(MyCurr * 8.2 * 0.01) 把结果转换为 Double 型 (19.2254576)。 = Chr 函数 描述 返回与指定的 ANSI 字符代码相对应的字符。 语法 Chr(charcode) charcode 参数是可以标识字符的数字。 说明 从 0 到 31 的数字表示标准的不可打印的 ASCII 代码。例如，Chr(10) 返回换行符。 下面例子利用 Chr 函数返回与指定的字符代码相对应的字符: - 示例: Dim MyChar MyChar = Chr(65) 返回 A。 MyChar = Chr(97) 返回 a。 MyChar = Chr(62) 返回 。 MyChar = Chr(37) 返回 %。 - 注意 ChrB 函数与包含在字符串中的字节数据一起使用。ChrB 不是返回一个或两个字节的字符，而总是返回单个字节的字符。ChrW 是为使用 Unicode 字符的 32 位平台提供的。它的参数是一个 Unicode (宽字符)的字符代码，因此可以避免将 ANSI 转化为 Unicode 字符。 = CInt 函数 描述 返回表达式，此表达式已被转换为 Integer 子类型的 Variant。 语法 CInt(expression) expression 参数是任意有效的表达式。 说明 通常，可以使用子类型转换函数书写代码，以显示某些操作的结果应被表示为特定的数据类型，而不是默认类型。例如，在出现货币、单精度或双精度运算的情况下，使用 CInt 或 CLng 强制执行整数运算。 CInt 函数用于进行从其他数据类型到 Integer 子类型的国际公认的格式转换。例如对十进制分隔符（如千分符）的识别，可能取决于系统的区域设置。 如果 expression 在 Integer 子类型可接受的范围之外，则发生错误。 下面的示例利用 CInt 函数把值转换为 Integer: - 示例: Dim MyDouble, MyInt MyDouble = 2345.5678 MyDouble 是 Double。 MyInt = CInt(MyDouble) MyInt 包含 2346。 - 注意 CInt 不同于 Fix 和 Int 函数删除数值的小数部分，而是采用四舍五入的方式。 当小数部分正好等于 0.5 时, CInt 总是将其四舍五入成最接近该数的偶数。例如， 0.5 四舍五入为 0, 以及 1.5 四舍五入为 2. = CLng 函数 描述 返回表达式，此表达式已被转换为 Long 子类型的 Variant。 语法 CLng(expression) expression 参数是任意有效的表达式。 说明 通常，您可以使用子类型数据转换函数书写代码，以显示某些操作的结果应当被表达为特定的数据类型，而非默认的数据类型。例如，在出现货币运算、单精度或双精度算术运算的情况下，使用 CInt 或 CLng 函数强制进行整数运算。 CLng 函数用于进行从其他数据类型到 Long 子类型的的国际公认的格式转换。例如，对十进制分隔符和千位分隔符的识别取决于系统的区域设置。 如果 expression 取值不在 Long 子类型的允许范围内，则会出现错误。 下面的示例利用 CLng 函数把值转换为 Long: - 示例: Dim MyVal1, MyVal2, MyLong1, MyLong2 MyVal1 = 25427.45: MyVal2 = 25427.55 MyVal1, MyVal2 是双精度值。 MyLong1 = CLng(MyVal1) MyLong1 25427。 MyLong2 = CLng(MyVal2) MyLong2 包含 25428 。 - 注意 CLng 不同于 Fix 和 Int 函数删除小数部分， 而是采用四舍五入的方式。 当小数部分正好等于 0.5 时， CLng 函数总是将其四舍五入为最接近该数的偶数。如， 0.5 四舍五入为 0, 以及 1.5 四舍五入为 2 。 = Cos 函数 描述 返回某个角的余弦值。 语法 Cos(number) number 参数可以是任何将某个角表示为弧度的有效数值表达式。 说明 Cos 函数取某个角并返回直角三角形两边的比值。此比值是直角三角形中该角的邻边长度与斜边长度之比。结果范围在 -1 到 1 之间。 角度转化成弧度方法是用角度乘以 pi/180 。 反之，弧度转化成角度的方法是用弧度乘以 180/pi 。 下面的示例利用 Cos 函数返回一个角的余弦值: - 示例: Dim MyAngle, MySecant MyAngle = 1.3 用弧度定义一个角。 MySecant = 1 / Cos(MyAngle) 计算正割。 = CreateObject 函数 描述 创建并返回对 Automation 对象的引用。 语法 CreateObject(servername.typename , location) CreateObject 函数语法 ，有以下部分： 部分 描述 servername 要求。提供对象的应用程序名称。 typename 要求。要创建的对象类型或类。 location 可选的。对象所在的网络服务器将被创建。 说明 Automation 服务器至少提供一种对象类型。例如，字处理应用程序可以提供应用程序对象、文档对象和工具条对象。 要创建 Automation 对象，将 CreateObject 函数返回的对象赋值给某对象变量： Dim ExcelSheet Set ExcelSheet = CreateObject(Excel.Sheet) 上述代码启动创建对象（在此实例中，是 Microsoft Excel 电子表格）的应用程序。对象创建后，就可以在代码中使用定义的对象变量引用此对象。在下面的示例中，可使用对象变量、ExcelSheet 和其他 Excel 对象，包括 Application 对象和 Cells 集合访问新对象的属性和方法。例如： 通过 Application 对象使 Excel 可见。 ExcelSheet.Application.Visible = True 在工作表的第一个单元中放置文本。 ExcelSheet.ActiveSheet.Cells(1,1).Value = 这是 A 列第一行 保存工作表。 ExcelSheet. SaveAs C:DOCSTEST.XLS 在 Application 对象中使用 Quit 方法退出 Excel。 ExcelSheet.Application.Quit 释放对象变量。 Set ExcelSheet= Nothing 在远程服务器上创建一个对象，当 Internet 安全关闭时只能完成。通过传递计算机名到 CreateObject 服务器名的参数，能在远程网络上创建对象。该名称如同共享部份的机器名。例如网络共享名命名为： myserverpublic, servername 是 myserver。另外,只能指定 servername 使用 DNS 格式或 IP 地址。 以下代码返回运行在命名为myserver的远程网络计算机上 Excel 实例的版本号 : - 示例: Function GetVersion Dim XLApp Set XLApp = CreateObject(Excel.Application, MyServer) GetVersion = XLApp.Version End Function 错误发生在指定的远程服务器不存在或无法找到。 = CSng 函数 描述 返回表达式，该表达式已被转换为 Single 子类型的 Variant。 语法 CSng(expression) expression 参数是任意有效的表达式。 说明 通常，可以使用子类型转换函数书写代码，以显示某些操作的结果应被表示为特定的数据类型，而不是默认类型。例如，在出现货币或整数运算的情况下，使用 CDbl 或 CSng 强制执行双精度或单精度运算。 CSng 函数用于进行从其他数据类型到 Single 子类型的国际公认的格式转换。例如，对十进制分隔符（如千分符）的识别取决于系统的区域设置。 如果 expression 在 Single 子类型允许的范围之外，则发生错误。 下面的示例利用 CSng 函数把值转换为 Single: - 示例: Dim MyDouble1, MyDouble2, MySingle1, MySingle2 MyDouble1, MyDouble2 是双精度值。 MyDouble1 = 75.3421115: MyDouble2 = 75.3421555 MySingle1 = CSng(MyDouble1) MySingle1 包含 75.34211 。 MySingle2 = CSng(MyDouble2) MySingle2 包含 75.34216 。 = CStr 函数 描述 返回表达式，该表达式已被转换为 String 子类型的 Variant。 语法 CStr(expression) expression 参数是任意有效的表达式。 说明 通常，可以使用子类型转换函数书写代码，以显示某些操作的结果应被表示为特定的数据类型，而不是默认类型。例如，使用 CStr 强制将结果表示为 String。 CStr 函数用于替代 Str 函数来进行从其他数据类型到 String 子类型的国际公认的格式转换。例如对十进制分隔符的识别取决于系统的区域设置。 expression 根据下表决定返回的数据： 如果 expression 为 CStr 返回 Boolean 字符串，包含 True 或 False。 Date 字符串，包含系统的短日期格式日期。 Null 运行时错误。 Empty 零长度字符串 ()。 Error 字符串，包含跟随有错误号码的单词 Error。 其他数值 字符串，包含此数字。 下面的示例利用 CStr 函数把数字转换为 String: - 示例: Dim MyDouble, MyString MyDouble = 437.324 MyDouble 是双精度值。 MyString = CStr(MyDouble) MyString 包含 437.324。按字母顺序排列: D = Date 函数 描述 返回当前系统日期。 语法 Date Remarks 下面的示例利用 Date 函数返回当前系统日期: - 示例: Dim MyDate MyDate = Date MyDate 包含当前系统日期。 = DateAdd 函数 描述 返回已添加指定时间间隔的日期。 语法 DateAdd(interval, number, date) DateAdd 函数的语法有以下部分： 部分 描述 interval 必选。字符串表达式，表示要添加的时间间隔。有关数值，请参阅“设置”部分。 number 必选。数值表达式，表示要添加的时间间隔的个数。数值表达式可以是正数（得到未来的日期）或负数（得到过去的日期）。 date 必选。Variant 或要添加 interval 的表示日期的文字。 设置 interval 参数可以有以下值： 设置 描述 yyyy 年 q 季度 m 月 y 一年的日数 d 日 w 一周的日数 ww 周 h 小时 n 分钟 s 秒 说明 可用 DateAdd 函数从日期中添加或减去指定时间间隔。例如可以使用 DateAdd 从当天算起 30 天以后的日期或从现在算起 45 分钟以后的时间。要向 date 添加以“日”为单位的时间间隔，可以使用“一年的日数”（“y”）、“日”（“d”）或“一周的日数”（“w”）。 DateAdd 函数不会返回无效日期。如下示例将 95 年 1 月 31 日加上一个月： - 示例: NewDate = DateAdd(m, 1, 31-Jan-95) 在这个示例中，DateAdd 返回 95 年 2 月 28 日，而不是 95 年 2 月 31 日。如果 date 为 96 年 1 月 31 日，则返回 96 年 2 月 29 日，这是因为 1996 是闰年。 如果计算的日期是在公元 100 年之前，则会产生错误。 如果 number 不是 Long 型值，则在计算前四舍五入为最接近的整数。 = DateDiff 函数 描述 返回两个日期之间的时间间隔。 语法 DateDiff(interval, date1, date2 ,firstdayofweek, firstweekofyear) DateDiff 函数的语法有以下参数： 参数 描述 interval 必选。String expression 表示用于计算 date1 和 date2 之间的时间间隔。有关数值，请参阅“设置”部分。 date1, date2 必选。日期表达式。用于计算的两个日期。 firstdayofweek 可选。指定星期中第一天的常数。如果没有指定，则默认为星期日。有关数值，请参阅“设置”部分。 firstweekofyear 可选。指定一年中第一周的常数。如果没有指定，则默认为 1 月 1 日所在的星期。有关数值，请参阅“设置”部分。 设置 interval 参数可以有以下值： 设置 描述 yyyy 年 q 季度 n 月 y 一年的日数 d 日 w 一周的日数 ww 周 h 小时 m 分钟 s 秒 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 由 1 月 1 日所在的星期开始（默认）。 vbFirstFourDays 2 由在新年中至少有四天的第一周开始。 vbFirstFullWeek 3 由在新的一年中第一个完整的周开始。 说明 DateDiff 函数用于判断在两个日期之间存在的指定时间间隔的数目。例如可以使用 DateDiff 计算两个日期相差的天数，或者当天到当年最后一天之间的星期数。 要计算 date1 和 date2 相差的天数，可以使用“一年的日数”（“y”）或“日”（“d”）。当 interval 为“一周的日数”（“w”）时，DateDiff 返回两个日期之间的星期数。如果 date1 是星期一，则 DateDiff 计算到 date2 之前星期一的数目。此结果包含 date2 而不包含 date1。如果 interval 是“周”（“ww”），则 DateDiff 函数返回日历表中两个日期之间的星期数。函数计算 date1 和 date2 之间星期日的数目。如果 date2 是星期日，DateDiff 将计算 date2，但即使 date1 是星期日，也不会计算 date1。 如果 date1 晚于 date2，则 DateDiff 函数返回负数。 firstdayofweek 参数会对使用“w”和“ww”间隔符号的计算产生影响。 如果 date1 或 date2 是日期文字，则指定的年度会成为日期的固定部分。但是如果 date1 或 date2 被包括在引号 ( ) 中并且省略年份，则在代码中每次计算 date1 或 date2 表达式时，将插入当前年份。这样就可以编写适用于不同年份的程序代码。 在 interval 为“年”（“yyyy”）时，比较 12 月 31 日和来年的 1 月 1 日，虽然实际上只相差一天，DateDiff 返回 1 表示相差一个年份。 下面的示例利用 DateDiff 函数显示今天与给定日期之间间隔天数: - 示例: Function DiffADate(theDate) DiffADate = 从当天开始的天数: & DateDiff(d, Now, theDate) End Function = DatePart 函数 描述 返回给定日期的指定部分。 语法 DatePart(interval, date, firstdayofweek, firstweekofyear) DatePart 函数的语法有以下参数： 参数 描述 interval 必选。字符串表达式表示要返回的时间间隔。有关数值，请参阅“设置”部分。 date 必选。要计算的日期表达式。 firstdayof week 可选。指定星期中的第一天的常数。如果没有指定，则默认为星期日。有关数值，请参阅“设置”部分。 firstweekofyear 可选。指定一年中第一周的常数。如果没有指定，则默认为 1 月 1 日所在的星期。有关数值，请参阅“设置”部分。 设置 interval 参数可以有以下值： 设置 描述 yyyy 年 q 季度 m 月 y 一年的日数 d 日 w 一周的日数 ww 周 h 小时 n 分钟 s 秒 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 由 1 月 1 日所在的星期开始（默认）。 vbFirstFourDays 2 由在新年中至少有四天的第一周开始。 vbFirstFullWeek 3 由在新的一年中第一个完整的周（不跨年度）开始。 说明 DatePart 函数用于计算日期并返回指定的时间间隔。例如使用 DatePart 计算某一天是星期几或当前的时间。 firstdayofweek 参数会影响使用“w”和“ww”间隔符号的计算。 如果 date 是日期文字，则指定的年度会成为日期的固定部分。但是如果 date 被包含在引号 ( ) 中，并且省略年份，则在代码中每次计算 date 表达式时，将插入当前年份。这样就可以编写适用于不同年份的程序代码。. 下面的示例利用 DatePart 函数获得日期并显示该日所在的季节。 - 示例: Function GetQuarter(TheDate) GetQuarter = DatePart(q, TheDate) End Function = DateSerial 函数 描述 对于指定的年、月、日，返回 Date 子类型的 Variant。 语法 DateSerial(year, month, day) DateSerial 函数的语法有以下参数： 参数 描述 year 从 100 到 9999 之间的数字或数值表达式。 month 任意数值表达式。 day 任意数值表达式。 说明 要指定日期，如 1991 年 12 月 31 日，DateSerial 函数中每个参数的取值范围都应该是可接受的；即日的取值应在 1 和 31 之间，月的取值应在 1 和 12 之间。但是，也可以使用表示某日之前或之后的年、月、日数目的数值