通过

Excel.Functions class

  • 参考
包:
excel

用于评估 Excel 函数的对象。

扩展
OfficeExtension.ClientObject

注解

[ API 集：ExcelApi 1.2 ]

示例

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/50-workbook/workbook-built-in-functions.yaml

await Excel.run(async (context) => {
  // This function uses VLOOKUP to find data in the "Wrench" row on the worksheet. 
  let range = context.workbook.worksheets.getItem("Sample").getRange("A1:D4");

  // Get the value in the second column in the "Wrench" row.
  let unitSoldInNov = context.workbook.functions.vlookup("Wrench", range, 2, false);
  unitSoldInNov.load("value");

  await context.sync();
  console.log(" Number of wrenches sold in November = " + unitSoldInNov.value);
});

属性

context

与 对象关联的请求上下文。 这会将加载项的进程连接到 Office 主机应用程序的进程。

方法

abs(number)

返回一个数字的绝对值，一个没有其符号的数字。
accrInt(issue, firstInterest, settlement, rate, par, frequency, basis, calcMethod)

返回定期付息有价证券的应计利息。
accrIntM(issue, settlement, rate, par, basis)

返回到期一次性付息有价证券的应计利息。
acos(number)

返回数字的反正弦值，以弧度为单位，范围为 0 到 Pi。 反余弦值是余弦为数字的角度。
acosh(number)

返回数字的反双曲余弦值。
acot(number)

返回数字的反正切值，以弧度为单位，范围为 0 到 Pi。
acoth(number)

返回数字的反双曲余切值。
amorDegrc(cost, datePurchased, firstPeriod, salvage, period, rate, basis)

返回每个会计期间资产的按比例计算的线性折旧。
amorLinc(cost, datePurchased, firstPeriod, salvage, period, rate, basis)

返回每个会计期间资产的按比例计算的线性折旧。
and(values)

检查所有参数是否为 TRUE，如果所有参数均为 TRUE，则返回 TRUE。
arabic(text)

将罗马数字转换为阿拉伯语。
areas(reference)

返回引用中的区域数。 区域是连续单元格或单个单元格的区域。
asc(text)

