Project 桌面版中的自定义域的项目函数

这些函数用于公式之中以计算自定义域的值。

Project 函数概述

使用 Microsoft Project 时，可能需要处理不直接驻留在域中的值。 使用公式可以处理域以创建这些新值。

以下示例说明了如何使用公式和自定义域：

• 当添加到一个自定义数字域后，以下公式将返回一个数值，用于说明当前日期与日程中任务的完成日期之间的天数：

DateDiff("d",NOW(),[Finish])

• 当添加到自定义文本域后，以下公式将返回值“无比较基准”、“预算超过 20% 或更多”或“在预算范围内”：

  Switch(Len(CStr([Baseline Finish]))<3, "No baseline", ([Cost]+1)/ ([Baseline Cost]+1)>1.2,"Overbudget by 20% or more", ([Cost]+1)/([Baseline Cost]+1)>1, "Overbudget",True,"Under budget")
   The CStr function in the above formula works only if the [Baseline Finish] field is defined.
  

转换函数

Asc

返回一个整数值，该值代表与字符串中第一个字母相对应的字符代码。

语法

Asc( string )

字符串  任何有效的字符串表达式。

CBool

将表达式强制转换为 Boolean 数据类型。

语法

CBool( expression )

表达式  任何有效的字符串或数值表达式。

CByte

将表达式强制转换为 Byte 数据类型。

语法

CByte( expression )

表达式  从 0 到 255 的任何 整数 。

CCur

将表达式强制转换为 Currency 数据类型。

语法

CCur( expression )

表达式  从 -922,337,203,685,477.5808 到 922,337,203,685,477.5807 的任何数值表达式。

CDate

将表达式强制性转换为 Date 数据类型。

语法

CDate( expression )

表达式  任何有效的日期表达式。

CDbl

将表达式强制转换为 Double 数据类型。

语法

CDbl( expression )

表达式  负值从 -1.79769313486232E308 到 -4.94065645841247E-324 的任何数值表达式;正值的 4.94065645841247E-324 到 1.79769313486232E308。

CDec

将表达式强制转换为 Decimal 数据类型。

语法

CDec( expression )

表达式  来自 +/-79,228,162,514,264,337,593,543,950,335 的任何数值表达式，即没有小数位数的数字。 对于具有 28 个小数位数的数字，范围为 +/-7.9228162514264337593543950335。 最小可能的非零数为 0.000000000000000000000000000001。

Chr

返回一个字符串值，该值包含与指定的字符代码关联的字符。

语法

Chr( charcode )

charcode  标识字符的 Long 。

CInt

将表达式强制转换为 Integer 数据类型。

语法

CInt( expression )

表达式  从 -32,768 到 32,767 的任何数值表达式;分数是舍入的。

CLng

将表达式强制转换为 Long 数据类型。

语法

CLng( expression )

表达式  从 -2,147,483,648 到 2,147,483,647 的任何数值表达式;分数是舍入的。

CSng

将表达式强制转换为 Single 数据类型。

语法

CSng( expression )

表达式  负值的任何数值表达式 -3.402823E38 到 -1.401298E-45;正值 1.401298E-45 到 3.402823E38。

CStr

将表达式强制转换为 String 数据类型。

语法

CStr( expression )

表达式  任何有效的字符串或数值表达式。

CVar

将表达式强制转换为 Variant 数据类型。

语法

CVar( expression )

表达式  与数字的 Double 范围相同。 对于非数值，范围与 String 相同。

DateSerial

返回指定年、月和日的 Variant (Date) 类型的值。

语法

DateSerial( year, month, day )

年  必填; 整数。 介于 100 和 9999 之间的数字（含）或数值表达式。

月  必填; 整数。 任何数值表达式。

一天  必填; 整数。 任何数值表达式。

DateValue

返回一个 Variant (Date) 值。

语法

DateValue( date )

日期  必填;通常表示从 100 年 1 月 1 日到 9999 年 12 月 31 日的日期的字符串表达式。 但是， date 也可以是表示该范围内的日期、时间或日期和时间的任何表达式。

Day

返回一个 Variant (Integer) 值，指定介于 1 和 31（包括 1 和 31）之间表示一个月的第几天的整数。

语法

Day( date)

日期  必填;任何 可以表示日期的 Variant、数值表达式、字符串表达式或任何组合。 如果 date 包含 Null，则返回 Null 。

Hex

返回一个字符串 值，该值表示数字的十六进制值。

语法

Hex( number )

数量  必填;任何有效的字符串或数值表达式。

Hour

返回一个 Variant (Integer) 值，该值指定 0 和 23 之间（包括 0 和 23）的整数（表示一天中某个小时）。

语法

Hour( time )

时间  必填;任何 可表示时间的 Variant、数值表达式、字符串表达式或任何组合。 如果 time 包含 Null，则返回 Null 。

Minute

返回一个 Variant (Integer) 值，指定一个介于 0 和 59 之间（包括 0 和 59）的整数，表示小时的分钟数。

语法

Minute( time )

时间  必填;任何 可表示时间的 Variant、数值表达式、字符串表达式或任何组合。 如果 time 包含 Null，则返回 Null 。

Month

返回一个 Variant (Integer) 值，指定介于 1 和 12 之间（包括 1 和 12）的整数，表示一年中的某一月份。

语法

Month( date)

日期  必填;任何 可表示时间的 Variant、数值表达式、字符串表达式或任何组合。 如果 date 包含 Null，则返回 Null 。

Oct

返回一个 Variant (String) 值，表示数字的八进制值。

语法

Oct( number )

数量  必填;任何有效的字符串或数值表达式。

ProjDateConv

将某个值转换成日期。

语法

ProjDateConv( expression, dateformat )

表达式  必填; Variant。 要转换为日期的表达式。

dateformat  选; Long。 日期格式默认值为 pjDateDefault，但可以替换以下 pjDateFormat 常量之一， (日期格式应用的日期格式 9/25/07 中午 12：33 ) ：

• pjDateDefault：默认格式。 在“选项”对话框（“工具”菜单）中的“视图”选项卡上设置。

• pjDate_mm_dd_yy_hh_mmAM: 9/25/07 12:33 PM

• pjDate_mm_dd_yy: 9/25/07

• pjDate_mm_dd_yyyy: 9/25/2007

• pjDate_mmmm_dd_yyyy_hh_mmAM: September 25, 2007 12:33 PM

• pjDate_mmmm_dd_yyyy: September 25, 2007

• pjDate_mmm_dd_hh_mmAM: Sep 25 12:33 PM

• pjDate_mmm_dd_yyy: Sep 25, '07

• pjDate_mmmm_dd: September 25

• pjDate_mmm_dd: Sep 25

• pjDate_ddd_mm_dd_yy_hh_mmAM: Tue 9/25/07 12:33 PM

• pjDate_ddd_mm_dd_yy: Tue 9/25/07

• pjDate_ddd_mmm_dd_yyy: Tue Sep 25, '07

• pjDate_ddd_hh_mmAM: Tue 12:33 PM

• pjDate_mm_dd: 9/25

• pjDate_dd: 25

• pjDate_hh_mmAM: 12:33 PM

• pjDate_ddd_mmm_dd: Tue Sep 25

• pjDate_ddd_mm_dd: Tue 9/25

• pjDate_ddd_dd: Tue 25

• pjDate_Www_dd: W40/2

• pjDate_Www_dd_yy_hh_mmAM: W40/2/07 12:33 PM

ProjDurConv

以指定的单位将某个表达式转换成工期值。

语法

ProjDurConv( expression, durationunits )

表达式  必填; Variant。 要转换为持续时间的表达式。