将全角 (双字节) 字符更改为半角 (单字节) 字符。 与 DBCS) (双字节字符集一起使用。
asin(number)

返回以弧度为单位的数字的反正弦值，范围为 -Pi/2 到 Pi/2。
asinh(number)

返回数字的反双曲正弦值。
atan(number)

返回以弧度为单位的数字的反正切值，范围为 -Pi/2 到 Pi/2。
atan2(xNum, yNum)

返回指定 x 和 y 坐标的反正切值，以 -Pi 和 Pi 之间的弧度表示，不包括 -Pi。
atanh(number)

返回数字的反双曲正切值。
aveDev(values)

返回多个数据点与其平均值的绝对偏差的平均值。 参数可以是包含数字的数字或名称、数组或引用。
average(values)

返回其参数的平均 (算术平均值) ，可以是包含数字的数字或名称、数组或引用。
averageA(values)

返回其参数的平均 (算术平均值) ，并将参数中的文本和 FALSE 计算为 0;TRUE 的计算结果为 1。 参数可以是数字、名称、数组或引用。
averageIf(range, criteria, averageRange)

查找由给定条件或条件指定的单元格的平均 (算术平均值) 。
averageIfs(averageRange, values)

查找由一组给定条件或条件指定的单元格的平均 (算术平均值) 。
bahtText(number)

将数字转换为文本 (泰铢) 。
base(number, radix, minLength)

将数字转换为具有给定基数 (基) 的文本表示形式。
besselI(x, n)

返回修改后的 Bessel 函数 In (x) 。
besselJ(x, n)

返回 Bessel 函数 Jn (x) 。
besselK(x, n)

返回修改的 Bessel 函数 Kn (x) 。
besselY(x, n)

返回贝塞尔函数 Yn (x) 。
beta_Dist(x, alpha, beta, cumulative, A, B)

返回 beta 概率分布函数。
beta_Inv(probability, alpha, beta, A, B)

返回累积 beta 概率密度函数 (BETA 的反函数。DIST) 。
bin2Dec(number)

将二进制数转换为十进制数。
bin2Hex(number, places)

将二进制数转换为十六进制数。
bin2Oct(number, places)

将二进制数转换为八进制数。
binom_Dist_Range(trials, probabilityS, numberS, numberS2)

使用二项式分布返回试验结果的概率。
binom_Dist(numberS, trials, probabilityS, cumulative)

返回一元二项式分布的概率。
binom_Inv(trials, probabilityS, alpha)

返回使累积二项式分布大于或等于临界值的最小值。
bitand(number1, number2)

返回两个数字的按位“And”。
bitlshift(number, shiftAmount)

返回由shift_amount位向左移动的数字。
bitor(number1, number2)

返回两个数字的按位“Or”。
bitrshift(number, shiftAmount)

返回由shift_amount位向右移动的数字。
bitxor(number1, number2)

返回两个数字的按位“独占 Or”。
ceiling_Math(number, significance, mode)

将数字向上舍入为最接近的整数或最接近的显著性倍数。
ceiling_Precise(number, significance)

将数字向上舍入为最接近的整数或最接近的显著性倍数。
char(number)

从计算机的字符集中返回由代码号指定的字符。
chiSq_Dist_RT(x, degFreedom)

返回 χ2 分布的右尾概率。
chiSq_Dist(x, degFreedom, cumulative)

返回卡方分布的左尾概率。
chiSq_Inv_RT(probability, degFreedom)

返回 χ2 分布的右尾概率的反函数。
chiSq_Inv(probability, degFreedom)

返回 χ2 分布的左尾概率的反函数。
choose(indexNum, values)

根据索引号从值列表中选择要执行的值或操作。
clean(text)

删除文本中的所有非打印字符。
code(text)

返回计算机使用的字符集中文本字符串中第一个字符的数字代码。
columns(array)

返回数组或引用中的列数。
combin(number, numberChosen)

返回从给定的项目数中提取若干项目的组合数。
combina(number, numberChosen)

返回给定数量项的重复的组合数。
complex(realNum, iNum, suffix)

将实系数和虚系数转换为复数。
concatenate(values)

将多个文本字符串联接到一个文本字符串中。
confidence_Norm(alpha, standardDev, size)

使用正态分布返回总体平均值的置信区间。
confidence_T(alpha, standardDev, size)

使用学生的 T 分布返回总体平均值的置信区间。
convert(number, fromUnit, toUnit)

将数字从一个度量系统转换为另一个度量系统。
cos(number)

返回角度的余弦值。
cosh(number)

返回数字的双曲余弦值。
cot(number)

返回角度的余切值。
coth(number)

返回数字的双曲余切值。
count(values)

计算区域中包含数字的单元格数。
countA(values)

计算区域中不为空的单元格数。
countBlank(range)

计算指定单元格区域中空单元格的数目。
countIf(range, criteria)

计算区域中满足给定条件的单元格数。
countIfs(values)

计算由一组给定条件或条件指定的单元格数。
coupDayBs(settlement, maturity, frequency, basis)

返回从息票期开始到结算日的天数。
coupDays(settlement, maturity, frequency, basis)

返回结算日所在的息票期的天数。
coupDaysNc(settlement, maturity, frequency, basis)

返回从结算日到下一个息票日之间的天数。
coupNcd(settlement, maturity, frequency, basis)

返回结算日之后的下一个优惠券日期。
coupNum(settlement, maturity, frequency, basis)

返回结算日和到期日之间应付的息票数。
coupPcd(settlement, maturity, frequency, basis)

返回结算日之前的优惠券日期。
csc(number)

返回角度的余割值。
csch(number)

返回角度的双曲余割值。
cumIPmt(rate, nper, pv, startPeriod, endPeriod, type)

返回两个期间之间已支付的累计利息。
cumPrinc(rate, nper, pv, startPeriod, endPeriod, type)

返回两个期间之间对贷款支付的累计本金。
date(year, month, day)

返回表示 Excel 日期时间代码中Microsoft日期的数字。
datevalue(dateText)

将文本格式的日期转换为一个数字，该数字表示Microsoft Excel 日期时间代码中的日期。
daverage(database, field, criteria)

平均列表或数据库中与指定的条件匹配的列中的值。
day(serialNumber)

返回月份中的某一天，一个介于 1 到 31 的数字。
days(endDate, startDate)

返回两个日期之间的天数。
days360(startDate, endDate, method)

返回基于 360 天的年份 (12 个 30 天月) 的两个日期之间的天数。
db(cost, salvage, life, period, month)

使用固定余额递减法返回指定周期内某项资产的折旧值。
dbcs(text)

将字符串中的半角 (单字节) 字符更改为全角 (双字节) 字符。 与 DBCS) (双字节字符集一起使用。
dcount(database, field, criteria)

对数据库中与指定条件匹配的记录的字段 (列) 包含数字的单元格进行计数。
dcountA(database, field, criteria)

对字段中与指定条件匹配的记录 (列) 的非空单元格进行计数。
ddb(cost, salvage, life, period, factor)

使用双倍余额递减法或其他指定方法返回某项资产在指定周期内的折旧值。
dec2Bin(number, places)

将十进制数转换为二进制数。
dec2Hex(number, places)

将十进制数转换为十六进制数。
dec2Oct(number, places)

将十进制数转换为八进制数。
decimal(number, radix)

将给定基数中的数字的文本表示形式转换为十进制数。
degrees(angle)

将弧度转换为度。
delta(number1, number2)

测试两个数字是否相等。
devSq(values)

返回数据点与其样本平均值的偏差的平方和。
dget(database, field, criteria)

从数据库中提取与指定条件匹配的单个记录。
disc(settlement, maturity, pr, redemption, basis)

返回债券的贴现率。
dmax(database, field, criteria)

返回字段中与指定条件匹配的记录 (列) 的最大数字。
dmin(database, field, criteria)

返回字段中 (列) 与指定条件匹配的记录的最小数字。
dollar(number, decimals)

使用货币格式将数字转换为文本。
dollarDe(fractionalDollar, fraction)

将以小数表示的美元价格转换为以小数表示的美元价格。
dollarFr(decimalDollar, fraction)

将以小数表示的美元价格转换为以小数表示的美元价格。
dproduct(database, field, criteria)

将字段中的值相乘 (列) 数据库中与指定条件匹配的记录。
dstDev(database, field, criteria)

根据所选数据库条目中的样本估计标准偏差。
dstDevP(database, field, criteria)

根据所选数据库条目的整个总体计算标准偏差。
dsum(database, field, criteria)

) 数据库中与指定条件匹配的记录 (列中的数字相加。
duration(settlement, maturity, coupon, yld, frequency, basis)

返回定期支付利息的证券的年度持续时间。
dvar(database, field, criteria)

根据所选数据库条目中的样本估计方差。
dvarP(database, field, criteria)

根据所选数据库条目的整个总体计算方差。
ecma_Ceiling(number, significance)

将数字向上舍入为最接近的整数或最接近的显著性倍数。
edate(startDate, months)

返回日期的序列号，即在开始日期之前或之后的指示月份数。
effect(nominalRate, npery)

返回有效的年利率。
eoMonth(startDate, months)

返回指定月份数之前或之后的月份最后一天的序列号。
erf_Precise(X)

返回 error 函数。
erf(lowerLimit, upperLimit)

返回 error 函数。
erfC_Precise(X)

返回互补错误函数。
erfC(x)

返回互补错误函数。
error_Type(errorVal)

返回与错误值匹配的数字。
even(number)

将正数向上舍入，将负数向下舍入到最接近的偶数整数。
exact(text1, text2)

检查两个文本字符串是否完全相同，并返回 TRUE 或 FALSE。 EXACT 区分大小写。
exp(number)

返回将 e 提升到给定数字的幂。
expon_Dist(x, lambda, cumulative)

返回指数分布。
f_Dist_RT(x, degFreedom1, degFreedom2)

返回两个数据集的 (右尾) F 概率分布 (多样性程度) 。
f_Dist(x, degFreedom1, degFreedom2, cumulative)

返回两个数据集的 (左尾) F 概率分布 (多样性) 。
f_Inv_RT(probability, degFreedom1, degFreedom2)

返回 (右尾) F 概率分布的反值：如果 p = F.DIST。RT (x,...) ，然后是 F.INV。RT (p,...) = x。
f_Inv(probability, degFreedom1, degFreedom2)

返回 (左尾) F 概率分布的反函数：如果 p = F.DIST (x,...) ，则 F.INV (p,...) = x。
fact(number)

返回数字的阶乘，等于 123*...*数字。
factDouble(number)

返回数字的双倍阶乘。
false()

返回逻辑值 FALSE。
find(findText, withinText, startNum)

返回一个文本字符串在另一个文本字符串中的起始位置。 FIND 区分大小写。
findB(findText, withinText, startNum)

查找另一个文本字符串中的一个文本字符串的起始位置。 FINDB 区分大小写。 与 DBCS) (双字节字符集一起使用。
fisher(x)

返回 Fisher 转换。
fisherInv(y)

返回 Fisher 转换的反函数：如果 y = FISHER (x) ，则 FISHERINV (y) = x。
fixed(number, decimals, noCommas)

将数字舍入到指定的小数位数，并将结果返回为带逗号或不带逗号的文本。
floor_Math(number, significance, mode)

将数字向下舍入为最接近的整数或最接近的倍数。
floor_Precise(number, significance)

将数字向下舍入为最接近的整数或最接近的倍数。
fv(rate, nper, pmt, pv, type)

基于固定利率和等额分期付款方式，返回某项投资的未来值。
fvschedule(principal, schedule)

基于一系列复利返回本金的未来值。
gamma_Dist(x, alpha, beta, cumulative)

返回 γ 分布函数值。
gamma_Inv(probability, alpha, beta)

返回伽玛累积分布的反值：如果 p = GAMMA。DIST (x,...) ，然后是 GAMMA。INV (p,...) = x。
gamma(x)

返回 Gamma 函数值。
gammaLn_Precise(x)

返回 gamma 函数的自然对数。
gammaLn(x)

返回 gamma 函数的自然对数。
gauss(x)

返回小于标准正态累积分布的 0.5。
gcd(values)

返回最大的公用除数。
geoMean(values)

返回正数值数据的数组或范围的几何平均值。
geStep(number, step)

测试数字是否大于阈值。
harMean(values)

返回正数数据集的和谐平均值：倒数算术平均值的倒数。
hex2Bin(number, places)

将十六进制数转换为二进制数。
hex2Dec(number)

将十六进制数转换为十进制数。
hex2Oct(number, places)

将十六进制数转换为八进制数。
hlookup(lookupValue, tableArray, rowIndexNum, rangeLookup)

在表或值数组的上一行中查找值，并从指定的行返回同一列中的值。
hour(serialNumber)

以数字的形式返回小时，从上午 0 (12：00 ) 到 23 (晚上 11：00 ) 。
hyperlink(linkLocation, friendlyName)

创建快捷方式或跳转以打开存储在硬盘驱动器、网络服务器或 Internet 上的文档。
hypGeom_Dist(sampleS, numberSample, populationS, numberPop, cumulative)

返回超几何分布。
if(logicalTest, valueIfTrue, valueIfFalse)

检查是否满足条件，如果为 TRUE，则返回一个值，如果为 FALSE，则返回另一个值。
imAbs(inumber)

返回复数的绝对值 (模数) 。
imaginary(inumber)

返回复数的虚系数。
imArgument(inumber)

返回参数 q，一个以弧度表示的角度。
imConjugate(inumber)

返回复数的复数共和值。
imCos(inumber)

返回复数的余弦值。
imCosh(inumber)

返回复数的双曲余弦值。
imCot(inumber)

返回复数的余切值。
imCsc(inumber)

返回复数的余割值。
imCsch(inumber)

返回复数的双曲余割值。
imDiv(inumber1, inumber2)

返回两个复数的商。
imExp(inumber)

返回复数的指数。
imLn(inumber)

返回复数的自然对数。
imLog10(inumber)

返回复数的以 10 为底的对数。
imLog2(inumber)

返回复数的以 2 为底的对数。
imPower(inumber, number)

返回以整数幂引发的复数。
imProduct(values)

返回 1 到 255 个复数的乘积。
imReal(inumber)

返回复数的实际系数。
imSec(inumber)

返回复数的正割值。
imSech(inumber)

返回复数的双曲正割值。
imSin(inumber)

返回复数的正弦值。
imSinh(inumber)

返回复数的双曲正弦值。
imSqrt(inumber)

返回复数的平方根。
imSub(inumber1, inumber2)

返回两个复数的差值。
imSum(values)

返回复数的总和。
imTan(inumber)

返回复数的正切值。
int(number)

将数字向下舍入到最接近的整数。
intRate(settlement, maturity, investment, redemption, basis)

返回完全投资型债券的利率。
ipmt(rate, per, nper, pv, fv, type)

基于定期、固定付款和固定利率，返回投资给定期间的利息支付。
irr(values, guess)

返回一系列现金流的内部收益率。
isErr(value)

检查值是否为 #N/A 以外的错误，并返回 TRUE 或 FALSE。
isError(value)

检查值是错误，并返回 TRUE 还是 FALSE。
isEven(number)

如果数字为偶数，则返回 TRUE。
isFormula(reference)

检查引用是对包含公式的单元格的引用，并返回 TRUE 还是 FALSE。
isLogical(value)

检查值是 (TRUE 还是 FALSE) 的逻辑值，并返回 TRUE 或 FALSE。
isNA(value)

检查值是 #N/A，并返回 TRUE 还是 FALSE。
isNonText(value)

检查值是否不是文本 (空白单元格不是文本) ，并返回 TRUE 或 FALSE。
isNumber(value)

检查值是数字，并返回 TRUE 还是 FALSE。
iso_Ceiling(number, significance)

将数字向上舍入为最接近的整数或最接近的显著性倍数。
isOdd(number)

如果数字为奇数，则返回 TRUE。
isoWeekNum(date)

返回给定日期的一年中 ISO 周号。
ispmt(rate, per, nper, pv)

返回在投资的特定期间支付的利息。
isref(value)

检查值是引用，并返回 TRUE 还是 FALSE。
isText(value)

检查值是文本，并返回 TRUE 还是 FALSE。
kurt(values)

返回一组数据的峰值。
large(array, k)

返回数据集中第 k 个最大值。 例如，第五大数字。
lcm(values)

返回最不常见的倍数。
left(text, numChars)

返回文本字符串开头的指定字符数。
leftb(text, numBytes)

返回文本字符串开头的指定字符数。 与 DBCS) (双字节字符集一起使用。
len(text)

返回文本字符串中的字符数。
lenb(text)

返回文本字符串中的字符数。 与 DBCS) (双字节字符集一起使用。
ln(number)

返回数字的自然对数。
log(number, base)

按所指定的底数，返回一个数的对数。
log10(number)

返回以 10 为底的对数。
logNorm_Dist(x, mean, standardDev, cumulative)

返回 x 的对数正态分布，其中 ln (x) 使用参数 Mean 和 Standard_dev 进行正常分布。
logNorm_Inv(probability, mean, standardDev)

返回 x 的对数累积分布函数的反函数，其中 ln (x) 使用参数 Mean 和 Standard_dev 进行正常分布。
lookup(lookupValue, lookupVector, resultVector)

从单行或单列范围或数组查找值。 为向后兼容而提供。
lower(text)

将文本字符串中的所有字母转换为小写。
match(lookupValue, lookupArray, matchType)

返回在指定方式下与指定数值匹配的数组中元素的相应位置。
max(values)

返回一组值中的最大值。 忽略逻辑值和文本。
maxA(values)

返回一组值中的最大值。 不忽略逻辑值和文本。
mduration(settlement, maturity, coupon, yld, frequency, basis)

返回假设面值为 $100 的证券的 Macauley 修改持续时间。
median(values)

返回中值或给定数字集中间的数字。
mid(text, startNum, numChars)

返回文本字符串中间的字符，给定起始位置和长度。
midb(text, startNum, numBytes)

返回文本字符串中间的字符，给定起始位置和长度。 与 DBCS) (双字节字符集一起使用。
min(values)

返回一组值中的最小值。 忽略逻辑值和文本。
minA(values)

返回一组值中的最小值。 不忽略逻辑值和文本。
minute(serialNumber)

返回分钟，一个介于 0 到 59 的数字。
mirr(values, financeRate, reinvestRate)

返回一系列定期现金流的内部收益率，同时考虑投资成本和现金再投资利息。
mod(number, divisor)

返回数字除以除数后的余数。
month(serialNumber)

返回月份，即) 年 1 月 1 (到) 年 12 月 12 日 (的数字。
mround(number, multiple)

返回参数按指定基数舍入后的数值。
multiNomial(values)

返回一组数字的多项式。
n(value)

将非数字值转换为数字，将日期转换为序列号，将 TRUE 转换为 1，将任何其他值转换为 0 (零) 。
na()

返回错误值 #N/A (值) 不可用。
negBinom_Dist(numberF, numberS, probabilityS, cumulative)

返回负二项式分布，即第Number_s次成功之前Number_f失败的概率，Probability_s成功的概率。
networkDays_Intl(startDate, endDate, weekend, holidays)

使用自定义周末参数返回两个日期之间的整个工作日数。
networkDays(startDate, endDate, holidays)

返回两个日期之间的整个工作日数。
nominal(effectRate, npery)

返回年名义利率。
norm_Dist(x, mean, standardDev, cumulative)

返回指定平均值和标准偏差的正态分布。
norm_Inv(probability, mean, standardDev)

返回指定平均值和标准偏差的正态累积分布函数的反函数。
norm_S_Dist(z, cumulative)

返回标准正态分布 (的平均值为零，标准偏差为 1) 。
norm_S_Inv(probability)

返回标准正态累积分布的反数， (的平均值为零，标准偏差为 1) 。
not(logical)

将 FALSE 更改为 TRUE，或将 TRUE 更改为 FALSE。
now()

返回格式为日期和时间的当前日期和时间。
nper(rate, pmt, pv, fv, type)

基于固定利率及等额分期付款方式，返回某项投资的总期数。
npv(rate, values)

根据折扣率和一系列未来付款返回投资的净现值， (负值) 和收入 (正值) 。
numberValue(text, decimalSeparator, groupSeparator)

以独立于区域设置的方式将文本转换为数字。
oct2Bin(number, places)

将八进制数转换为二进制数。
oct2Dec(number)

将八进制数转换为十进制数。
oct2Hex(number, places)

将八进制数转换为十六进制数。
odd(number)

将正数向上舍入，将负数向下舍入到最接近的奇数。
oddFPrice(settlement, maturity, issue, firstCoupon, rate, yld, redemption, frequency, basis)

返回具有奇数第一期的证券的每 100 美元面值的价格。
oddFYield(settlement, maturity, issue, firstCoupon, rate, pr, redemption, frequency, basis)

返回第一个周期为奇数的证券的收益率。
oddLPrice(settlement, maturity, lastInterest, rate, yld, redemption, frequency, basis)

返回具有奇数最后一周期的证券的每 100 美元面值的价格。
oddLYield(settlement, maturity, lastInterest, rate, pr, redemption, frequency, basis)

返回最后一个周期为奇数的证券的收益率。
or(values)

检查任何参数是否为 TRUE，并返回 TRUE 或 FALSE。 仅当所有参数均为 FALSE 时，才返回 FALSE。
pduration(rate, pv, fv)

返回投资达到指定值所需的时间段数。
percentile_Exc(array, k)

返回区域中数值的第 k 个百分点的值，其中 k 的范围是从 0 到 1（不包括 0 和 1）。
percentile_Inc(array, k)

返回区域中值的第 k 个百分位，其中 k 在范围 0..1（含） 内。
percentRank_Exc(array, x, significance)

返回特定数值在一个数据集中的百分比（从 0 到 1，不包括 0 和 1）排位。
percentRank_Inc(array, x, significance)

返回某个值在一个数据集中的百分比（从 0 到 1，包括 0 和 1）排位。
permut(number, numberChosen)

返回给定数量的对象（可从总对象中选择）的排列数。
permutationa(number, numberChosen)

返回给定数量的对象的排列数， (可从对象总数中选择的重复) 。
phi(x)

返回标准正态分布的密度函数的值。
pi()

返回 Pi 值 3.14159265358979，精确到 15 位。
pmt(rate, nper, pv, fv, type)

基于固定利率及等额分期付款方式，计算贷款的每期付款额。
poisson_Dist(x, mean, cumulative)

返回泊松分布。
power(number, power)

返回某数的乘幂结果。
ppmt(rate, per, nper, pv, fv, type)

根据定期、固定付款和固定利率返回给定投资本金的付款。
price(settlement, maturity, rate, yld, redemption, frequency, basis)

返回定期付息的面值 ￥100 的债券价格。
priceDisc(settlement, maturity, discount, redemption, basis)

返回折价发行的面值 ￥100 的债券的价格。
priceMat(settlement, maturity, issue, rate, yld, basis)

返回到期付息的面值 ￥100 的债券的价格。
product(values)

将作为参数提供的所有数字相乘。
proper(text)

将文本字符串转换为正确的大小写;每个单词中的第一个字母为大写，所有其他字母为小写。
pv(rate, nper, pmt, fv, type)

返回投资的现值：一系列未来付款现在的价值总额。
quartile_Exc(array, quart)

基于 0..1（排除）的百分位值返回数据集的四分位数。
quartile_Inc(array, quart)

基于 0..1（含）的百分位值返回数据集的四分位数。
quotient(numerator, denominator)

返回除法的整数部分。
radians(angle)

将度转换为弧度。
rand()

返回一个大于或等于 0 且小于 1 的随机数，在重新计算) 时均匀分布 (更改。
randBetween(bottom, top)

返回指定数字之间的随机数。
rank_Avg(number, ref, order)

返回数字列表中数字的排名：其大小相对于列表中的其他值;如果多个值具有相同的排名，则返回平均排名。
rank_Eq(number, ref, order)

返回数字列表中数字的排名：其大小相对于列表中的其他值;如果多个值具有相同的排名，则返回该值集的最高排名。
rate(nper, pmt, pv, fv, type, guess)

返回每期贷款或投资的利率。 例如，对于 6% APR 的季度付款，请使用 6%/4。
received(settlement, maturity, investment, discount, basis)

返回完全投资型债券到期收回的金额。
replace(oldText, startNum, numChars, newText)

用不同的文本字符串替换文本字符串的一部分。
replaceB(oldText, startNum, numBytes, newText)

用不同的文本字符串替换文本字符串的一部分。 与 DBCS) (双字节字符集一起使用。
rept(text, numberTimes)

按照给定的次数重复显示文本。 可以通过函数 REPT 来不断地重复显示某一文本字符串，对单元格进行填充。
right(text, numChars)

返回文本字符串末尾的指定字符数。
rightb(text, numBytes)

返回文本字符串末尾的指定字符数。 与 DBCS) (双字节字符集一起使用。
roman(number, form)

将阿拉伯数字转换为罗马数字作为文本。
round(number, numDigits)

将数字舍入到指定位数。
roundDown(number, numDigits)

将数字向零的方向向下舍入。
roundUp(number, numDigits)

将数字从零向上舍入。
rows(array)

返回引用或数组中的行数。
rri(nper, pv, fv)

返回投资增长的等效利率。
sec(number)

返回角度的正割值。
sech(number)

返回角度的双曲正割值。
second(serialNumber)

返回第二个值，即从 0 到 59 的数字。
seriesSum(x, n, m, coefficients)

返回基于公式的幂系列的总和。
sheet(value)

返回所引用工作表的工作表编号。
sheets(reference)

返回引用中的工作表数。
sign(number)

返回数字的符号：1 如果数字为正，则返回零;如果数字为零，则返回 -1（如果数字为负）。
sin(number)

返回角度的正弦值。
sinh(number)

返回某一数字的双曲正弦值。
skew_p(values)

返回基于总体的分布的偏斜性：表示分布围绕其平均值的不对称程度。
skew(values)

返回分布的偏斜性：表示分布围绕其平均值的不对称程度。
sln(cost, salvage, life)

返回某项资产一个周期的直线折旧值。
small(array, k)

返回数据集中第 k 个最小值。 例如，第五个最小数字。
sqrt(number)

返回数字的平方根。
sqrtPi(number)

返回 (数字 * Pi) 的平方根。
standardize(x, mean, standardDev)

从以平均值和标准偏差为特征的分布中返回规范化值。
stDev_P(values)

根据作为参数给出的整个总体计算标准偏差， (忽略逻辑值和文本) 。
stDev_S(values)

根据样本估计标准偏差 (忽略示例) 中的逻辑值和文本。
stDevA(values)

根据样本（包括逻辑值和文本）估算标准偏差。 文本和逻辑值 FALSE 的值为 0;逻辑值 TRUE 的值为 1。
stDevPA(values)

基于整个总体（包括逻辑值和文本）计算标准偏差。 文本和逻辑值 FALSE 的值为 0;逻辑值 TRUE 的值为 1。
substitute(text, oldText, newText, instanceNum)

将现有文本替换为文本字符串中的新文本。
subtotal(functionNum, values)

返回列表或数据库中的分类汇总。
sum(values)

对某单元格区域中的所有数字求和。
sumIf(range, criteria, sumRange)

添加由给定条件或条件指定的单元格。
sumIfs(sumRange, values)

添加由一组给定条件或条件指定的单元格。
sumSq(values)

返回参数的平方之和。 参数可以是数字、数组、名称或对包含数字的单元格的引用。
syd(cost, salvage, life, per)

返回某项资产按年限总和折旧法计算的指定期间的折旧值。
t_Dist_2T(x, degFreedom)

返回双尾学生的 t 分布。
t_Dist_RT(x, degFreedom)

返回右尾学生的 t 分布。
t_Dist(x, degFreedom, cumulative)

返回左尾学生的 t 分布。
t_Inv_2T(probability, degFreedom)

返回学生的 t 分布的双尾反数。
t_Inv(probability, degFreedom)

返回学生的 t 分布的左尾反数。
t(value)

检查值是否为文本，如果为，则返回文本;如果不是，则返回双引号 (空文本) 。
tan(number)

返回一个角度的正切值。
tanh(number)

返回某一数字的双曲正切值。
tbillEq(settlement, maturity, discount)

返回国库券的债券等效收益率。
tbillPrice(settlement, maturity, discount)

返回国库券每 100 美元面值的价格。
tbillYield(settlement, maturity, pr)

返回国库券的收益率。
text(value, formatText)

将数值转换为按指定数字格式表示的文本。
time(hour, minute, second)

将以数字形式给出的小时、分钟和秒转换为使用时间格式设置格式的 Excel 序列号。
timevalue(timeText)

将文本时间一次性转换为 Excel 序列号，从 0 (12：00：00 am) 到 0.999988426 (晚上 11：59：59) 。 输入公式后，使用时间格式设置数字的格式。
today()

返回格式为日期的当前日期。
toJSON()

重写 JavaScript toJSON() 方法，以便在将 API 对象传递给 JSON.stringify()时提供更有用的输出。 JSON.stringify (，反过来又调用toJSON传递给它的 对象的 方法。) 而原始Excel.Functions对象是 API 对象，toJSON该方法返回一个纯 JavaScript 对象， (类型为 Excel.Interfaces.FunctionsData) ，其中包含原始对象中任何已加载子属性的浅表副本。
trim(text)

删除文本字符串中的所有空格，单词之间的单个空格除外。
trimMean(array, percent)

返回一组数据值的内部部分的平均值。
true()

返回逻辑值 TRUE。
trunc(number, numDigits)

通过删除数字的十进制或小数部分，将数字截断为整数。
type(value)

返回一个整数，表示值的数据类型：number = 1;text = 2;逻辑值 = 4;error 值 = 16;array = 64;复合数据 = 128。
unichar(number)

返回由给定数值引用的 Unicode 字符。
unicode(text)

返回与文本的第一个字符对应的数字 (码位) 。
upper(text)

将文本字符串转换为所有大写字母。
usdollar(number, decimals)

使用货币格式将数字转换为文本。
value(text)

将表示数字的文本字符串转换为数字。
var_P(values)

基于整个总体计算方差 (忽略总体) 中的逻辑值和文本。
var_S(values)

基于样本估计方差 (忽略示例) 中的逻辑值和文本。
varA(values)

根据样本（包括逻辑值和文本）估算方差。 文本和逻辑值 FALSE 的值为 0;逻辑值 TRUE 的值为 1。
varPA(values)

根据整个总体计算方差，包括逻辑值和文本。 文本和逻辑值 FALSE 的值为 0;逻辑值 TRUE 的值为 1。
vdb(cost, salvage, life, startPeriod, endPeriod, factor, noSwitch)

使用双倍余额递减法或其他指定的方法，返回指定的任何期间内（包括部分期间）的资产折旧值。
vlookup(lookupValue, tableArray, colIndexNum, rangeLookup)

在表的最左侧列中查找值，然后从指定的列返回同一行中的值。 默认情况下，表必须按升序排序。
weekday(serialNumber, returnType)

返回一个从 1 到 7 的数字，标识日期的一周中的某一天。
weekNum(serialNumber, returnType)

返回当年中的周数。
weibull_Dist(x, alpha, beta, cumulative)

返回韦伯分布。
workDay_Intl(startDate, days, weekend, holidays)

使用自定义周末参数返回指定数量的工作日之前或之后的日期的序列号。
workDay(startDate, days, holidays)

返回指定工作日数之前或之后的日期的序列号。
xirr(values, dates, guess)

返回现金流计划的内部收益率。
xnpv(rate, values, dates)

返回现金流计划的净现值。
xor(values)

返回所有参数的逻辑“独占或”。
year(serialNumber)

返回日期的年份，即 1900 - 9999 范围内的整数。
yearFrac(startDate, endDate, basis)

返回表示start_date和end_date之间的整天天数的年份分数。
yield(settlement, maturity, rate, pr, redemption, frequency, basis)

返回定期支付利息的债券的收益率。
yieldDisc(settlement, maturity, pr, redemption, basis)

返回已贴现债券的年收益。 例如，国库券。
yieldMat(settlement, maturity, issue, rate, pr, basis)

返回到期付息的债券的年收益。
z_Test(array, x, sigma)

返回 z 测试的单尾 P 值。

属性详细信息

context

与 对象关联的请求上下文。 这会将加载项的进程连接到 Office 主机应用程序的进程。

context: RequestContext;

属性值

Excel.RequestContext

方法详细信息

abs(number)

返回一个数字的绝对值，一个没有其符号的数字。

abs(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

需要其绝对值的实数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

accrInt(issue, firstInterest, settlement, rate, par, frequency, basis, calcMethod)

返回定期付息有价证券的应计利息。

accrInt(issue: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, firstInterest: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, settlement: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, rate: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, par: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, frequency: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, basis?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, calcMethod?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

issue

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的发行日期，以序列号表示。

firstInterest

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的第一个利息日期，以序列号表示。

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的结算日期，以序列号表示。

rate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的年优惠券率。

par

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

安全性的 par 值。

frequency

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每年的优惠券付款数。

basis

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的日计数基础的类型。

calcMethod

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个逻辑值：从发行日期算起的应计利息 = TRUE 或省略;从上一优惠券付款日期 = FALSE 进行计算。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

accrIntM(issue, settlement, rate, par, basis)

返回到期一次性付息有价证券的应计利息。

accrIntM(issue: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, settlement: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, rate: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, par: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, basis?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

issue

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的发行日期，以序列号表示。

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的到期日期，以序列号表示。

rate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的年优惠券率。

par

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

安全性的 par 值。

basis

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的日计数基础的类型。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

acos(number)

返回数字的反正弦值，以弧度为单位，范围为 0 到 Pi。 反余弦值是余弦为数字的角度。

acos(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

所需角度的余弦值，并且必须从 -1 到 1。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

acosh(number)

返回数字的反双曲余弦值。

acosh(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

等于或大于 1 的任何实数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

acot(number)

返回数字的反正切值，以弧度为单位，范围为 0 到 Pi。

acot(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

所需角度的余切值。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

acoth(number)

返回数字的反双曲余切值。

acoth(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

所需的角度的双曲余切值。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

amorDegrc(cost, datePurchased, firstPeriod, salvage, period, rate, basis)

返回每个会计期间资产的按比例计算的线性折旧。

amorDegrc(cost: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, datePurchased: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, firstPeriod: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, salvage: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, period: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, rate: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, basis?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

cost

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

资产的成本。

datePurchased

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

资产的购买日期。

firstPeriod

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

第一个周期结束的日期。

salvage

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

资产生命周期结束时的打捞值。

period

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是句点。

rate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

折旧率。

basis

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

Year_basis：0 用于 360 天的年份，1 个用于实际年份，3 用于 365 天的年份。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

amorLinc(cost, datePurchased, firstPeriod, salvage, period, rate, basis)

返回每个会计期间资产的按比例计算的线性折旧。

amorLinc(cost: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, datePurchased: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, firstPeriod: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, salvage: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, period: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, rate: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, basis?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

cost

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

资产的成本。

datePurchased

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

资产的购买日期。

firstPeriod

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

第一个周期结束的日期。

salvage

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

资产生命周期结束时的打捞值。

period

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是句点。

rate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

折旧率。

basis

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

Year_basis：0 用于 360 天的年份，1 个用于实际年份，3 用于 365 天的年份。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

and(values)

检查所有参数是否为 TRUE，如果所有参数均为 TRUE，则返回 TRUE。

and(...values: Array<boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<boolean>;

参数

values

Array<boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素是要测试的 1 到 255 个条件，可以是 TRUE 或 FALSE，可以是逻辑值、数组或引用。

返回

Excel.FunctionResult<boolean>

注解

[ API 集：ExcelApi 1.2 ]

arabic(text)

将罗马数字转换为阿拉伯语。

arabic(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

text

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要转换的罗马数字。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

areas(reference)

返回引用中的区域数。 区域是连续单元格或单个单元格的区域。

areas(reference: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

reference

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

对单元格或单元格区域的引用，可以引用多个区域。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

asc(text)

将全角 (双字节) 字符更改为半角 (单字节) 字符。 与 DBCS) (双字节字符集一起使用。

asc(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

参数

text

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

文本或对包含文本的单元格的引用。

返回

Excel.FunctionResult<string>

注解

[ API 集：ExcelApi 1.2 ]

asin(number)

返回以弧度为单位的数字的反正弦值，范围为 -Pi/2 到 Pi/2。

asin(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

所需角度的正弦值，并且必须从 -1 到 1。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

asinh(number)

返回数字的反双曲正弦值。

asinh(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

等于或大于 1 的任何实数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

atan(number)

返回以弧度为单位的数字的反正切值，范围为 -Pi/2 到 Pi/2。

atan(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

所需角度的正切值。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

atan2(xNum, yNum)

返回指定 x 和 y 坐标的反正切值，以 -Pi 和 Pi 之间的弧度表示，不包括 -Pi。

atan2(xNum: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, yNum: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

xNum

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

点的 x 坐标。

yNum

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

点的 y 坐标。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

atanh(number)

返回数字的反双曲正切值。

atanh(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

介于 -1 和 1 之间的任意实数，不包括 -1 和 1。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

aveDev(values)

返回多个数据点与其平均值的绝对偏差的平均值。 参数可以是包含数字的数字或名称、数组或引用。

aveDev(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素是需要其绝对偏差平均值的 1 到 255 个参数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

average(values)

返回其参数的平均 (算术平均值) ，可以是包含数字的数字或名称、数组或引用。

average(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素是需要平均值的 1 到 255 个数值参数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

averageA(values)

返回其参数的平均 (算术平均值) ，并将参数中的文本和 FALSE 计算为 0;TRUE 的计算结果为 1。 参数可以是数字、名称、数组或引用。

averageA(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素是需要平均值的 1 到 255 个参数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

averageIf(range, criteria, averageRange)

查找由给定条件或条件指定的单元格的平均 (算术平均值) 。

averageIf(range: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, criteria: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, averageRange?: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

range

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要计算的单元格区域。

criteria

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

数字、表达式或文本形式的条件或条件，用于定义将用于查找平均值的单元格。

averageRange

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

用于查找平均值的实际单元格。 如果省略，则使用区域中的单元格。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

averageIfs(averageRange, values)

查找由一组给定条件或条件指定的单元格的平均 (算术平均值) 。

averageIfs(averageRange: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, ...values: Array<Excel.Range | Excel.RangeReference | Excel.FunctionResult<any> | number | string | boolean>): FunctionResult<number>;

参数

averageRange

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

用于查找平均值的实际单元格。

values

Array<Excel.Range | Excel.RangeReference | Excel.FunctionResult<any> | number | string | boolean>

参数列表，其中每对的第一个元素是要针对特定条件计算的单元格区域，第二个元素是数字、表达式或文本形式的条件或条件，用于定义将用于查找平均值的单元格。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

bahtText(number)

将数字转换为文本 (泰铢) 。

bahtText(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要转换的数字。

返回

Excel.FunctionResult<string>

注解

[ API 集：ExcelApi 1.2 ]

base(number, radix, minLength)

将数字转换为具有给定基数 (基) 的文本表示形式。

base(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, radix: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, minLength?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要转换的数字。

radix

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要将数字转换为的基基 Radix。

minLength

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

返回的字符串的最小长度。 如果省略前导零，则不添加前导零。

返回

Excel.FunctionResult<string>

注解

[ API 集：ExcelApi 1.2 ]

besselI(x, n)

返回修改后的 Bessel 函数 In (x) 。

besselI(x: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, n: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

x

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

计算函数的值。

n

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

Bessel 函数的顺序。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

besselJ(x, n)

返回 Bessel 函数 Jn (x) 。

besselJ(x: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, n: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

x

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

计算函数的值。

n

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

Bessel 函数的顺序。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

besselK(x, n)

返回修改的 Bessel 函数 Kn (x) 。

besselK(x: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, n: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

x

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

计算函数的值。

n

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

函数的顺序。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

besselY(x, n)

返回贝塞尔函数 Yn (x) 。

besselY(x: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, n: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

x

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

计算函数的值。

n

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

函数的顺序。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

beta_Dist(x, alpha, beta, cumulative, A, B)

返回 beta 概率分布函数。

beta_Dist(x: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, alpha: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, beta: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, cumulative: boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, A?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, B?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

x

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

A 和 B 之间的值，用于计算函数。

alpha

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是分布的参数，必须大于 0。

beta

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是分布的参数，必须大于 0。

cumulative

boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个逻辑值：对于累积分布函数，请使用 TRUE;对于概率密度函数，请使用 FALSE。

A

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是 x 间隔的可选下限。 如果省略，则 A = 0。

B

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是 x 间隔的可选上限。 如果省略，则 B = 1。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

beta_Inv(probability, alpha, beta, A, B)

返回累积 beta 概率密度函数 (BETA 的反函数。DIST) 。

beta_Inv(probability: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, alpha: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, beta: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, A?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, B?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

probability

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是与 beta 分布关联的概率。

alpha

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是分布的参数，必须大于 0。

beta

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是分布的参数，必须大于 0。

A

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是 x 间隔的可选下限。 如果省略，则 A = 0。

B

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是 x 间隔的可选上限。 如果省略，则 B = 1。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

bin2Dec(number)

将二进制数转换为十进制数。

bin2Dec(number: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要转换的二进制数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

bin2Hex(number, places)

将二进制数转换为十六进制数。

bin2Hex(number: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, places?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要转换的二进制数。

places

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的字符数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

bin2Oct(number, places)

将二进制数转换为八进制数。

bin2Oct(number: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, places?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要转换的二进制数。

places

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的字符数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

binom_Dist_Range(trials, probabilityS, numberS, numberS2)

使用二项式分布返回试验结果的概率。

binom_Dist_Range(trials: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, probabilityS: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, numberS: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, numberS2?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

trials

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

独立试验的次数。

probabilityS

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每次试用成功的概率。

numberS

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是试验中成功的次数。

numberS2

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

如果提供，则此函数返回成功试验数应介于 numberS 和 numberS2 之间的概率。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

binom_Dist(numberS, trials, probabilityS, cumulative)

返回一元二项式分布的概率。

binom_Dist(numberS: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, trials: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, probabilityS: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, cumulative: boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

numberS

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是试验中成功的次数。

trials

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

独立试验的次数。

probabilityS

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每次试用成功的概率。

cumulative

boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个逻辑值：对于累积分布函数，请使用 TRUE;对于概率质量函数，请使用 FALSE。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

binom_Inv(trials, probabilityS, alpha)

返回使累积二项式分布大于或等于临界值的最小值。

binom_Inv(trials: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, probabilityS: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, alpha: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

trials

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是伯努利审判的次数。

probabilityS

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每次试验的成功概率，介于 0 和 1（含 0 和 1）之间的数字。

alpha

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

条件值，介于 0 和 1（含 0 和 1）之间的数字。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

bitand(number1, number2)

返回两个数字的按位“And”。

bitand(number1: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, number2: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number1

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要计算的二进制数的十进制表示形式。

number2

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要计算的二进制数的十进制表示形式。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

bitlshift(number, shiftAmount)

返回由shift_amount位向左移动的数字。

bitlshift(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, shiftAmount: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要计算的二进制数的十进制表示形式。

shiftAmount

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要将数字左移的位数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

bitor(number1, number2)

返回两个数字的按位“Or”。

bitor(number1: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, number2: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number1

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要计算的二进制数的十进制表示形式。

number2

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要计算的二进制数的十进制表示形式。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

bitrshift(number, shiftAmount)

返回由shift_amount位向右移动的数字。

bitrshift(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, shiftAmount: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要计算的二进制数的十进制表示形式。

shiftAmount

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要右移数字的位数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

bitxor(number1, number2)

返回两个数字的按位“独占 Or”。

bitxor(number1: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, number2: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number1

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要计算的二进制数的十进制表示形式。

number2

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要计算的二进制数的十进制表示形式。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

ceiling_Math(number, significance, mode)

将数字向上舍入为最接近的整数或最接近的显著性倍数。

ceiling_Math(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, significance?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, mode?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要舍入的值。

significance

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要舍入到的倍数。

mode

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

当给定 和 非零时，此函数将从零舍入。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

ceiling_Precise(number, significance)

将数字向上舍入为最接近的整数或最接近的显著性倍数。

ceiling_Precise(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, significance?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要舍入的值。

significance

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要舍入到的倍数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

char(number)

从计算机的字符集中返回由代码号指定的字符。

char(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个介于 1 和 255 之间的数字，用于指定所需的字符。

返回

Excel.FunctionResult<string>

注解

[ API 集：ExcelApi 1.2 ]

chiSq_Dist_RT(x, degFreedom)

返回 χ2 分布的右尾概率。

chiSq_Dist_RT(x: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, degFreedom: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

x

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要计算分布的值，非数值。

degFreedom

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

自由度数，介于 1 和 10^10 之间的数字，不包括 10^10。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

chiSq_Dist(x, degFreedom, cumulative)

返回卡方分布的左尾概率。

chiSq_Dist(x: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, degFreedom: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, cumulative: boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

x

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要计算分布的值，非数值。

degFreedom

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

自由度数，介于 1 和 10^10 之间的数字，不包括 10^10。

cumulative

boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要返回的函数的逻辑值：累积分布函数 = TRUE;概率密度函数 = FALSE。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

chiSq_Inv_RT(probability, degFreedom)

返回 χ2 分布的右尾概率的反函数。

chiSq_Inv_RT(probability: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, degFreedom: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

probability

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是与卡方分布关联的概率，该值介于 0 和 1（含 0 和 1）之间。

degFreedom

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

自由度数，介于 1 和 10^10 之间的数字，不包括 10^10。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

chiSq_Inv(probability, degFreedom)

返回 χ2 分布的左尾概率的反函数。

chiSq_Inv(probability: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, degFreedom: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

probability

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是与卡方分布关联的概率，该值介于 0 和 1（含 0 和 1）之间。

degFreedom

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

自由度数，介于 1 和 10^10 之间的数字，不包括 10^10。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

choose(indexNum, values)

根据索引号从值列表中选择要执行的值或操作。

choose(indexNum: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, ...values: Array<Excel.Range | number | string | boolean | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number | string | boolean>;

参数

indexNum

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

指定所选定的值参数。 indexNum 必须介于 1 和 254 之间，或者公式或对介于 1 和 254 之间的数字的引用。

values

Array<Excel.Range | number | string | boolean | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素为 1 到 254 个数字、单元格引用、定义的名称、公式、函数或 SELECT 从中选择的文本参数。

返回

Excel.FunctionResult<number | string | boolean>

注解

[ API 集：ExcelApi 1.2 ]

clean(text)

删除文本中的所有非打印字符。

clean(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

参数

text

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要从中删除不可打印字符的任何工作表信息。

返回

Excel.FunctionResult<string>

注解

[ API 集：ExcelApi 1.2 ]

code(text)

返回计算机使用的字符集中文本字符串中第一个字符的数字代码。

code(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

text

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

需要其第一个字符的代码的文本。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

columns(array)

返回数组或引用中的列数。

columns(array: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

array

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是数组或数组公式，或者对需要其列数的单元格区域的引用。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

combin(number, numberChosen)

返回从给定的项目数中提取若干项目的组合数。

combin(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, numberChosen: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

项的总数。

numberChosen

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每个组合中的项数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

combina(number, numberChosen)

返回给定数量项的重复的组合数。

combina(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, numberChosen: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

项的总数。

numberChosen

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每个组合中的项数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

complex(realNum, iNum, suffix)

将实系数和虚系数转换为复数。

complex(realNum: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, iNum: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, suffix?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

realNum

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

复数的实际系数。

iNum

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

复数的虚系数。

suffix

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

复数虚部分的后缀。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

concatenate(values)

将多个文本字符串联接到一个文本字符串中。

concatenate(...values: Array<string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<string>;

参数

values

Array<string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素为要联接到单个文本字符串中的 1 到 255 个文本字符串，可以是文本字符串、数字或单单元格引用。

返回

Excel.FunctionResult<string>

注解

[ API 集：ExcelApi 1.2 ]

confidence_Norm(alpha, standardDev, size)

使用正态分布返回总体平均值的置信区间。

confidence_Norm(alpha: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, standardDev: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, size: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

alpha

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

用于计算置信度级别的显著性级别，一个大于 0 且小于 1 的数字。

standardDev

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

数据范围的总体标准偏差，假定为已知。 standardDev 必须大于 0。

size

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

样本大小。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

confidence_T(alpha, standardDev, size)

使用学生的 T 分布返回总体平均值的置信区间。

confidence_T(alpha: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, standardDev: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, size: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

alpha

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

用于计算置信度级别的显著性级别，一个大于 0 且小于 1 的数字。

standardDev

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

数据范围的总体标准偏差，假定为已知。 standardDev 必须大于 0。

size

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

样本大小。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

convert(number, fromUnit, toUnit)

将数字从一个度量系统转换为另一个度量系统。

convert(number: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, fromUnit: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, toUnit: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要转换from_units中的值。

fromUnit

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

数字的单位。

toUnit

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

结果的单位。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

cos(number)

返回角度的余弦值。

cos(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

需要余弦值的角度（以弧度为单位）。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

cosh(number)

返回数字的双曲余弦值。

cosh(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是任何实数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

cot(number)

返回角度的余切值。

cot(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

需要余切的角度（以弧度为单位）。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

coth(number)

返回数字的双曲余切值。

coth(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

需要双曲余切值的角度（以弧度为单位）。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

count(values)

计算区域中包含数字的单元格数。

count(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素为 1 到 255 个参数，可以包含或引用各种不同类型的数据，但只计算数字。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

countA(values)

计算区域中不为空的单元格数。

countA(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素为 1 到 255 个参数，表示要计数的值和单元格。 值可以是任何类型的信息。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

countBlank(range)

计算指定单元格区域中空单元格的数目。

countBlank(range: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

range

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要对空单元格进行计数的范围。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

countIf(range, criteria)

计算区域中满足给定条件的单元格数。

countIf(range: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, criteria: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

range

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要从中计算非空白单元格的单元格区域。

criteria

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

数字、表达式或文本形式的条件，用于定义将计数的单元格。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

countIfs(values)

计算由一组给定条件或条件指定的单元格数。

countIfs(...values: Array<Excel.Range | Excel.RangeReference | Excel.FunctionResult<any> | number | string | boolean>): FunctionResult<number>;

参数

values

Array<Excel.Range | Excel.RangeReference | Excel.FunctionResult<any> | number | string | boolean>

参数列表，其中每对的第一个元素是要针对特定条件计算的单元格区域，第二个元素是数字、表达式或文本形式的条件，用于定义将计数哪些单元格。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

coupDayBs(settlement, maturity, frequency, basis)

返回从息票期开始到结算日的天数。

coupDayBs(settlement: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, maturity: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, frequency: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, basis?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的结算日期，以序列号表示。

maturity

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的到期日期，以序列号表示。

frequency

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每年的优惠券付款数。

basis

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的日计数基础的类型。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

coupDays(settlement, maturity, frequency, basis)

返回结算日所在的息票期的天数。

coupDays(settlement: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, maturity: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, frequency: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, basis?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的结算日期，以序列号表示。

maturity

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的到期日期，以序列号表示。

frequency

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每年的优惠券付款数。

basis

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的日计数基础的类型。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

coupDaysNc(settlement, maturity, frequency, basis)

返回从结算日到下一个息票日之间的天数。

coupDaysNc(settlement: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, maturity: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, frequency: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, basis?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的结算日期，以序列号表示。

maturity

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的到期日期，以序列号表示。

frequency

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每年的优惠券付款数。

basis

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的日计数基础的类型。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

coupNcd(settlement, maturity, frequency, basis)

返回结算日之后的下一个优惠券日期。

coupNcd(settlement: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, maturity: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, frequency: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, basis?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的结算日期，以序列号表示。

maturity

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的到期日期，以序列号表示。

frequency

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每年的优惠券付款数。

basis

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的日计数基础的类型。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

coupNum(settlement, maturity, frequency, basis)

返回结算日和到期日之间应付的息票数。

coupNum(settlement: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, maturity: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, frequency: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, basis?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的结算日期，以序列号表示。

maturity

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的到期日期，以序列号表示。

frequency

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每年的优惠券付款数。

basis

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的日计数基础的类型。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

coupPcd(settlement, maturity, frequency, basis)

返回结算日之前的优惠券日期。

coupPcd(settlement: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, maturity: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, frequency: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, basis?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的结算日期，以序列号表示。

maturity

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的到期日期，以序列号表示。

frequency

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每年的优惠券付款数。

basis

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的日计数基础的类型。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

csc(number)

返回角度的余割值。

csc(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

需要余割值的角度（以弧度为单位）。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

csch(number)

返回角度的双曲余割值。

csch(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

需要其双曲余割值的角度（以弧度为单位）。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

cumIPmt(rate, nper, pv, startPeriod, endPeriod, type)

返回两个期间之间已支付的累计利息。

cumIPmt(rate: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, nper: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, pv: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, startPeriod: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, endPeriod: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, type: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

rate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

利率。

nper

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

付款期的总数。

pv

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是现值。

startPeriod

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

计算中的第一个周期。

endPeriod

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

计算的最后一个周期。

type

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

付款的时间。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

cumPrinc(rate, nper, pv, startPeriod, endPeriod, type)

返回两个期间之间对贷款支付的累计本金。

cumPrinc(rate: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, nper: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, pv: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, startPeriod: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, endPeriod: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, type: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

rate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

利率。

nper

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

付款期的总数。

pv

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是现值。

startPeriod

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

计算中的第一个周期。

endPeriod

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

计算的最后一个周期。

type

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

付款的时间。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

date(year, month, day)

返回表示 Excel 日期时间代码中Microsoft日期的数字。

date(year: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, month: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, day: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

year

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

从 1900 或 1904 (的数字，具体取决于工作簿的日期系统) 到 9999。

month

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

表示一年中的月份的 1 到 12 的数字。

day

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

一个从 1 到 31 的数字，表示月份中的某一天。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

datevalue(dateText)

将文本格式的日期转换为一个数字，该数字表示Microsoft Excel 日期时间代码中的日期。

datevalue(dateText: string | number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

dateText

string | number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

表示Microsoft Excel 日期格式的日期的文本，介于 1/1/1900 或 1904/1/1 (，具体取决于工作簿的日期系统) 和 12/31/9999。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

daverage(database, field, criteria)

平均列表或数据库中与指定的条件匹配的列中的值。

daverage(database: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, field: number | string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, criteria: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

database

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

构成列表或数据库的单元格区域。 数据库是相关数据的列表。

field

number | string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

双引号中的列的标签或表示列在列表中的位置的数字。

criteria

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

包含指定条件的单元格区域。 该区域包括一个列标签和一个条件标签下方的单元格。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

day(serialNumber)

返回月份中的某一天，一个介于 1 到 31 的数字。

day(serialNumber: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

serialNumber

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

Microsoft Excel 使用的日期时间代码中的数字。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

days(endDate, startDate)

返回两个日期之间的天数。

days(endDate: string | number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, startDate: string | number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

endDate

string | number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

startDate 和 endDate 是想要了解天数的两个日期。

startDate

string | number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

startDate 和 endDate 是想要了解天数的两个日期。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

days360(startDate, endDate, method)

返回基于 360 天的年份 (12 个 30 天月) 的两个日期之间的天数。

days360(startDate: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, endDate: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, method?: boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

startDate

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

startDate 和 endDate 是想要了解天数的两个日期。

endDate

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

startDate 和 endDate 是想要了解天数的两个日期。

method

boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

指定计算方法的逻辑值：U.S. (NASD) = FALSE 或省略;欧洲 = TRUE。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

db(cost, salvage, life, period, month)

使用固定余额递减法返回指定周期内某项资产的折旧值。

db(cost: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, salvage: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, life: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, period: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, month?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

cost

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

资产的初始成本。

salvage

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

资产生命周期结束时的打捞值。

life

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

资产贬值的周期数， (有时称为资产) 的使用寿命。

period

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要计算折旧的周期。 Period 必须使用与 Life 相同的单位。

month

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

第一年的月数。 如果省略，则假定为 12。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

dbcs(text)

将字符串中的半角 (单字节) 字符更改为全角 (双字节) 字符。 与 DBCS) (双字节字符集一起使用。

dbcs(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

参数

text

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

文本或对包含文本的单元格的引用。

返回

Excel.FunctionResult<string>

注解

[ API 集：ExcelApi 1.2 ]

dcount(database, field, criteria)

对数据库中与指定条件匹配的记录的字段 (列) 包含数字的单元格进行计数。

dcount(database: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, field: number | string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, criteria: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

database

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

构成列表或数据库的单元格区域。 数据库是相关数据的列表。

field

number | string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

双引号中的列的标签或表示列在列表中的位置的数字。

criteria

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

包含指定条件的单元格区域。 该区域包括一个列标签和一个条件标签下方的单元格。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

dcountA(database, field, criteria)

对字段中与指定条件匹配的记录 (列) 的非空单元格进行计数。

dcountA(database: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, field: number | string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, criteria: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

database

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

构成列表或数据库的单元格区域。 数据库是相关数据的列表。

field

number | string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

双引号中的列的标签或表示列在列表中的位置的数字。

criteria

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

包含指定条件的单元格区域。 该区域包括一个列标签和一个条件标签下方的单元格。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

ddb(cost, salvage, life, period, factor)

使用双倍余额递减法或其他指定方法返回某项资产在指定周期内的折旧值。

ddb(cost: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, salvage: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, life: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, period: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, factor?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

cost

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

资产的初始成本。

salvage

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

资产生命周期结束时的打捞值。

life

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

资产贬值的周期数， (有时称为资产) 的使用寿命。

period

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要计算折旧的周期。 Period 必须使用与 Life 相同的单位。

factor

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

余额下降的速度。 如果省略 Factor，则假定为 2 (双减余额方法) 。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

dec2Bin(number, places)

将十进制数转换为二进制数。

dec2Bin(number: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, places?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要转换的十进制整数。

places

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的字符数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

dec2Hex(number, places)

将十进制数转换为十六进制数。

dec2Hex(number: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, places?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要转换的十进制整数。

places

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的字符数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

dec2Oct(number, places)

将十进制数转换为八进制数。

dec2Oct(number: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, places?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要转换的十进制整数。

places

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的字符数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

decimal(number, radix)

将给定基数中的数字的文本表示形式转换为十进制数。

decimal(number: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, radix: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要转换的数字。

radix

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要转换的数字的基基基数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

degrees(angle)

将弧度转换为度。

degrees(angle: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

angle

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要转换的角度（以弧度为单位）。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

delta(number1, number2)

测试两个数字是否相等。

delta(number1: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, number2?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number1

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是第一个数字。

number2

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是第二个数字。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

devSq(values)

返回数据点与其样本平均值的偏差的平方和。

devSq(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素为 1 到 255 个参数，或者希望 DEVSQ 计算的数组或数组引用。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

dget(database, field, criteria)

从数据库中提取与指定条件匹配的单个记录。

dget(database: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, field: number | string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, criteria: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number | boolean | string>;

参数

database

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

构成列表或数据库的单元格区域。 数据库是相关数据的列表。

field

number | string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

双引号中的列的标签或表示列在列表中的位置的数字。

criteria

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

包含指定条件的单元格区域。 该区域包括一个列标签和一个条件标签下方的单元格。

返回

Excel.FunctionResult<number | boolean | string>

注解

[ API 集：ExcelApi 1.2 ]

disc(settlement, maturity, pr, redemption, basis)

返回债券的贴现率。

disc(settlement: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, maturity: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, pr: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, redemption: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, basis?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的结算日期，以序列号表示。

maturity

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的到期日期，以序列号表示。

pr

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每 100 美元面值的证券价格。

redemption

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每 100 美元面值的证券赎回价值。

basis

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的日计数基础的类型。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

dmax(database, field, criteria)

返回字段中与指定条件匹配的记录 (列) 的最大数字。

dmax(database: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, field: number | string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, criteria: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

database

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

构成列表或数据库的单元格区域。 数据库是相关数据的列表。

field

number | string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

双引号中的列的标签或表示列在列表中的位置的数字。

criteria

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

包含指定条件的单元格区域。 该区域包括一个列标签和一个条件标签下方的单元格。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

dmin(database, field, criteria)

返回字段中 (列) 与指定条件匹配的记录的最小数字。

dmin(database: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, field: number | string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, criteria: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

database

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

构成列表或数据库的单元格区域。 数据库是相关数据的列表。

field

number | string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

双引号中的列的标签或表示列在列表中的位置的数字。

criteria

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

包含指定条件的单元格区域。 该区域包括一个列标签和一个条件标签下方的单元格。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

dollar(number, decimals)

使用货币格式将数字转换为文本。

dollar(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, decimals?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是数字、对包含数字的单元格的引用，或计算结果为数字的公式。

decimals

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

小数点右侧的位数。 根据需要对数字进行舍入：如果省略，则 Decimals = 2。

返回

Excel.FunctionResult<string>

注解

[ API 集：ExcelApi 1.2 ]

dollarDe(fractionalDollar, fraction)

将以小数表示的美元价格转换为以小数表示的美元价格。

dollarDe(fractionalDollar: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, fraction: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

fractionalDollar

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

以分数表示的数字。

fraction

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

在分数的分母中使用的整数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

dollarFr(decimalDollar, fraction)

将以小数表示的美元价格转换为以小数表示的美元价格。

dollarFr(decimalDollar: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, fraction: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

decimalDollar

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是十进制数。

fraction

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

在分数的分母中使用的整数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

dproduct(database, field, criteria)

将字段中的值相乘 (列) 数据库中与指定条件匹配的记录。

dproduct(database: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, field: number | string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, criteria: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

database

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

构成列表或数据库的单元格区域。 数据库是相关数据的列表。

field

number | string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

双引号中的列的标签或表示列在列表中的位置的数字。

criteria

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

包含指定条件的单元格区域。 该区域包括一个列标签和一个条件标签下方的单元格。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

dstDev(database, field, criteria)

根据所选数据库条目中的样本估计标准偏差。

dstDev(database: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, field: number | string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, criteria: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

database

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

构成列表或数据库的单元格区域。 数据库是相关数据的列表。

field

number | string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

双引号中的列的标签或表示列在列表中的位置的数字。

criteria

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

包含指定条件的单元格区域。 该区域包括一个列标签和一个条件标签下方的单元格。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

dstDevP(database, field, criteria)

根据所选数据库条目的整个总体计算标准偏差。

dstDevP(database: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, field: number | string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, criteria: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

database

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

构成列表或数据库的单元格区域。 数据库是相关数据的列表。

field

number | string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

双引号中的列的标签或表示列在列表中的位置的数字。

criteria

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

包含指定条件的单元格区域。 该区域包括一个列标签和一个条件标签下方的单元格。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

dsum(database, field, criteria)

) 数据库中与指定条件匹配的记录 (列中的数字相加。

dsum(database: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, field: number | string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, criteria: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

database

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

构成列表或数据库的单元格区域。 数据库是相关数据的列表。

field

number | string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

双引号中的列的标签或表示列在列表中的位置的数字。

criteria

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

包含指定条件的单元格区域。 该区域包括一个列标签和一个条件标签下方的单元格。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

duration(settlement, maturity, coupon, yld, frequency, basis)

返回定期支付利息的证券的年度持续时间。

duration(settlement: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, maturity: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, coupon: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, yld: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, frequency: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, basis?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的结算日期，以序列号表示。

maturity

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的到期日期，以序列号表示。

coupon

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的年优惠券率。

yld

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是证券的年收益率。

frequency

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每年的优惠券付款数。

basis

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的日计数基础的类型。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

dvar(database, field, criteria)

根据所选数据库条目中的样本估计方差。

dvar(database: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, field: number | string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, criteria: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

database

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

构成列表或数据库的单元格区域。 数据库是相关数据的列表。

field

number | string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

双引号中的列的标签或表示列在列表中的位置的数字。

criteria

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

包含指定条件的单元格区域。 该区域包括一个列标签和一个条件标签下方的单元格。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

dvarP(database, field, criteria)

根据所选数据库条目的整个总体计算方差。

dvarP(database: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, field: number | string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, criteria: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

database

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

构成列表或数据库的单元格区域。 数据库是相关数据的列表。

field

number | string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

双引号中的列的标签或表示列在列表中的位置的数字。

criteria

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

包含指定条件的单元格区域。 该区域包括一个列标签和一个条件标签下方的单元格。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

ecma_Ceiling(number, significance)

将数字向上舍入为最接近的整数或最接近的显著性倍数。

ecma_Ceiling(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, significance: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要舍入的值。

significance

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要舍入到的倍数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

edate(startDate, months)

返回日期的序列号，即在开始日期之前或之后的指示月份数。

edate(startDate: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, months: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

startDate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

表示开始日期的序列号。

months

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

startDate 之前或之后的月数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

effect(nominalRate, npery)

返回有效的年利率。

effect(nominalRate: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, npery: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

nominalRate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

名义利率。

npery

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是每年的复合周期数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

eoMonth(startDate, months)

返回指定月份数之前或之后的月份最后一天的序列号。

eoMonth(startDate: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, months: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

startDate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

表示开始日期的序列号。

months

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

startDate 之前或之后的月数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

erf_Precise(X)

返回 error 函数。

erf_Precise(X: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

X

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

集成 ERF 的下限。精确。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

erf(lowerLimit, upperLimit)

返回 error 函数。

erf(lowerLimit: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, upperLimit?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

lowerLimit

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

集成 ERF 的下限。

upperLimit

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

集成 ERF 的上限。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

erfC_Precise(X)

返回互补错误函数。

erfC_Precise(X: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

X

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

集成 ERFC 的下限。精确。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

erfC(x)

返回互补错误函数。

erfC(x: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

x

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

集成 ERF 的下限。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

error_Type(errorVal)

返回与错误值匹配的数字。

error_Type(errorVal: string | number | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

errorVal

string | number | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

需要标识号的错误值，可以是实际错误值，也可以是对包含错误值的单元格的引用。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

even(number)

将正数向上舍入，将负数向下舍入到最接近的偶数整数。

even(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要舍入的值。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

exact(text1, text2)

检查两个文本字符串是否完全相同，并返回 TRUE 或 FALSE。 EXACT 区分大小写。

exact(text1: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, text2: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<boolean>;

参数

text1

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是第一个文本字符串。

text2

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

第二个文本字符串。

返回

Excel.FunctionResult<boolean>

注解

[ API 集：ExcelApi 1.2 ]

exp(number)

返回将 e 提升到给定数字的幂。

exp(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

应用于底 e 的指数。 常量 e 等于 2.71828182845904，即自然对数的基数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

expon_Dist(x, lambda, cumulative)

返回指数分布。

expon_Dist(x: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, lambda: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, cumulative: boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

x

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

函数的值，一个非数值。

lambda

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

参数值是正数。

cumulative

boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要返回的函数的逻辑值：累积分布函数 = TRUE;概率密度函数 = FALSE。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

f_Dist_RT(x, degFreedom1, degFreedom2)

返回两个数据集的 (右尾) F 概率分布 (多样性程度) 。

f_Dist_RT(x: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, degFreedom1: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, degFreedom2: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

x

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

计算函数的值，一个非数值。

degFreedom1

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

分子自由度，介于 1 和 10^10 之间的数字，不包括 10^10。

degFreedom2

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

自由度分母，介于 1 和 10^10 之间的数字，不包括 10^10。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

f_Dist(x, degFreedom1, degFreedom2, cumulative)

返回两个数据集的 (左尾) F 概率分布 (多样性) 。

f_Dist(x: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, degFreedom1: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, degFreedom2: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, cumulative: boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

x

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

计算函数的值，一个非数值。

degFreedom1

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

分子自由度，介于 1 和 10^10 之间的数字，不包括 10^10。

degFreedom2

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

自由度分母，介于 1 和 10^10 之间的数字，不包括 10^10。

cumulative

boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要返回的函数的逻辑值：累积分布函数 = TRUE;概率密度函数 = FALSE。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

f_Inv_RT(probability, degFreedom1, degFreedom2)

返回 (右尾) F 概率分布的反值：如果 p = F.DIST。RT (x,...) ，然后是 F.INV。RT (p,...) = x。

f_Inv_RT(probability: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, degFreedom1: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, degFreedom2: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

probability

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是与 F 累积分布相关的概率，介于 0 和 1（含 0 和 1）之间。

degFreedom1

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

分子自由度，介于 1 和 10^10 之间的数字，不包括 10^10。

degFreedom2

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

自由度分母，介于 1 和 10^10 之间的数字，不包括 10^10。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

f_Inv(probability, degFreedom1, degFreedom2)

返回 (左尾) F 概率分布的反函数：如果 p = F.DIST (x,...) ，则 F.INV (p,...) = x。

f_Inv(probability: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, degFreedom1: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, degFreedom2: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

probability

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是与 F 累积分布相关的概率，介于 0 和 1（含 0 和 1）之间。

degFreedom1

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

分子自由度，介于 1 和 10^10 之间的数字，不包括 10^10。

degFreedom2

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

自由度分母，介于 1 和 10^10 之间的数字，不包括 10^10。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

fact(number)

返回数字的阶乘，等于 123*...*数字。

fact(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

需要其阶乘的非否定数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

factDouble(number)

返回数字的双倍阶乘。

factDouble(number: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要为其返回双阶阶乘的值。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

false()

返回逻辑值 FALSE。

false(): FunctionResult<boolean>;

返回

Excel.FunctionResult<boolean>

注解

[ API 集：ExcelApi 1.2 ]

find(findText, withinText, startNum)

返回一个文本字符串在另一个文本字符串中的起始位置。 FIND 区分大小写。

find(findText: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, withinText: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, startNum?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

findText

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要查找的文本。 使用双引号 (空文本) 来匹配Text 中的第一个字符;不允许通配符。

withinText

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

包含要查找的文本的文本。

startNum

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

指定开始搜索的字符。 Text 中的第一个字符是字符数 1。 如果省略，则 startNum = 1。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

findB(findText, withinText, startNum)

查找另一个文本字符串中的一个文本字符串的起始位置。 FINDB 区分大小写。 与 DBCS) (双字节字符集一起使用。

findB(findText: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, withinText: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, startNum?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

findText

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要查找的文本。

withinText

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

包含要查找的文本的文本。

startNum

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

指定开始搜索的字符。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

fisher(x)

返回 Fisher 转换。

fisher(x: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

x

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

需要转换的值，一个介于 -1 和 1 之间的数字，不包括 -1 和 1。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

fisherInv(y)

返回 Fisher 转换的反函数：如果 y = FISHER (x) ，则 FISHERINV (y) = x。

fisherInv(y: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

y

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要对其执行反向转换的值。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

fixed(number, decimals, noCommas)

将数字舍入到指定的小数位数，并将结果返回为带逗号或不带逗号的文本。

fixed(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, decimals?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, noCommas?: boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要舍入并转换为文本的数字。

decimals

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

小数点右侧的位数。 如果省略，则 Decimals = 2。

noCommas

boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个逻辑值：不要在返回的文本 = TRUE 中显示逗号;在返回的文本 = FALSE 或省略时显示逗号。

返回

Excel.FunctionResult<string>

注解

[ API 集：ExcelApi 1.2 ]

floor_Math(number, significance, mode)

将数字向下舍入为最接近的整数或最接近的倍数。

floor_Math(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, significance?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, mode?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要舍入的值。

significance

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要舍入到的倍数。

mode

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

如果给定 且为非零，则此函数将舍入为零。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

floor_Precise(number, significance)

将数字向下舍入为最接近的整数或最接近的倍数。

floor_Precise(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, significance?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要舍入的数值。

significance

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要舍入到的倍数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

fv(rate, nper, pmt, pv, type)

基于固定利率和等额分期付款方式，返回某项投资的未来值。

fv(rate: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, nper: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, pmt: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, pv?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, type?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

rate

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每个周期的利率。 例如，对于 6% APR 的季度付款，请使用 6%/4。

nper

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

投资中的付款期总数。

pmt

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是每个周期的付款;它不能在投资的整个生命周期内改变。

pv

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一系列未来付款现在的现值或总和金额。 如果省略，则 Pv = 0。

type

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

表示付款时间的值：期初付款 = 1;期末付款 = 0 或省略。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

fvschedule(principal, schedule)

基于一系列复利返回本金的未来值。

fvschedule(principal: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, schedule: number | string | Excel.Range | boolean | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

principal

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是现值。

schedule

number | string | Excel.Range | boolean | Excel.RangeReference | Excel.FunctionResult<any>

要应用的利率数组。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

gamma_Dist(x, alpha, beta, cumulative)

返回 γ 分布函数值。

gamma_Dist(x: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, alpha: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, beta: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, cumulative: boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

x

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要计算分布的值，非数值。

alpha

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是分布的参数，正数。

beta

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是分布的参数，正数。 如果 beta = 1，则为 GAMMA。DIST 返回标准伽玛分布。

cumulative

boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个逻辑值：返回累积分布函数 = TRUE;返回概率质量函数 = FALSE 或省略。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

gamma_Inv(probability, alpha, beta)

返回伽玛累积分布的反值：如果 p = GAMMA。DIST (x,...) ，然后是 GAMMA。INV (p,...) = x。

gamma_Inv(probability: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, alpha: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, beta: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

probability

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

与伽玛分布（介于 0 和 1 之间的数字）关联的概率（含 0 到 1）。

alpha

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是分布的参数，正数。

beta

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是分布的参数，正数。 如果 beta = 1，则为 GAMMA。INV 返回标准伽玛分布的反值。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

gamma(x)

返回 Gamma 函数值。

gamma(x: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

x

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要计算其 Gamma 的值。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

gammaLn_Precise(x)

返回 gamma 函数的自然对数。

gammaLn_Precise(x: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

x

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要计算其 GAMMALN 的值。PRECISE，一个正数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

gammaLn(x)

返回 gamma 函数的自然对数。

gammaLn(x: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

x

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要计算其 GAMMALN 的值，正数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

gauss(x)

返回小于标准正态累积分布的 0.5。

gauss(x: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

x

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

需要其分布的值。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

gcd(values)

返回最大的公用除数。

gcd(...values: Array<number | string | Excel.Range | boolean | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<number | string | Excel.Range | boolean | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素为 1 到 255 个值。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

geoMean(values)

返回正数值数据的数组或范围的几何平均值。

geoMean(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素为 1 到 255 个数字或名称、数组或引用，其中包含所需的平均值的数字。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

geStep(number, step)

测试数字是否大于阈值。

geStep(number: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, step?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要针对步骤测试的值。

step

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

阈值。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

harMean(values)

返回正数数据集的和谐平均值：倒数算术平均值的倒数。

harMean(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素为 1 到 255 个数字，或者名称、数组或引用，其中包含需要其调和平均值的数字。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

hex2Bin(number, places)

将十六进制数转换为二进制数。

hex2Bin(number: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, places?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要转换的十六进制数。

places

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的字符数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

hex2Dec(number)

将十六进制数转换为十进制数。

hex2Dec(number: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要转换的十六进制数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

hex2Oct(number, places)

将十六进制数转换为八进制数。

hex2Oct(number: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, places?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要转换的十六进制数。

places

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的字符数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

hlookup(lookupValue, tableArray, rowIndexNum, rangeLookup)

在表或值数组的上一行中查找值，并从指定的行返回同一列中的值。

hlookup(lookupValue: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, tableArray: Excel.Range | number | Excel.RangeReference | Excel.FunctionResult<any>, rowIndexNum: Excel.Range | number | Excel.RangeReference | Excel.FunctionResult<any>, rangeLookup?: boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number | string | boolean>;

参数

lookupValue

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要在表的第一行中找到的值，可以是值、引用或文本字符串。

tableArray

Excel.Range | number | Excel.RangeReference | Excel.FunctionResult<any>

在其中查找数据的文本、数字或逻辑值表。tableArray 可以是对区域或区域名称的引用。

rowIndexNum

Excel.Range | number | Excel.RangeReference | Excel.FunctionResult<any>

tableArray 中应从中返回匹配值的行号。 表中值的第一行是第 1 行。

rangeLookup

boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个逻辑值：查找最匹配的顶部行 (按升序排序) = TRUE 或省略;查找完全匹配项 = FALSE。

返回

Excel.FunctionResult<number | string | boolean>

注解

[ API 集：ExcelApi 1.2 ]

hour(serialNumber)

以数字的形式返回小时，从上午 0 (12：00 ) 到 23 (晚上 11：00 ) 。

hour(serialNumber: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

serialNumber

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

Microsoft Excel 使用的日期时间代码中的数字，或时间格式的文本，例如下午 16：48：00 或 4：48：00。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

创建快捷方式或跳转以打开存储在硬盘驱动器、网络服务器或 Internet 上的文档。

hyperlink(linkLocation: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, friendlyName?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number | string | boolean>;

参数

linkLocation

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

为要打开的文档提供路径和文件名、硬盘驱动器位置、UNC 地址或 URL 路径的文本。

friendlyName

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

单元格中显示的文本或数字。 如果省略，单元格将显示 linkLocation 文本。

返回

Excel.FunctionResult<number | string | boolean>

注解

[ API 集：ExcelApi 1.2 ]

hypGeom_Dist(sampleS, numberSample, populationS, numberPop, cumulative)

返回超几何分布。

hypGeom_Dist(sampleS: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, numberSample: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, populationS: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, numberPop: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, cumulative: boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

sampleS

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

示例中的成功次数。

numberSample

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

示例的大小。

populationS

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是总体中的成功次数。

numberPop

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

总体大小。

cumulative

boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个逻辑值：对于累积分布函数，请使用 TRUE;对于概率密度函数，请使用 FALSE。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

if(logicalTest, valueIfTrue, valueIfFalse)

检查是否满足条件，如果为 TRUE，则返回一个值，如果为 FALSE，则返回另一个值。

if(logicalTest: boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, valueIfTrue?: Excel.Range | number | string | boolean | Excel.RangeReference | Excel.FunctionResult<any>, valueIfFalse?: Excel.Range | number | string | boolean | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number | string | boolean>;

参数

logicalTest

boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

计算结果为 TRUE 或 FALSE 的任何值或表达式。

valueIfTrue

Excel.Range | number | string | boolean | Excel.RangeReference | Excel.FunctionResult<any>

logicalTest 为 TRUE 时返回的值。 如果省略，则返回 TRUE。 最多可以嵌套 7 个 IF 函数。

valueIfFalse

Excel.Range | number | string | boolean | Excel.RangeReference | Excel.FunctionResult<any>

logicalTest 为 FALSE 时返回的值。 如果省略，则返回 FALSE。

返回

Excel.FunctionResult<number | string | boolean>

注解

[ API 集：ExcelApi 1.2 ]

imAbs(inumber)

返回复数的绝对值 (模数) 。

imAbs(inumber: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

inumber

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

需要其绝对值的复数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

imaginary(inumber)

返回复数的虚系数。

imaginary(inumber: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

inumber

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个复数，需要其虚数系数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

imArgument(inumber)

返回参数 q，一个以弧度表示的角度。

imArgument(inumber: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

inumber

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

需要参数的复数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

imConjugate(inumber)

返回复数的复数共和值。

imConjugate(inumber: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

inumber

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个复数，需要为其共聚物。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

imCos(inumber)

返回复数的余弦值。

imCos(inumber: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

inumber

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个复数，需要余弦值。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

imCosh(inumber)

返回复数的双曲余弦值。

imCosh(inumber: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

inumber

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个复数，需要双曲余弦值。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

imCot(inumber)

返回复数的余切值。

imCot(inumber: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

inumber

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是需要余切的复数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

imCsc(inumber)

返回复数的余割值。

imCsc(inumber: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

inumber

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

需要余割的复数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

imCsch(inumber)

返回复数的双曲余割值。

imCsch(inumber: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

inumber

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个复数，需要其双曲余割值。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

imDiv(inumber1, inumber2)

返回两个复数的商。

imDiv(inumber1: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, inumber2: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

inumber1

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

复数分子或红利。

inumber2

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

复分母还是除数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

imExp(inumber)

返回复数的指数。

imExp(inumber: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

inumber

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个需要指数的复数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

imLn(inumber)

返回复数的自然对数。

imLn(inumber: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

inumber

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

需要自然对数的复数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

imLog10(inumber)

返回复数的以 10 为底的对数。

imLog10(inumber: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

inumber

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个复数，需要其通用对数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

imLog2(inumber)

返回复数的以 2 为底的对数。

imLog2(inumber: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

inumber

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个复数，需要以 2 为底数的对数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

imPower(inumber, number)

返回以整数幂引发的复数。

imPower(inumber: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, number: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

inumber

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是要提高到幂的复数。

number

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要将复数提高到的幂。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

imProduct(values)

返回 1 到 255 个复数的乘积。

imProduct(...values: Array<Excel.Range | number | string | boolean | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<Excel.Range | number | string | boolean | Excel.RangeReference | Excel.FunctionResult<any>>

Inumber1、Inumber2,...从 1 到 255 个复数相乘。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

imReal(inumber)

返回复数的实际系数。

imReal(inumber: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

inumber

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是需要其实际系数的复数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

imSec(inumber)

返回复数的正割值。

imSec(inumber: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

inumber

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是需要其正数的复数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

imSech(inumber)

返回复数的双曲正割值。

imSech(inumber: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

inumber

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是需要双曲正割的复数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

imSin(inumber)

返回复数的正弦值。

imSin(inumber: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

inumber

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个复数，需要正弦值。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

imSinh(inumber)

返回复数的双曲正弦值。

imSinh(inumber: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

inumber

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个复数，需要其双曲正弦值。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

imSqrt(inumber)

返回复数的平方根。

imSqrt(inumber: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

inumber

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是需要其平方根的复数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

imSub(inumber1, inumber2)

返回两个复数的差值。

imSub(inumber1: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, inumber2: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

inumber1

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要从中减去 inumber2 的复数。

inumber2

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要从 inumber1 中减去的复数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

imSum(values)

返回复数的总和。

imSum(...values: Array<Excel.Range | number | string | boolean | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<Excel.Range | number | string | boolean | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素是 1 到 255 个要添加的复数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

imTan(inumber)

返回复数的正切值。

imTan(inumber: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

inumber

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是需要正切的复数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

int(number)

将数字向下舍入到最接近的整数。

int(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要向下舍入为整数的实数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

intRate(settlement, maturity, investment, redemption, basis)

返回完全投资型债券的利率。

intRate(settlement: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, maturity: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, investment: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, redemption: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, basis?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的结算日期，以序列号表示。

maturity

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的到期日期，以序列号表示。

investment

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

在证券中投资的金额。

redemption

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

到期时接收的金额。

basis

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的日计数基础的类型。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

ipmt(rate, per, nper, pv, fv, type)

基于定期、固定付款和固定利率，返回投资给定期间的利息支付。

ipmt(rate: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, per: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, nper: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, pv: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, fv?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, type?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

rate

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每个周期的利率。 例如，对于 6% APR 的季度付款，请使用 6%/4。

per

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要查找兴趣的时间段，并且必须在 1 到 Nper 的范围内。

nper

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

投资中的付款期总数。

pv

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一系列未来付款现在的现值或总和金额。

fv

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是未来值，或者要在最后一次付款后获得的现金余额。 如果省略，则 Fv = 0。

type

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

表示付款时间的逻辑值：期末 = 0 或省略，期初 = 1。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

irr(values, guess)

返回一系列现金流的内部收益率。

irr(values: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, guess?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

values

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

对包含要计算其内部回报率的数字的单元格的数组或引用。

guess

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

您猜到接近 IRR 结果的数字;如果省略，则为 0.1 (10%) 。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

isErr(value)

检查值是否为 #N/A 以外的错误，并返回 TRUE 或 FALSE。

isErr(value: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<boolean>;

参数

value

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要测试的值。 值可以引用单元格、公式或引用单元格、公式或值的名称。

返回

Excel.FunctionResult<boolean>

注解

[ API 集：ExcelApi 1.2 ]

isError(value)

检查值是错误，并返回 TRUE 还是 FALSE。

isError(value: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<boolean>;

参数

value

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要测试的值。 值可以引用单元格、公式或引用单元格、公式或值的名称。

返回

Excel.FunctionResult<boolean>

注解

[ API 集：ExcelApi 1.2 ]

isEven(number)

如果数字为偶数，则返回 TRUE。

isEven(number: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要测试的值。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

isFormula(reference)

检查引用是对包含公式的单元格的引用，并返回 TRUE 还是 FALSE。

isFormula(reference: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<boolean>;

参数

reference

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

对要测试的单元格的引用。 引用可以是单元格引用、公式或引用单元格的名称。

返回

Excel.FunctionResult<boolean>

注解

[ API 集：ExcelApi 1.2 ]

isLogical(value)

检查值是 (TRUE 还是 FALSE) 的逻辑值，并返回 TRUE 或 FALSE。

isLogical(value: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<boolean>;

参数

value

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要测试的值。 值可以引用单元格、公式或引用单元格、公式或值的名称。

返回

Excel.FunctionResult<boolean>

注解

[ API 集：ExcelApi 1.2 ]

isNA(value)

检查值是 #N/A，并返回 TRUE 还是 FALSE。

isNA(value: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<boolean>;

参数

value

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要测试的值。 值可以引用单元格、公式或引用单元格、公式或值的名称。

返回

Excel.FunctionResult<boolean>

注解

[ API 集：ExcelApi 1.2 ]

isNonText(value)

检查值是否不是文本 (空白单元格不是文本) ，并返回 TRUE 或 FALSE。

isNonText(value: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<boolean>;

参数

value

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要测试的值：单元格;公式;或引用单元格、公式或值的名称。

返回

Excel.FunctionResult<boolean>

注解

[ API 集：ExcelApi 1.2 ]

isNumber(value)

检查值是数字，并返回 TRUE 还是 FALSE。

isNumber(value: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<boolean>;

参数

value

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要测试的值。 值可以引用单元格、公式或引用单元格、公式或值的名称。

返回

Excel.FunctionResult<boolean>

注解

[ API 集：ExcelApi 1.2 ]

iso_Ceiling(number, significance)

将数字向上舍入为最接近的整数或最接近的显著性倍数。

iso_Ceiling(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, significance?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要舍入的值。

significance

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要舍入到的可选倍数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

isOdd(number)

如果数字为奇数，则返回 TRUE。

isOdd(number: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要测试的值。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

isoWeekNum(date)

返回给定日期的一年中 ISO 周号。

isoWeekNum(date: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

date

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

Microsoft Excel 用于日期和时间计算的日期时间代码。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

ispmt(rate, per, nper, pv)

返回在投资的特定期间支付的利息。

ispmt(rate: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, per: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, nper: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, pv: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

rate

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每期利率。 例如，对于 6% APR 的季度付款，请使用 6%/4。

per

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要查找兴趣的时间段。

nper

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

投资中的付款期数。

pv

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

现在一系列未来付款的一次性总金额。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

isref(value)

检查值是引用，并返回 TRUE 还是 FALSE。

isref(value: Excel.Range | number | string | boolean | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<boolean>;

参数

value

Excel.Range | number | string | boolean | Excel.RangeReference | Excel.FunctionResult<any>

要测试的值。 值可以引用单元格、公式或引用单元格、公式或值的名称。

返回

Excel.FunctionResult<boolean>

注解

[ API 集：ExcelApi 1.2 ]

isText(value)

检查值是文本，并返回 TRUE 还是 FALSE。

isText(value: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<boolean>;

参数

value

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要测试的值。 值可以引用单元格、公式或引用单元格、公式或值的名称。

返回

Excel.FunctionResult<boolean>

注解

[ API 集：ExcelApi 1.2 ]

kurt(values)

返回一组数据的峰值。

kurt(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素为 1 到 255 个数字，或者名称、数组或引用，其中包含要对其进行峰度数的数字。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

large(array, k)

返回数据集中第 k 个最大值。 例如，第五大数字。

large(array: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, k: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

array

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要确定第 k 个最大值的数组或数据范围。

k

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

从要返回的值的数组或单元格区域中的最大) (的位置。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

lcm(values)

返回最不常见的倍数。

lcm(...values: Array<number | string | Excel.Range | boolean | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<number | string | Excel.Range | boolean | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素为 1 到 255 个值，需要其最不常见的倍数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

left(text, numChars)

返回文本字符串开头的指定字符数。

left(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, numChars?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

参数

text

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

包含要提取的字符的文本字符串。

numChars

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

指定要提取的 LEFT 字符数;如果省略，则为 1。

返回

Excel.FunctionResult<string>

注解

[ API 集：ExcelApi 1.2 ]

leftb(text, numBytes)

返回文本字符串开头的指定字符数。 与 DBCS) (双字节字符集一起使用。

leftb(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, numBytes?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

参数

text

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

包含要提取的字符的文本字符串。

numBytes

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

指定希望 LEFT 返回的字符数。

返回

Excel.FunctionResult<string>

注解

[ API 集：ExcelApi 1.2 ]

len(text)

返回文本字符串中的字符数。

len(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

text

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要查找其长度的文本。 空格计数为字符。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

lenb(text)

返回文本字符串中的字符数。 与 DBCS) (双字节字符集一起使用。

lenb(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

text

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要查找其长度的文本。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

ln(number)

返回数字的自然对数。

ln(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

需要其自然对数的正实数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

log(number, base)

按所指定的底数，返回一个数的对数。

log(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, base?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

需要其对数的正实数。

base

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

对数的基数;如果省略，则为 10。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

log10(number)

返回以 10 为底的对数。

log10(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

需要以 10 为底数的正实数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

logNorm_Dist(x, mean, standardDev, cumulative)

返回 x 的对数正态分布，其中 ln (x) 使用参数 Mean 和 Standard_dev 进行正常分布。

logNorm_Dist(x: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, mean: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, standardDev: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, cumulative: boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

x

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

计算函数的值，一个正数。

mean

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

ln (x) 的平均值。

standardDev

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

ln (x) 的标准偏差，正数。

cumulative

boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个逻辑值：对于累积分布函数，请使用 TRUE;对于概率密度函数，请使用 FALSE。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

logNorm_Inv(probability, mean, standardDev)

返回 x 的对数累积分布函数的反函数，其中 ln (x) 使用参数 Mean 和 Standard_dev 进行正常分布。

logNorm_Inv(probability: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, mean: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, standardDev: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

probability

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是与对数分布（介于 0 和 1 之间的数字）关联的概率，包括 0 和 1。

mean

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

ln (x) 的平均值。

standardDev

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

ln (x) 的标准偏差，正数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

lookup(lookupValue, lookupVector, resultVector)

从单行或单列范围或数组查找值。 为向后兼容而提供。

lookup(lookupValue: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, lookupVector: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, resultVector?: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number | string | boolean>;

参数

lookupValue

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

LOOKUP 在 lookupVector 中搜索的值，可以是数字、文本、逻辑值或名称或对值的引用。

lookupVector

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

仅包含一行或一列文本、数字或逻辑值（按升序排列）的区域。

resultVector

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

仅包含一行或一列的区域，其大小与 lookupVector 相同。

返回

Excel.FunctionResult<number | string | boolean>

注解

[ API 集：ExcelApi 1.2 ]

lower(text)

将文本字符串中的所有字母转换为小写。

lower(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

参数

text

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要转换为小写的文本。 文本中不是字母的字符不会更改。

返回

Excel.FunctionResult<string>

注解

[ API 集：ExcelApi 1.2 ]

match(lookupValue, lookupArray, matchType)

返回在指定方式下与指定数值匹配的数组中元素的相应位置。

match(lookupValue: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, lookupArray: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, matchType?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

lookupValue

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

用于在数组、数字、文本或逻辑值中查找所需值的值，或者对其中一个值的引用。

lookupArray

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

包含可能的查找值、值数组或对数组的引用的连续单元格区域。

matchType

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

指示要返回的值的数字 1、0 或 -1。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

max(values)

返回一组值中的最大值。 忽略逻辑值和文本。

max(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素为 1 到 255 个数字、空单元格、逻辑值或需要最大值的文本数字。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

maxA(values)

返回一组值中的最大值。 不忽略逻辑值和文本。

maxA(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素为 1 到 255 个数字、空单元格、逻辑值或需要最大值的文本数字。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

mduration(settlement, maturity, coupon, yld, frequency, basis)

返回假设面值为 $100 的证券的 Macauley 修改持续时间。

mduration(settlement: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, maturity: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, coupon: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, yld: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, frequency: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, basis?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的结算日期，以序列号表示。

maturity

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的到期日期，以序列号表示。

coupon

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的年优惠券率。

yld

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是证券的年收益率。

frequency

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每年的优惠券付款数。

basis

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的日计数基础的类型。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

median(values)

返回中值或给定数字集中间的数字。

median(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素为 1 到 255 个数字，或者名称、数组或引用，其中包含需要中值的数字。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

mid(text, startNum, numChars)

返回文本字符串中间的字符，给定起始位置和长度。

mid(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, startNum: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, numChars: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

参数

text

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要从中提取字符的文本字符串。

startNum

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要提取的第一个字符的位置。 Text 中的第一个字符是 1。

numChars

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

指定要从 Text 返回的字符数。

返回

Excel.FunctionResult<string>

注解

[ API 集：ExcelApi 1.2 ]

midb(text, startNum, numBytes)

返回文本字符串中间的字符，给定起始位置和长度。 与 DBCS) (双字节字符集一起使用。

midb(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, startNum: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, numBytes: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

参数

text

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

包含要提取的字符的文本字符串。

startNum

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要在文本中提取的第一个字符的位置。

numBytes

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

指定要从文本返回的字符数。

返回

Excel.FunctionResult<string>

注解

[ API 集：ExcelApi 1.2 ]

min(values)

返回一组值中的最小值。 忽略逻辑值和文本。

min(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素为 1 到 255 个数字、空单元格、逻辑值或所需的最小文本数字。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

minA(values)

返回一组值中的最小值。 不忽略逻辑值和文本。

minA(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素为 1 到 255 个数字、空单元格、逻辑值或所需的最小文本数字。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

minute(serialNumber)

返回分钟，一个介于 0 到 59 的数字。

minute(serialNumber: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

serialNumber

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

Microsoft Excel 使用的日期时间代码中的数字或时间格式的文本，例如下午 16：48：00 或 4：48：00。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

mirr(values, financeRate, reinvestRate)

返回一系列定期现金流的内部收益率，同时考虑投资成本和现金再投资利息。

mirr(values: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, financeRate: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, reinvestRate: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

values

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个数组或对单元格的引用，其中包含表示一系列付款的数字， (负) 和收入 (正) 在常规周期。

financeRate

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

在现金流中使用的资金上支付的利率。

reinvestRate

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是再投资时收到的现金流利率。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

mod(number, divisor)

返回数字除以除数后的余数。

mod(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, divisor: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

在执行除法后要查找其余数的数字。

divisor

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要除以 Number 的数字。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

month(serialNumber)

返回月份，即) 年 1 月 1 (到) 年 12 月 12 日 (的数字。

month(serialNumber: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

serialNumber

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

Microsoft Excel 使用的日期时间代码中的数字。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

mround(number, multiple)

返回参数按指定基数舍入后的数值。

mround(number: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, multiple: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要舍入的值。

multiple

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要进行舍入的倍数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

multiNomial(values)

返回一组数字的多项式。

multiNomial(...values: Array<number | string | Excel.Range | boolean | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<number | string | Excel.Range | boolean | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素是需要其多项式的 1 到 255 个值。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

n(value)

将非数字值转换为数字，将日期转换为序列号，将 TRUE 转换为 1，将任何其他值转换为 0 (零) 。

n(value: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

value

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要转换的值。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

na()

返回错误值 #N/A (值) 不可用。

na(): FunctionResult<number | string>;

返回

Excel.FunctionResult<number | string>

注解

[ API 集：ExcelApi 1.2 ]

negBinom_Dist(numberF, numberS, probabilityS, cumulative)

返回负二项式分布，即第Number_s次成功之前Number_f失败的概率，Probability_s成功的概率。

negBinom_Dist(numberF: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, numberS: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, probabilityS: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, cumulative: boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

numberF

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

失败次数。

numberS

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

成功的阈值数。

probabilityS

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

成功的概率;一个介于 0 和 1 之间的数字。

cumulative

boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个逻辑值：对于累积分布函数，请使用 TRUE;对于概率质量函数，请使用 FALSE。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

networkDays_Intl(startDate, endDate, weekend, holidays)

使用自定义周末参数返回两个日期之间的整个工作日数。

networkDays_Intl(startDate: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, endDate: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, weekend?: number | string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, holidays?: number | string | Excel.Range | boolean | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

startDate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

表示开始日期的序列号。

endDate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

表示结束日期的序列号。

weekend

number | string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

指定周末发生时间的数字或字符串。

holidays

number | string | Excel.Range | boolean | Excel.RangeReference | Excel.FunctionResult<any>

要从工作日历中排除的一个或多个序列号的可选集，例如州和联邦假日以及浮动假日。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

networkDays(startDate, endDate, holidays)

返回两个日期之间的整个工作日数。

networkDays(startDate: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, endDate: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, holidays?: number | string | Excel.Range | boolean | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

startDate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

表示开始日期的序列号。

endDate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

表示结束日期的序列号。

holidays

number | string | Excel.Range | boolean | Excel.RangeReference | Excel.FunctionResult<any>

要从工作日历中排除的一个或多个序列号的可选集，例如州和联邦假日以及浮动假日。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

nominal(effectRate, npery)

返回年名义利率。

nominal(effectRate: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, npery: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

effectRate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是有效利率。

npery

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是每年的复合周期数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

norm_Dist(x, mean, standardDev, cumulative)

返回指定平均值和标准偏差的正态分布。

norm_Dist(x: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, mean: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, standardDev: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, cumulative: boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

x

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

需要其分布的值。

mean

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

分布的算术平均值。

standardDev

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

分布的标准偏差，正数。

cumulative

boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个逻辑值：对于累积分布函数，请使用 TRUE;对于概率密度函数，请使用 FALSE。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

norm_Inv(probability, mean, standardDev)

返回指定平均值和标准偏差的正态累积分布函数的反函数。

norm_Inv(probability: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, mean: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, standardDev: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

probability

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是对应于正态分布的概率，介于 0 和 1（含 0 和 1）之间的数字。

mean

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

分布的算术平均值。

standardDev

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

分布的标准偏差，正数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

norm_S_Dist(z, cumulative)

返回标准正态分布 (的平均值为零，标准偏差为 1) 。

norm_S_Dist(z: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, cumulative: boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

z

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

需要其分布的值。

cumulative

boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要返回的函数的逻辑值：累积分布函数 = TRUE;概率密度函数 = FALSE。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

norm_S_Inv(probability)

返回标准正态累积分布的反数， (的平均值为零，标准偏差为 1) 。

norm_S_Inv(probability: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

probability

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是对应于正态分布的概率，介于 0 和 1（含 0 和 1）之间的数字。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

not(logical)

将 FALSE 更改为 TRUE，或将 TRUE 更改为 FALSE。

not(logical: boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<boolean>;

参数

logical

boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

可计算为 TRUE 或 FALSE 的值或表达式。

返回

Excel.FunctionResult<boolean>

注解

[ API 集：ExcelApi 1.2 ]

now()

返回格式为日期和时间的当前日期和时间。

now(): FunctionResult<number>;

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

nper(rate, pmt, pv, fv, type)

基于固定利率及等额分期付款方式，返回某项投资的总期数。

nper(rate: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, pmt: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, pv: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, fv?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, type?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

rate

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每个周期的利率。 例如，对于 6% APR 的季度付款，请使用 6%/4。

pmt

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是每个周期的付款;它不能在投资的整个生命周期内改变。

pv

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一系列未来付款现在的现值或总和金额。

fv

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是未来值，或者要在最后一次付款后获得的现金余额。 如果省略，则使用零。

type

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个逻辑值：期初付款 = 1;期末付款 = 0 或省略。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

npv(rate, values)

根据折扣率和一系列未来付款返回投资的净现值， (负值) 和收入 (正值) 。

npv(rate: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, ...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

rate

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

一个时间段的折扣率。

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素为 1 到 254 个付款和收入，在时间上相等，在每个周期结束时发生。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

numberValue(text, decimalSeparator, groupSeparator)

以独立于区域设置的方式将文本转换为数字。

numberValue(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, decimalSeparator?: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, groupSeparator?: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

text

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

表示要转换的数字的字符串。

decimalSeparator

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

字符串中用作小数分隔符的字符。

groupSeparator

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

字符串中用作组分隔符的字符。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

oct2Bin(number, places)

将八进制数转换为二进制数。

oct2Bin(number: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, places?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要转换的八进制数。

places

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的字符数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

oct2Dec(number)

将八进制数转换为十进制数。

oct2Dec(number: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要转换的八进制数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

oct2Hex(number, places)

将八进制数转换为十六进制数。

oct2Hex(number: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, places?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要转换的八进制数。

places

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的字符数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

odd(number)

将正数向上舍入，将负数向下舍入到最接近的奇数。

odd(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要舍入的值。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

oddFPrice(settlement, maturity, issue, firstCoupon, rate, yld, redemption, frequency, basis)

返回具有奇数第一期的证券的每 100 美元面值的价格。

oddFPrice(settlement: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, maturity: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, issue: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, firstCoupon: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, rate: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, yld: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, redemption: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, frequency: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, basis?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的结算日期，以序列号表示。

maturity

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的到期日期，以序列号表示。

issue

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的发行日期，以序列号表示。

firstCoupon

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的第一个优惠券日期，以序列号表示。

rate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

债券的利率。

yld

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是证券的年收益率。

redemption

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每 100 美元面值的证券赎回价值。

frequency

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每年的优惠券付款数。

basis

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的日计数基础的类型。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

oddFYield(settlement, maturity, issue, firstCoupon, rate, pr, redemption, frequency, basis)

返回第一个周期为奇数的证券的收益率。

oddFYield(settlement: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, maturity: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, issue: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, firstCoupon: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, rate: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, pr: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, redemption: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, frequency: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, basis?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的结算日期，以序列号表示。

maturity

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的到期日期，以序列号表示。

issue

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的发行日期，以序列号表示。

firstCoupon

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的第一个优惠券日期，以序列号表示。

rate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

债券的利率。

pr

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是证券的价格。

redemption

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每 100 美元面值的证券赎回价值。

frequency

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每年的优惠券付款数。

basis

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的日计数基础的类型。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

oddLPrice(settlement, maturity, lastInterest, rate, yld, redemption, frequency, basis)

返回具有奇数最后一周期的证券的每 100 美元面值的价格。

oddLPrice(settlement: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, maturity: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, lastInterest: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, rate: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, yld: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, redemption: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, frequency: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, basis?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的结算日期，以序列号表示。

maturity

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的到期日期，以序列号表示。

lastInterest

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的最后优惠券日期，以序列号表示。

rate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

债券的利率。

yld

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是证券的年收益率。

redemption

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每 100 美元面值的证券赎回价值。

frequency

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每年的优惠券付款数。

basis

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的日计数基础的类型。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

oddLYield(settlement, maturity, lastInterest, rate, pr, redemption, frequency, basis)

返回最后一个周期为奇数的证券的收益率。

oddLYield(settlement: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, maturity: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, lastInterest: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, rate: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, pr: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, redemption: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, frequency: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, basis?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的结算日期，以序列号表示。

maturity

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的到期日期，以序列号表示。

lastInterest

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的最后优惠券日期，以序列号表示。

rate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

债券的利率。

pr

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是证券的价格。

redemption

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每 100 美元面值的证券赎回价值。

frequency

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每年的优惠券付款数。

basis

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的日计数基础的类型。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

or(values)

检查任何参数是否为 TRUE，并返回 TRUE 或 FALSE。 仅当所有参数均为 FALSE 时，才返回 FALSE。

or(...values: Array<boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<boolean>;

参数

values

Array<boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素是要测试的 1 到 255 个条件，可以是 TRUE 或 FALSE。

返回

Excel.FunctionResult<boolean>

注解

[ API 集：ExcelApi 1.2 ]

pduration(rate, pv, fv)

返回投资达到指定值所需的时间段数。

pduration(rate: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, pv: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, fv: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

rate

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每个周期的利率。

pv

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

投资的现值。

fv

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

投资的所需未来价值。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

percentile_Exc(array, k)

返回区域中数值的第 k 个百分点的值，其中 k 的范围是从 0 到 1（不包括 0 和 1）。

percentile_Exc(array: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, k: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

array

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

定义相对位置的数组或数据区域。

k

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

介于 0 到 1（含）之间的百分位值。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

percentile_Inc(array, k)

返回区域中值的第 k 个百分位，其中 k 在范围 0..1（含） 内。

percentile_Inc(array: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, k: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

array

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

定义相对位置的数组或数据区域。

k

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

介于 0 到 1（含）之间的百分位值。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

percentRank_Exc(array, x, significance)

返回特定数值在一个数据集中的百分比（从 0 到 1，不包括 0 和 1）排位。

percentRank_Exc(array: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, x: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, significance?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

array

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

具有定义相对站立的数值的数组或数据区域。

x

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

想要了解其排名的值。

significance

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个可选值，用于标识返回的百分比（如果省略 (0.xxx%) ，则为 3 位数字）。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

percentRank_Inc(array, x, significance)

返回某个值在一个数据集中的百分比（从 0 到 1，包括 0 和 1）排位。

percentRank_Inc(array: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, x: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, significance?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

array

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

具有定义相对站立的数值的数组或数据区域。

x

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

想要了解其排名的值。

significance

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个可选值，用于标识返回的百分比（如果省略 (0.xxx%) ，则为 3 位数字）。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

permut(number, numberChosen)

返回给定数量的对象（可从总对象中选择）的排列数。

permut(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, numberChosen: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

对象的总数。

numberChosen

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每个排列中的对象数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

permutationa(number, numberChosen)

返回给定数量的对象的排列数， (可从对象总数中选择的重复) 。

permutationa(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, numberChosen: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

对象的总数。

numberChosen

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每个排列中的对象数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

phi(x)

返回标准正态分布的密度函数的值。

phi(x: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

x

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

需要其标准正态分布密度的数字。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

pi()

返回 Pi 值 3.14159265358979，精确到 15 位。

pi(): FunctionResult<number>;

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

pmt(rate, nper, pv, fv, type)

基于固定利率及等额分期付款方式，计算贷款的每期付款额。

pmt(rate: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, nper: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, pv: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, fv?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, type?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

rate

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

贷款的每期利率。 例如，对于 6% APR 的季度付款，请使用 6%/4。

nper

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

贷款的付款总数。

pv

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是现值：一系列未来付款现在的总金额。

fv

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是要在上次付款后获得的未来值或现金余额，如果省略，则为 0 (零) 。

type

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个逻辑值：期初付款 = 1;期末付款 = 0 或省略。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

poisson_Dist(x, mean, cumulative)

返回泊松分布。

poisson_Dist(x: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, mean: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, cumulative: boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

x

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

事件数。

mean

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是预期的数值，一个正数。

cumulative

boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个逻辑值：对于累积泊松概率，请使用 TRUE;对于泊松概率质量函数，请使用 FALSE。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

power(number, power)

返回某数的乘幂结果。

power(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, power: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是基数，任何实数。

power

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

将基数提高到的指数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

ppmt(rate, per, nper, pv, fv, type)

根据定期、固定付款和固定利率返回给定投资本金的付款。

ppmt(rate: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, per: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, nper: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, pv: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, fv?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, type?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

rate

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每个周期的利率。 例如，对于 6% APR 的季度付款，请使用 6%/4。

per

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

指定时间段，并且必须在 1 到 nper 的范围内。

nper

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

投资中的付款期总数。

pv

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是现值：一系列未来付款现在的总金额。

fv

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是要在进行最后一次付款后获得的未来值或现金余额。

type

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个逻辑值：期初付款 = 1;期末付款 = 0 或省略。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

price(settlement, maturity, rate, yld, redemption, frequency, basis)

返回定期付息的面值 ￥100 的债券价格。

price(settlement: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, maturity: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, rate: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, yld: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, redemption: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, frequency: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, basis?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的结算日期，以序列号表示。

maturity

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的到期日期，以序列号表示。

rate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的年优惠券率。

yld

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是证券的年收益率。

redemption

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每 100 美元面值的证券赎回价值。

frequency

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每年的优惠券付款数。

basis

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的日计数基础的类型。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

priceDisc(settlement, maturity, discount, redemption, basis)

返回折价发行的面值 ￥100 的债券的价格。

priceDisc(settlement: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, maturity: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, discount: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, redemption: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, basis?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的结算日期，以序列号表示。

maturity

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的到期日期，以序列号表示。

discount

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的折扣率。

redemption

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每 100 美元面值的证券赎回价值。

basis

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的日计数基础的类型。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

priceMat(settlement, maturity, issue, rate, yld, basis)

返回到期付息的面值 ￥100 的债券的价格。

priceMat(settlement: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, maturity: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, issue: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, rate: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, yld: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, basis?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的结算日期，以序列号表示。

maturity

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的到期日期，以序列号表示。

issue

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的发行日期，以序列号表示。

rate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

债券发行日利率。

yld

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是证券的年收益率。

basis

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的日计数基础的类型。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

product(values)

将作为参数提供的所有数字相乘。

product(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素为 1 到 255 个数字、逻辑值或要相乘的数字的文本表示形式。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

proper(text)

将文本字符串转换为正确的大小写;每个单词中的第一个字母为大写，所有其他字母为小写。

proper(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

参数

text

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是用引号括起来的文本、返回文本的公式，还是对包含要部分大写的文本的单元格的引用。

返回

Excel.FunctionResult<string>

注解

[ API 集：ExcelApi 1.2 ]

pv(rate, nper, pmt, fv, type)

返回投资的现值：一系列未来付款现在的价值总额。

pv(rate: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, nper: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, pmt: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, fv?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, type?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

rate

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每个周期的利率。 例如，对于 6% APR 的季度付款，请使用 6%/4。

nper

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

投资中的付款期总数。

pmt

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是每个时期的付款，并且不能在投资的整个生命周期内更改。

fv

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是未来值，或者要在最后一次付款后获得的现金余额。

type

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个逻辑值：期初付款 = 1;期末付款 = 0 或省略。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

quartile_Exc(array, quart)

基于 0..1（排除）的百分位值返回数据集的四分位数。

quartile_Exc(array: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, quart: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

array

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

需要其四分位值的数值的数组或单元格范围。

quart

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个数字：最小值 = 0;第 1 个四分位数 = 1;中值 = 2;第三个四分位数 = 3;最大值 = 4。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

quartile_Inc(array, quart)

基于 0..1（含）的百分位值返回数据集的四分位数。

quartile_Inc(array: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, quart: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

array

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

需要其四分位值的数值的数组或单元格范围。

quart

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个数字：最小值 = 0;第 1 个四分位数 = 1;中值 = 2;第三个四分位数 = 3;最大值 = 4。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

quotient(numerator, denominator)

返回除法的整数部分。

quotient(numerator: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, denominator: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

numerator

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是股息。

denominator

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是除数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

radians(angle)

将度转换为弧度。

radians(angle: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

angle

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要转换的角度（以度为单位）。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

rand()

返回一个大于或等于 0 且小于 1 的随机数，在重新计算) 时均匀分布 (更改。

rand(): FunctionResult<number>;

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

randBetween(bottom, top)

返回指定数字之间的随机数。

randBetween(bottom: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, top: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

bottom

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

将返回的最小整数 RANDBETWEEN。

top

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

将返回的最大整数 RANDBETWEEN。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

rank_Avg(number, ref, order)

返回数字列表中数字的排名：其大小相对于列表中的其他值;如果多个值具有相同的排名，则返回平均排名。

rank_Avg(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, ref: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, order?: boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要查找其排名的数字。

ref

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是数字列表的数组或对 的引用。 忽略非数值。

order

boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个数字：按降序排列的列表中的排名 = 0 或省略;排名在列表中按升序排序 = 任何非零值。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

rank_Eq(number, ref, order)

返回数字列表中数字的排名：其大小相对于列表中的其他值;如果多个值具有相同的排名，则返回该值集的最高排名。

rank_Eq(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, ref: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, order?: boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要查找其排名的数字。

ref

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是数字列表的数组或对 的引用。 忽略非数值。

order

boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个数字：按降序排列的列表中的排名 = 0 或省略;排名在列表中按升序排序 = 任何非零值。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

rate(nper, pmt, pv, fv, type, guess)

返回每期贷款或投资的利率。 例如，对于 6% APR 的季度付款，请使用 6%/4。

rate(nper: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, pmt: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, pv: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, fv?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, type?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, guess?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

nper

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

贷款或投资的付款期总数。

pmt

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是每个时期的付款，不能在贷款或投资的生命周期内改变。

pv

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是现值：一系列未来付款现在的总金额。

fv

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是未来值，或者要在最后一次付款后获得的现金余额。 如果省略，则使用 Fv = 0。

type

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个逻辑值：期初付款 = 1;期末付款 = 0 或省略。

guess

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

你对费率的猜测是吗？如果省略，则 Guess = 0.1 (10%) 。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

received(settlement, maturity, investment, discount, basis)

返回完全投资型债券到期收回的金额。

received(settlement: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, maturity: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, investment: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, discount: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, basis?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的结算日期，以序列号表示。

maturity

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的到期日期，以序列号表示。

investment

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

在证券中投资的金额。

discount

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的折扣率。

basis

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的日计数基础的类型。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

replace(oldText, startNum, numChars, newText)

用不同的文本字符串替换文本字符串的一部分。

replace(oldText: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, startNum: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, numChars: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, newText: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

参数

oldText

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要替换某些字符的文本。

startNum

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要用 newText 替换的字符在 oldText 中的位置。

numChars

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要替换的 oldText 中的字符数。

newText

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

将替换 oldText 中的字符的文本。

返回

Excel.FunctionResult<string>

注解

[ API 集：ExcelApi 1.2 ]

replaceB(oldText, startNum, numBytes, newText)

用不同的文本字符串替换文本字符串的一部分。 与 DBCS) (双字节字符集一起使用。

replaceB(oldText: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, startNum: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, numBytes: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, newText: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

参数

oldText

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要替换某些字符的文本。

startNum

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要用 newText 替换的字符在 oldText 中的位置。

numBytes

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要用 newText 替换的 oldText 中的字符数。

newText

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

将替换 oldText 中的字符的文本。

返回

Excel.FunctionResult<string>

注解

[ API 集：ExcelApi 1.2 ]

rept(text, numberTimes)

按照给定的次数重复显示文本。 可以通过函数 REPT 来不断地重复显示某一文本字符串，对单元格进行填充。

rept(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, numberTimes: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

参数

text

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要重复的文本。

numberTimes

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个正数，指定重复文本的次数。

返回

Excel.FunctionResult<string>

注解

[ API 集：ExcelApi 1.2 ]

right(text, numChars)

返回文本字符串末尾的指定字符数。

right(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, numChars?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

参数

text

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

包含要提取的字符的文本字符串。

numChars

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

指定要提取的字符数，如果省略，则为 1。

返回

Excel.FunctionResult<string>

注解

[ API 集：ExcelApi 1.2 ]

rightb(text, numBytes)

返回文本字符串末尾的指定字符数。 与 DBCS) (双字节字符集一起使用。

rightb(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, numBytes?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

参数

text

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

包含要提取的字符的文本字符串。

numBytes

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

指定要提取的字符数。

返回

Excel.FunctionResult<string>

注解

[ API 集：ExcelApi 1.2 ]

roman(number, form)

将阿拉伯数字转换为罗马数字作为文本。

roman(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, form?: boolean | number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要转换的阿拉伯数字。

form

boolean | number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

指定所需罗马数字类型的数字。

返回

Excel.FunctionResult<string>

注解

[ API 集：ExcelApi 1.2 ]

round(number, numDigits)

将数字舍入到指定位数。

round(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, numDigits: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要舍入的数字。

numDigits

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要舍入到的位数。 负数舍入到小数点左侧;零到最接近的整数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

roundDown(number, numDigits)

将数字向零的方向向下舍入。

roundDown(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, numDigits: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要向下舍入的任何实数。

numDigits

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要舍入到的位数。 负数舍入到小数点左侧;零或省略，为最接近的整数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

roundUp(number, numDigits)

将数字从零向上舍入。

roundUp(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, numDigits: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要舍入的任何实数。

numDigits

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要舍入到的位数。 负数舍入到小数点左侧;零或省略，为最接近的整数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

rows(array)

返回引用或数组中的行数。

rows(array: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

array

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

需要其行数的数组、数组公式或对单元格区域的引用。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

rri(nper, pv, fv)

返回投资增长的等效利率。

rri(nper: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, pv: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, fv: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

nper

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

投资的周期数。

pv

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

投资的现值。

fv

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

投资的未来价值。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

sec(number)

返回角度的正割值。

sec(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

需要其正割值的角度（以弧度为单位）。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

sech(number)

返回角度的双曲正割值。

sech(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

需要其双曲正割值的角度（以弧度为单位）。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

second(serialNumber)

返回第二个值，即从 0 到 59 的数字。

second(serialNumber: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

serialNumber

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

Microsoft Excel 使用的日期时间代码中的数字或时间格式的文本，例如下午 16：48：23 或 4：48：47。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

seriesSum(x, n, m, coefficients)

返回基于公式的幂系列的总和。

seriesSum(x: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, n: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, m: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, coefficients: Excel.Range | string | number | boolean | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

x

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

电源系列的输入值。

n

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要将 x 提升到的初始幂。

m

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

序列中每个字词增加 n 的步骤。

coefficients

Excel.Range | string | number | boolean | Excel.RangeReference | Excel.FunctionResult<any>

是 x 的每个连续幂乘以的一组系数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

sheet(value)

返回所引用工作表的工作表编号。

sheet(value?: Excel.Range | string | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

value

Excel.Range | string | Excel.RangeReference | Excel.FunctionResult<any>

需要其工作表编号的工作表或引用的名称。 如果省略，则返回包含函数的工作表的编号。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

sheets(reference)

返回引用中的工作表数。

sheets(reference?: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

reference

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

你希望了解其包含的工作表数的引用。 如果省略，则返回包含函数的工作簿中的工作表数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

sign(number)

返回数字的符号：1 如果数字为正，则返回零;如果数字为零，则返回 -1（如果数字为负）。

sign(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是任何实数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

sin(number)

返回角度的正弦值。

sin(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

需要正弦值的角度（以弧度为单位）。 Degrees * PI () /180 = 弧度。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

sinh(number)

返回某一数字的双曲正弦值。

sinh(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是任何实数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

skew_p(values)

返回基于总体的分布的偏斜性：表示分布围绕其平均值的不对称程度。

skew_p(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素为 1 到 254 个数字，或者名称、数组或引用，其中包含需要其总体偏差的数字。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

skew(values)

返回分布的偏斜性：表示分布围绕其平均值的不对称程度。

skew(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素为 1 到 255 个数字，或者名称、数组或引用，其中包含需要偏斜的数字。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

sln(cost, salvage, life)

返回某项资产一个周期的直线折旧值。

sln(cost: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, salvage: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, life: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

cost

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

资产的初始成本。

salvage

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

资产生命周期结束时的打捞值。

life

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

资产贬值的周期数， (有时称为资产) 的使用寿命。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

small(array, k)

返回数据集中第 k 个最小值。 例如，第五个最小数字。

small(array: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, k: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

array

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要确定第 k 个最小值的数字数据的数组或范围。

k

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

从要返回的值的数组或区域中的最小) (的位置。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

sqrt(number)

返回数字的平方根。

sqrt(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

需要其平方根的数字。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

sqrtPi(number)

返回 (数字 * Pi) 的平方根。

sqrtPi(number: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

p 乘以的数字。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

standardize(x, mean, standardDev)

从以平均值和标准偏差为特征的分布中返回规范化值。

standardize(x: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, mean: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, standardDev: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

x

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要规范化的值。

mean

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

分布的算术平均值。

standardDev

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

分布的标准偏差，正数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

stDev_P(values)

根据作为参数给出的整个总体计算标准偏差， (忽略逻辑值和文本) 。

stDev_P(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素是对应于总体的 1 到 255 个数字，可以是包含数字的数字或引用。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

stDev_S(values)

根据样本估计标准偏差 (忽略示例) 中的逻辑值和文本。

stDev_S(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素是对应于总体样本的 1 到 255 个数字，可以是包含数字的数字或引用。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

stDevA(values)

根据样本（包括逻辑值和文本）估算标准偏差。 文本和逻辑值 FALSE 的值为 0;逻辑值 TRUE 的值为 1。

stDevA(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素是对应于总体样本的 1 到 255 个值，可以是值、名称或对值的引用。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

stDevPA(values)

基于整个总体（包括逻辑值和文本）计算标准偏差。 文本和逻辑值 FALSE 的值为 0;逻辑值 TRUE 的值为 1。

stDevPA(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素是对应于总体的 1 到 255 个值，可以是包含值的值、名称、数组或引用。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

substitute(text, oldText, newText, instanceNum)

将现有文本替换为文本字符串中的新文本。

substitute(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, oldText: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, newText: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, instanceNum?: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

参数

text

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要在其中替换字符的文本或对包含文本的单元格的引用。

oldText

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要替换的现有文本。 如果 oldText 大小写与文本大小写不匹配，SUBSTITUTE 将不会替换文本。

newText

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要替换 oldText 的文本。

instanceNum

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

指定要替换的 oldText 的匹配项。 如果省略，则替换每个 oldText 实例。

返回

Excel.FunctionResult<string>

注解

[ API 集：ExcelApi 1.2 ]

subtotal(functionNum, values)

返回列表或数据库中的分类汇总。

subtotal(functionNum: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, ...values: Array<Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

functionNum

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

指定小计摘要函数的数字 1 到 11。

values

Array<Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素是需要小计的 1 到 254 个范围或引用。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

sum(values)

对某单元格区域中的所有数字求和。

sum(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素为 1 到 255 个数字的总和。 逻辑值和文本在单元格中被忽略，如果键入为参数，则包含这些值和文本。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

示例

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/50-workbook/workbook-built-in-functions.yaml

await Excel.run(async (context) => {
  // This function uses VLOOKUP to find data in the "Wrench" row 
  // on the worksheet, and then it uses SUM to combine the values.
  let range = context.workbook.worksheets.getItem("Sample").getRange("A1:D4");

  // Get the values in the second, third, and fourth columns in the "Wrench" row,
  // and combine those values with SUM. 
  let sumOfTwoLookups = context.workbook.functions.sum(
    context.workbook.functions.vlookup("Wrench", range, 2, false),
    context.workbook.functions.vlookup("Wrench", range, 3, false),
    context.workbook.functions.vlookup("Wrench", range, 4, false)
  );
  sumOfTwoLookups.load("value");

  await context.sync();
  console.log(" Number of wrenches sold in November, December, and January = " + sumOfTwoLookups.value);
});

sumIf(range, criteria, sumRange)

添加由给定条件或条件指定的单元格。

sumIf(range: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, criteria: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, sumRange?: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

range

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要计算的单元格区域。

criteria

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

定义要添加的单元格的数字、表达式或文本形式的条件或条件。

sumRange

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要求和的实际单元格。 如果省略，则使用区域中的单元格。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

sumIfs(sumRange, values)

添加由一组给定条件或条件指定的单元格。

sumIfs(sumRange: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, ...values: Array<Excel.Range | Excel.RangeReference | Excel.FunctionResult<any> | number | string | boolean>): FunctionResult<number>;

参数

sumRange

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要求和的实际单元格。

values

Array<Excel.Range | Excel.RangeReference | Excel.FunctionResult<any> | number | string | boolean>

参数列表，其中每对的第一个元素是要针对特定条件计算的单元格区域，第二个元素是定义将添加哪些单元格的数字、表达式或文本形式的条件或条件。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

sumSq(values)

返回参数的平方之和。 参数可以是数字、数组、名称或对包含数字的单元格的引用。

sumSq(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素为 1 到 255 个数字、数组、名称或对需要其平方和的数组的引用。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

syd(cost, salvage, life, per)

返回某项资产按年限总和折旧法计算的指定期间的折旧值。

syd(cost: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, salvage: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, life: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, per: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

cost

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

资产的初始成本。

salvage

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

资产生命周期结束时的打捞值。

life

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

资产贬值的周期数， (有时称为资产) 的使用寿命。

per

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

周期和必须使用与 Life 相同的单位。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

t_Dist_2T(x, degFreedom)

返回双尾学生的 t 分布。

t_Dist_2T(x: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, degFreedom: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

x

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

计算分布的数值。

degFreedom

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个整数，指示表示分布特征的自由度数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

t_Dist_RT(x, degFreedom)

返回右尾学生的 t 分布。

t_Dist_RT(x: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, degFreedom: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

x

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

计算分布的数值。

degFreedom

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个整数，指示表示分布特征的自由度数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

t_Dist(x, degFreedom, cumulative)

返回左尾学生的 t 分布。

t_Dist(x: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, degFreedom: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, cumulative: boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

x

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

计算分布的数值。

degFreedom

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个整数，指示表示分布特征的自由度数。

cumulative

boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个逻辑值：对于累积分布函数，请使用 TRUE;对于概率密度函数，请使用 FALSE。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

t_Inv_2T(probability, degFreedom)

返回学生的 t 分布的双尾反数。

t_Inv_2T(probability: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, degFreedom: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

probability

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

与双尾学生的 t 分布相关的概率，数字介于 0 和 1（含 0 和 1）之间。

degFreedom

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个正整数，指示用于特征分布的自由度数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

t_Inv(probability, degFreedom)

返回学生的 t 分布的左尾反数。

t_Inv(probability: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, degFreedom: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

probability

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

与双尾学生的 t 分布相关的概率，数字介于 0 和 1（含 0 和 1）之间。

degFreedom

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个正整数，指示用于特征分布的自由度数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

t(value)

检查值是否为文本，如果为，则返回文本;如果不是，则返回双引号 (空文本) 。

t(value: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

参数

value

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要测试的值。

返回

Excel.FunctionResult<string>

注解

[ API 集：ExcelApi 1.2 ]

tan(number)

返回一个角度的正切值。

tan(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要为其切线的角度（以弧度为单位）。 Degrees * PI () /180 = 弧度。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

tanh(number)

返回某一数字的双曲正切值。

tanh(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是任何实数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

tbillEq(settlement, maturity, discount)

返回国库券的债券等效收益率。

tbillEq(settlement: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, maturity: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, discount: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

国库券的结算日，以序列号表示。

maturity

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

国库券的到期日，以序列号表示。

discount

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是国库券的贴现率。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

tbillPrice(settlement, maturity, discount)

返回国库券每 100 美元面值的价格。

tbillPrice(settlement: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, maturity: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, discount: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

国库券的结算日，以序列号表示。

maturity

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

国库券的到期日，以序列号表示。

discount

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是国库券的贴现率。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

tbillYield(settlement, maturity, pr)

返回国库券的收益率。

tbillYield(settlement: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, maturity: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, pr: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

国库券的结算日，以序列号表示。

maturity

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

国库券的到期日，以序列号表示。

pr

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

国库券每 100 美元面值的价格。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

text(value, formatText)

将数值转换为按指定数字格式表示的文本。

text(value: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, formatText: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

参数

value

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

数字、计算结果为数值的公式，或对包含数值的单元格的引用。

formatText

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是“设置单元格格式”对话框中“数字”选项卡上的“类别”框的文本格式。

返回

Excel.FunctionResult<string>

注解

[ API 集：ExcelApi 1.2 ]

time(hour, minute, second)

将以数字形式给出的小时、分钟和秒转换为使用时间格式设置格式的 Excel 序列号。

time(hour: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, minute: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, second: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

hour

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

表示小时数的介于 0 到 23 的数字。

minute

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

表示分钟数的介于 0 到 59 的数字。

second

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

表示第二个数字的 0 到 59。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

timevalue(timeText)

将文本时间一次性转换为 Excel 序列号，从 0 (12：00：00 am) 到 0.999988426 (晚上 11：59：59) 。 输入公式后，使用时间格式设置数字的格式。

timevalue(timeText: string | number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

timeText

string | number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

一个文本字符串，它以任意一种Microsoft Excel 时间格式提供时间， (字符串中的日期信息) 被忽略。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

today()

返回格式为日期的当前日期。

today(): FunctionResult<number>;

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

toJSON()

重写 JavaScript toJSON() 方法，以便在将 API 对象传递给 JSON.stringify()时提供更有用的输出。 JSON.stringify (，反过来又调用toJSON传递给它的 对象的 方法。) 而原始Excel.Functions对象是 API 对象，toJSON该方法返回一个纯 JavaScript 对象， (类型为 Excel.Interfaces.FunctionsData) ，其中包含原始对象中任何已加载子属性的浅表副本。

toJSON(): {
            [key: string]: string;
        };

返回

{ [key: string]: string; }

trim(text)

删除文本字符串中的所有空格，单词之间的单个空格除外。

trim(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

参数

text

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要从中删除空格的文本。

返回

Excel.FunctionResult<string>

注解

[ API 集：ExcelApi 1.2 ]

trimMean(array, percent)

返回一组数据值的内部部分的平均值。

trimMean(array: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, percent: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

array

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要剪裁和平均值的值的范围或数组。

percent

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要从数据集的顶部和底部排除的数据点的小数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

true()

返回逻辑值 TRUE。

true(): FunctionResult<boolean>;

返回

Excel.FunctionResult<boolean>

注解

[ API 集：ExcelApi 1.2 ]

trunc(number, numDigits)

通过删除数字的十进制或小数部分，将数字截断为整数。

trunc(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, numDigits?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要截断的数字。

numDigits

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

指定截断精度的数字，如果省略，则为 0 (零) 。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

type(value)

返回一个整数，表示值的数据类型：number = 1;text = 2;逻辑值 = 4;error 值 = 16;array = 64;复合数据 = 128。

type(value: boolean | string | number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

value

boolean | string | number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

可以是任何值。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

unichar(number)

返回由给定数值引用的 Unicode 字符。

unichar(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

表示字符的 Unicode 编号。

返回

Excel.FunctionResult<string>

注解

[ API 集：ExcelApi 1.2 ]

unicode(text)

返回与文本的第一个字符对应的数字 (码位) 。

unicode(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

text

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

需要 Unicode 值的字符。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

upper(text)

将文本字符串转换为所有大写字母。

upper(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

参数

text

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要转换为大写、引用或文本字符串的文本。

返回

Excel.FunctionResult<string>

注解

[ API 集：ExcelApi 1.2 ]

usdollar(number, decimals)

使用货币格式将数字转换为文本。

usdollar(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, decimals?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

参数

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是数字、对包含数字的单元格的引用，或计算结果为数字的公式。

decimals

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

小数点右侧的位数。

返回

Excel.FunctionResult<string>

注解

[ API 集：ExcelApi 1.2 ]

value(text)

将表示数字的文本字符串转换为数字。

value(text: string | boolean | number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

text

string | boolean | number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是用引号括起来的文本，还是对包含要转换的文本的单元格的引用。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

var_P(values)

基于整个总体计算方差 (忽略总体) 中的逻辑值和文本。

var_P(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素是对应于总体的 1 到 255 个数值参数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

var_S(values)

基于样本估计方差 (忽略示例) 中的逻辑值和文本。

var_S(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素是对应于总体样本的 1 到 255 个数值参数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

varA(values)

根据样本（包括逻辑值和文本）估算方差。 文本和逻辑值 FALSE 的值为 0;逻辑值 TRUE 的值为 1。

varA(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素是对应于总体样本的 1 到 255 个值参数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

varPA(values)

根据整个总体计算方差，包括逻辑值和文本。 文本和逻辑值 FALSE 的值为 0;逻辑值 TRUE 的值为 1。

varPA(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

参数

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素是对应于总体的 1 到 255 个值参数。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

vdb(cost, salvage, life, startPeriod, endPeriod, factor, noSwitch)

使用双倍余额递减法或其他指定的方法，返回指定的任何期间内（包括部分期间）的资产折旧值。

vdb(cost: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, salvage: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, life: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, startPeriod: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, endPeriod: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, factor?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, noSwitch?: boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

cost

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

资产的初始成本。

salvage

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

资产生命周期结束时的打捞值。

life

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

资产贬值的周期数， (有时称为资产) 的使用寿命。

startPeriod

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要计算折旧的起始周期，单位与 Life 相同。

endPeriod

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要计算折旧的结束周期，单位与 Life 相同。

factor

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

余额下降的速度，如果省略，则 2 (双倍余额下降) 。

noSwitch

boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

当折旧大于递减余额 = FALSE 或省略时，切换到直线折旧;请勿切换 = TRUE。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

vlookup(lookupValue, tableArray, colIndexNum, rangeLookup)

在表的最左侧列中查找值，然后从指定的列返回同一行中的值。 默认情况下，表必须按升序排序。

vlookup(lookupValue: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, tableArray: Excel.Range | number | Excel.RangeReference | Excel.FunctionResult<any>, colIndexNum: Excel.Range | number | Excel.RangeReference | Excel.FunctionResult<any>, rangeLookup?: boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number | string | boolean>;

参数

lookupValue

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要在表的第一列中找到的值，可以是值、引用或文本字符串。

tableArray

Excel.Range | number | Excel.RangeReference | Excel.FunctionResult<any>

文本、数字或逻辑值表，在其中检索数据。 tableArray 可以是对区域或区域名称的引用。

colIndexNum

Excel.Range | number | Excel.RangeReference | Excel.FunctionResult<any>

应从中返回匹配值的 tableArray 中的列号。 表中值的第一列是第 1 列。

rangeLookup

boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个逻辑值：查找第一列中最接近的匹配项 (按升序排序) = TRUE 或省略;查找完全匹配项 = FALSE。

返回

Excel.FunctionResult<number | string | boolean>

注解

[ API 集：ExcelApi 1.2 ]

示例

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/50-workbook/workbook-built-in-functions.yaml

await Excel.run(async (context) => {
  // This function uses VLOOKUP to find data in the "Wrench" row on the worksheet. 
  let range = context.workbook.worksheets.getItem("Sample").getRange("A1:D4");

  // Get the value in the second column in the "Wrench" row.
  let unitSoldInNov = context.workbook.functions.vlookup("Wrench", range, 2, false);
  unitSoldInNov.load("value");

  await context.sync();
  console.log(" Number of wrenches sold in November = " + unitSoldInNov.value);
});

weekday(serialNumber, returnType)

返回一个从 1 到 7 的数字，标识日期的一周中的某一天。

weekday(serialNumber: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, returnType?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

serialNumber

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

表示日期的数字。

returnType

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个数字：对于 Sunday=1 到 saturday=7，请使用 1;对于 monday=1 到 Sunday=7，请使用 2;对于 Monday=0 到 Sunday=6，请使用 3。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

weekNum(serialNumber, returnType)

返回当年中的周数。

weekNum(serialNumber: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, returnType?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

serialNumber

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

Microsoft Excel 用于日期和时间计算的日期时间代码。

returnType

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

确定返回值类型的数字 (1 或 2) 。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

weibull_Dist(x, alpha, beta, cumulative)

返回韦伯分布。

weibull_Dist(x: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, alpha: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, beta: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, cumulative: boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

x

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

计算函数的值，一个非数值。

alpha

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是分布的参数，正数。

beta

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是分布的参数，正数。

cumulative

boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

是一个逻辑值：对于累积分布函数，请使用 TRUE;对于概率质量函数，请使用 FALSE。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

workDay_Intl(startDate, days, weekend, holidays)

使用自定义周末参数返回指定数量的工作日之前或之后的日期的序列号。

workDay_Intl(startDate: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, days: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, weekend?: number | string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, holidays?: number | string | Excel.Range | boolean | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

startDate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

表示开始日期的序列号。

days

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

开始日期之前或之后的非周数和非假日天数。

weekend

number | string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

指定周末发生时间的数字或字符串。

holidays

number | string | Excel.Range | boolean | Excel.RangeReference | Excel.FunctionResult<any>

要从工作日历中排除的一个或多个序列号的可选数组，例如州和联邦假日以及浮动假日。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

workDay(startDate, days, holidays)

返回指定工作日数之前或之后的日期的序列号。

workDay(startDate: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, days: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, holidays?: number | string | Excel.Range | boolean | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

startDate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

表示开始日期的序列号。

days

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

开始日期之前或之后的非周数和非假日天数。

holidays

number | string | Excel.Range | boolean | Excel.RangeReference | Excel.FunctionResult<any>

要从工作日历中排除的一个或多个序列号的可选数组，例如州和联邦假日以及浮动假日。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

xirr(values, dates, guess)

返回现金流计划的内部收益率。

xirr(values: number | string | Excel.Range | boolean | Excel.RangeReference | Excel.FunctionResult<any>, dates: number | string | Excel.Range | boolean | Excel.RangeReference | Excel.FunctionResult<any>, guess?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

values

number | string | Excel.Range | boolean | Excel.RangeReference | Excel.FunctionResult<any>

与日期中的付款计划相对应的一系列现金流。

dates

number | string | Excel.Range | boolean | Excel.RangeReference | Excel.FunctionResult<any>

与现金流付款对应的付款日期计划。

guess

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

你猜到的接近 XIRR 结果的数字。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

xnpv(rate, values, dates)

返回现金流计划的净现值。

xnpv(rate: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, values: number | string | Excel.Range | boolean | Excel.RangeReference | Excel.FunctionResult<any>, dates: number | string | Excel.Range | boolean | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

rate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

应用于现金流的折扣率。

values

number | string | Excel.Range | boolean | Excel.RangeReference | Excel.FunctionResult<any>

与日期中的付款计划相对应的一系列现金流。

dates

number | string | Excel.Range | boolean | Excel.RangeReference | Excel.FunctionResult<any>

与现金流付款对应的付款日期计划。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

xor(values)

返回所有参数的逻辑“独占或”。

xor(...values: Array<boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<boolean>;

参数

values

Array<boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

参数列表，其元素是要测试的 1 到 254 个条件，可以是 TRUE 或 FALSE，可以是逻辑值、数组或引用。

返回

Excel.FunctionResult<boolean>

注解

[ API 集：ExcelApi 1.2 ]

year(serialNumber)

返回日期的年份，即 1900 - 9999 范围内的整数。

year(serialNumber: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

serialNumber

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

Microsoft Excel 使用的日期时间代码中的数字。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

yearFrac(startDate, endDate, basis)

返回表示start_date和end_date之间的整天天数的年份分数。

yearFrac(startDate: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, endDate: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, basis?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

startDate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

表示开始日期的序列号。

endDate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

表示结束日期的序列号。

basis

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的日计数基础的类型。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

yield(settlement, maturity, rate, pr, redemption, frequency, basis)

返回定期支付利息的债券的收益率。

yield(settlement: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, maturity: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, rate: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, pr: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, redemption: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, frequency: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, basis?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的结算日期，以序列号表示。

maturity

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的到期日期，以序列号表示。

rate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的年优惠券率。

pr

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每 100 美元面值的证券价格。

redemption

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每 100 美元面值的证券赎回价值。

frequency

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每年的优惠券付款数。

basis

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的日计数基础的类型。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

yieldDisc(settlement, maturity, pr, redemption, basis)

返回已贴现债券的年收益。 例如，国库券。

yieldDisc(settlement: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, maturity: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, pr: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, redemption: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, basis?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的结算日期，以序列号表示。

maturity

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的到期日期，以序列号表示。

pr

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每 100 美元面值的证券价格。

redemption

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每 100 美元面值的证券赎回价值。

basis

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的日计数基础的类型。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

yieldMat(settlement, maturity, issue, rate, pr, basis)

返回到期付息的债券的年收益。

yieldMat(settlement: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, maturity: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, issue: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, rate: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, pr: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, basis?: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的结算日期，以序列号表示。

maturity

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的到期日期，以序列号表示。

issue

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

证券的发行日期，以序列号表示。

rate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

债券发行日利率。

pr

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

每 100 美元面值的证券价格。

basis

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要使用的日计数基础的类型。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]

z_Test(array, x, sigma)

返回 z 测试的单尾 P 值。

z_Test(array: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, x: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, sigma?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

参数

array

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要对其测试 X 的数组或数据范围。

x

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

要测试的值。

sigma

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

总体 (已知) 标准偏差。 如果省略，则使用样本标准偏差。

返回

Excel.FunctionResult<number>

注解

[ API 集：ExcelApi 1.2 ]