durationunits  选; Long。 用于表示持续时间的单位。 如果未指定 durationunits，则默认值为“选项”对话框的“计划”选项卡上的“工期输入”选项中指定的单位类型， (“工具”菜单) 。 durationunits 可以是以下 pjFormatUnit 常量之一：

• pjMinutes: pjElapsedMinutes

• pjHours: pjElapsedHours

• pjDays: pjElapsedDays

• pjWeeks: pjElapsedWeeks

• pjMonths: pjElapsedMonths

• pjMinutesEstimated: pjElapsedMinutesEstimated

• pjHoursEstimated: pjElapsedHoursEstimated

• pjDaysEstimated: pjElapsedDaysEstimated

• pjWeeksEstimated: pjElapsedWeeksEstimated

• pjMonthsEstimated: pjElapsedMonthsEstimated

Second

返回一个 Variant (Integer) 值，指定一个介于 0 到 59 之间（包括 0 和 59）的整数，表示分钟的秒数。

语法

Second( time )

时间  必填;任何 可表示时间的 Variant、数值表达式、字符串表达式或任何组合。 如果 time 包含 Null，则返回 Null 。

Str

返回数字的 Variant (String) 表示形式。

语法

Str( number )

数量  必填; 包含 任何有效数值表达式的 Long。

StrConv

返回一个按照指定方式转换的 Variant (String) 值。

语法

StrConv( string, conversion, LCID )

字符串  必填;要转换的字符串表达式。

转换  必填; 整数。 指定要执行的转换类型的值之和。

<c0>LCID</c0>  可选，LocaleID（如果不同于系统 LocaleID）。  （系统 LocaleID 是默认值。 )

TimeSerial

返回一个 Variant (Date) 值，其中包含具体的时间（时、分、秒）。

语法

TimeSerial( hour, minute, second )

小时  必填; Variant (Integer) 。 介于 0 (12：00 ) 到 23 (晚上 11：00 之间的数字 ) （含）或数值表达式。

分钟  必填; Variant (Integer) 。 任何数值表达式。

第二  必填; Variant (Integer) 。 任何数值表达式。

TimeValue

返回一个包含时间的 Variant (Date) 值。

语法

TimeValue( time)

时间  必填;通常表示从 0：00：00 (12：00：00 ) 到 23：59：59 (下午 11：59：59（含）) 的字符串表达式（含）。 但是， 时间 也可以是表示该范围内的时间的任何表达式。 如果 time 包含 Null，则返回 Null 。

Val

返回作为适当类型的数值的字符串中包含的数字。

语法

Val( string )

字符串  必填;任何有效的字符串表达式。

Weekday

返回一个 Variant (Integer) 值，其中包含表示星期几的整数。

语法

Weekday( date[, firstdayofweek] )

日期  必填; 变量、数值表达式、任意组合的字符串表达式，可以表示日期。 如果 date 包含 Null，则返回 Null 。

firstdayofweek  选;一个指定一周的第一天的常量。 如果未指定，则假定为星期日。

Year

返回一个 Variant (Integer) 值，其中包含表示年份的整数。

语法

Year( date )

日期  必填;任何 可以表示日期的 Variant、数值表达式、字符串表达式或任何组合。 如果 date 包含 Null，则返回 Null 。

日期/时间函数

CDate

将表达式强制性转换为 Date 数据类型。

语法

CDate( expression )

表达式  任何有效的日期表达式。

Date

返回一个包含当前系统日期的 Variant (Date) 值。

语法

Date

DateAdd

返回一个 Variant (Date) 值，其中包含已添加了指定时间间隔的日期。

语法

DateAdd( interval, number, date )

interval  必填;要添加的时间间隔的字符串表达式，例如“m”或“d”。

数量  必填;要添加的间隔数的 numeric 表达式。 获取未来) 的日期可以是正 (，也可以是负 (来获取过去) 的日期。

日期  必填; 变量 (日期) 或文本，表示将间隔添加到的日期。

DateDiff

返回一个 Variant (Long) 值，指定两个指定的日期之间的时间间隔数。

语法

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

interval  必填;字符串表达式，它是用于计算 date1 和 date2 之间的差值的时间间隔。

date1、date2  必填; 变量 (日期) 。 要在计算中使用的两个日期。

firstdayofweek  选;一个指定一周的第一天的常量。 如果未指定，则假定为星期日。

firstweekofyear  选;一个指定一年的第一周的常量。 如果未指定，则假定第一周是 1 月 1 日发生的周。

DatePart

返回一个 Variant (Integer) 值，其中包含给定日期的指定部分。

语法

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

interval  必填;字符串表达式，它是要返回的时间间隔。

日期  必填; 变量 (日期) 要计算的值。

firstdayofweek  选;一个指定一周的第一天的常量。 如果未指定，则假定为星期日。

firstweekofyear  选;一个指定一年的第一周的常量。 如果未指定，则假定第一周是在 1 月 1 日发生的那一周。

DateSerial

返回指定年、月和日的 Variant (Date) 类型的值。

语法

DateSerial( year, month, day )

年  必填; 整数。 介于 100 和 9999 之间的数字（含）或数值表达式。

月  必填; 整数。 任何数值表达式。

一天  必填; 整数。 任何数值表达式。

DateValue

返回一个 Variant (Date) 值。

语法

DateValue( date)

日期  必填;通常表示从 100 年 1 月 1 日到 9999 年 12 月 31 日的日期的字符串表达式。 但是， date 也可以是表示该范围内的日期、时间或日期和时间的任何表达式。

Day

返回一个 Variant (Integer) 值，指定介于 1 和 31（包括 1 和 31）之间表示一个月的第几天的整数。

语法

Day( date)

日期  必填;任何 可以表示日期的 Variant、数值表达式、字符串表达式或任何组合。 如果 date 包含 Null，则返回 Null 。

Hour

返回一个 Variant (Integer) 值，该值指定 0 和 23 之间（包括 0 和 23）的整数（表示一天中某个小时）。

语法

Hour( time )

时间  必填;任何 可表示时间的 Variant、数值表达式、字符串表达式或任何组合。 如果 time 包含 Null，则返回 Null 。

IsDate

返回一个 Boolean 值，指示表达式是否可以转换为日期。

语法

IsDate( expression )

表达式  必填;包含可识别为日期或时间的日期表达式或字符串表达式的任何 Variant 。

Minute

返回一个 Variant (Integer) 值，指定一个介于 0 和 59 之间（包括 0 和 59）的整数，表示小时的分钟数。

语法

Minute( time)

时间  必填;任何 可表示时间的 Variant、数值表达式、字符串表达式或任何组合。 如果 time 包含 Null，则返回 Null 。

Month

返回一个 Variant (Integer) 值，指定介于 1 和 12 之间（包括 1 和 12）的整数，表示一年中的某一月份。

语法

Month( date)

日期  必填;任何 可表示时间的 Variant、数值表达式、字符串表达式或任何组合。 如果 date 包含 Null，则返回 Null 。

Now

返回一个 Variant (Date) 值，根据计算机的系统日期和时间指定当前的日期和时间。

语法

Now

ProjDateAdd

在某个日期上增加一段工期，并返回一个新日期。

语法

ProjDateAdd( date, duration, calendar )

日期  必填; Variant。 将 持续时间 添加到的原始日期。

工期  必填; Variant。 要添加到 日期的持续时间。

日历  选; 字符串。 计算新日期时要使用的日历。 如果未指定 日历 ，则当前资源的默认值为资源日历;如果没有任务日历，则为当前任务、任务日历或标准日历。 对于 Project Server，将使用标准日历，而不管日历字符串中指定了哪个 日历 。 在 Project Web App 中创建的公式中使用此函数并将其与 Project Professional 中创建的相同公式进行比较时，应进行测试以确保结果符合预期。

ProjDateConv

将某个值转换成日期。

语法

ProjDateConv( expression, dateformat )

表达式  必填; Variant。 要转换为日期的表达式。

dateformat  选; Long。 日期格式默认值为 pjDateDefault，但您可以替换以下 pjDateFormat 常量之一， (日期格式应用的日期格式 9/25/07 中午 12：33 ) ：

• pjDateDefault：默认格式。 在“选项”对话框（“工具”菜单）中的“视图”选项卡上设置。

• pjDate_mm_dd_yy_hh_mmAM: 9/25/07 12:33 PM

• pjDate_mm_dd_yy: 9/25/07

• pjDate_mm_dd_yyyy: 9/25/2007

• pjDate_mmmm_dd_yyyy_hh_mmAM: September 25, 2007 12:33 PM

• pjDate_mmmm_dd_yyyy: September 25, 2007

• pjDate_mmm_dd_hh_mmAM: Sep 25 12:33 PM

• pjDate_mmm_dd_yyy: Sep 25, '07

• pjDate_mmmm_dd: September 25

• pjDate_mmm_dd: Sep 25

• pjDate_ddd_mm_dd_yy_hh_mmAM: Tue 9/25/07 12:33 PM

• pjDate_ddd_mm_dd_yy: Tue 9/25/03

• pjDate_ddd_mmm_dd_yyy: Tue Sep 25, '07

• pjDate_ddd_hh_mmAM: Tue 12:33 PM

• pjDate_mm_dd: 9/25

• pjDate_dd: 25

• pjDate_hh_mmAM: 12:33 PM

• pjDate_ddd_mmm_dd: Tue Sep 25

• pjDate_ddd_mm_dd: Tue 9/25

• pjDate_ddd_dd: Tue 25

• pjDate_Www_dd: W40/2

• pjDate_Www_dd_yy_hh_mmAM: W40/2/07 12:33 PM

ProjDateDiff

以分钟为单位，返回两个日期间的工期。

语法

ProjDateDiff( date1, date2, calendar )

date1  必填; Variant。 用作持续时间开始的日期。

date2  必填; Variant。 用作持续时间结束的日期。

日历  选; 字符串。 计算工期时要使用的日历。 如果未指定 日历 ，则当前资源的默认值为资源日历，或者对于当前任务、任务日历 (或标准日历（如果没有适用于 Project Server 的任务日历），则无论日历字符串中指定了哪个日历，都将使用标准 日历 。 在 Project Web App 中创建的公式中使用此函数并将其与 Project Professional 中创建的相同公式进行比较时，应进行测试以确保结果符合预期。

ProjDateSub

返回相对于某个日期的指定工期前的日期。

语法

ProjDateSub( date, duration, calendar )

日期  必填; Variant。 从中减去 持续时间 的原始日期。

工期  必填; Variant。 要从 日期中减去的持续时间。

日历  选; 字符串。 计算日期差时要使用的日历。 如果未指定 日历 ，则当前资源的默认值为资源日历;对于当前任务，任务日历 (;如果没有任务日历) ，则为标准日历。 对于 Project Server，将使用标准日历，而不管日历字符串中指定了哪个 日历 。 在 Project Web App 中创建的公式中使用此函数并将其与 Project Professional 中创建的相同公式进行比较时，应进行测试以确保结果符合预期。

ProjDateValue

返回某个表达式的日期值。

语法

ProjDateValue( expression )

表达式  必填; Variant。 要表示为日期的表达式。

ProjDurConv

以指定的单位将某个表达式转换成工期值。

语法

ProjDurConv( expression, durationunits )

表达式  必填; Variant。 要转换为持续时间的表达式。

durationunits  选; Long。 用于表示持续时间的单位。 如果未指定 durationunits，则默认值为“选项”对话框的“计划”选项卡上的“工期输入”选项中指定的单位类型， (“工具”菜单) 。 durationunits 可以是以下 pjFormatUnit 常量之一：

• pjMinutes: pjElapsedMinutes

• pjHours: pjElapsedHours

• pjDays: pjElapsedDays

• pjWeeks: pjElapsedWeeks

• pjMonths: pjElapsedMonths

• pjMinutesEstimated: pjElapsedMinutesEstimated

• pjHoursEstimated: pjElapsedHoursEstimated

• pjDaysEstimated: pjElapsedDaysEstimated

• pjWeeksEstimated: pjElapsedWeeksEstimated

• pjMonthsEstimated: pjElapsedMonthsEstimated

ProjDurValue

返回工期的分钟数。

语法

ProjDurValue( duration )

工期  必填; Variant。 要以分钟为单位表示的持续时间。

Second

返回一个 Variant (Integer) 值，指定一个介于 0 到 59 之间（包括 0 和 59）的整数，表示分钟的秒数。

语法

Second( time )

时间  必填;任何 可表示时间的 Variant、数值表达式、字符串表达式或任何组合。 如果 time 包含 Null，则返回 Null 。

Time

返回一个 Variant (Date) 值，指示当前的系统时间。

语法

Time

Timer

返回一个 Single 值，表示自午夜后经过的秒数。

语法

Timer

TimeSerial

返回一个 Variant (Date) 值，其中包含具体的时间（时、分、秒）。

语法

TimeSerial( hour, minute, second)

小时  必填; Variant (Integer) 。 介于 0 (12：00 ) 到 23 (晚上 11：00 之间的数字 ) （含）或数值表达式。

分钟  必填; Variant (Integer) 。 任何数值表达式。

第二  必填; Variant (Integer) 。 任何数值表达式。

TimeValue

返回一个包含时间的 Variant (Date) 值。

语法

TimeValue( time)

时间  必填;通常表示从 0：00：00 (12：00：00 ) 到 23：59：59 (下午 11：59：59（含）) 的字符串表达式（含）。 但是， 时间 也可以是表示该范围内的时间的任何表达式。 如果 time 包含 Null，则返回 Null 。

Weekday

返回一个 Variant (Integer) 值，其中包含表示星期几的整数。

语法

Weekday( date[, firstdayofweek] )

日期  必填; 变量、数值表达式、任意组合的字符串表达式，可以表示日期。 如果 date 包含 Null，则返回 Null 。

firstdayofweek  选;一个指定一周的第一天的常量。 如果未指定，则假定为星期日。

Year

返回一个 Variant (Integer) 值，其中包含表示年份的整数。

语法

Year( date)

日期  必填;任何 可以表示日期的 Variant、数值表达式、字符串表达式或任何组合。 如果 date 包含 Null，则返回 Null 。

常规函数

Choose

从参数列表中选择并返回值。

语法

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

索引  必填;数值表达式或字段，其结果为 1 和可用选项数之间的值。

选择  必填;包含其中一个可能选项的 变体 表达式。

IIf

返回两部分之一，具体取决于表达式的计算结果。

语法

IIf( expr, truepart, falsepart )

expr  必填;要计算的 变量 表达式。

truepart  必填;如果相应的表达式为 True，则返回的值或表达式。

falsepart  必填;如果相应的表达式为False，则返回的值或表达式。

IsNumeric

返回一个 Boolean 值，表示表达式是否可以作为数字进行计算。

语法

IsNumeric( expression)

表达式  必填;包含数值表达式或字符串表达式的 变体 。

IsNull

返回一个 Boolean 值，表示表达式是否包含无效数据 (Null)。

语法

IsNull( expression )

表达式  必填;包含数值表达式或字符串表达式的 变体 。

Switch

对表达式列表求值，并返回一个 Variant 类型的值或与列表中第一个为 True 的表达式相关联的表达式。

语法

Switch( expr-1, value-1[, expr-2, value-2, ... [, expr-n,value-n]] )

数学函数

Abs

返回传递给它的相同类型的值，用于指定数字的绝对值。

语法

Abs( number )

数量  必填;任何有效的数值表达式。 如果 number 包含 Null，则返回 Null ;如果它是未初始化的变量，则返回零。

Atn

返回一个 Double 值，指定数字的反正切值。

语法

Atn( number )

数量  必填; Double 或任何有效的数值表达式。

Cos

返回一个 Double 值，指定角度的余弦。

语法

Cos( number )

数量  必填; 双精度 值或任何以弧度表示角度的有效数值表达式。

Exp

返回一个 Double 值，指定 e（自然对数的底）的幂。

语法

Exp( number )

数量  必填; Double 或任何有效的数值表达式。

Fix

返回数字的整数部分。 如果 number 为负数，则返回大于或等于 number 的第一个负整数。

语法

Fix( number )

数量  必填; Double 或任何有效的数值表达式。 如果 number 包含 Null，则返回 Null 。

Int

返回数字的整数部分。 如果 number 为负数，则返回小于或等于 number 的第一个负整数。

语法

Int( number )

数量  必填; Double 或任何有效的数值表达式。 如果 number 包含 Null，则返回 Null 。

Log

返回一个 Double 值，指定数值的自然对数。

语法

Log( number )

数量  必填; 双精度 值或任何大于零的有效数值表达式。

Rnd

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

语法

Rnd( number )

数量  必填; 单个 或任何有效的数值表达式。

Sgn

返回一个指示数字的符号的 Variant (Integer) 值。

语法

Sgn( number )

数量  必填;任何有效的数值表达式。

返回下列值：

• 如果数值大于零，Sgn 返回 1。

• 如果数值等于零，Sgn 返回 0。

• 如果数值小于零，Sgn 返回 -1。

Sin

返回一个 Double 值，指定角的正弦值。

语法

Sin( number )

数量  必填; 双精度 值或任何以弧度表示角度的有效数值表达式。

Sqr

返回一个 Double 值，指定数字的平方根。

语法

Sqr( number )

数量  必填; Double 或等于或大于零的任何有效数值表达式。

Tan

返回一个 Double 值，指定角的正切值。

语法

Tan( number )

数量  必填; 双精度 值或任何以弧度表示角度的有效数值表达式。

文本函数

Asc

返回一个整数值，该值代表与字符串中第一个字母相对应的字符代码。

语法

Asc( string )

字符串  任何有效的字符串表达式。

Chr

返回一个字符串值，该值包含与指定的字符代码关联的字符。

语法

Chr( charcode )

charcode  标识字符的 Long 。

Format

返回一个 Variant (String) 值，其中包含根据格式表达式中所包含的指令设置格式的表达式。

语法

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

表达式  必填;任何有效表达式。

格式  选;有效的命名或用户定义的格式表达式。

firstdayofweek  选;一个 指定一周的第一天的 常量 。

firstweekofyear  选;指定一年的第一周的 常量 。

Instr

返回一个 Variant (Long) 值，指定一个字符串在另一个字符串中首次出现的位置。

语法

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

开始  选;用于设置每个搜索的起始位置的 numeric 表达式。 如果省略，则搜索从第一个字符位置开始。 如果 start 包含 Null，则会发生错误。 如果指定了比较，则需要 start 参数。

string1  必填;正在搜索的字符串表达式。

string2  必填;所寻求的字符串表达式。

比较  选;指定字符串比较的类型。 如果 compare 为 Null，则会发生错误。 如果省略 比较 ，“ 选项比较 ”设置将确定比较的类型。

LCase

返回一个已经转换为小写的 String 值。

语法

LCase( string )

字符串   必填;任何有效的字符串表达式。 如果 string 包含 Null，将返回 Null。

Left

返回一个 Variant (String) 值，其中包含从字符串左侧算起指定数量的字符。

语法

Left( string, length )

字符串  必需。 从中返回最左侧字符的字符串表达式。 如果 string 包含 Null，将返回 Null。

长度  必填; 变量 (长) 。 指示要返回的字符数的数值表达式。 如果为 0，则返回零长度字符串 (“”) 。 如果大于或等于 字符串中的字符数，则返回整个字符串。

Len

返回一个 Long 的值，包含字符串中的字符数或存储变量所需的字节数。

语法

Len( string, varname )

字符串  任何有效的字符串表达式。 如果 string 包含 Null，将返回 Null。

varname  任何有效的变量名称。 如果 varname 包含 Null，则返回 Null 。 如果 varname 是 Variant， 则 Len 将其视为 字符串 ，并始终返回它包含的字符数。

LTrim

返回一个 Variant (String) 值，包含指定字符串的副本，不包含前导空格。

语法

LTrim( string )

字符串  必填;任何有效的字符串表达式。 如果 string 包含 Null，将返回 Null。

Mid

返回一个 Variant (String) 值，其中包含字符串中指定数量的字符。

语法

Mid( string, start[, length] )

字符串  必填;从中返回字符的字符串表达式。 如果 string 包含 Null，将返回 Null。

开始  必填; Long。 要获取的部件开始的 字符串 中的字符位置。 如果 start 大于 字符串中的字符数， 则 Mid 返回长度为零的字符串 (“”) 。

长度  选; 变量 (长) 。 要返回的字符数。 如果省略或文本中 长度 少于字符 (包含 开头) 字符，则返回从 字符串的开始 位置到结束的所有字符。

Right

返回一个 Variant (String) 值，其中包含从字符串右侧算起指定数量的字符。

语法

Right( string, length )

<c0>string</c0>  必需。  字符串表达式，将返回其最右边的字符。 如果 string 包含 Null，将返回 Null。

长度  必填; 变量 (长) 。 指示要返回的字符数的数值表达式。 如果为 0，则返回零长度字符串 (“”) 。 如果等于或大于 字符串中的字符数，则返回整个字符串。

RTrim

返回一个 Variant (String) 值，包含指定字符串的副本，不包含尾随空格。

语法

RTrim( string )

字符串  必填;任何有效的字符串表达式。 如果 string 包含 Null，将返回 Null。

Space

返回一个包含指定空格数的 Variant (String) 值。

语法

Space( number )

数量  必填;字符串中所需的空格数。

StrComp

返回一个 Variant (Integer) 值，指示字符串比较的结果。

语法

StrComp( string1, string2[, compare] )

string1  必填;任何有效的字符串表达式。

string2  必填;任何有效的字符串表达式。

比较  选;指定字符串比较的类型。 如果 比较 参数为 Null，则会发生错误。

StrConv

返回一个按照指定方式转换的 Variant (String) 值。

语法

StrConv( string, conversion, LCID )

字符串  必填;要转换的字符串表达式。

转换  必填; 整数。 指定要执行的转换类型的值之和。

<c0>LCID</c0>  可选，LocaleID（如果不同于系统 LocaleID）。  （系统 LocaleID 是默认值。 )

String

返回一个 Variant (String) 值，其中包含指定长度的重复字符串。

语法

String( number, character )

数量  必填; Long。 返回字符串的长度。 如果 number 包含 Null，则返回 Null 。

字符  必填; Variant。 指定其第一个字符用于生成返回字符串的字符或字符串表达式的字符代码。 如果 字符 包含 Null，则返回 Null 。

Trim

返回一个 Variant (String) 值，包含指定字符串的副本，不包含前导空格或尾随空格。

语法

Trim( string )

字符串  必填;任何有效的字符串表达式。 如果 string 包含 Null，将返回 Null。

UCase

返回一个包含指定字符串（已转换为大写形式）的 Variant (String) 值。

语法

UCase( string )

字符串  必填;任何有效的字符串表达式。 如果 string 包含 Null，将返回 Null。