Excel.Functions class

  • Referência
Pacote:
excel

Um objeto para avaliar as funções do Excel.

Extends
OfficeExtension.ClientObject

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

Exemplos

// 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);
});

Propriedades

context

O contexto do pedido associado ao objeto . Esta ação liga o processo do suplemento ao processo da aplicação anfitriã do Office.

Métodos

abs(number)

Devolve o valor absoluto de um número, um número sem o respetivo sinal.
accrInt(issue, firstInterest, settlement, rate, par, frequency, basis, calcMethod)

Retorna juros acumulados de um título que paga juros periódicos.
accrIntM(issue, settlement, rate, par, basis)

Retorna juros acumulados de um título que paga juros no vencimento.
acos(number)

Devolve o arco de cosseno de um número, em radianos no intervalo 0 a Pi. O arco de cosseno é o ângulo cujo cosseno é Number.
acosh(number)

Retorna o cosseno hiperbólico inverso de um número.
acot(number)

Devolve o arco de tangente de um número, em radianos no intervalo de 0 a Pi.
acoth(number)

Devolve a cotangente hiperbólica inversa de um número.
amorDegrc(cost, datePurchased, firstPeriod, salvage, period, rate, basis)

Devolve a depreciação linear proporcional de um ativo para cada período contabilístico.
amorLinc(cost, datePurchased, firstPeriod, salvage, period, rate, basis)

Devolve a depreciação linear proporcional de um ativo para cada período contabilístico.
and(values)

Verifica se todos os argumentos são VERDADEIRO e devolve VERDADEIRO se todos os argumentos forem VERDADEIRO.
arabic(text)

Converte um numeral romano em árabe.
areas(reference)

Devolve o número de áreas numa referência. Uma área é um intervalo de células contíguas ou uma única célula.
asc(text)

Altera os carateres de largura total (byte duplo) para carateres de meia largura (byte único). Utilize com conjuntos de carateres de byte duplo (DBCS).
asin(number)

Devolve o arco de seno de um número em radianos, no intervalo -Pi/2 a Pi/2.
asinh(number)

Retorna o seno hiperbólico inverso de um número.
atan(number)

Devolve o arco de tangente de um número em radianos, no intervalo -Pi/2 a Pi/2.
atan2(xNum, yNum)

Devolve o arco de tangente das coordenadas x e y especificadas, em radianos entre -Pi e Pi, excluindo -Pi.
atanh(number)

Retorna a tangente hiperbólica inversa de um número.
aveDev(values)

Retorna a média dos desvios absolutos de pontos de dados com relação a sua média. Os argumentos podem ser números ou nomes, matrizes ou referências que contenham números.
average(values)

Devolve a média (média aritmética) dos respetivos argumentos, que podem ser números ou nomes, matrizes ou referências que contêm números.
averageA(values)

Devolve a média (média aritmética) dos respetivos argumentos, avaliando texto e FALSO em argumentos como 0; TRUE avalia como 1. Os argumentos podem ser números, nomes, matrizes ou referências.
averageIf(range, criteria, averageRange)

Localiza a média(média aritmética) das células especificadas por uma determinada condição ou critério.
averageIfs(averageRange, values)

Localiza a média(média aritmética) das células especificadas por um determinado conjunto de condições ou critérios.
bahtText(number)

Converte um número em texto (baht).
base(number, radix, minLength)

Converte um número numa representação de texto com o radix especificado (base).
besselI(x, n)

Devolve a função de Bessel modificada In(x).
besselJ(x, n)

Devolve a função de Bessel Jn(x).
besselK(x, n)

Devolve a função de Bessel modificada Kn(x).
besselY(x, n)

Devolve a função De Bessel Yn(x).
beta_Dist(x, alpha, beta, cumulative, A, B)

Devolve a função de distribuição de probabilidade beta.
beta_Inv(probability, alpha, beta, A, B)

Devolve o inverso da função de densidade de probabilidade beta cumulativa (BETA). DIST).
bin2Dec(number)

Converte um número binário em decimal.
bin2Hex(number, places)

Converte um número binário em hexadecimal.
bin2Oct(number, places)

Converte um número binário em octal.
binom_Dist_Range(trials, probabilityS, numberS, numberS2)

Devolve a probabilidade de um resultado de avaliação com uma distribuição binomial.
binom_Dist(numberS, trials, probabilityS, cumulative)

Retorna a probabilidade de distribuição binomial do termo individual.
binom_Inv(trials, probabilityS, alpha)

Retorna o menor valor para o qual a distribuição binomial cumulativa é maior ou igual ao valor padrão.
bitand(number1, number2)

Devolve um valor bit a bit "E" de dois números.
bitlshift(number, shiftAmount)

Devolve um número deslocado para a esquerda por shift_amount bits.
bitor(number1, number2)

Devolve um valor bit a bit "Ou" de dois números.
bitrshift(number, shiftAmount)

Devolve um número deslocado para a direita por shift_amount bits.
bitxor(number1, number2)

Devolve um valor bit a bit "Exclusivo Ou" de dois números.
ceiling_Math(number, significance, mode)

Arredonda um número por cima, para o número inteiro mais próximo ou para o múltiplo de significância mais próximo.
ceiling_Precise(number, significance)

Arredonda um número por cima, para o número inteiro mais próximo ou para o múltiplo de significância mais próximo.
char(number)

Devolve o caráter especificado pelo número de código do conjunto de carateres do computador.
chiSq_Dist_RT(x, degFreedom)

Retorna a probabilidade da distribuição qui-quadrada de cauda direita.
chiSq_Dist(x, degFreedom, cumulative)

Devolve a probabilidade caudal esquerda da distribuição chi-quadrado.
chiSq_Inv_RT(probability, degFreedom)

Retorna o inverso da probabilidade de cauda direita da distribuição qui-quadrada.
chiSq_Inv(probability, degFreedom)

Retorna o inverso da probabilidade da distribuição qui-quadrada de cauda esquerda.
choose(indexNum, values)

Escolhe um valor ou ação a executar a partir de uma lista de valores, com base num número de índice.
clean(text)

Remove todos os caracteres do texto que não podem ser impressos.
code(text)

Devolve um código numérico para o primeiro caráter numa cadeia de texto, no conjunto de carateres utilizado pelo computador.
columns(array)

Devolve o número de colunas numa matriz ou referência.
combin(number, numberChosen)

Retorna o número de combinações de um dado número de itens.
combina(number, numberChosen)

Devolve o número de combinações com repetições para um determinado número de itens.
complex(realNum, iNum, suffix)

Converte coeficientes reais e imaginários num número complexo.
concatenate(values)

Associa várias cadeias de texto a uma cadeia de texto.
confidence_Norm(alpha, standardDev, size)

Devolve o intervalo de confiança de uma média de população, utilizando uma distribuição normal.
confidence_T(alpha, standardDev, size)

Devolve o intervalo de confiança de uma média de população, utilizando uma distribuição T de Student.
convert(number, fromUnit, toUnit)

Converte um número de um sistema de medida para outro.
cos(number)

Devolve o cosseno de um ângulo.
cosh(number)

Retorna o cosseno hiperbólico de um número.
cot(number)

Devolve a cotangente de um ângulo.
coth(number)

Devolve a cotangente hiperbólica de um número.
count(values)

Conta o número de células num intervalo que contém números.
countA(values)

Conta o número de células num intervalo que não estão vazias.
countBlank(range)

Conta o número de células vazias num intervalo de células especificado.
countIf(range, criteria)

Conta o número de células dentro de um intervalo que cumpre a condição especificada.
countIfs(values)

Conta o número de células especificadas por um determinado conjunto de condições ou critérios.
coupDayBs(settlement, maturity, frequency, basis)

Retorna o número de dias do início do período de cupom até a data de liquidação.
coupDays(settlement, maturity, frequency, basis)

Retorna o número de dias no período de cupom que contém a data de liquidação.
coupDaysNc(settlement, maturity, frequency, basis)

Retorna o número de dias da data de liquidação até a data do próximo cupom.
coupNcd(settlement, maturity, frequency, basis)

Devolve a data de cupom seguinte após a data de liquidação.
coupNum(settlement, maturity, frequency, basis)

Devolve o número de cupões a pagar entre a data de liquidação e a data de vencimento.
coupPcd(settlement, maturity, frequency, basis)

Devolve a data de cupom anterior antes da data de liquidação.
csc(number)

Devolve a cossecante de um ângulo.
csch(number)

Devolve a cossecante hiperbólica de um ângulo.
cumIPmt(rate, nper, pv, startPeriod, endPeriod, type)

Devolve os juros acumulados pagos entre dois períodos.
cumPrinc(rate, nper, pv, startPeriod, endPeriod, type)

Devolve o capital acumulado pago num empréstimo entre dois períodos.
date(year, month, day)

Devolve o número que representa a data no código de data/hora do Microsoft Excel.
datevalue(dateText)

Converte uma data sob a forma de texto num número que representa a data no código de data/hora do Microsoft Excel.
daverage(database, field, criteria)

Calcula a média dos valores numa coluna numa lista ou base de dados que correspondam às condições que especificar.
day(serialNumber)

Devolve o dia do mês, um número de 1 a 31.
days(endDate, startDate)

Devolve o número de dias entre as duas datas.
days360(startDate, endDate, method)

Devolve o número de dias entre duas datas com base num ano de 360 dias (doze meses de 30 dias).
db(cost, salvage, life, period, month)

Retorna a depreciação de um ativo para um período especificado, usando o método de balanço de declínio fixo.
dbcs(text)

Altera os carateres de largura média (byte único) dentro de uma cadeia de carateres para carateres de largura total (byte duplo). Utilize com conjuntos de carateres de byte duplo (DBCS).
dcount(database, field, criteria)

Conta as células que contêm números no campo (coluna) dos registos na base de dados que correspondem às condições especificadas.
dcountA(database, field, criteria)

Conta células que não estão em branco no campo (coluna) dos registos na base de dados que correspondem às condições que especificar.
ddb(cost, salvage, life, period, factor)

Retorna a depreciação de um ativo com relação a um período especificado usando o método de saldos decrescentes duplos ou qualquer outro método especificado por você.
dec2Bin(number, places)

Converte um número decimal em binário.
dec2Hex(number, places)

Converte um número decimal em hexadecimal.
dec2Oct(number, places)

Converte um número decimal em octal.
decimal(number, radix)

Converte uma representação de texto de um número numa determinada base num número decimal.
degrees(angle)

Converte radianos em graus.
delta(number1, number2)

Testa se dois números são iguais.
devSq(values)

Retorna a soma dos quadrados dos desvios de pontos de dados da média da amostra.
dget(database, field, criteria)

Extrai de uma base de dados um único registo que corresponde às condições que especificar.
disc(settlement, maturity, pr, redemption, basis)

Retorna a taxa de desconto de um título.
dmax(database, field, criteria)

Devolve o maior número no campo (coluna) de registos na base de dados que correspondem às condições que especificar.
dmin(database, field, criteria)

Devolve o menor número no campo (coluna) dos registos na base de dados que correspondem às condições que especificar.
dollar(number, decimals)

Converte um número em texto com o formato de moeda.
dollarDe(fractionalDollar, fraction)

Converte um preço em dólares, expresso como uma fração, num preço em dólares, expresso como um número decimal.
dollarFr(decimalDollar, fraction)

Converte um preço em dólares, expresso como um número decimal, num preço em dólar, expresso como uma fração.
dproduct(database, field, criteria)

Multiplica os valores no campo (coluna) dos registos na base de dados que correspondem às condições que especificar.
dstDev(database, field, criteria)

Estima o desvio padrão com base num exemplo de entradas de base de dados selecionadas.
dstDevP(database, field, criteria)

Calcula o desvio-padrão com base na população total de entradas de base de dados selecionadas.
dsum(database, field, criteria)

Adiciona os números no campo (coluna) dos registos na base de dados que correspondem às condições que especificar.
duration(settlement, maturity, coupon, yld, frequency, basis)

Devolve a duração anual de um título com pagamentos de juros periódicos.
dvar(database, field, criteria)

Calcula a variância com base num exemplo de entradas de base de dados selecionadas.
dvarP(database, field, criteria)

Calcula a variância com base na população total de entradas de base de dados selecionadas.
ecma_Ceiling(number, significance)

Arredonda um número por cima, para o número inteiro mais próximo ou para o múltiplo de significância mais próximo.
edate(startDate, months)

Devolve o número de série da data que corresponde ao número indicado de meses antes ou depois da data de início.
effect(nominalRate, npery)

Devolve a taxa de juros anual efetiva.
eoMonth(startDate, months)

Devolve o número de série do último dia do mês antes ou depois de um número especificado de meses.
erf_Precise(X)

Devolve a função de erro.
erf(lowerLimit, upperLimit)

Devolve a função de erro.
erfC_Precise(X)

Devolve a função de erro complementar.
erfC(x)

Devolve a função de erro complementar.
error_Type(errorVal)

Devolve um número que corresponde a um valor de erro.
even(number)

Arredonda um número positivo por cima e um número negativo por baixo para o número inteiro par mais próximo.
exact(text1, text2)

Verifica se duas cadeias de texto são exatamente iguais e devolve VERDADEIRO ou FALSO. EXATO é sensível às maiúsculas e minúsculas.
exp(number)

Devolve e elevado à potência de um determinado número.
expon_Dist(x, lambda, cumulative)

Retorna a distribuição exponencial.
f_Dist_RT(x, degFreedom1, degFreedom2)

Devolve a distribuição de probabilidade F (grau de diversidade) (caudal direita) para dois conjuntos de dados.
f_Dist(x, degFreedom1, degFreedom2, cumulative)

Devolve a distribuição de probabilidade F (grau de diversidade) (caudal esquerda) para dois conjuntos de dados.
f_Inv_RT(probability, degFreedom1, degFreedom2)

Devolve o inverso da distribuição de probabilidade F (caudal direita): se p = DIST.F. RT(x,...) e, em seguida, F.INV. RT(p,...) = x.
f_Inv(probability, degFreedom1, degFreedom2)

Devolve o inverso da distribuição da probabilidade F (caudal esquerda): se p = DIST.F(x,...), então INV.F(p,...) = x.
fact(number)

Devolve o fatorial de um número, igual a 123*...* Número.
factDouble(number)

Retorna o fatorial duplo de um número.
false()

Devolve o valor lógico FALSO.
find(findText, withinText, startNum)

Devolve a posição inicial de uma cadeia de texto dentro de outra cadeia de texto. LOCALIZAR é sensível a maiúsculas e minúsculas.
findB(findText, withinText, startNum)

Localiza a posição inicial de uma cadeia de texto dentro de outra cadeia de texto. FINDB é sensível a maiúsculas e minúsculas. Utilize com conjuntos de carateres de byte duplo (DBCS).
fisher(x)

Devolve a transformação Fisher.
fisherInv(y)

Devolve o inverso da transformação Fisher: se y = FISHER(x), então FISHERINV(y) = x.
fixed(number, decimals, noCommas)

Arredonda um número para o número especificado de decimais e devolve o resultado como texto com ou sem vírgulas.
floor_Math(number, significance, mode)

Arredonda um número por baixo para o número inteiro mais próximo ou para o múltiplo de significância mais próximo.
floor_Precise(number, significance)

Arredonda um número por baixo para o número inteiro mais próximo ou para o múltiplo de significância mais próximo.
fv(rate, nper, pmt, pv, type)

Retorna o valor futuro de um investimento de acordo com os pagamentos periódicos e constantes e com uma taxa de juros constante.
fvschedule(principal, schedule)

Retorna o valor futuro de um capital inicial após a aplicação de uma série de taxas de juros compostos.
gamma_Dist(x, alpha, beta, cumulative)

Retorna a distribuição gama.
gamma_Inv(probability, alpha, beta)

Devolve o inverso da distribuição cumulativa gama: se p = GAMA. DIST(x,...) e, em seguida, GAMA. INV(p,...) = x.
gamma(x)

Devolve o valor da função Gama.
gammaLn_Precise(x)

Devolve o logaritmo natural da função gama.
gammaLn(x)

Devolve o logaritmo natural da função gama.
gauss(x)

Devolve menos 0,5 do que a distribuição cumulativa normal padrão.
gcd(values)

Devolve o maior divisor comum.
geoMean(values)

Devolve a média geométrica de uma matriz ou intervalo de dados numéricos positivos.
geStep(number, step)

Testa se um número é superior a um valor de limiar.
harMean(values)

Devolve a média harmónica de um conjunto de dados de números positivos: o recíproco da média aritmética dos recíprocos.
hex2Bin(number, places)

Converte um número hexadecimal em binário.
hex2Dec(number)

Converte um número hexadecimal em decimal.
hex2Oct(number, places)

Converte um número hexadecimal em octal.
hlookup(lookupValue, tableArray, rowIndexNum, rangeLookup)

Procura um valor na linha superior de uma tabela ou matriz de valores e devolve o valor na mesma coluna de uma linha que especificar.
hour(serialNumber)

Devolve a hora como um número de 0 (12:00) a 23 (23:00).
hyperlink(linkLocation, friendlyName)

Cria um atalho ou salto que abre um documento armazenado no disco rígido, num servidor de rede ou na Internet.
hypGeom_Dist(sampleS, numberSample, populationS, numberPop, cumulative)

Retorna a distribuição hipergeométrica.
if(logicalTest, valueIfTrue, valueIfFalse)

Verifica se uma condição é cumprida e devolve um valor se FOR VERDADEIRO e outro valor se for FALSO.
imAbs(inumber)

Devolve o valor absoluto (modulus) de um número complexo.
imaginary(inumber)

Devolve o coeficiente imaginário de um número complexo.
imArgument(inumber)

Devolve o argumento q, um ângulo expresso em radianos.
imConjugate(inumber)

Devolve o conjugado complexo de um número complexo.
imCos(inumber)

Devolve o cosseno de um número complexo.
imCosh(inumber)

Devolve o cosseno hiperbólico de um número complexo.
imCot(inumber)

Devolve a cotangente de um número complexo.
imCsc(inumber)

Devolve a cossecante de um número complexo.
imCsch(inumber)

Devolve a cossecante hiperbólica de um número complexo.
imDiv(inumber1, inumber2)

Devolve o quociente de dois números complexos.
imExp(inumber)

Devolve o exponencial de um número complexo.
imLn(inumber)

Devolve o logaritmo natural de um número complexo.
imLog10(inumber)

Devolve o logaritmo de base 10 de um número complexo.
imLog2(inumber)

Devolve o logaritmo de base 2 de um número complexo.
imPower(inumber, number)

Devolve um número complexo elevado a uma potência de número inteiro.
imProduct(values)

Devolve o produto de 1 a 255 números complexos.
imReal(inumber)

Devolve o coeficiente real de um número complexo.
imSec(inumber)

Devolve a secante de um número complexo.
imSech(inumber)

Devolve a secante hiperbólica de um número complexo.
imSin(inumber)

Devolve o seno de um número complexo.
imSinh(inumber)

Devolve o seno hiperbólico de um número complexo.
imSqrt(inumber)

Devolve a raiz quadrada de um número complexo.
imSub(inumber1, inumber2)

Devolve a diferença de dois números complexos.
imSum(values)

Devolve a soma de números complexos.
imTan(inumber)

Devolve a tangente de um número complexo.
int(number)

Arredonda um número por baixo para o número inteiro mais próximo.
intRate(settlement, maturity, investment, redemption, basis)

Retorna a taxa de juros de um título totalmente investido.
ipmt(rate, per, nper, pv, fv, type)

Devolve o pagamento de juros de um determinado período para um investimento, com base em pagamentos periódicos constantes e numa taxa de juro constante.
irr(values, guess)

Devolve a taxa interna de rentabilidade de uma série de fluxos monetários.
isErr(value)

Verifica se um valor é um erro diferente de #N/D e devolve VERDADEIRO ou FALSO.
isError(value)

Verifica se um valor é um erro e devolve VERDADEIRO ou FALSO.
isEven(number)

Devolve VERDADEIRO se o número for par.
isFormula(reference)

Verifica se uma referência é a uma célula que contém uma fórmula e devolve VERDADEIRO ou FALSO.
isLogical(value)

Verifica se um valor é um valor lógico (VERDADEIRO ou FALSO) e devolve VERDADEIRO ou FALSO.
isNA(value)

Verifica se um valor é #N/D e devolve VERDADEIRO ou FALSO.
isNonText(value)

Verifica se um valor não é texto (as células em branco não são texto) e devolve VERDADEIRO ou FALSO.
isNumber(value)

Verifica se um valor é um número e devolve VERDADEIRO ou FALSO.
iso_Ceiling(number, significance)

Arredonda um número por cima, para o número inteiro mais próximo ou para o múltiplo de significância mais próximo.
isOdd(number)

Devolve VERDADEIRO se o número for ímpar.
isoWeekNum(date)

Devolve o número da semana ISO no ano de uma determinada data.
ispmt(rate, per, nper, pv)

Devolve os juros pagos durante um período específico de um investimento.
isref(value)

Verifica se um valor é uma referência e devolve VERDADEIRO ou FALSO.
isText(value)

Verifica se um valor é texto e devolve VERDADEIRO ou FALSO.
kurt(values)

Retorna a curtose de um conjunto de dados.
large(array, k)

Retorna o k-ésimo maior valor em um conjunto de dados. Por exemplo, o quinto maior número.
lcm(values)

Devolve o múltiplo menos comum.
left(text, numChars)

Devolve o número especificado de carateres a partir do início de uma cadeia de texto.
leftb(text, numBytes)

Devolve o número especificado de carateres a partir do início de uma cadeia de texto. Utilize com conjuntos de carateres de byte duplo (DBCS).
len(text)

Devolve o número de carateres numa cadeia de texto.
lenb(text)

Devolve o número de carateres numa cadeia de texto. Utilize com conjuntos de carateres de byte duplo (DBCS).
ln(number)

Retorna o logaritmo natural de um número.
log(number, base)

Retorna o logaritmo de um número para a base especificada.
log10(number)

Retorna o logaritmo de base 10 de um número.
logNorm_Dist(x, mean, standardDev, cumulative)

Devolve a distribuição normal log de x, em que ln(x) é normalmente distribuída com os parâmetros Média e Standard_dev.
logNorm_Inv(probability, mean, standardDev)

Devolve o inverso da função de distribuição cumulativa normal lognormal de x, em que ln(x) é normalmente distribuído com os parâmetros Média e Standard_dev.
lookup(lookupValue, lookupVector, resultVector)

Procura um valor a partir de um intervalo de uma linha ou de uma coluna ou de uma matriz. Fornecido para retrocompatibilidade.
lower(text)

Converte todas as letras numa cadeia de texto em minúsculas.
match(lookupValue, lookupArray, matchType)

Retorna a posição relativa de um item em uma matriz que corresponda a um valor especificado em uma ordem especificada.
max(values)

Retorna o maior valor em um conjunto de valores. Ignora valores lógicos e texto.
maxA(values)

Retorna o maior valor em um conjunto de valores. Não ignora valores lógicos e texto.
mduration(settlement, maturity, coupon, yld, frequency, basis)

Devolve a duração modificada de Macauley para um título com um valor nominal assumido de 100 $.
median(values)

Devolve a mediana ou o número no meio do conjunto de números especificados.
mid(text, startNum, numChars)

Devolve os carateres a partir do meio de uma cadeia de texto, com uma posição e comprimento iniciais.
midb(text, startNum, numBytes)

Devolve carateres a partir do meio de uma cadeia de texto, dada a posição inicial e o comprimento. Utilize com conjuntos de carateres de byte duplo (DBCS).
min(values)

Retorna o menor número em um conjunto de valores. Ignora valores lógicos e texto.
minA(values)

Devolve o menor valor num conjunto de valores. Não ignora valores lógicos e texto.
minute(serialNumber)

Devolve o minuto, um número de 0 a 59.
mirr(values, financeRate, reinvestRate)

Devolve a taxa interna de rentabilidade de uma série de fluxos monetários periódicos, considerando tanto o custo do investimento como os juros sobre o reinvestimento de dinheiro.
mod(number, divisor)

Devolve o resto depois de um número ser dividido por um divisor.
month(serialNumber)

Devolve o mês, um número de 1 (janeiro) a 12 (dezembro).
mround(number, multiple)

Retorna um número arredondado para o múltiplo desejado.
multiNomial(values)

Devolve o multinomial de um conjunto de números.
n(value)

Converte o valor não numérico num número, datas em números de série, VERDADEIRO para 1, qualquer outra coisa em 0 (zero).
na()

Devolve o valor de erro #N/D (valor não disponível).
negBinom_Dist(numberF, numberS, probabilityS, cumulative)

Devolve a distribuição binomial negativa, a probabilidade de haver Number_f falhas antes do Number_s-th-sucesso, com Probability_s probabilidade de sucesso.
networkDays_Intl(startDate, endDate, weekend, holidays)

Devolve o número de dias de trabalho inteiros entre duas datas com parâmetros de fim de semana personalizados.
networkDays(startDate, endDate, holidays)

Devolve o número de dias de trabalho inteiros entre duas datas.
nominal(effectRate, npery)

Devolve a taxa de juro nominal anual.
norm_Dist(x, mean, standardDev, cumulative)

Retorna a distribuição normal para a média e o desvio padrão especificados.
norm_Inv(probability, mean, standardDev)

Retorna o inverso da distribuição cumulativa normal para a média especificada e o desvio padrão.
norm_S_Dist(z, cumulative)

Devolve a distribuição normal padrão (tem uma média de zero e um desvio-padrão de um).
norm_S_Inv(probability)

Devolve o inverso da distribuição cumulativa normal padrão (tem uma média de zero e um desvio-padrão de um).
not(logical)

Altera FALSO para VERDADEIRO ou VERDADEIRO para FALSO.
now()

Devolve a data e hora atuais formatadas como uma data e hora.
nper(rate, pmt, pv, fv, type)

Retorna o número de períodos de um investimento de acordo com os pagamentos periódicos e constantes e com uma taxa de juros constante.
npv(rate, values)

Devolve o valor atual líquido de um investimento com base numa taxa de desconto e numa série de pagamentos futuros (valores negativos) e rendimentos (valores positivos).
numberValue(text, decimalSeparator, groupSeparator)

Converte texto em número de forma independente da região.
oct2Bin(number, places)

Converte um número octal em binário.
oct2Dec(number)

Converte um número octal em decimal.
oct2Hex(number, places)

Converte um número octal em hexadecimal.
odd(number)

Arredonda um número positivo para cima e um número negativo por baixo para o número inteiro ímpar mais próximo.
oddFPrice(settlement, maturity, issue, firstCoupon, rate, yld, redemption, frequency, basis)

Devolve o preço por valor nominal de 100 $ de um título com um primeiro período indefinido.
oddFYield(settlement, maturity, issue, firstCoupon, rate, pr, redemption, frequency, basis)

Devolve o rendimento de um título com um primeiro período ímpar.
oddLPrice(settlement, maturity, lastInterest, rate, yld, redemption, frequency, basis)

Devolve o preço por valor nominal de 100 $ de um título com um último período indefinido.
oddLYield(settlement, maturity, lastInterest, rate, pr, redemption, frequency, basis)

Devolve o rendimento de um título com um último período indefinido.
or(values)

Verifica se algum dos argumentos é VERDADEIRO e devolve VERDADEIRO ou FALSO. Devolve FALSO apenas se todos os argumentos forem FALSO.
pduration(rate, pv, fv)

Devolve o número de períodos exigidos por um investimento para atingir um valor especificado.
percentile_Exc(array, k)

Retorna o k-ésimo percentil de valores em um intervalo, onde k está no intervalo 0.. 1, exclusivo.
percentile_Inc(array, k)

Devolve o percentil k-ésimo de valores num intervalo, em que k está no intervalo 0..1, inclusive.
percentRank_Exc(array, x, significance)

Retorna a posição de um valor em um conjunto de dados como uma porcentagem (0.. 1, exclusivo) do conjunto de dados.
percentRank_Inc(array, x, significance)

Retorna a posição de um valor em um conjunto de dados como uma porcentagem (0..1, inclusive) do conjunto de dados.
permut(number, numberChosen)

Devolve o número de permutações para um determinado número de objetos que podem ser selecionados a partir do total de objetos.
permutationa(number, numberChosen)

Devolve o número de permutações para um determinado número de objetos (com repetições) que podem ser selecionados a partir do total de objetos.
phi(x)

Devolve o valor da função de densidade para uma distribuição normal padrão.
pi()

Devolve o valor de Pi, 3,14159265358979, preciso para 15 dígitos.
pmt(rate, nper, pv, fv, type)

Calcula o pagamento de um empréstimo com base em pagamentos constantes e em uma taxa de juros constante.
poisson_Dist(x, mean, cumulative)

Retorna a distribuição Poisson.
power(number, power)

Retorna o resultado de um número elevado a uma potência.
ppmt(rate, per, nper, pv, fv, type)

Devolve o pagamento no capital de um determinado investimento com base em pagamentos periódicos constantes e numa taxa de juros constante.
price(settlement, maturity, rate, yld, redemption, frequency, basis)

Retorna o preço pelo valor nominal R$100 de um título que paga juros periódicos.
priceDisc(settlement, maturity, discount, redemption, basis)

Retorna o preço por valor nominal de R$ 100,00 de um título descontado.
priceMat(settlement, maturity, issue, rate, yld, basis)

Retorna o preço pelo valor nominal R$100 de um título que paga juros no vencimento.
product(values)

Multiplica todos os números fornecidos como argumentos.
proper(text)

Converte uma cadeia de texto em maiúsculas/minúsculas; a primeira letra em cada palavra em maiúsculas e todas as outras letras em minúsculas.
pv(rate, nper, pmt, fv, type)

Devolve o valor atual de um investimento: o montante total que uma série de pagamentos futuros vale agora.
quartile_Exc(array, quart)

Devolve o quartil de um conjunto de dados, com base em valores de percentil de 0,.1, exclusivos.
quartile_Inc(array, quart)

Devolve o quartil de um conjunto de dados, com base em valores de percentil de 0,.1, inclusive.
quotient(numerator, denominator)

Retorna a parte inteira de uma divisão.
radians(angle)

Converte graus em radianos.
rand()

Devolve um número aleatório maior ou igual a 0 e inferior a 1, distribuído uniformemente (alterações no recálculo).
randBetween(bottom, top)

Devolve um número aleatório entre os números que especificar.
rank_Avg(number, ref, order)

Devolve a classificação de um número numa lista de números: o respetivo tamanho em relação a outros valores na lista; Se mais do que um valor tiver a mesma classificação, é devolvida a classificação média.
rank_Eq(number, ref, order)

Devolve a classificação de um número numa lista de números: o respetivo tamanho em relação a outros valores na lista; Se mais do que um valor tiver a mesma classificação, é devolvida a classificação superior desse conjunto de valores.
rate(nper, pmt, pv, fv, type, guess)

Devolve a taxa de juro por período de um empréstimo ou de um investimento. Por exemplo, utilize 6%/4 para pagamentos trimestrais a 6% APR.
received(settlement, maturity, investment, discount, basis)

Retorna a quantia recebida no vencimento de um título totalmente investido.
replace(oldText, startNum, numChars, newText)

Substitui parte de uma cadeia de texto por uma cadeia de texto diferente.
replaceB(oldText, startNum, numBytes, newText)

Substitui parte de uma cadeia de texto por uma cadeia de texto diferente. Utilize com conjuntos de carateres de byte duplo (DBCS).
rept(text, numberTimes)

Repete um texto um determinado número de vezes. Utilize REPT para preencher uma célula com um número de ocorrências de uma sequência de caracteres de texto.
right(text, numChars)

Devolve o número especificado de carateres a partir do fim de uma cadeia de texto.
rightb(text, numBytes)

Devolve o número especificado de carateres a partir do fim de uma cadeia de texto. Utilize com conjuntos de carateres de byte duplo (DBCS).
roman(number, form)

Converte um numeral árabe em romano, como texto.
round(number, numDigits)

Arredonda um número até uma quantidade especificada de dígitos.
roundDown(number, numDigits)

Arredonda um número para baixo até zero.
roundUp(number, numDigits)

Arredonda um número para cima, longe de zero.
rows(array)

Devolve o número de linhas numa referência ou matriz.
rri(nper, pv, fv)

Devolve uma taxa de juro equivalente para o crescimento de um investimento.
sec(number)

Devolve a secante de um ângulo.
sech(number)

Devolve a secante hiperbólica de um ângulo.
second(serialNumber)

Devolve o segundo, um número de 0 a 59.
seriesSum(x, n, m, coefficients)

Devolve a soma de uma série de energia com base na fórmula.
sheet(value)

Devolve o número da folha da folha referenciada.
sheets(reference)

Devolve o número de folhas numa referência.
sign(number)

Devolve o sinal de um número: 1 se o número for positivo, zero se o número for zero ou -1 se o número for negativo.
sin(number)

Retorna o seno de um ângulo.
sinh(number)

Retorna o seno hiperbólico de um número.
skew_p(values)

Devolve a distorção de uma distribuição com base numa população: uma caracterização do grau de assimetria de uma distribuição em torno da sua média.
skew(values)

Devolve a distorção de uma distribuição: uma caracterização do grau de assimetria de uma distribuição em torno da respetiva média.
sln(cost, salvage, life)

Retorna a depreciação em linha reta de um ativo durante um período.
small(array, k)

Retorna o k-ésimo menor valor do conjunto de dados. Por exemplo, o quinto número menor.
sqrt(number)

Devolve a raiz quadrada de um número.
sqrtPi(number)

Devolve a raiz quadrada de (núm * Pi).
standardize(x, mean, standardDev)

Devolve um valor normalizado de uma distribuição caracterizada por um desvio-padrão e médio.
stDev_P(values)

Calcula o desvio-padrão com base na população total fornecida como argumentos (ignora valores lógicos e texto).
stDev_S(values)

Calcula o desvio-padrão com base numa amostra (ignora valores lógicos e texto na amostra).
stDevA(values)

Calcula o desvio-padrão com base numa amostra, incluindo valores lógicos e texto. O texto e o valor lógico FALSO têm o valor 0; o valor lógico VERDADEIRO tem o valor 1.
stDevPA(values)

Calcula o desvio-padrão com base numa população inteira, incluindo valores lógicos e texto. O texto e o valor lógico FALSO têm o valor 0; o valor lógico VERDADEIRO tem o valor 1.
substitute(text, oldText, newText, instanceNum)

Substitui o texto existente por texto novo numa cadeia de texto.
subtotal(functionNum, values)

Devolve um subtotal numa lista ou base de dados.
sum(values)

Adiciona todos os números em um intervalo de células.
sumIf(range, criteria, sumRange)

Adiciona as células especificadas por uma determinada condição ou critérios.
sumIfs(sumRange, values)

Adiciona as células especificadas por um determinado conjunto de condições ou critérios.
sumSq(values)

Retorna a soma dos quadrados dos argumentos. Os argumentos podem ser números, matrizes, nomes ou referências a células que contenham números.
syd(cost, salvage, life, per)

Retorna a depreciação dos dígitos da soma dos anos de um ativo para um período especificado.
t_Dist_2T(x, degFreedom)

Devolve a distribuição t de Student bicaudal.
t_Dist_RT(x, degFreedom)

Devolve a distribuição t de Student de cauda direita.
t_Dist(x, degFreedom, cumulative)

Devolve a distribuição t de Student de cauda esquerda.
t_Inv_2T(probability, degFreedom)

Devolve o inverso bicaudal da distribuição t de Student.
t_Inv(probability, degFreedom)

Devolve o inverso do lado esquerdo da distribuição t de Student.
t(value)

Verifica se um valor é texto e devolve o texto se for ou devolve aspas duplas (texto vazio) se não for.
tan(number)

Retorna a tangente de um ângulo.
tanh(number)

Retorna a tangente hiperbólica de um número.
tbillEq(settlement, maturity, discount)

Devolve o rendimento equivalente à obrigação de uma obrigação do Tesouro.
tbillPrice(settlement, maturity, discount)

Devolve o preço por valor nominal de 100 $ de uma obrigação do Tesouro.
tbillYield(settlement, maturity, pr)

Devolve o rendimento de uma obrigação do Tesouro.
text(value, formatText)

Converte um valor em texto com um formato de número específico.
time(hour, minute, second)

Converte horas, minutos e segundos fornecidos como números num número de série do Excel, formatado com um formato de tempo.
timevalue(timeText)

Converte uma hora de texto num número de série do Excel por uma hora, um número de 0 (0:00:00) para 0,999988426 (23:59:59). Formate o número com um formato de hora depois de introduzir a fórmula.
today()

Devolve a data atual formatada como uma data.
toJSON()

Substitui o método JavaScript toJSON() para fornecer uma saída mais útil quando um objeto de API é transmitido para JSON.stringify(). (JSON.stringifypor sua vez, chama o toJSON método do objeto que lhe é transmitido.) Enquanto o objeto original Excel.Functions é um objeto de API, o toJSON método devolve um objeto JavaScript simples (escrito como Excel.Interfaces.FunctionsData) que contém cópias rasas de quaisquer propriedades subordinadas carregadas do objeto original.
trim(text)

Remove todos os espaços de uma cadeia de texto, exceto espaços únicos entre palavras.
trimMean(array, percent)

Devolve a média da parte interior de um conjunto de valores de dados.
true()

Devolve o valor lógico VERDADEIRO.
trunc(number, numDigits)

Trunca um número para um número inteiro ao remover a parte decimal ou fracionária do número.
type(value)

Devolve um número inteiro que representa o tipo de dados de um valor: number = 1; texto = 2; valor lógico = 4; valor de erro = 16; matriz = 64; dados compostos = 128.
unichar(number)

Devolve o caráter Unicode referenciado pelo valor numérico especificado.
unicode(text)

Devolve o número (ponto de código) correspondente ao primeiro caráter do texto.
upper(text)

Converte uma cadeia de texto em todas as letras maiúsculas.
usdollar(number, decimals)

Converte um número em texto com o formato de moeda.
value(text)

Converte uma cadeia de texto que representa um número num número.
var_P(values)

Calcula a variância com base na população total (ignora valores lógicos e texto na população).
var_S(values)

Calcula a variância com base numa amostra (ignora os valores lógicos e o texto na amostra).
varA(values)

Calcula a variância com base numa amostra, incluindo valores lógicos e texto. O texto e o valor lógico FALSO têm o valor 0; o valor lógico VERDADEIRO tem o valor 1.
varPA(values)

Calcula a variância com base na população total, incluindo valores lógicos e texto. O texto e o valor lógico FALSO têm o valor 0; o valor lógico VERDADEIRO tem o valor 1.
vdb(cost, salvage, life, startPeriod, endPeriod, factor, noSwitch)

Retorna a depreciação de um ativo para o período que você especificar, incluindo períodos parciais, usando o método balanço declinante duplo ou algum outro método especificado.
vlookup(lookupValue, tableArray, colIndexNum, rangeLookup)

Procura um valor na coluna mais à esquerda de uma tabela e, em seguida, devolve um valor na mesma linha de uma coluna que especificar. Por predefinição, a tabela tem de ser ordenada por ordem ascendente.
weekday(serialNumber, returnType)

Devolve um número de 1 a 7 identificando o dia da semana de uma data.
weekNum(serialNumber, returnType)

Devolve o número da semana no ano.
weibull_Dist(x, alpha, beta, cumulative)

Retorna a distribuição Weibull.
workDay_Intl(startDate, days, weekend, holidays)

Retorna o número de série da data, antes ou depois de um número especificado de dias úteis, com parâmetros personalizados de final de semana.
workDay(startDate, days, holidays)

Devolve o número de série da data antes ou depois de um número especificado de dias de trabalho.
xirr(values, dates, guess)

Devolve a taxa interna de rentabilidade de uma agenda de fluxos monetários.
xnpv(rate, values, dates)

Devolve o valor atual líquido de uma agenda de fluxos monetários.
xor(values)

Devolve um "Exclusivo Ou" lógico de todos os argumentos.
year(serialNumber)

Devolve o ano de uma data, um número inteiro no intervalo de 1900 a 9999.
yearFrac(startDate, endDate, basis)

Devolve a fração de ano que representa o número de dias inteiros entre start_date e end_date.
yield(settlement, maturity, rate, pr, redemption, frequency, basis)

Devolve o rendimento de um título que paga juros periódicos.
yieldDisc(settlement, maturity, pr, redemption, basis)

Retorna o rendimento anual de um título descontado. Por exemplo, uma obrigação do Tesouro.
yieldMat(settlement, maturity, issue, rate, pr, basis)

Retorna o rendimento anual de um título que paga juros no vencimento.
z_Test(array, x, sigma)

Devolve o valor P unicaudo de um teste z.

Detalhes da propriedade

context

O contexto do pedido associado ao objeto . Esta ação liga o processo do suplemento ao processo da aplicação anfitriã do Office.

context: RequestContext;

Valor da propriedade

Excel.RequestContext

Detalhes do método

abs(number)

Devolve o valor absoluto de um número, um número sem o respetivo sinal.

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

Parâmetros

number

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

É o número real para o qual pretende obter o valor absoluto.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

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

Retorna juros acumulados de um título que paga juros periódicos.

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>;

Parâmetros

issue

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

É a data de emissão do título, expressa como um número de data de série.

firstInterest

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

É a primeira data de juros do título, expressa como um número de data de série.

settlement

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

É a data de liquidação do título, expressa como um número de data de série.

rate

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

É a taxa de cupom anual do título.

par

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

É o valor de paridade do título.

frequency

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

É o número de pagamentos cupom por ano.

basis

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

É o tipo de base de contagem diária a utilizar.

calcMethod

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

É um valor lógico: para acumular juros a partir da data de emissão = VERDADEIRO ou omitido; para calcular a partir da data de pagamento do último cupom = FALSO.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

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

Retorna juros acumulados de um título que paga juros no vencimento.

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>;

Parâmetros

issue

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

É a data de emissão do título, expressa como um número de data de série.

settlement

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

É a data de vencimento do título, expressa como um número de data de série.

rate

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

É a taxa de cupom anual do título.

par

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

É o valor de paridade do título.

basis

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

É o tipo de base de contagem diária a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

acos(number)

Devolve o arco de cosseno de um número, em radianos no intervalo 0 a Pi. O arco de cosseno é o ângulo cujo cosseno é Number.

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

Parâmetros

number

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

É o cosseno do ângulo que pretende e tem de ser de -1 a 1.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

acosh(number)

Retorna o cosseno hiperbólico inverso de um número.

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

Parâmetros

number

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

É qualquer número real igual ou superior a 1.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

acot(number)

Devolve o arco de tangente de um número, em radianos no intervalo de 0 a Pi.

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

Parâmetros

number

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

É a cotangente do ângulo que pretende.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

acoth(number)

Devolve a cotangente hiperbólica inversa de um número.

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

Parâmetros

number

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

É a cotangente hiperbólica do ângulo que pretende.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

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

Devolve a depreciação linear proporcional de um ativo para cada período contabilístico.

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>;

Parâmetros

cost

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

É o custo do recurso.

datePurchased

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

É a data em que o recurso é comprado.

firstPeriod

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

É a data do fim do primeiro período.

salvage

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

É o valor residual no fim da vida útil do ativo.

period

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

É o ponto final.

rate

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

É a taxa de depreciação.

basis

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

Year_basis: 0 para o ano de 360 dias, 1 para real, 3 para o ano de 365 dias.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

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

Devolve a depreciação linear proporcional de um ativo para cada período contabilístico.

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>;

Parâmetros

cost

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

É o custo do recurso.

datePurchased

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

É a data em que o recurso é comprado.

firstPeriod

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

É a data do fim do primeiro período.

salvage

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

É o valor residual no fim da vida útil do ativo.

period

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

É o ponto final.

rate

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

É a taxa de depreciação.

basis

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

Year_basis: 0 para o ano de 360 dias, 1 para real, 3 para o ano de 365 dias.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

and(values)

Verifica se todos os argumentos são VERDADEIRO e devolve VERDADEIRO se todos os argumentos forem VERDADEIRO.

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

Parâmetros

values

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

Lista de parâmetros, cujos elementos são 1 a 255 condições que pretende testar que podem ser VERDADEIRO ou FALSO e podem ser valores lógicos, matrizes ou referências.

Retornos

Excel.FunctionResult<boolean>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

arabic(text)

Converte um numeral romano em árabe.

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

Parâmetros

text

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

É o numeral romano que quer converter.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

areas(reference)

Devolve o número de áreas numa referência. Uma área é um intervalo de células contíguas ou uma única célula.

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

Parâmetros

reference

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

É uma referência a uma célula ou intervalo de células e pode referir-se a várias áreas.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

asc(text)

Altera os carateres de largura total (byte duplo) para carateres de meia largura (byte único). Utilize com conjuntos de carateres de byte duplo (DBCS).

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

Parâmetros

text

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

É um texto ou uma referência a uma célula que contém um texto.

Retornos

Excel.FunctionResult<string>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

asin(number)

Devolve o arco de seno de um número em radianos, no intervalo -Pi/2 a Pi/2.

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

Parâmetros

number

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

É o seno do ângulo que pretende e tem de ser de -1 a 1.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

asinh(number)

Retorna o seno hiperbólico inverso de um número.

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

Parâmetros

number

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

É qualquer número real igual ou superior a 1.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

atan(number)

Devolve o arco de tangente de um número em radianos, no intervalo -Pi/2 a Pi/2.

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

Parâmetros

number

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

É a tangente do ângulo que pretende.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

atan2(xNum, yNum)

Devolve o arco de tangente das coordenadas x e y especificadas, em radianos entre -Pi e Pi, excluindo -Pi.

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

Parâmetros

xNum

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

É a coordenada x do ponto.

yNum

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

É a coordenada y do ponto.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

atanh(number)

Retorna a tangente hiperbólica inversa de um número.

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

Parâmetros

number

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

É qualquer número real entre -1 e 1, excluindo -1 e 1.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

aveDev(values)

Retorna a média dos desvios absolutos de pontos de dados com relação a sua média. Os argumentos podem ser números ou nomes, matrizes ou referências que contenham números.

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

Parâmetros

values

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

Lista de parâmetros, cujos elementos são de 1 a 255 argumentos para os quais pretende obter a média dos desvios absolutos.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

average(values)

Devolve a média (média aritmética) dos respetivos argumentos, que podem ser números ou nomes, matrizes ou referências que contêm números.

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

Parâmetros

values

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

Lista de parâmetros, cujos elementos são de 1 a 255 argumentos numéricos para os quais pretende obter a média.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

averageA(values)

Devolve a média (média aritmética) dos respetivos argumentos, avaliando texto e FALSO em argumentos como 0; TRUE avalia como 1. Os argumentos podem ser números, nomes, matrizes ou referências.

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

Parâmetros

values

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

Lista de parâmetros, cujos elementos são de 1 a 255 argumentos para os quais pretende obter a média.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

averageIf(range, criteria, averageRange)

Localiza a média(média aritmética) das células especificadas por uma determinada condição ou critério.

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>;

Parâmetros

range

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

É o intervalo de células que pretende avaliar.

criteria

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

É a condição ou critérios na forma de um número, expressão ou texto que define as células que serão utilizadas para encontrar a média.

averageRange

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

São as células reais a serem utilizadas para encontrar a média. Se omitido, são utilizadas as células no intervalo.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

averageIfs(averageRange, values)

Localiza a média(média aritmética) das células especificadas por um determinado conjunto de condições ou critérios.

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

Parâmetros

averageRange

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

São as células reais a serem utilizadas para encontrar a média.

values

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

Lista de parâmetros, em que o primeiro elemento de cada par é o intervalo de células que pretende avaliar para a condição específica e o segundo elemento é a condição ou critérios sob a forma de um número, expressão ou texto que define as células que serão utilizadas para encontrar a média.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

bahtText(number)

Converte um número em texto (baht).

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

Parâmetros

number

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

É um número que pretende converter.

Retornos

Excel.FunctionResult<string>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

base(number, radix, minLength)

Converte um número numa representação de texto com o radix especificado (base).

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>;

Parâmetros

number

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

É o número que pretende converter.

radix

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

É o Radix base em que pretende converter o número.

minLength

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

É o comprimento mínimo da cadeia devolvida. Se não forem adicionados zeros à esquerda omitidos.

Retornos

Excel.FunctionResult<string>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

besselI(x, n)

Devolve a função de Bessel modificada 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>;

Parâmetros

x

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

É o valor no qual se avalia a função.

n

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

É a ordem da função de Bessel.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

besselJ(x, n)

Devolve a função de 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>;

Parâmetros

x

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

É o valor no qual se avalia a função.

n

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

É a ordem da função de Bessel.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

besselK(x, n)

Devolve a função de Bessel modificada 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>;

Parâmetros

x

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

É o valor no qual se avalia a função.

n

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

É a ordem da função.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

besselY(x, n)

Devolve a função De Bessel 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>;

Parâmetros

x

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

É o valor no qual se avalia a função.

n

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

É a ordem da função.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

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

Devolve a função de distribuição de probabilidade 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>;

Parâmetros

x

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

É o valor entre A e B no qual se avalia a função.

alpha

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

É um parâmetro para a distribuição e tem de ser superior a 0.

beta

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

É um parâmetro para a distribuição e tem de ser superior a 0.

cumulative

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

É um valor lógico: para a função de distribuição cumulativa, utilize VERDADEIRO; para a função de densidade de probabilidade, utilize FALSO.

A

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

É um limite inferior opcional para o intervalo de x. Se omitido, A = 0.

B

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

É um limite superior opcional para o intervalo de x. Se omitido, B = 1.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

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

Devolve o inverso da função de densidade de probabilidade beta cumulativa (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>;

Parâmetros

probability

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

É uma probabilidade associada à distribuição beta.

alpha

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

É um parâmetro para a distribuição e tem de ser superior a 0.

beta

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

É um parâmetro para a distribuição e tem de ser superior a 0.

A

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

É um limite inferior opcional para o intervalo de x. Se omitido, A = 0.

B

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

É um limite superior opcional para o intervalo de x. Se omitido, B = 1.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

bin2Dec(number)

Converte um número binário em decimal.

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

Parâmetros

number

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

É o número binário que pretende converter.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

bin2Hex(number, places)

Converte um número binário em hexadecimal.

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>;

Parâmetros

number

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

É o número binário que pretende converter.

places

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

É o número de carateres a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

bin2Oct(number, places)

Converte um número binário em octal.

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>;

Parâmetros

number

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

É o número binário que pretende converter.

places

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

É o número de carateres a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

binom_Dist_Range(trials, probabilityS, numberS, numberS2)

Devolve a probabilidade de um resultado de avaliação com uma distribuição binomial.

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>;

Parâmetros

trials

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

É o número de tentativas independentes.

probabilityS

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

É a probabilidade de sucesso em cada tentativa.

numberS

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

É o número de êxitos em tentativas.

numberS2

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

Se for fornecida, esta função devolve a probabilidade de o número de tentativas bem-sucedidas se situar entre numberS e numberS2.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

binom_Dist(numberS, trials, probabilityS, cumulative)

Retorna a probabilidade de distribuição binomial do termo individual.

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>;

Parâmetros

numberS

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

É o número de êxitos em tentativas.

trials

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

É o número de tentativas independentes.

probabilityS

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

É a probabilidade de sucesso em cada tentativa.

cumulative

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

É um valor lógico: para a função de distribuição cumulativa, utilize VERDADEIRO; para a função de densidade de probabilidade, utilize FALSO.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

binom_Inv(trials, probabilityS, alpha)

Retorna o menor valor para o qual a distribuição binomial cumulativa é maior ou igual ao valor padrão.

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>;

Parâmetros

trials

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

É o número de tentativas de Bernoulli.

probabilityS

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

É a probabilidade de sucesso em cada tentativa, um número entre 0 e 1 inclusive.

alpha

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

É o valor do critério, um número entre 0 e 1 inclusive.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

bitand(number1, number2)

Devolve um valor bit a bit "E" de dois números.

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

Parâmetros

number1

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

É a representação decimal do número binário que pretende avaliar.

number2

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

É a representação decimal do número binário que pretende avaliar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

bitlshift(number, shiftAmount)

Devolve um número deslocado para a esquerda por shift_amount bits.

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

Parâmetros

number

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

É a representação decimal do número binário que pretende avaliar.

shiftAmount

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

É o número de bits pelo qual pretende mudar o Número para a esquerda.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

bitor(number1, number2)

Devolve um valor bit a bit "Ou" de dois números.

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

Parâmetros

number1

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

É a representação decimal do número binário que pretende avaliar.

number2

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

É a representação decimal do número binário que pretende avaliar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

bitrshift(number, shiftAmount)

Devolve um número deslocado para a direita por shift_amount bits.

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

Parâmetros

number

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

É a representação decimal do número binário que pretende avaliar.

shiftAmount

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

É o número de bits pelo qual pretende mudar o Número para a direita.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

bitxor(number1, number2)

Devolve um valor bit a bit "Exclusivo Ou" de dois números.

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

Parâmetros

number1

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

É a representação decimal do número binário que pretende avaliar.

number2

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

É a representação decimal do número binário que pretende avaliar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

ceiling_Math(number, significance, mode)

Arredonda um número por cima, para o número inteiro mais próximo ou para o múltiplo de significância mais próximo.

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>;

Parâmetros

number

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

É o valor que pretende arredondar.

significance

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

É o múltiplo para o qual pretende arredondar.

mode

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

Quando dada e diferente de zero, esta função arredondará para fora do zero.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

ceiling_Precise(number, significance)

Arredonda um número por cima, para o número inteiro mais próximo ou para o múltiplo de significância mais próximo.

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

Parâmetros

number

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

É o valor que pretende arredondar.

significance

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

É o múltiplo para o qual pretende arredondar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

char(number)

Devolve o caráter especificado pelo número de código do conjunto de carateres do computador.

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

Parâmetros

number

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

É um número entre 1 e 255 que especifica o caráter pretendido.

Retornos

Excel.FunctionResult<string>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

chiSq_Dist_RT(x, degFreedom)

Retorna a probabilidade da distribuição qui-quadrada de cauda direita.

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

Parâmetros

x

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

É o valor no qual pretende avaliar a distribuição, um número não negativo.

degFreedom

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

É o número de graus de liberdade, um número entre 1 e 10^10, excluindo 10^10.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

chiSq_Dist(x, degFreedom, cumulative)

Devolve a probabilidade caudal esquerda da distribuição chi-quadrado.

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>;

Parâmetros

x

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

É o valor no qual pretende avaliar a distribuição, um número não negativo.

degFreedom

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

É o número de graus de liberdade, um número entre 1 e 10^10, excluindo 10^10.

cumulative

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

É um valor lógico para a função devolver: a função de distribuição cumulativa = VERDADEIRO; a função de densidade de probabilidade = FALSO.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

chiSq_Inv_RT(probability, degFreedom)

Retorna o inverso da probabilidade de cauda direita da distribuição qui-quadrada.

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

Parâmetros

probability

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

É uma probabilidade associada à distribuição chi-quadrado, um valor entre 0 e 1 inclusive.

degFreedom

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

É o número de graus de liberdade, um número entre 1 e 10^10, excluindo 10^10.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

chiSq_Inv(probability, degFreedom)

Retorna o inverso da probabilidade da distribuição qui-quadrada de cauda esquerda.

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

Parâmetros

probability

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

É uma probabilidade associada à distribuição chi-quadrado, um valor entre 0 e 1 inclusive.

degFreedom

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

É o número de graus de liberdade, um número entre 1 e 10^10, excluindo 10^10.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

choose(indexNum, values)

Escolhe um valor ou ação a executar a partir de uma lista de valores, com base num número de índice.

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>;

Parâmetros

indexNum

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

Especifica qual argumento de valor é selecionado. indexNum tem de estar entre 1 e 254, ou uma fórmula ou uma referência a um número entre 1 e 254.

values

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

Lista de parâmetros, cujos elementos são de 1 a 254 números, referências de células, nomes definidos, fórmulas, funções ou argumentos de texto a partir dos quais SELECIONAR seleciona.

Retornos

Excel.FunctionResult<number | string | boolean>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

clean(text)

Remove todos os caracteres do texto que não podem ser impressos.

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

Parâmetros

text

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

É qualquer informação de folha de cálculo a partir da qual pretende remover carateres não imprimíveis.

Retornos

Excel.FunctionResult<string>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

code(text)

Devolve um código numérico para o primeiro caráter numa cadeia de texto, no conjunto de carateres utilizado pelo computador.

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

Parâmetros

text

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

É o texto para o qual pretende obter o código do primeiro caráter.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

columns(array)

Devolve o número de colunas numa matriz ou referência.

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

Parâmetros

array

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

É uma matriz ou fórmula de matriz ou uma referência a um intervalo de células para o qual pretende obter o número de colunas.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

combin(number, numberChosen)

Retorna o número de combinações de um dado número de itens.

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

Parâmetros

number

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

É o número total de itens.

numberChosen

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

É o número de itens em cada combinação.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

combina(number, numberChosen)

Devolve o número de combinações com repetições para um determinado número de itens.

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

Parâmetros

number

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

É o número total de itens.

numberChosen

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

É o número de itens em cada combinação.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

complex(realNum, iNum, suffix)

Converte coeficientes reais e imaginários num número complexo.

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>;

Parâmetros

realNum

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

É o coeficiente real do número complexo.

iNum

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

É o coeficiente imaginário do número complexo.

suffix

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

É o sufixo do componente imaginário do número complexo.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

concatenate(values)

Associa várias cadeias de texto a uma cadeia de texto.

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

Parâmetros

values

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

Lista de parâmetros, cujos elementos são de 1 a 255 cadeias de texto a serem associadas numa única cadeia de texto e podem ser cadeias de texto, números ou referências de célula única.

Retornos

Excel.FunctionResult<string>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

confidence_Norm(alpha, standardDev, size)

Devolve o intervalo de confiança de uma média de população, utilizando uma distribuição normal.

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>;

Parâmetros

alpha

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

É o nível de significância utilizado para calcular o nível de confiança, um número superior a 0 e inferior a 1.

standardDev

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

É o desvio-padrão da população para o intervalo de dados e é assumido como conhecido. standardDev tem de ser superior a 0.

size

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

É o tamanho da amostra.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

confidence_T(alpha, standardDev, size)

Devolve o intervalo de confiança de uma média de população, utilizando uma distribuição T de Student.

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>;

Parâmetros

alpha

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

É o nível de significância utilizado para calcular o nível de confiança, um número superior a 0 e inferior a 1.

standardDev

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

É o desvio-padrão da população para o intervalo de dados e é assumido como conhecido. standardDev tem de ser superior a 0.

size

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

É o tamanho da amostra.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

convert(number, fromUnit, toUnit)

Converte um número de um sistema de medida para outro.

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>;

Parâmetros

number

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

É o valor em from_units a converter.

fromUnit

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

São as unidades para o número.

toUnit

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

São as unidades do resultado.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

cos(number)

Devolve o cosseno de um ângulo.

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

Parâmetros

number

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

É o ângulo em radianos para o qual pretende obter o cosseno.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

cosh(number)

Retorna o cosseno hiperbólico de um número.

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

Parâmetros

number

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

É qualquer número real.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

cot(number)

Devolve a cotangente de um ângulo.

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

Parâmetros

number

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

É o ângulo em radianos para o qual pretende obter a cotangente.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

coth(number)

Devolve a cotangente hiperbólica de um número.

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

Parâmetros

number

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

É o ângulo em radianos para o qual pretende obter a cotangente hiperbólica.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

count(values)

Conta o número de células num intervalo que contém números.

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

Parâmetros

values

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

Lista de parâmetros, cujos elementos são de 1 a 255 argumentos que podem conter ou referenciar uma variedade de diferentes tipos de dados, mas apenas os números são contados.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

countA(values)

Conta o número de células num intervalo que não estão vazias.

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

Parâmetros

values

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

Lista de parâmetros, cujos elementos são de 1 a 255 argumentos que representam os valores e células que pretende contar. Os valores podem ser qualquer tipo de informação.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

countBlank(range)

Conta o número de células vazias num intervalo de células especificado.

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

Parâmetros

range

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

É o intervalo a partir do qual pretende contar as células vazias.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

countIf(range, criteria)

Conta o número de células dentro de um intervalo que cumpre a condição especificada.

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

Parâmetros

range

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

É o intervalo de células a partir do qual pretende contar células que não estão em branco.

criteria

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

É a condição sob a forma de um número, expressão ou texto que define as células que serão contadas.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

countIfs(values)

Conta o número de células especificadas por um determinado conjunto de condições ou critérios.

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

Parâmetros

values

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

Lista de parâmetros, em que o primeiro elemento de cada par é o intervalo de células que pretende avaliar para a condição específica e o segundo elemento é a condição sob a forma de um número, expressão ou texto que define as células que serão contadas.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

coupDayBs(settlement, maturity, frequency, basis)

Retorna o número de dias do início do período de cupom até a data de liquidação.

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>;

Parâmetros

settlement

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

É a data de liquidação do título, expressa como um número de data de série.

maturity

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

É a data de vencimento do título, expressa como um número de data de série.

frequency

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

É o número de pagamentos cupom por ano.

basis

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

É o tipo de base de contagem diária a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

coupDays(settlement, maturity, frequency, basis)

Retorna o número de dias no período de cupom que contém a data de liquidação.

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>;

Parâmetros

settlement

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

É a data de liquidação do título, expressa como um número de data de série.

maturity

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

É a data de vencimento do título, expressa como um número de data de série.

frequency

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

É o número de pagamentos cupom por ano.

basis

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

É o tipo de base de contagem diária a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

coupDaysNc(settlement, maturity, frequency, basis)

Retorna o número de dias da data de liquidação até a data do próximo cupom.

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>;

Parâmetros

settlement

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

É a data de liquidação do título, expressa como um número de data de série.

maturity

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

É a data de vencimento do título, expressa como um número de data de série.

frequency

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

É o número de pagamentos cupom por ano.

basis

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

É o tipo de base de contagem diária a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

coupNcd(settlement, maturity, frequency, basis)

Devolve a data de cupom seguinte após a data de liquidação.

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>;

Parâmetros

settlement

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

É a data de liquidação do título, expressa como um número de data de série.

maturity

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

É a data de vencimento do título, expressa como um número de data de série.

frequency

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

É o número de pagamentos cupom por ano.

basis

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

É o tipo de base de contagem diária a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

coupNum(settlement, maturity, frequency, basis)

Devolve o número de cupões a pagar entre a data de liquidação e a data de vencimento.

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>;

Parâmetros

settlement

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

É a data de liquidação do título, expressa como um número de data de série.

maturity

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

É a data de vencimento do título, expressa como um número de data de série.

frequency

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

É o número de pagamentos cupom por ano.

basis

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

É o tipo de base de contagem diária a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

coupPcd(settlement, maturity, frequency, basis)

Devolve a data de cupom anterior antes da data de liquidação.

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>;

Parâmetros

settlement

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

É a data de liquidação do título, expressa como um número de data de série.

maturity

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

É a data de vencimento do título, expressa como um número de data de série.

frequency

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

É o número de pagamentos cupom por ano.

basis

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

É o tipo de base de contagem diária a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

csc(number)

Devolve a cossecante de um ângulo.

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

Parâmetros

number

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

É o ângulo em radianos para o qual pretende obter a cossecante.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

csch(number)

Devolve a cossecante hiperbólica de um ângulo.

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

Parâmetros

number

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

É o ângulo em radianos para o qual pretende obter a cossecante hiperbólica.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

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

Devolve os juros acumulados pagos entre dois períodos.

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>;

Parâmetros

rate

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

É a taxa de juros.

nper

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

É o número total de períodos de pagamento.

pv

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

É o valor atual.

startPeriod

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

É o primeiro período no cálculo.

endPeriod

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

É o último período no cálculo.

type

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

É o momento do pagamento.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

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

Devolve o capital acumulado pago num empréstimo entre dois períodos.

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>;

Parâmetros

rate

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

É a taxa de juros.

nper

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

É o número total de períodos de pagamento.

pv

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

É o valor atual.

startPeriod

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

É o primeiro período no cálculo.

endPeriod

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

É o último período no cálculo.

type

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

É o momento do pagamento.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

date(year, month, day)

Devolve o número que representa a data no código de data/hora do Microsoft Excel.

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>;

Parâmetros

year

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

É um número de 1900 ou 1904 (dependendo do sistema de datas do livro) para 9999.

month

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

É um número de 1 a 12 que representa o mês do ano.

day

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

É um número de 1 a 31 que representa o dia do mês.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

datevalue(dateText)

Converte uma data sob a forma de texto num número que representa a data no código de data/hora do Microsoft Excel.

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

Parâmetros

dateText

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

É texto que representa uma data num formato de data do Microsoft Excel, entre 1/1/1900 ou 1/1/1904 (dependendo do sistema de datas do livro) e 31/12/9999.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

daverage(database, field, criteria)

Calcula a média dos valores numa coluna numa lista ou base de dados que correspondam às condições que especificar.

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>;

Parâmetros

database

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

É o intervalo de células que compõe a lista ou base de dados. Uma base de dados é uma lista de dados relacionados.

field

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

É a etiqueta da coluna entre aspas duplas ou um número que representa a posição da coluna na lista.

criteria

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

É o intervalo de células que contém as condições que especificar. O intervalo inclui uma etiqueta de coluna e uma célula abaixo da etiqueta para uma condição.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

day(serialNumber)

Devolve o dia do mês, um número de 1 a 31.

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

Parâmetros

serialNumber

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

É um número no código de data/hora utilizado pelo Microsoft Excel.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

days(endDate, startDate)

Devolve o número de dias entre as duas datas.

days(endDate: string | number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, startDate: string | number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

endDate

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

startDate e endDate são as duas datas entre as quais pretende saber o número de dias.

startDate

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

startDate e endDate são as duas datas entre as quais pretende saber o número de dias.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

days360(startDate, endDate, method)

Devolve o número de dias entre duas datas com base num ano de 360 dias (doze meses de 30 dias).

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>;

Parâmetros

startDate

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

startDate e endDate são as duas datas entre as quais pretende saber o número de dias.

endDate

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

startDate e endDate são as duas datas entre as quais pretende saber o número de dias.

method

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

É um valor lógico que especifica o método de cálculo: EUA (NASD) = FALSO ou omitido; Europeu = VERDADEIRO.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

db(cost, salvage, life, period, month)

Retorna a depreciação de um ativo para um período especificado, usando o método de balanço de declínio fixo.

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>;

Parâmetros

cost

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

É o custo inicial do recurso.

salvage

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

É o valor residual no final da vida útil do ativo.

life

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

É o número de períodos durante os quais o ativo está a ser depreciado (por vezes denominado vida útil do ativo).

period

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

É o período para o qual pretende calcular a depreciação. O período tem de utilizar as mesmas unidades que a Life.

month

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

É o número de meses no primeiro ano. Se mês for omitido, será presumido como 12.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

dbcs(text)

Altera os carateres de largura média (byte único) dentro de uma cadeia de carateres para carateres de largura total (byte duplo). Utilize com conjuntos de carateres de byte duplo (DBCS).

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

Parâmetros

text

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

É um texto ou uma referência a uma célula que contém um texto.

Retornos

Excel.FunctionResult<string>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

dcount(database, field, criteria)

Conta as células que contêm números no campo (coluna) dos registos na base de dados que correspondem às condições especificadas.

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>;

Parâmetros

database

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

É o intervalo de células que compõe a lista ou base de dados. Uma base de dados é uma lista de dados relacionados.

field

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

É a etiqueta da coluna entre aspas duplas ou um número que representa a posição da coluna na lista.

criteria

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

É o intervalo de células que contém as condições que especificar. O intervalo inclui uma etiqueta de coluna e uma célula abaixo da etiqueta para uma condição.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

dcountA(database, field, criteria)

Conta células que não estão em branco no campo (coluna) dos registos na base de dados que correspondem às condições que especificar.

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>;

Parâmetros

database

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

É o intervalo de células que compõe a lista ou base de dados. Uma base de dados é uma lista de dados relacionados.

field

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

É a etiqueta da coluna entre aspas duplas ou um número que representa a posição da coluna na lista.

criteria

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

É o intervalo de células que contém as condições que especificar. O intervalo inclui uma etiqueta de coluna e uma célula abaixo da etiqueta para uma condição.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

ddb(cost, salvage, life, period, factor)

Retorna a depreciação de um ativo com relação a um período especificado usando o método de saldos decrescentes duplos ou qualquer outro método especificado por você.

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>;

Parâmetros

cost

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

É o custo inicial do recurso.

salvage

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

É o valor residual no final da vida útil do ativo.

life

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

É o número de períodos durante os quais o ativo está a ser depreciado (por vezes denominado vida útil do ativo).

period

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

É o período para o qual pretende calcular a depreciação. O período tem de utilizar as mesmas unidades que a Life.

factor

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

É a taxa a que o saldo diminui. Se Factor for omitido, assume-se que é 2 (o método de saldo degressiva de base dupla).

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

dec2Bin(number, places)

Converte um número decimal em binário.

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>;

Parâmetros

number

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

É o número inteiro decimal que pretende converter.

places

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

É o número de carateres a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

dec2Hex(number, places)

Converte um número decimal em hexadecimal.

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>;

Parâmetros

number

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

É o número inteiro decimal que pretende converter.

places

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

É o número de carateres a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

dec2Oct(number, places)

Converte um número decimal em octal.

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>;

Parâmetros

number

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

É o número inteiro decimal que pretende converter.

places

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

É o número de carateres a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

decimal(number, radix)

Converte uma representação de texto de um número numa determinada base num número decimal.

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

Parâmetros

number

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

É o número que pretende converter.

radix

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

É o Radix base do número que está a converter.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

degrees(angle)

Converte radianos em graus.

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

Parâmetros

angle

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

É o ângulo em radianos que pretende converter.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

delta(number1, number2)

Testa se dois números são iguais.

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>;

Parâmetros

number1

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

É o primeiro número.

number2

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

É o segundo número.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

devSq(values)

Retorna a soma dos quadrados dos desvios de pontos de dados da média da amostra.

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

Parâmetros

values

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

Lista de parâmetros, cujos elementos são de 1 a 255 argumentos, ou uma referência de matriz ou matriz, na qual pretende que o DEVSQ calcule.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

dget(database, field, criteria)

Extrai de uma base de dados um único registo que corresponde às condições que especificar.

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>;

Parâmetros

database

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

É o intervalo de células que compõe a lista ou base de dados. Uma base de dados é uma lista de dados relacionados.

field

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

É a etiqueta da coluna entre aspas duplas ou um número que representa a posição da coluna na lista.

criteria

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

É o intervalo de células que contém as condições que especificar. O intervalo inclui uma etiqueta de coluna e uma célula abaixo da etiqueta para uma condição.

Retornos

Excel.FunctionResult<number | boolean | string>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

disc(settlement, maturity, pr, redemption, basis)

Retorna a taxa de desconto de um título.

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>;

Parâmetros

settlement

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

É a data de liquidação do título, expressa como um número de data de série.

maturity

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

É a data de vencimento do título, expressa como um número de data de série.

pr

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

É o preço do título por valor nominal de 100 $.

redemption

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

É o valor de resgate do título por valor nominal de 100 $.

basis

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

É o tipo de base de contagem diária a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

dmax(database, field, criteria)

Devolve o maior número no campo (coluna) de registos na base de dados que correspondem às condições que especificar.

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>;

Parâmetros

database

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

É o intervalo de células que compõe a lista ou base de dados. Uma base de dados é uma lista de dados relacionados.

field

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

É a etiqueta da coluna entre aspas duplas ou um número que representa a posição da coluna na lista.

criteria

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

É o intervalo de células que contém as condições que especificar. O intervalo inclui uma etiqueta de coluna e uma célula abaixo da etiqueta para uma condição.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

dmin(database, field, criteria)

Devolve o menor número no campo (coluna) dos registos na base de dados que correspondem às condições que especificar.

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>;

Parâmetros

database

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

É o intervalo de células que compõe a lista ou base de dados. Uma base de dados é uma lista de dados relacionados.

field

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

É a etiqueta da coluna entre aspas duplas ou um número que representa a posição da coluna na lista.

criteria

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

É o intervalo de células que contém as condições que especificar. O intervalo inclui uma etiqueta de coluna e uma célula abaixo da etiqueta para uma condição.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

dollar(number, decimals)

Converte um número em texto com o formato de moeda.

dollar(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, decimals?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

Parâmetros

number

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

É um número, uma referência a uma célula que contém um número ou uma fórmula que é avaliada como um número.

decimals

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

É o número de dígitos à direita da vírgula decimal. O número é arredondado conforme necessário; se omitido, Casas Decimais = 2.

Retornos

Excel.FunctionResult<string>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

dollarDe(fractionalDollar, fraction)

Converte um preço em dólares, expresso como uma fração, num preço em dólares, expresso como um número decimal.

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>;

Parâmetros

fractionalDollar

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

É um número expresso como uma fração.

fraction

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

É o número inteiro a utilizar no denominador da fração.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

dollarFr(decimalDollar, fraction)

Converte um preço em dólares, expresso como um número decimal, num preço em dólar, expresso como uma fração.

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>;

Parâmetros

decimalDollar

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

É um número decimal.

fraction

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

É o número inteiro a utilizar no denominador de uma fração.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

dproduct(database, field, criteria)

Multiplica os valores no campo (coluna) dos registos na base de dados que correspondem às condições que especificar.

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>;

Parâmetros

database

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

É o intervalo de células que compõe a lista ou base de dados. Uma base de dados é uma lista de dados relacionados.

field

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

É a etiqueta da coluna entre aspas duplas ou um número que representa a posição da coluna na lista.

criteria

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

É o intervalo de células que contém as condições que especificar. O intervalo inclui uma etiqueta de coluna e uma célula abaixo da etiqueta para uma condição.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

dstDev(database, field, criteria)

Estima o desvio padrão com base num exemplo de entradas de base de dados selecionadas.

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>;

Parâmetros

database

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

É o intervalo de células que compõe a lista ou base de dados. Uma base de dados é uma lista de dados relacionados.

field

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

É a etiqueta da coluna entre aspas duplas ou um número que representa a posição da coluna na lista.

criteria

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

É o intervalo de células que contém as condições que especificar. O intervalo inclui uma etiqueta de coluna e uma célula abaixo da etiqueta para uma condição.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

dstDevP(database, field, criteria)

Calcula o desvio-padrão com base na população total de entradas de base de dados selecionadas.

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>;

Parâmetros

database

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

É o intervalo de células que compõe a lista ou base de dados. Uma base de dados é uma lista de dados relacionados.

field

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

É a etiqueta da coluna entre aspas duplas ou um número que representa a posição da coluna na lista.

criteria

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

É o intervalo de células que contém as condições que especificar. O intervalo inclui uma etiqueta de coluna e uma célula abaixo da etiqueta para uma condição.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

dsum(database, field, criteria)

Adiciona os números no campo (coluna) dos registos na base de dados que correspondem às condições que especificar.

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>;

Parâmetros

database

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

É o intervalo de células que compõe a lista ou base de dados. Uma base de dados é uma lista de dados relacionados.

field

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

É a etiqueta da coluna entre aspas duplas ou um número que representa a posição da coluna na lista.

criteria

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

É o intervalo de células que contém as condições que especificar. O intervalo inclui uma etiqueta de coluna e uma célula abaixo da etiqueta para uma condição.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

duration(settlement, maturity, coupon, yld, frequency, basis)

Devolve a duração anual de um título com pagamentos de juros periódicos.

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>;

Parâmetros

settlement

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

É a data de liquidação do título, expressa como um número de data de série.

maturity

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

É a data de vencimento do título, expressa como um número de data de série.

coupon

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

É a taxa de cupom anual do título.

yld

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

É o rendimento anual do título.

frequency

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

É o número de pagamentos cupom por ano.

basis

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

É o tipo de base de contagem diária a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

dvar(database, field, criteria)

Calcula a variância com base num exemplo de entradas de base de dados selecionadas.

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>;

Parâmetros

database

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

É o intervalo de células que compõe a lista ou base de dados. Uma base de dados é uma lista de dados relacionados.

field

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

É a etiqueta da coluna entre aspas duplas ou um número que representa a posição da coluna na lista.

criteria

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

É o intervalo de células que contém as condições que especificar. O intervalo inclui uma etiqueta de coluna e uma célula abaixo da etiqueta para uma condição.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

dvarP(database, field, criteria)

Calcula a variância com base na população total de entradas de base de dados selecionadas.

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>;

Parâmetros

database

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

É o intervalo de células que compõe a lista ou base de dados. Uma base de dados é uma lista de dados relacionados.

field

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

É a etiqueta da coluna entre aspas duplas ou um número que representa a posição da coluna na lista.

criteria

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

É o intervalo de células que contém as condições que especificar. O intervalo inclui uma etiqueta de coluna e uma célula abaixo da etiqueta para uma condição.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

ecma_Ceiling(number, significance)

Arredonda um número por cima, para o número inteiro mais próximo ou para o múltiplo de significância mais próximo.

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

Parâmetros

number

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

É o valor que pretende arredondar.

significance

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

É o múltiplo para o qual pretende arredondar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

edate(startDate, months)

Devolve o número de série da data que corresponde ao número indicado de meses antes ou depois da data de início.

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>;

Parâmetros

startDate

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

É um número de data de série que representa a data de início.

months

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

É o número de meses antes ou depois de startDate.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

effect(nominalRate, npery)

Devolve a taxa de juros anual efetiva.

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>;

Parâmetros

nominalRate

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

É a taxa de juro nominal.

npery

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

É o número de períodos compostos por ano.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

eoMonth(startDate, months)

Devolve o número de série do último dia do mês antes ou depois de um número especificado de meses.

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>;

Parâmetros

startDate

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

É um número de data de série que representa a data de início.

months

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

É o número de meses antes ou depois do startDate.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

erf_Precise(X)

Devolve a função de erro.

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

Parâmetros

X

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

É o limite inferior para a integração de FUNCERRO. PRECISO.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

erf(lowerLimit, upperLimit)

Devolve a função de erro.

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>;

Parâmetros

lowerLimit

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

É o limite inferior para a integração de FUNCERRO.

upperLimit

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

É o limite superior para a integração de FUNCERRO.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

erfC_Precise(X)

Devolve a função de erro complementar.

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

Parâmetros

X

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

É o vínculo inferior para integrar o ERFC. PRECISO.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

erfC(x)

Devolve a função de erro complementar.

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

Parâmetros

x

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

É o limite inferior para a integração de FUNCERRO.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

error_Type(errorVal)

Devolve um número que corresponde a um valor de erro.

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

Parâmetros

errorVal

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

É o valor de erro para o qual pretende obter o número de identificação e pode ser um valor de erro real ou uma referência a uma célula que contém um valor de erro.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

even(number)

Arredonda um número positivo por cima e um número negativo por baixo para o número inteiro par mais próximo.

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

Parâmetros

number

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

É o valor a arredondar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

exact(text1, text2)

Verifica se duas cadeias de texto são exatamente iguais e devolve VERDADEIRO ou FALSO. EXATO é sensível às maiúsculas e minúsculas.

exact(text1: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, text2: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<boolean>;

Parâmetros

text1

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

É a primeira cadeia de texto.

text2

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

É a segunda cadeia de texto.

Retornos

Excel.FunctionResult<boolean>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

exp(number)

Devolve e elevado à potência de um determinado número.

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

Parâmetros

number

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

É o expoente aplicado à base e. A constante e é igual a 2,71828182845904, a base do logaritmo natural.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

expon_Dist(x, lambda, cumulative)

Retorna a distribuição exponencial.

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>;

Parâmetros

x

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

É o valor da função, um número não negativo.

lambda

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

É o valor do parâmetro, um número positivo.

cumulative

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

É um valor lógico para a função devolver: a função de distribuição cumulativa = VERDADEIRO; a função de densidade de probabilidade = FALSO.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

f_Dist_RT(x, degFreedom1, degFreedom2)

Devolve a distribuição de probabilidade F (grau de diversidade) (caudal direita) para dois conjuntos de dados.

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>;

Parâmetros

x

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

É o valor no qual se avalia a função, um número não negativo.

degFreedom1

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

É o numerador graus de liberdade, um número entre 1 e 10^10, excluindo 10^10.

degFreedom2

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

São os graus de liberdade do denominador, um número entre 1 e 10^10, excluindo 10^10.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

f_Dist(x, degFreedom1, degFreedom2, cumulative)

Devolve a distribuição de probabilidade F (grau de diversidade) (caudal esquerda) para dois conjuntos de dados.

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>;

Parâmetros

x

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

É o valor no qual se avalia a função, um número não negativo.

degFreedom1

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

É o numerador graus de liberdade, um número entre 1 e 10^10, excluindo 10^10.

degFreedom2

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

São os graus de liberdade do denominador, um número entre 1 e 10^10, excluindo 10^10.

cumulative

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

É um valor lógico para a função devolver: a função de distribuição cumulativa = VERDADEIRO; a função de densidade de probabilidade = FALSO.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

f_Inv_RT(probability, degFreedom1, degFreedom2)

Devolve o inverso da distribuição de probabilidade F (caudal direita): se p = DIST.F. RT(x,...) e, em seguida, 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>;

Parâmetros

probability

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

É uma probabilidade associada à distribuição cumulativa F, um número entre 0 e 1 inclusive.

degFreedom1

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

É o numerador graus de liberdade, um número entre 1 e 10^10, excluindo 10^10.

degFreedom2

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

São os graus de liberdade do denominador, um número entre 1 e 10^10, excluindo 10^10.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

f_Inv(probability, degFreedom1, degFreedom2)

Devolve o inverso da distribuição da probabilidade F (caudal esquerda): se p = DIST.F(x,...), então INV.F(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>;

Parâmetros

probability

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

É uma probabilidade associada à distribuição cumulativa F, um número entre 0 e 1 inclusive.

degFreedom1

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

É o numerador graus de liberdade, um número entre 1 e 10^10, excluindo 10^10.

degFreedom2

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

São os graus de liberdade do denominador, um número entre 1 e 10^10, excluindo 10^10.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

fact(number)

Devolve o fatorial de um número, igual a 123*...* Número.

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

Parâmetros

number

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

É o número não negativo do qual pretende obter o fatorial.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

factDouble(number)

Retorna o fatorial duplo de um número.

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

Parâmetros

number

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

É o valor para o qual devolver o fatorial duplo.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

false()

Devolve o valor lógico FALSO.

false(): FunctionResult<boolean>;

Retornos

Excel.FunctionResult<boolean>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

find(findText, withinText, startNum)

Devolve a posição inicial de uma cadeia de texto dentro de outra cadeia de texto. LOCALIZAR é sensível a maiúsculas e minúsculas.

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>;

Parâmetros

findText

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

É o texto que pretende localizar. Utilize aspas duplas (texto vazio) para corresponder ao primeiro caráter em emText; carateres universais não permitidos.

withinText

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

É o texto que contém o texto que pretende localizar.

startNum

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

Especifica o caráter no qual pretende iniciar a pesquisa. O primeiro caráter em emText é o caráter número 1. Se omitido, startNum = 1.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

findB(findText, withinText, startNum)

Localiza a posição inicial de uma cadeia de texto dentro de outra cadeia de texto. FINDB é sensível a maiúsculas e minúsculas. Utilize com conjuntos de carateres de byte duplo (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>;

Parâmetros

findText

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

É o texto que pretende localizar.

withinText

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

É o texto que contém o texto que pretende localizar.

startNum

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

Especifica o caráter no qual pretende iniciar a pesquisa.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

fisher(x)

Devolve a transformação Fisher.

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

Parâmetros

x

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

É o valor para o qual pretende a transformação, um número entre -1 e 1, excluindo -1 e 1.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

fisherInv(y)

Devolve o inverso da transformação Fisher: se y = FISHER(x), então FISHERINV(y) = x.

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

Parâmetros

y

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

É o valor para o qual pretende efetuar o inverso da transformação.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

fixed(number, decimals, noCommas)

Arredonda um número para o número especificado de decimais e devolve o resultado como texto com ou sem vírgulas.

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>;

Parâmetros

number

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

É o número que pretende arredondar e converter em texto.

decimals

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

É o número de dígitos à direita da vírgula decimal. Se omitido, Casas Decimais = 2.

noCommas

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

É um valor lógico: não apresentar vírgulas no texto devolvido = VERDADEIRO; apresentar vírgulas no texto devolvido = FALSO ou omitido.

Retornos

Excel.FunctionResult<string>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

floor_Math(number, significance, mode)

Arredonda um número por baixo para o número inteiro mais próximo ou para o múltiplo de significância mais próximo.

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>;

Parâmetros

number

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

É o valor que pretende arredondar.

significance

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

É o múltiplo para o qual pretende arredondar.

mode

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

Quando fornecida e não igual a zero, esta função arredondará para zero.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

floor_Precise(number, significance)

Arredonda um número por baixo para o número inteiro mais próximo ou para o múltiplo de significância mais próximo.

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

Parâmetros

number

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

É o valor numérico que pretende arredondar.

significance

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

É o múltiplo para o qual pretende arredondar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

fv(rate, nper, pmt, pv, type)

Retorna o valor futuro de um investimento de acordo com os pagamentos periódicos e constantes e com uma taxa de juros constante.

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>;

Parâmetros

rate

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

É a taxa de juro por período. Por exemplo, utilize 6%/4 para pagamentos trimestrais a 6% APR.

nper

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

É o número total de períodos de pagamento no investimento.

pmt

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

É o pagamento efetuada em cada período; não pode mudar ao longo da vida do investimento.

pv

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

É o valor atual ou o montante de montante fixo que uma série de pagamentos futuros vale agora. Se omitido, Va = 0.

type

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

É um valor que representa o tempo de pagamento: pagamento no início do período = 1; pagamento no final do período = 0 ou omitido.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

fvschedule(principal, schedule)

Retorna o valor futuro de um capital inicial após a aplicação de uma série de taxas de juros compostos.

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>;

Parâmetros

principal

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

É o valor atual.

schedule

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

É uma matriz de taxas de juro a aplicar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

gamma_Dist(x, alpha, beta, cumulative)

Retorna a distribuição gama.

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>;

Parâmetros

x

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

É o valor no qual pretende avaliar a distribuição, um número não negativo.

alpha

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

É um parâmetro para a distribuição, um número positivo.

beta

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

É um parâmetro para a distribuição, um número positivo. Se beta = 1, GAMA. DIST devolve a distribuição gama padrão.

cumulative

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

É um valor lógico: devolver a função de distribuição cumulativa = VERDADEIRO; devolver a função de densidade de probabilidade = FALSO ou omitido.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

gamma_Inv(probability, alpha, beta)

Devolve o inverso da distribuição cumulativa gama: se p = GAMA. DIST(x,...) e, em seguida, GAMA. 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>;

Parâmetros

probability

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

É a probabilidade associada à distribuição gama, um número entre 0 e 1, inclusive.

alpha

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

É um parâmetro para a distribuição, um número positivo.

beta

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

É um parâmetro para a distribuição, um número positivo. Se beta = 1, GAMA. INV devolve o inverso da distribuição gama padrão.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

gamma(x)

Devolve o valor da função Gama.

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

Parâmetros

x

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

É o valor para o qual pretende calcular Gama.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

gammaLn_Precise(x)

Devolve o logaritmo natural da função gama.

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

Parâmetros

x

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

É o valor para o qual pretende calcular GAMMALN. PRECISO, um número positivo.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

gammaLn(x)

Devolve o logaritmo natural da função gama.

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

Parâmetros

x

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

É o valor para o qual pretende calcular GAMMALN, um número positivo.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

gauss(x)

Devolve menos 0,5 do que a distribuição cumulativa normal padrão.

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

Parâmetros

x

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

É o valor para o qual pretende obter a distribuição.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

gcd(values)

Devolve o maior divisor comum.

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

Parâmetros

values

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

Lista de parâmetros, cujos elementos são de 1 a 255 valores.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

geoMean(values)

Devolve a média geométrica de uma matriz ou intervalo de dados numéricos positivos.

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

Parâmetros

values

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

Lista de parâmetros, cujos elementos são de 1 a 255 números ou nomes, matrizes ou referências que contêm números para os quais pretende obter a média.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

geStep(number, step)

Testa se um número é superior a um valor de limiar.

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>;

Parâmetros

number

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

É o valor a testar em relação ao passo .

step

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

É o valor de limiar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

harMean(values)

Devolve a média harmónica de um conjunto de dados de números positivos: o recíproco da média aritmética dos recíprocos.

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

Parâmetros

values

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

Lista de parâmetros, cujos elementos são de 1 a 255 números ou nomes, matrizes ou referências que contêm números para os quais pretende obter a média harmónica.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

hex2Bin(number, places)

Converte um número hexadecimal em binário.

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>;

Parâmetros

number

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

É o número hexadecimal que pretende converter.

places

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

É o número de carateres a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

hex2Dec(number)

Converte um número hexadecimal em decimal.

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

Parâmetros

number

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

É o número hexadecimal que pretende converter.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

hex2Oct(number, places)

Converte um número hexadecimal em octal.

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>;

Parâmetros

number

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

É o número hexadecimal que pretende converter.

places

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

É o número de carateres a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

hlookup(lookupValue, tableArray, rowIndexNum, rangeLookup)

Procura um valor na linha superior de uma tabela ou matriz de valores e devolve o valor na mesma coluna de uma linha que especificar.

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>;

Parâmetros

lookupValue

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

É o valor a ser encontrado na primeira linha da tabela e pode ser um valor, uma referência ou uma cadeia de texto.

tableArray

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

É uma tabela de texto, números ou valores lógicos nos quais os dados são pesquisados. tableArray pode ser uma referência a um intervalo ou a um nome de intervalo.

rowIndexNum

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

É o número da linha em tableArray a partir do qual o valor correspondente deve ser devolvido. A primeira linha de valores na tabela é a linha 1.

rangeLookup

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

É um valor lógico: para localizar a correspondência mais próxima na linha superior (ordenada por ordem ascendente) = VERDADEIRO ou omitido; localizar uma correspondência exata = FALSO.

Retornos

Excel.FunctionResult<number | string | boolean>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

hour(serialNumber)

Devolve a hora como um número de 0 (12:00) a 23 (23:00).

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

Parâmetros

serialNumber

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

É um número no código de data/hora utilizado pelo Microsoft Excel ou texto no formato de hora, como 16:48:00 ou 16:48:00.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

Cria um atalho ou salto que abre um documento armazenado no disco rígido, num servidor de rede ou na 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>;

Parâmetros

linkLocation

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

É o texto que dá o caminho e o nome de ficheiro ao documento a abrir, uma localização do disco rígido, um endereço UNC ou um caminho de URL.

friendlyName

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

É texto ou um número que é apresentado na célula. Se for omitida, a célula apresenta o texto linkLocation.

Retornos

Excel.FunctionResult<number | string | boolean>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

hypGeom_Dist(sampleS, numberSample, populationS, numberPop, cumulative)

Retorna a distribuição hipergeométrica.

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>;

Parâmetros

sampleS

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

É o número de êxitos no exemplo.

numberSample

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

É o tamanho da amostra.

populationS

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

É o número de sucessos na população.

numberPop

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

É o tamanho da população.

cumulative

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

É um valor lógico: para a função de distribuição cumulativa, utilize VERDADEIRO; para a função de densidade de probabilidade, utilize FALSO.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

if(logicalTest, valueIfTrue, valueIfFalse)

Verifica se uma condição é cumprida e devolve um valor se FOR VERDADEIRO e outro valor se for FALSO.

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>;

Parâmetros

logicalTest

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

É qualquer valor ou expressão que pode ser avaliado como VERDADEIRO ou FALSO.

valueIfTrue

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

É o valor devolvido se logicalTest for VERDADEIRO. Se for omitido, é devolvido VERDADEIRO. Pode aninhar até sete funções SE.

valueIfFalse

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

É o valor devolvido se logicalTest for FALSE. Se for omitido, é devolvido FALSO.

Retornos

Excel.FunctionResult<number | string | boolean>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

imAbs(inumber)

Devolve o valor absoluto (modulus) de um número complexo.

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

Parâmetros

inumber

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

É um número complexo para o qual pretende obter o valor absoluto.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

imaginary(inumber)

Devolve o coeficiente imaginário de um número complexo.

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

Parâmetros

inumber

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

É um número complexo para o qual pretende obter o coeficiente imaginário.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

imArgument(inumber)

Devolve o argumento q, um ângulo expresso em radianos.

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

Parâmetros

inumber

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

É um número complexo para o qual pretende obter o argumento.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

imConjugate(inumber)

Devolve o conjugado complexo de um número complexo.

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

Parâmetros

inumber

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

É um número complexo para o qual quer o conjugado.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

imCos(inumber)

Devolve o cosseno de um número complexo.

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

Parâmetros

inumber

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

É um número complexo para o qual pretende obter o cosseno.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

imCosh(inumber)

Devolve o cosseno hiperbólico de um número complexo.

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

Parâmetros

inumber

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

É um número complexo para o qual pretende obter o cosseno hiperbólico.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

imCot(inumber)

Devolve a cotangente de um número complexo.

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

Parâmetros

inumber

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

É um número complexo para o qual pretende obter a cotangente.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

imCsc(inumber)

Devolve a cossecante de um número complexo.

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

Parâmetros

inumber

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

É um número complexo para o qual pretende obter a cossecante.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

imCsch(inumber)

Devolve a cossecante hiperbólica de um número complexo.

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

Parâmetros

inumber

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

É um número complexo para o qual pretende obter a cossecante hiperbólica.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

imDiv(inumber1, inumber2)

Devolve o quociente de dois números complexos.

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>;

Parâmetros

inumber1

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

É o numerador ou dividendo complexo.

inumber2

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

É o denominador ou divisor complexo.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

imExp(inumber)

Devolve o exponencial de um número complexo.

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

Parâmetros

inumber

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

É um número complexo para o qual pretende obter o exponencial.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

imLn(inumber)

Devolve o logaritmo natural de um número complexo.

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

Parâmetros

inumber

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

É um número complexo para o qual pretende obter o logaritmo natural.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

imLog10(inumber)

Devolve o logaritmo de base 10 de um número complexo.

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

Parâmetros

inumber

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

É um número complexo para o qual pretende obter o logaritmo comum.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

imLog2(inumber)

Devolve o logaritmo de base 2 de um número complexo.

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

Parâmetros

inumber

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

É um número complexo para o qual pretende obter o logaritmo de base 2.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

imPower(inumber, number)

Devolve um número complexo elevado a uma potência de número inteiro.

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>;

Parâmetros

inumber

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

É um número complexo que se quer elevar a um poder.

number

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

É o poder ao qual pretende aumentar o número complexo.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

imProduct(values)

Devolve o produto de 1 a 255 números complexos.

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

Parâmetros

values

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

Inúm1, Inúm2,... são de 1 a 255 números complexos para multiplicar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

imReal(inumber)

Devolve o coeficiente real de um número complexo.

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

Parâmetros

inumber

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

É um número complexo para o qual pretende obter o coeficiente real.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

imSec(inumber)

Devolve a secante de um número complexo.

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

Parâmetros

inumber

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

É um número complexo para o qual pretende obter a secante.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

imSech(inumber)

Devolve a secante hiperbólica de um número complexo.

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

Parâmetros

inumber

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

É um número complexo para o qual pretende obter a secante hiperbólica.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

imSin(inumber)

Devolve o seno de um número complexo.

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

Parâmetros

inumber

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

É um número complexo para o qual pretende obter o seno.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

imSinh(inumber)

Devolve o seno hiperbólico de um número complexo.

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

Parâmetros

inumber

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

É um número complexo para o qual pretende obter o seno hiperbólico.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

imSqrt(inumber)

Devolve a raiz quadrada de um número complexo.

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

Parâmetros

inumber

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

É um número complexo para o qual pretende obter a raiz quadrada.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

imSub(inumber1, inumber2)

Devolve a diferença de dois números complexos.

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>;

Parâmetros

inumber1

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

É o número complexo a partir do qual subtrair inúm2.

inumber2

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

É o número complexo a subtrair de inúm1.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

imSum(values)

Devolve a soma de números complexos.

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

Parâmetros

values

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

Lista de parâmetros, cujos elementos são de 1 a 255 números complexos a adicionar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

imTan(inumber)

Devolve a tangente de um número complexo.

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

Parâmetros

inumber

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

É um número complexo para o qual pretende obter a tangente.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

int(number)

Arredonda um número por baixo para o número inteiro mais próximo.

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

Parâmetros

number

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

É o número real que pretende arredondar para um número inteiro.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

intRate(settlement, maturity, investment, redemption, basis)

Retorna a taxa de juros de um título totalmente investido.

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>;

Parâmetros

settlement

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

É a data de liquidação do título, expressa como um número de data de série.

maturity

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

É a data de vencimento do título, expressa como um número de data de série.

investment

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

É o montante investido no título.

redemption

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

É o montante a receber no vencimento.

basis

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

É o tipo de base de contagem diária a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

ipmt(rate, per, nper, pv, fv, type)

Devolve o pagamento de juros de um determinado período para um investimento, com base em pagamentos periódicos constantes e numa taxa de juro constante.

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>;

Parâmetros

rate

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

É a taxa de juro por período. Por exemplo, utilize 6%/4 para pagamentos trimestrais a 6% APR.

per

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

É o período para o qual pretende encontrar os juros e tem de estar no intervalo de 1 a Nper.

nper

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

É o número total de períodos de pagamento num investimento.

pv

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

É o valor atual ou o montante de montante fixo que uma série de pagamentos futuros vale agora.

fv

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

É o valor futuro ou um saldo em dinheiro que pretende obter após o último pagamento ser feito. Se omitido, Fv = 0.

type

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

É um valor lógico que representa o tempo de pagamento: no final do período = 0 ou omitido, no início do período = 1.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

irr(values, guess)

Devolve a taxa interna de rentabilidade de uma série de fluxos monetários.

irr(values: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, guess?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

values

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

É uma matriz ou uma referência a células que contêm números para os quais pretende calcular a taxa interna de retorno.

guess

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

É um número que se estima estar próximo do resultado do IRR; 0,1 (10 por cento) se omitido.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

isErr(value)

Verifica se um valor é um erro diferente de #N/D e devolve VERDADEIRO ou FALSO.

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

Parâmetros

value

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

É o valor que pretende testar. O valor pode referir-se a uma célula, fórmula ou nome que se refere a uma célula, fórmula ou valor.

Retornos

Excel.FunctionResult<boolean>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

isError(value)

Verifica se um valor é um erro e devolve VERDADEIRO ou FALSO.

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

Parâmetros

value

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

É o valor que pretende testar. O valor pode referir-se a uma célula, fórmula ou nome que se refere a uma célula, fórmula ou valor.

Retornos

Excel.FunctionResult<boolean>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

isEven(number)

Devolve VERDADEIRO se o número for par.

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

Parâmetros

number

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

É o valor a testar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

isFormula(reference)

Verifica se uma referência é a uma célula que contém uma fórmula e devolve VERDADEIRO ou FALSO.

isFormula(reference: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<boolean>;

Parâmetros

reference

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

É uma referência à célula que pretende testar. A referência pode ser uma referência de célula, uma fórmula ou um nome que se refere a uma célula.

Retornos

Excel.FunctionResult<boolean>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

isLogical(value)

Verifica se um valor é um valor lógico (VERDADEIRO ou FALSO) e devolve VERDADEIRO ou FALSO.

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

Parâmetros

value

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

É o valor que pretende testar. O valor pode referir-se a uma célula, fórmula ou nome que se refere a uma célula, fórmula ou valor.

Retornos

Excel.FunctionResult<boolean>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

isNA(value)

Verifica se um valor é #N/D e devolve VERDADEIRO ou FALSO.

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

Parâmetros

value

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

É o valor que pretende testar. O valor pode referir-se a uma célula, fórmula ou nome que se refere a uma célula, fórmula ou valor.

Retornos

Excel.FunctionResult<boolean>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

isNonText(value)

Verifica se um valor não é texto (as células em branco não são texto) e devolve VERDADEIRO ou FALSO.

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

Parâmetros

value

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

É o valor que pretende testar: uma célula; uma fórmula; ou um nome que se refere a uma célula, fórmula ou valor.

Retornos

Excel.FunctionResult<boolean>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

isNumber(value)

Verifica se um valor é um número e devolve VERDADEIRO ou FALSO.

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

Parâmetros

value

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

É o valor que pretende testar. O valor pode referir-se a uma célula, fórmula ou nome que se refere a uma célula, fórmula ou valor.

Retornos

Excel.FunctionResult<boolean>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

iso_Ceiling(number, significance)

Arredonda um número por cima, para o número inteiro mais próximo ou para o múltiplo de significância mais próximo.

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

Parâmetros

number

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

É o valor que pretende arredondar.

significance

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

É o múltiplo opcional para o qual pretende arredondar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

isOdd(number)

Devolve VERDADEIRO se o número for ímpar.

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

Parâmetros

number

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

É o valor a testar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

isoWeekNum(date)

Devolve o número da semana ISO no ano de uma determinada data.

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

Parâmetros

date

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

É o código de data/hora utilizado pelo Microsoft Excel para cálculo de data e hora.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

ispmt(rate, per, nper, pv)

Devolve os juros pagos durante um período específico de um investimento.

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>;

Parâmetros

rate

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

Taxa de juro por período. Por exemplo, utilize 6%/4 para pagamentos trimestrais a 6% APR.

per

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

Período para o qual pretende encontrar o interesse.

nper

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

Número de períodos de pagamento num investimento.

pv

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

Montante fixo que uma série de pagamentos futuros é neste momento.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

isref(value)

Verifica se um valor é uma referência e devolve VERDADEIRO ou FALSO.

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

Parâmetros

value

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

É o valor que pretende testar. O valor pode referir-se a uma célula, fórmula ou nome que se refere a uma célula, fórmula ou valor.

Retornos

Excel.FunctionResult<boolean>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

isText(value)

Verifica se um valor é texto e devolve VERDADEIRO ou FALSO.

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

Parâmetros

value

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

É o valor que pretende testar. O valor pode referir-se a uma célula, fórmula ou nome que se refere a uma célula, fórmula ou valor.

Retornos

Excel.FunctionResult<boolean>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

kurt(values)

Retorna a curtose de um conjunto de dados.

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

Parâmetros

values

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

Lista de parâmetros, cujos elementos são de 1 a 255 números ou nomes, matrizes ou referências que contêm números para os quais pretende obter a kurtose.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

large(array, k)

Retorna o k-ésimo maior valor em um conjunto de dados. Por exemplo, o quinto maior número.

large(array: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, k: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

array

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

É a matriz ou intervalo de dados para o qual pretende determinar o maior valor k-th.

k

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

É a posição (do maior) na matriz ou intervalo de células do valor a devolver.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

lcm(values)

Devolve o múltiplo menos comum.

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

Parâmetros

values

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

Lista de parâmetros, cujos elementos são de 1 a 255 valores para os quais pretende obter o múltiplo menos comum.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

left(text, numChars)

Devolve o número especificado de carateres a partir do início de uma cadeia de texto.

left(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, numChars?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

Parâmetros

text

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

É a cadeia de texto que contém os carateres que pretende extrair.

numChars

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

Especifica quantos carateres pretende que LEFT extraia; 1 se omitido.

Retornos

Excel.FunctionResult<string>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

leftb(text, numBytes)

Devolve o número especificado de carateres a partir do início de uma cadeia de texto. Utilize com conjuntos de carateres de byte duplo (DBCS).

leftb(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, numBytes?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

Parâmetros

text

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

É a cadeia de texto que contém os carateres que pretende extrair.

numBytes

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

Especifica quantos carateres pretende que LEFT devolva.

Retornos

Excel.FunctionResult<string>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

len(text)

Devolve o número de carateres numa cadeia de texto.

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

Parâmetros

text

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

É o texto cujo comprimento pretende localizar. Os espaços contam como carateres.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

lenb(text)

Devolve o número de carateres numa cadeia de texto. Utilize com conjuntos de carateres de byte duplo (DBCS).

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

Parâmetros

text

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

É o texto cujo comprimento pretende localizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

ln(number)

Retorna o logaritmo natural de um número.

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

Parâmetros

number

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

É o número real positivo para o qual pretende obter o logaritmo natural.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

log(number, base)

Retorna o logaritmo de um número para a base especificada.

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

Parâmetros

number

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

É o número real positivo para o qual pretende obter o logaritmo.

base

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

É a base do logaritmo; 10, se omitido.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

log10(number)

Retorna o logaritmo de base 10 de um número.

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

Parâmetros

number

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

É o número real positivo para o qual pretende obter o logaritmo de base 10.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

logNorm_Dist(x, mean, standardDev, cumulative)

Devolve a distribuição normal log de x, em que ln(x) é normalmente distribuída com os parâmetros Média e 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>;

Parâmetros

x

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

É o valor no qual se avalia a função, um número positivo.

mean

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

É a média de ln(x).

standardDev

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

É o desvio padrão de ln(x), um número positivo.

cumulative

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

É um valor lógico: para a função de distribuição cumulativa, utilize VERDADEIRO; para a função de densidade de probabilidade, utilize FALSO.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

logNorm_Inv(probability, mean, standardDev)

Devolve o inverso da função de distribuição cumulativa normal lognormal de x, em que ln(x) é normalmente distribuído com os parâmetros Média e 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>;

Parâmetros

probability

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

É uma probabilidade associada à distribuição normal log, um número entre 0 e 1, inclusive.

mean

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

É a média de ln(x).

standardDev

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

É o desvio padrão de ln(x), um número positivo.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

lookup(lookupValue, lookupVector, resultVector)

Procura um valor a partir de um intervalo de uma linha ou de uma coluna ou de uma matriz. Fornecido para retrocompatibilidade.

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>;

Parâmetros

lookupValue

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

É um valor que a FUNÇÃO PROC procura em lookupVector e pode ser um número, texto, um valor lógico ou um nome ou referência a um valor.

lookupVector

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

É um intervalo que contém apenas uma linha ou uma coluna de texto, números ou valores lógicos, colocados por ordem ascendente.

resultVector

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

É um intervalo que contém apenas uma linha ou coluna, o mesmo tamanho que lookupVector.

Retornos

Excel.FunctionResult<number | string | boolean>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

lower(text)

Converte todas as letras numa cadeia de texto em minúsculas.

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

Parâmetros

text

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

É o texto que pretende converter em minúsculas. Os carateres em Texto que não sejam letras não são alterados.

Retornos

Excel.FunctionResult<string>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

match(lookupValue, lookupArray, matchType)

Retorna a posição relativa de um item em uma matriz que corresponda a um valor especificado em uma ordem especificada.

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>;

Parâmetros

lookupValue

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

É o valor que utiliza para localizar o valor pretendido na matriz, um número, texto ou valor lógico ou uma referência a um destes valores.

lookupArray

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

É um intervalo contíguo de células que contém possíveis valores de pesquisa, uma matriz de valores ou uma referência a uma matriz.

matchType

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

É um número 1, 0 ou -1 que indica o valor a devolver.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

max(values)

Retorna o maior valor em um conjunto de valores. Ignora valores lógicos e texto.

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

Parâmetros

values

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

Lista de parâmetros, cujos elementos são de 1 a 255 números, células vazias, valores lógicos ou números de texto para os quais pretende obter o máximo.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

maxA(values)

Retorna o maior valor em um conjunto de valores. Não ignora valores lógicos e texto.

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

Parâmetros

values

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

Lista de parâmetros, cujos elementos são de 1 a 255 números, células vazias, valores lógicos ou números de texto para os quais pretende obter o máximo.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

mduration(settlement, maturity, coupon, yld, frequency, basis)

Devolve a duração modificada de Macauley para um título com um valor nominal assumido de 100 $.

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>;

Parâmetros

settlement

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

É a data de liquidação do título, expressa como um número de data de série.

maturity

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

É a data de vencimento do título, expressa como um número de data de série.

coupon

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

É a taxa de cupom anual do título.

yld

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

É o rendimento anual do título.

frequency

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

É o número de pagamentos cupom por ano.

basis

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

É o tipo de base de contagem diária a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

median(values)

Devolve a mediana ou o número no meio do conjunto de números especificados.

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

Parâmetros

values

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

Lista de parâmetros, cujos elementos são de 1 a 255 números ou nomes, matrizes ou referências que contêm números para os quais pretende obter a mediana.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

mid(text, startNum, numChars)

Devolve os carateres a partir do meio de uma cadeia de texto, com uma posição e comprimento iniciais.

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>;

Parâmetros

text

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

É a cadeia de texto a partir da qual pretende extrair os carateres.

startNum

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

É a posição do primeiro caráter que pretende extrair. O primeiro caráter em Texto é 1.

numChars

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

Especifica o número de carateres a devolver do Texto.

Retornos

Excel.FunctionResult<string>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

midb(text, startNum, numBytes)

Devolve carateres a partir do meio de uma cadeia de texto, dada a posição inicial e o comprimento. Utilize com conjuntos de carateres de byte duplo (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>;

Parâmetros

text

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

É a cadeia de texto que contém os carateres que pretende extrair.

startNum

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

É a posição do primeiro caráter que pretende extrair no texto.

numBytes

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

Especifica o número de carateres a devolver do texto.

Retornos

Excel.FunctionResult<string>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

min(values)

Retorna o menor número em um conjunto de valores. Ignora valores lógicos e texto.

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

Parâmetros

values

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

Lista de parâmetros, cujos elementos são de 1 a 255 números, células vazias, valores lógicos ou números de texto para os quais pretende obter o mínimo.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

minA(values)

Devolve o menor valor num conjunto de valores. Não ignora valores lógicos e texto.

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

Parâmetros

values

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

Lista de parâmetros, cujos elementos são de 1 a 255 números, células vazias, valores lógicos ou números de texto para os quais pretende obter o mínimo.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

minute(serialNumber)

Devolve o minuto, um número de 0 a 59.

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

Parâmetros

serialNumber

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

É um número no código de data/hora utilizado pelo Microsoft Excel ou texto no formato de hora, como 16:48:00 ou 16:48:00.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

mirr(values, financeRate, reinvestRate)

Devolve a taxa interna de rentabilidade de uma série de fluxos monetários periódicos, considerando tanto o custo do investimento como os juros sobre o reinvestimento de dinheiro.

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>;

Parâmetros

values

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

É uma matriz ou uma referência a células que contêm números que representam uma série de pagamentos (negativos) e rendimentos (positivos) em períodos regulares.

financeRate

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

É a taxa de juros que paga sobre o dinheiro utilizado nos fluxos monetários.

reinvestRate

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

É a taxa de juros que recebe nos fluxos monetários à medida que os reinveste.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

mod(number, divisor)

Devolve o resto depois de um número ser dividido por um divisor.

mod(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, divisor: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

number

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

É o número para o qual pretende localizar o resto após a divisão ser executada.

divisor

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

É o número pelo qual pretende dividir Número.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

month(serialNumber)

Devolve o mês, um número de 1 (janeiro) a 12 (dezembro).

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

Parâmetros

serialNumber

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

É um número no código de data/hora utilizado pelo Microsoft Excel.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

mround(number, multiple)

Retorna um número arredondado para o múltiplo desejado.

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>;

Parâmetros

number

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

É o valor a arredondar.

multiple

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

É o múltiplo para o qual pretende arredondar o número.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

multiNomial(values)

Devolve o multinomial de um conjunto de números.

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

Parâmetros

values

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

Lista de parâmetros, cujos elementos são de 1 a 255 valores para os quais pretende obter o multinomial.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

n(value)

Converte o valor não numérico num número, datas em números de série, VERDADEIRO para 1, qualquer outra coisa em 0 (zero).

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

Parâmetros

value

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

É o valor que pretende converter.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

na()

Devolve o valor de erro #N/D (valor não disponível).

na(): FunctionResult<number | string>;

Retornos

Excel.FunctionResult<number | string>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

negBinom_Dist(numberF, numberS, probabilityS, cumulative)

Devolve a distribuição binomial negativa, a probabilidade de haver Number_f falhas antes do Number_s-th-sucesso, com Probability_s probabilidade de sucesso.

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>;

Parâmetros

numberF

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

É o número de falhas.

numberS

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

É o número limiar de êxitos.

probabilityS

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

É a probabilidade de um sucesso; um número entre 0 e 1.

cumulative

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

É um valor lógico: para a função de distribuição cumulativa, utilize VERDADEIRO; para a função de densidade de probabilidade, utilize FALSO.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

networkDays_Intl(startDate, endDate, weekend, holidays)

Devolve o número de dias de trabalho inteiros entre duas datas com parâmetros de fim de semana personalizados.

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>;

Parâmetros

startDate

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

É um número de data de série que representa a data de início.

endDate

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

É um número de data de série que representa a data de fim.

weekend

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

É um número ou cadeia que especifica quando ocorrem fins de semana.

holidays

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

É um conjunto opcional de um ou mais números de data de série a excluir do calendário de trabalho, como feriados estatais e federais e feriados flutuantes.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

networkDays(startDate, endDate, holidays)

Devolve o número de dias de trabalho inteiros entre duas datas.

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>;

Parâmetros

startDate

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

É um número de data de série que representa a data de início.

endDate

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

É um número de data de série que representa a data de fim.

holidays

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

É um conjunto opcional de um ou mais números de data de série a excluir do calendário de trabalho, como feriados estatais e federais e feriados flutuantes.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

nominal(effectRate, npery)

Devolve a taxa de juro nominal anual.

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>;

Parâmetros

effectRate

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

É a taxa de juro efetiva.

npery

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

É o número de períodos compostos por ano.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

norm_Dist(x, mean, standardDev, cumulative)

Retorna a distribuição normal para a média e o desvio padrão especificados.

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>;

Parâmetros

x

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

É o valor para o qual pretende obter a distribuição.

mean

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

É a média aritmética da distribuição.

standardDev

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

É o desvio padrão da distribuição, um número positivo.

cumulative

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

É um valor lógico: para a função de distribuição cumulativa, utilize VERDADEIRO; para a função de densidade de probabilidade, utilize FALSO.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

norm_Inv(probability, mean, standardDev)

Retorna o inverso da distribuição cumulativa normal para a média especificada e o desvio padrão.

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>;

Parâmetros

probability

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

É uma probabilidade correspondente à distribuição normal, um número entre 0 e 1 inclusive.

mean

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

É a média aritmética da distribuição.

standardDev

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

É o desvio padrão da distribuição, um número positivo.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

norm_S_Dist(z, cumulative)

Devolve a distribuição normal padrão (tem uma média de zero e um desvio-padrão de um).

norm_S_Dist(z: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, cumulative: boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

z

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

É o valor para o qual pretende obter a distribuição.

cumulative

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

É um valor lógico para a função devolver: a função de distribuição cumulativa = VERDADEIRO; a função de densidade de probabilidade = FALSO.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

norm_S_Inv(probability)

Devolve o inverso da distribuição cumulativa normal padrão (tem uma média de zero e um desvio-padrão de um).

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

Parâmetros

probability

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

É uma probabilidade correspondente à distribuição normal, um número entre 0 e 1 inclusive.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

not(logical)

Altera FALSO para VERDADEIRO ou VERDADEIRO para FALSO.

not(logical: boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<boolean>;

Parâmetros

logical

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

É um valor ou expressão que pode ser avaliado como VERDADEIRO ou FALSO.

Retornos

Excel.FunctionResult<boolean>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

now()

Devolve a data e hora atuais formatadas como uma data e hora.

now(): FunctionResult<number>;

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

nper(rate, pmt, pv, fv, type)

Retorna o número de períodos de um investimento de acordo com os pagamentos periódicos e constantes e com uma taxa de juros constante.

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>;

Parâmetros

rate

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

É a taxa de juro por período. Por exemplo, utilize 6%/4 para pagamentos trimestrais a 6% APR.

pmt

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

É o pagamento efetuada em cada período; não pode mudar ao longo da vida do investimento.

pv

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

É o valor atual ou o montante de montante fixo que uma série de pagamentos futuros vale agora.

fv

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

É o valor futuro ou um saldo em dinheiro que pretende obter após o último pagamento ser feito. Se omitido, é utilizado zero.

type

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

É um valor lógico: pagamento no início do período = 1; pagamento no final do período = 0 ou omitido.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

npv(rate, values)

Devolve o valor atual líquido de um investimento com base numa taxa de desconto e numa série de pagamentos futuros (valores negativos) e rendimentos (valores positivos).

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

Parâmetros

rate

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

É a taxa de desconto ao longo de um período.

values

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

Lista de parâmetros, cujos elementos são 1 a 254 pagamentos e rendimentos, igualmente espaçados no tempo e que ocorrem no final de cada período.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

numberValue(text, decimalSeparator, groupSeparator)

Converte texto em número de forma independente da região.

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>;

Parâmetros

text

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

É a cadeia que representa o número que pretende converter.

decimalSeparator

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

É o caráter utilizado como separador decimal na cadeia.

groupSeparator

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

É o caráter utilizado como separador de grupo na cadeia.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

oct2Bin(number, places)

Converte um número octal em binário.

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>;

Parâmetros

number

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

É o número octal que pretende converter.

places

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

É o número de carateres a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

oct2Dec(number)

Converte um número octal em decimal.

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

Parâmetros

number

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

É o número octal que pretende converter.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

oct2Hex(number, places)

Converte um número octal em hexadecimal.

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>;

Parâmetros

number

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

É o número octal que pretende converter.

places

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

É o número de carateres a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

odd(number)

Arredonda um número positivo para cima e um número negativo por baixo para o número inteiro ímpar mais próximo.

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

Parâmetros

number

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

É o valor a arredondar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

oddFPrice(settlement, maturity, issue, firstCoupon, rate, yld, redemption, frequency, basis)

Devolve o preço por valor nominal de 100 $ de um título com um primeiro período indefinido.

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>;

Parâmetros

settlement

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

É a data de liquidação do título, expressa como um número de data de série.

maturity

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

É a data de vencimento do título, expressa como um número de data de série.

issue

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

É a data de emissão do título, expressa como um número de data de série.

firstCoupon

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

É a primeira data de cupom do título, expressa como um número de data de série.

rate

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

É a taxa de juro do título.

yld

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

É o rendimento anual do título.

redemption

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

É o valor de resgate do título por valor nominal de 100 $.

frequency

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

É o número de pagamentos cupom por ano.

basis

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

É o tipo de base de contagem diária a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

oddFYield(settlement, maturity, issue, firstCoupon, rate, pr, redemption, frequency, basis)

Devolve o rendimento de um título com um primeiro período ímpar.

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>;

Parâmetros

settlement

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

É a data de liquidação do título, expressa como um número de data de série.

maturity

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

É a data de vencimento do título, expressa como um número de data de série.

issue

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

É a data de emissão do título, expressa como um número de data de série.

firstCoupon

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

É a primeira data de cupom do título, expressa como um número de data de série.

rate

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

É a taxa de juro do título.

pr

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

É o preço do título.

redemption

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

É o valor de resgate do título por valor nominal de 100 $.

frequency

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

É o número de pagamentos cupom por ano.

basis

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

É o tipo de base de contagem diária a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

oddLPrice(settlement, maturity, lastInterest, rate, yld, redemption, frequency, basis)

Devolve o preço por valor nominal de 100 $ de um título com um último período indefinido.

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>;

Parâmetros

settlement

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

É a data de liquidação do título, expressa como um número de data de série.

maturity

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

É a data de vencimento do título, expressa como um número de data de série.

lastInterest

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

É a última data de cupom do título, expressa como um número de data de série.

rate

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

É a taxa de juro do título.

yld

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

É o rendimento anual do título.

redemption

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

É o valor de resgate do título por valor nominal de 100 $.

frequency

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

É o número de pagamentos cupom por ano.

basis

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

É o tipo de base de contagem diária a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

oddLYield(settlement, maturity, lastInterest, rate, pr, redemption, frequency, basis)

Devolve o rendimento de um título com um último período indefinido.

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>;

Parâmetros

settlement

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

É a data de liquidação do título, expressa como um número de data de série.

maturity

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

É a data de vencimento do título, expressa como um número de data de série.

lastInterest

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

É a última data de cupom do título, expressa como um número de data de série.

rate

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

É a taxa de juro do título.

pr

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

É o preço do título.

redemption

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

É o valor de resgate do título por valor nominal de 100 $.

frequency

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

É o número de pagamentos cupom por ano.

basis

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

É o tipo de base de contagem diária a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

or(values)

Verifica se algum dos argumentos é VERDADEIRO e devolve VERDADEIRO ou FALSO. Devolve FALSO apenas se todos os argumentos forem FALSO.

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

Parâmetros

values

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

Lista de parâmetros, cujos elementos são 1 a 255 condições que pretende testar que podem ser VERDADEIRO ou FALSO.

Retornos

Excel.FunctionResult<boolean>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

pduration(rate, pv, fv)

Devolve o número de períodos exigidos por um investimento para atingir um valor especificado.

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>;

Parâmetros

rate

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

É a taxa de juro por período.

pv

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

É o valor atual do investimento.

fv

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

É o valor futuro pretendido do investimento.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

percentile_Exc(array, k)

Retorna o k-ésimo percentil de valores em um intervalo, onde k está no intervalo 0.. 1, exclusivo.

percentile_Exc(array: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, k: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

array

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

É a matriz ou intervalo de dados que define a posição relativa.

k

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

É o valor de percentil entre 0 e 1, inclusive.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

percentile_Inc(array, k)

Devolve o percentil k-ésimo de valores num intervalo, em que k está no intervalo 0..1, inclusive.

percentile_Inc(array: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, k: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

array

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

É a matriz ou intervalo de dados que define a posição relativa.

k

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

É o valor de percentil entre 0 e 1, inclusive.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

percentRank_Exc(array, x, significance)

Retorna a posição de um valor em um conjunto de dados como uma porcentagem (0.. 1, exclusivo) do conjunto de dados.

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>;

Parâmetros

array

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

É a matriz ou intervalo de dados com valores numéricos que define a posição relativa.

x

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

É o valor para o qual pretende saber a classificação.

significance

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

É um valor opcional que identifica o número de dígitos significativos para a percentagem devolvida, três dígitos se omitido (0.xxx%).

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

percentRank_Inc(array, x, significance)

Retorna a posição de um valor em um conjunto de dados como uma porcentagem (0..1, inclusive) do conjunto de dados.

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>;

Parâmetros

array

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

É a matriz ou intervalo de dados com valores numéricos que define a posição relativa.

x

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

É o valor para o qual pretende saber a classificação.

significance

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

É um valor opcional que identifica o número de dígitos significativos para a percentagem devolvida, três dígitos se omitido (0.xxx%).

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

permut(number, numberChosen)

Devolve o número de permutações para um determinado número de objetos que podem ser selecionados a partir do total de objetos.

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

Parâmetros

number

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

É o número total de objetos.

numberChosen

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

É o número de objetos em cada permutação.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

permutationa(number, numberChosen)

Devolve o número de permutações para um determinado número de objetos (com repetições) que podem ser selecionados a partir do total de objetos.

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

Parâmetros

number

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

É o número total de objetos.

numberChosen

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

É o número de objetos em cada permutação.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

phi(x)

Devolve o valor da função de densidade para uma distribuição normal padrão.

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

Parâmetros

x

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

É o número para o qual pretende obter a densidade da distribuição normal padrão.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

pi()

Devolve o valor de Pi, 3,14159265358979, preciso para 15 dígitos.

pi(): FunctionResult<number>;

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

pmt(rate, nper, pv, fv, type)

Calcula o pagamento de um empréstimo com base em pagamentos constantes e em uma taxa de juros constante.

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>;

Parâmetros

rate

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

É a taxa de juro por período do empréstimo. Por exemplo, utilize 6%/4 para pagamentos trimestrais a 6% APR.

nper

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

É o número total de pagamentos do empréstimo.

pv

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

É o valor atual: o montante total que uma série de pagamentos futuros vale agora.

fv

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

É o valor futuro ou um saldo em dinheiro que pretende obter após o último pagamento ser efetuado, 0 (zero) se omitido.

type

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

É um valor lógico: pagamento no início do período = 1; pagamento no final do período = 0 ou omitido.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

poisson_Dist(x, mean, cumulative)

Retorna a distribuição Poisson.

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>;

Parâmetros

x

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

É o número de eventos.

mean

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

É o valor numérico esperado, um número positivo.

cumulative

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

É um valor lógico: para a probabilidade cumulativa de Poisson, utilize VERDADEIRO; para a função de densidade de probabilidade de Poisson, utilize FALSO.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

power(number, power)

Retorna o resultado de um número elevado a uma potência.

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

Parâmetros

number

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

É o número base, qualquer número real.

power

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

É o expoente, ao qual o número base é aumentado.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

ppmt(rate, per, nper, pv, fv, type)

Devolve o pagamento no capital de um determinado investimento com base em pagamentos periódicos constantes e numa taxa de juros constante.

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>;

Parâmetros

rate

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

É a taxa de juro por período. Por exemplo, utilize 6%/4 para pagamentos trimestrais a 6% APR.

per

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

Especifica o período e tem de estar no intervalo de 1 a nper.

nper

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

É o número total de períodos de pagamento num investimento.

pv

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

É o valor atual: o montante total que uma série de pagamentos futuros vale agora.

fv

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

É o valor futuro ou o saldo em numerário que pretende obter após o último pagamento ser feito.

type

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

É um valor lógico: pagamento no início do período = 1; pagamento no final do período = 0 ou omitido.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

price(settlement, maturity, rate, yld, redemption, frequency, basis)

Retorna o preço pelo valor nominal R$100 de um título que paga juros periódicos.

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>;

Parâmetros

settlement

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

É a data de liquidação do título, expressa como um número de data de série.

maturity

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

É a data de vencimento do título, expressa como um número de data de série.

rate

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

É a taxa de cupom anual do título.

yld

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

É o rendimento anual do título.

redemption

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

É o valor de resgate do título por valor nominal de 100 $.

frequency

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

É o número de pagamentos cupom por ano.

basis

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

É o tipo de base de contagem diária a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

priceDisc(settlement, maturity, discount, redemption, basis)

Retorna o preço por valor nominal de R$ 100,00 de um título descontado.

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>;

Parâmetros

settlement

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

É a data de liquidação do título, expressa como um número de data de série.

maturity

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

É a data de vencimento do título, expressa como um número de data de série.

discount

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

É a taxa de desconto do título.

redemption

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

É o valor de resgate do título por valor nominal de 100 $.

basis

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

É o tipo de base de contagem diária a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

priceMat(settlement, maturity, issue, rate, yld, basis)

Retorna o preço pelo valor nominal R$100 de um título que paga juros no vencimento.

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>;

Parâmetros

settlement

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

É a data de liquidação do título, expressa como um número de data de série.

maturity

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

É a data de vencimento do título, expressa como um número de data de série.

issue

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

É a data de emissão do título, expressa como um número de data de série.

rate

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

É a taxa de juros do título na data de emissão.

yld

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

É o rendimento anual do título.

basis

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

É o tipo de base de contagem diária a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

product(values)

Multiplica todos os números fornecidos como argumentos.

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

Parâmetros

values

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

Lista de parâmetros, cujos elementos são de 1 a 255 números, valores lógicos ou representações de números em texto que pretende multiplicar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

proper(text)

Converte uma cadeia de texto em maiúsculas/minúsculas; a primeira letra em cada palavra em maiúsculas e todas as outras letras em minúsculas.

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

Parâmetros

text

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

O texto está entre aspas, uma fórmula que devolve texto ou uma referência a uma célula que contém texto para colocar parcialmente em maiúsculas.

Retornos

Excel.FunctionResult<string>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

pv(rate, nper, pmt, fv, type)

Devolve o valor atual de um investimento: o montante total que uma série de pagamentos futuros vale agora.

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>;

Parâmetros

rate

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

É a taxa de juro por período. Por exemplo, utilize 6%/4 para pagamentos trimestrais a 6% APR.

nper

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

É o número total de períodos de pagamento num investimento.

pmt

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

O pagamento efetuou cada período e não pode mudar ao longo da vida útil do investimento.

fv

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

É o valor futuro ou um saldo em dinheiro que pretende obter após o último pagamento ser feito.

type

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

É um valor lógico: pagamento no início do período = 1; pagamento no final do período = 0 ou omitido.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

quartile_Exc(array, quart)

Devolve o quartil de um conjunto de dados, com base em valores de percentil de 0,.1, exclusivos.

quartile_Exc(array: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, quart: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

array

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

É a matriz ou intervalo de células de valores numéricos para os quais pretende obter o valor quartil.

quart

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

É um número: valor mínimo = 0; 1º quartil = 1; valor mediano = 2; 3º quartil = 3; valor máximo = 4.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

quartile_Inc(array, quart)

Devolve o quartil de um conjunto de dados, com base em valores de percentil de 0,.1, inclusive.

quartile_Inc(array: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, quart: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

array

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

É a matriz ou intervalo de células de valores numéricos para os quais pretende obter o valor quartil.

quart

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

É um número: valor mínimo = 0; 1º quartil = 1; valor mediano = 2; 3º quartil = 3; valor máximo = 4.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

quotient(numerator, denominator)

Retorna a parte inteira de uma divisão.

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>;

Parâmetros

numerator

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

É o dividendo.

denominator

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

É o divisor.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

radians(angle)

Converte graus em radianos.

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

Parâmetros

angle

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

É um ângulo em graus que pretende converter.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

rand()

Devolve um número aleatório maior ou igual a 0 e inferior a 1, distribuído uniformemente (alterações no recálculo).

rand(): FunctionResult<number>;

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

randBetween(bottom, top)

Devolve um número aleatório entre os números que especificar.

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>;

Parâmetros

bottom

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

É o menor número inteiro que RANDBETWEEN irá devolver.

top

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

É o maior número inteiro que RANDBETWEEN irá devolver.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

rank_Avg(number, ref, order)

Devolve a classificação de um número numa lista de números: o respetivo tamanho em relação a outros valores na lista; Se mais do que um valor tiver a mesma classificação, é devolvida a classificação média.

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>;

Parâmetros

number

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

É o número para o qual pretende encontrar a classificação.

ref

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

É uma matriz de, ou uma referência a, uma lista de números. Os valores não numéricos são ignorados.

order

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

É um número: classificação na lista ordenada descendente = 0 ou omitida; classificação na lista ordenada ascendente = qualquer valor diferente de zero.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

rank_Eq(number, ref, order)

Devolve a classificação de um número numa lista de números: o respetivo tamanho em relação a outros valores na lista; Se mais do que um valor tiver a mesma classificação, é devolvida a classificação superior desse conjunto de valores.

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>;

Parâmetros

number

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

É o número para o qual pretende encontrar a classificação.

ref

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

É uma matriz de, ou uma referência a, uma lista de números. Os valores não numéricos são ignorados.

order

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

É um número: classificação na lista ordenada descendente = 0 ou omitida; classificação na lista ordenada ascendente = qualquer valor diferente de zero.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

rate(nper, pmt, pv, fv, type, guess)

Devolve a taxa de juro por período de um empréstimo ou de um investimento. Por exemplo, utilize 6%/4 para pagamentos trimestrais a 6% APR.

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>;

Parâmetros

nper

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

É o número total de períodos de pagamento do empréstimo ou investimento.

pmt

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

O pagamento efetuou cada período e não pode mudar ao longo da vida útil do empréstimo ou investimento.

pv

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

É o valor atual: o montante total que uma série de pagamentos futuros vale agora.

fv

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

É o valor futuro ou um saldo em dinheiro que pretende obter após o último pagamento ser feito. Se for omitido, utiliza Fv = 0.

type

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

É um valor lógico: pagamento no início do período = 1; pagamento no final do período = 0 ou omitido.

guess

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

É o seu palpite para qual será a taxa; se omitido, Guess = 0,1 (10 por cento).

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

received(settlement, maturity, investment, discount, basis)

Retorna a quantia recebida no vencimento de um título totalmente investido.

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>;

Parâmetros

settlement

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

É a data de liquidação do título, expressa como um número de data de série.

maturity

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

É a data de vencimento do título, expressa como um número de data de série.

investment

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

É o montante investido no título.

discount

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

É a taxa de desconto do título.

basis

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

É o tipo de base de contagem diária a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

replace(oldText, startNum, numChars, newText)

Substitui parte de uma cadeia de texto por uma cadeia de texto diferente.

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>;

Parâmetros

oldText

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

É o texto no qual pretende substituir alguns carateres.

startNum

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

É a posição do caráter em oldText que pretende substituir por newText.

numChars

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

É o número de carateres em oldText que pretende substituir.

newText

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

É o texto que irá substituir carateres em oldText.

Retornos

Excel.FunctionResult<string>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

replaceB(oldText, startNum, numBytes, newText)

Substitui parte de uma cadeia de texto por uma cadeia de texto diferente. Utilize com conjuntos de carateres de byte duplo (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>;

Parâmetros

oldText

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

É o texto no qual pretende substituir alguns carateres.

startNum

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

É a posição do caráter em oldText que pretende substituir por newText.

numBytes

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

É o número de carateres em oldText que pretende substituir por newText.

newText

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

É o texto que irá substituir carateres em oldText.

Retornos

Excel.FunctionResult<string>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

rept(text, numberTimes)

Repete um texto um determinado número de vezes. Utilize REPT para preencher uma célula com um número de ocorrências de uma sequência de caracteres de texto.

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

Parâmetros

text

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

É o texto que pretende repetir.

numberTimes

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

É um número positivo que especifica o número de vezes que pretende repetir o texto.

Retornos

Excel.FunctionResult<string>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

right(text, numChars)

Devolve o número especificado de carateres a partir do fim de uma cadeia de texto.

right(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, numChars?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

Parâmetros

text

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

É a cadeia de texto que contém os carateres que pretende extrair.

numChars

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

Especifica quantos carateres pretende extrair, 1 se omitido.

Retornos

Excel.FunctionResult<string>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

rightb(text, numBytes)

Devolve o número especificado de carateres a partir do fim de uma cadeia de texto. Utilize com conjuntos de carateres de byte duplo (DBCS).

rightb(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, numBytes?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

Parâmetros

text

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É a cadeia de texto que contém os carateres que pretende extrair.

numBytes

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

Especifica quantos carateres pretende extrair.

Retornos

Excel.FunctionResult<string>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

roman(number, form)

Converte um numeral árabe em romano, como texto.

roman(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, form?: boolean | number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

Parâmetros

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o numeral árabe que pretende converter.

form

boolean | number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o número que especifica o tipo de numeral romano que pretende.

Retornos

Excel.FunctionResult<string>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

round(number, numDigits)

Arredonda um número até uma quantidade especificada de dígitos.

round(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, numDigits: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o número que pretende arredondar.

numDigits

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o número de dígitos para o qual pretende arredondar. Negativo arredonda para a esquerda da vírgula decimal; zero para o número inteiro mais próximo.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

roundDown(number, numDigits)

Arredonda um número para baixo até zero.

roundDown(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, numDigits: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É qualquer número real que pretende arredondar para baixo.

numDigits

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o número de dígitos para o qual pretende arredondar. Negativo arredonda para a esquerda da vírgula decimal; zero ou omitido, para o número inteiro mais próximo.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

roundUp(number, numDigits)

Arredonda um número para cima, longe de zero.

roundUp(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, numDigits: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É qualquer número real que pretende arredondar.

numDigits

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o número de dígitos para o qual pretende arredondar. Negativo arredonda para a esquerda da vírgula decimal; zero ou omitido, para o número inteiro mais próximo.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

rows(array)

Devolve o número de linhas numa referência ou matriz.

rows(array: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

array

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É uma matriz, uma fórmula de matriz ou uma referência a um intervalo de células para o qual pretende obter o número de linhas.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

rri(nper, pv, fv)

Devolve uma taxa de juro equivalente para o crescimento de um investimento.

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>;

Parâmetros

nper

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o número de períodos para o investimento.

pv

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o valor atual do investimento.

fv

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o valor futuro do investimento.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

sec(number)

Devolve a secante de um ângulo.

sec(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o ângulo em radianos para o qual pretende obter a secante.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

sech(number)

Devolve a secante hiperbólica de um ângulo.

sech(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o ângulo em radianos para o qual pretende obter a secante hiperbólica.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

second(serialNumber)

Devolve o segundo, um número de 0 a 59.

second(serialNumber: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

serialNumber

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É um número no código de data/hora utilizado pelo Microsoft Excel ou texto no formato de hora, como 16:48:23 ou 16:48:47.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

seriesSum(x, n, m, coefficients)

Devolve a soma de uma série de energia com base na fórmula.

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>;

Parâmetros

x

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o valor de entrada para a série de energia.

n

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É a potência inicial à qual pretende elevar x.

m

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o passo pelo qual aumentar n para cada termo da série.

coefficients

Excel.Range | string | number | boolean | Excel.RangeReference | Excel.FunctionResult<any>

É um conjunto de coeficientes através do qual cada potência sucessiva de x é multiplicada.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

sheet(value)

Devolve o número da folha da folha referenciada.

sheet(value?: Excel.Range | string | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

value

Excel.Range | string | Excel.RangeReference | Excel.FunctionResult<any>

É o nome de uma folha ou referência da qual pretende obter o número da folha. Se omitido, é devolvido o número da folha que contém a função.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

sheets(reference)

Devolve o número de folhas numa referência.

sheets(reference?: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

reference

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É uma referência para a qual pretende saber o número de folhas que contém. Se omitido, é devolvido o número de folhas no livro que contém a função.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

sign(number)

Devolve o sinal de um número: 1 se o número for positivo, zero se o número for zero ou -1 se o número for negativo.

sign(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É qualquer número real.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

sin(number)

Retorna o seno de um ângulo.

sin(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o ângulo em radianos para o qual quer o seno. Graus * PI()/180 = radianos.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

sinh(number)

Retorna o seno hiperbólico de um número.

sinh(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É qualquer número real.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

skew_p(values)

Devolve a distorção de uma distribuição com base numa população: uma caracterização do grau de assimetria de uma distribuição em torno da sua média.

skew_p(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

Parâmetros

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

Lista de parâmetros, cujos elementos são de 1 a 254 números ou nomes, matrizes ou referências que contêm números para os quais pretende obter a distorção da população.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

skew(values)

Devolve a distorção de uma distribuição: uma caracterização do grau de assimetria de uma distribuição em torno da respetiva média.

skew(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

Parâmetros

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

Lista de parâmetros, cujos elementos são de 1 a 255 números ou nomes, matrizes ou referências que contêm números para os quais pretende obter a distorção.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

sln(cost, salvage, life)

Retorna a depreciação em linha reta de um ativo durante um período.

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>;

Parâmetros

cost

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o custo inicial do recurso.

salvage

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o valor residual no final da vida útil do ativo.

life

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o número de períodos durante os quais o ativo está a ser depreciado (por vezes denominado vida útil do ativo).

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

small(array, k)

Retorna o k-ésimo menor valor do conjunto de dados. Por exemplo, o quinto número menor.

small(array: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, k: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

array

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É uma matriz ou intervalo de dados numéricos para o qual pretende determinar o valor menor de k-th.

k

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É a posição (do menor) na matriz ou intervalo do valor a devolver.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

sqrt(number)

Devolve a raiz quadrada de um número.

sqrt(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o número para o qual pretende obter a raiz quadrada.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

sqrtPi(number)

Devolve a raiz quadrada de (núm * Pi).

sqrtPi(number: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

number

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o número pelo qual p é multiplicado.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

standardize(x, mean, standardDev)

Devolve um valor normalizado de uma distribuição caracterizada por um desvio-padrão e médio.

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>;

Parâmetros

x

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o valor que pretende normalizar.

mean

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É a média aritmética da distribuição.

standardDev

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o desvio padrão da distribuição, um número positivo.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

stDev_P(values)

Calcula o desvio-padrão com base na população total fornecida como argumentos (ignora valores lógicos e texto).

stDev_P(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

Parâmetros

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

Lista de parâmetros, cujos elementos são de 1 a 255 números correspondentes a uma população e podem ser números ou referências que contêm números.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

stDev_S(values)

Calcula o desvio-padrão com base numa amostra (ignora valores lógicos e texto na amostra).

stDev_S(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

Parâmetros

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

Lista de parâmetros, cujos elementos são de 1 a 255 números correspondentes a uma amostra de uma população e podem ser números ou referências que contenham números.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

stDevA(values)

Calcula o desvio-padrão com base numa amostra, incluindo valores lógicos e texto. O texto e o valor lógico FALSO têm o valor 0; o valor lógico VERDADEIRO tem o valor 1.

stDevA(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

Parâmetros

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

Lista de parâmetros, cujos elementos são de 1 a 255 valores correspondentes a uma amostra de uma população e podem ser valores ou nomes ou referências a valores.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

stDevPA(values)

Calcula o desvio-padrão com base numa população inteira, incluindo valores lógicos e texto. O texto e o valor lógico FALSO têm o valor 0; o valor lógico VERDADEIRO tem o valor 1.

stDevPA(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

Parâmetros

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

Lista de parâmetros, cujos elementos são de 1 a 255 valores correspondentes a uma população e podem ser valores, nomes, matrizes ou referências que contêm valores.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

substitute(text, oldText, newText, instanceNum)

Substitui o texto existente por texto novo numa cadeia de texto.

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>;

Parâmetros

text

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o texto ou a referência a uma célula que contém texto no qual pretende substituir carateres.

oldText

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o texto existente que pretende substituir. Se as maiúsculas/minúsculas de texto antigo não corresponderem às maiúsculas/minúsculas do texto, a função SUBSTITUTE não substituirá o texto.

newText

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o texto pelo qual pretende substituir oldText.

instanceNum

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

Especifica a ocorrência de oldText que pretende substituir. Se omitido, todas as instâncias de oldText são substituídas.

Retornos

Excel.FunctionResult<string>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

subtotal(functionNum, values)

Devolve um subtotal numa lista ou base de dados.

subtotal(functionNum: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, ...values: Array<Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

Parâmetros

functionNum

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o número 1 a 11 que especifica a função de resumo do subtotal.

values

Array<Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

Lista de parâmetros, cujos elementos são de 1 a 254 intervalos ou referências para os quais pretende obter o subtotal.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

sum(values)

Adiciona todos os números em um intervalo de células.

sum(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

Parâmetros

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

Lista de parâmetros, cujos elementos são de 1 a 255 números a somar. Os valores lógicos e o texto são ignorados nas células, incluídos se forem escritos como argumentos.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

Exemplos

// 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)

Adiciona as células especificadas por uma determinada condição ou critérios.

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>;

Parâmetros

range

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o intervalo de células que pretende avaliar.

criteria

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É a condição ou critérios sob a forma de um número, expressão ou texto que define as células que serão adicionadas.

sumRange

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

São as células reais a somar. Se omitido, são utilizadas as células no intervalo.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

sumIfs(sumRange, values)

Adiciona as células especificadas por um determinado conjunto de condições ou critérios.

sumIfs(sumRange: Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, ...values: Array<Excel.Range | Excel.RangeReference | Excel.FunctionResult<any> | number | string | boolean>): FunctionResult<number>;

Parâmetros

sumRange

Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

São as células reais a somar.

values

Array<Excel.Range | Excel.RangeReference | Excel.FunctionResult<any> | number | string | boolean>

Lista de parâmetros, em que o primeiro elemento de cada par é o intervalo de células que pretende avaliar para a condição específica e o segundo elemento é a condição ou critérios sob a forma de um número, expressão ou texto que define as células que serão adicionadas.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

sumSq(values)

Retorna a soma dos quadrados dos argumentos. Os argumentos podem ser números, matrizes, nomes ou referências a células que contenham números.

sumSq(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

Parâmetros

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

Lista de parâmetros, cujos elementos são de 1 a 255 números, matrizes, nomes ou referências a matrizes para as quais pretende obter a soma dos quadrados.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

syd(cost, salvage, life, per)

Retorna a depreciação dos dígitos da soma dos anos de um ativo para um período especificado.

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>;

Parâmetros

cost

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o custo inicial do recurso.

salvage

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o valor residual no final da vida útil do ativo.

life

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o número de períodos durante os quais o ativo está a ser depreciado (por vezes denominado vida útil do ativo).

per

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o período e tem de utilizar as mesmas unidades que Life.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

t_Dist_2T(x, degFreedom)

Devolve a distribuição t de Student bicaudal.

t_Dist_2T(x: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, degFreedom: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

x

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o valor numérico no qual se avalia a distribuição.

degFreedom

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É um número inteiro que indica o número de graus de liberdade que caracteriza a distribuição.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

t_Dist_RT(x, degFreedom)

Devolve a distribuição t de Student de cauda direita.

t_Dist_RT(x: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, degFreedom: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

x

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o valor numérico no qual se avalia a distribuição.

degFreedom

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É um número inteiro que indica o número de graus de liberdade que caracteriza a distribuição.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

t_Dist(x, degFreedom, cumulative)

Devolve a distribuição t de Student de cauda esquerda.

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>;

Parâmetros

x

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o valor numérico no qual se avalia a distribuição.

degFreedom

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É um número inteiro que indica o número de graus de liberdade que caracteriza a distribuição.

cumulative

boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É um valor lógico: para a função de distribuição cumulativa, utilize VERDADEIRO; para a função de densidade de probabilidade, utilize FALSO.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

t_Inv_2T(probability, degFreedom)

Devolve o inverso bicaudal da distribuição t de Student.

t_Inv_2T(probability: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, degFreedom: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

probability

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É a probabilidade associada à distribuição t de Student bicaudal, um número entre 0 e 1 inclusive.

degFreedom

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É um número inteiro positivo que indica o número de graus de liberdade para caracterizar a distribuição.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

t_Inv(probability, degFreedom)

Devolve o inverso do lado esquerdo da distribuição t de Student.

t_Inv(probability: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, degFreedom: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

probability

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É a probabilidade associada à distribuição t de Student bicaudal, um número entre 0 e 1 inclusive.

degFreedom

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É um número inteiro positivo que indica o número de graus de liberdade para caracterizar a distribuição.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

t(value)

Verifica se um valor é texto e devolve o texto se for ou devolve aspas duplas (texto vazio) se não for.

t(value: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

Parâmetros

value

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o valor a testar.

Retornos

Excel.FunctionResult<string>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

tan(number)

Retorna a tangente de um ângulo.

tan(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o ângulo em radianos para o qual pretende obter a tangente. Graus * PI()/180 = radianos.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

tanh(number)

Retorna a tangente hiperbólica de um número.

tanh(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É qualquer número real.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

tbillEq(settlement, maturity, discount)

Devolve o rendimento equivalente à obrigação de uma obrigação do Tesouro.

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>;

Parâmetros

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É a data de liquidação do Título do Tesouro, expressa como um número de data em série.

maturity

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É a data de vencimento do Título do Tesouro, expressa como um número de data de série.

discount

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É a taxa de desconto do Tesouro.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

tbillPrice(settlement, maturity, discount)

Devolve o preço por valor nominal de 100 $ de uma obrigação do Tesouro.

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>;

Parâmetros

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É a data de liquidação do Título do Tesouro, expressa como um número de data em série.

maturity

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É a data de vencimento do Título do Tesouro, expressa como um número de data de série.

discount

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É a taxa de desconto do Tesouro.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

tbillYield(settlement, maturity, pr)

Devolve o rendimento de uma obrigação do Tesouro.

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>;

Parâmetros

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É a data de liquidação do Título do Tesouro, expressa como um número de data em série.

maturity

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É a data de vencimento do Título do Tesouro, expressa como um número de data de série.

pr

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o preço do Bilhete do Tesouro por valor nominal de $100.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

text(value, formatText)

Converte um valor em texto com um formato de número específico.

text(value: number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, formatText: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

Parâmetros

value

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É um número, uma fórmula que é avaliada como um valor numérico ou uma referência a uma célula que contém um valor numérico.

formatText

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É um formato numérico no formato de texto da caixa Categoria no separador Número na caixa de diálogo Formatar Células.

Retornos

Excel.FunctionResult<string>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

time(hour, minute, second)

Converte horas, minutos e segundos fornecidos como números num número de série do Excel, formatado com um formato de tempo.

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>;

Parâmetros

hour

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É um número de 0 a 23 que representa a hora.

minute

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É um número de 0 a 59 que representa o minuto.

second

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É um número de 0 a 59 que representa o segundo.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

timevalue(timeText)

Converte uma hora de texto num número de série do Excel por uma hora, um número de 0 (0:00:00) para 0,999988426 (23:59:59). Formate o número com um formato de hora depois de introduzir a fórmula.

timevalue(timeText: string | number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

timeText

string | number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É uma cadeia de texto que dá tempo a qualquer um dos formatos de hora do Microsoft Excel (as informações de data na cadeia são ignoradas).

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

today()

Devolve a data atual formatada como uma data.

today(): FunctionResult<number>;

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

toJSON()

Substitui o método JavaScript toJSON() para fornecer uma saída mais útil quando um objeto de API é transmitido para JSON.stringify(). (JSON.stringifypor sua vez, chama o toJSON método do objeto que lhe é transmitido.) Enquanto o objeto original Excel.Functions é um objeto de API, o toJSON método devolve um objeto JavaScript simples (escrito como Excel.Interfaces.FunctionsData) que contém cópias rasas de quaisquer propriedades subordinadas carregadas do objeto original.

toJSON(): {
            [key: string]: string;
        };

Retornos

{ [key: string]: string; }

trim(text)

Remove todos os espaços de uma cadeia de texto, exceto espaços únicos entre palavras.

trim(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

Parâmetros

text

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o texto a partir do qual pretende que os espaços sejam removidos.

Retornos

Excel.FunctionResult<string>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

trimMean(array, percent)

Devolve a média da parte interior de um conjunto de valores de dados.

trimMean(array: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, percent: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

array

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o intervalo ou matriz de valores a cortar e a média.

percent

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o número fracionário de pontos de dados a excluir da parte superior e inferior do conjunto de dados.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

true()

Devolve o valor lógico VERDADEIRO.

true(): FunctionResult<boolean>;

Retornos

Excel.FunctionResult<boolean>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

trunc(number, numDigits)

Trunca um número para um número inteiro ao remover a parte decimal ou fracionária do número.

trunc(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, numDigits?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o número que pretende truncar.

numDigits

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É um número que especifica a precisão da truncagem, 0 (zero) se omitido.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

type(value)

Devolve um número inteiro que representa o tipo de dados de um valor: number = 1; texto = 2; valor lógico = 4; valor de erro = 16; matriz = 64; dados compostos = 128.

type(value: boolean | string | number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

value

boolean | string | number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

Pode ser qualquer valor.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

unichar(number)

Devolve o caráter Unicode referenciado pelo valor numérico especificado.

unichar(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

Parâmetros

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o número Unicode que representa um caráter.

Retornos

Excel.FunctionResult<string>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

unicode(text)

Devolve o número (ponto de código) correspondente ao primeiro caráter do texto.

unicode(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

text

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o caráter do qual pretende obter o valor Unicode.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

upper(text)

Converte uma cadeia de texto em todas as letras maiúsculas.

upper(text: string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

Parâmetros

text

string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o texto que pretende converter em maiúsculas, uma referência ou uma cadeia de texto.

Retornos

Excel.FunctionResult<string>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

usdollar(number, decimals)

Converte um número em texto com o formato de moeda.

usdollar(number: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, decimals?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<string>;

Parâmetros

number

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É um número, uma referência a uma célula que contém um número ou uma fórmula que é avaliada como um número.

decimals

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o número de dígitos à direita da vírgula decimal.

Retornos

Excel.FunctionResult<string>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

value(text)

Converte uma cadeia de texto que representa um número num número.

value(text: string | boolean | number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

text

string | boolean | number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

O texto está entre aspas ou uma referência a uma célula que contém o texto que pretende converter.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

var_P(values)

Calcula a variância com base na população total (ignora valores lógicos e texto na população).

var_P(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

Parâmetros

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

Lista de parâmetros, cujos elementos são de 1 a 255 argumentos numéricos correspondentes a uma população.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

var_S(values)

Calcula a variância com base numa amostra (ignora os valores lógicos e o texto na amostra).

var_S(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

Parâmetros

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

Lista de parâmetros, cujos elementos são de 1 a 255 argumentos numéricos correspondentes a uma amostra de uma população.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

varA(values)

Calcula a variância com base numa amostra, incluindo valores lógicos e texto. O texto e o valor lógico FALSO têm o valor 0; o valor lógico VERDADEIRO tem o valor 1.

varA(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

Parâmetros

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

Lista de parâmetros, cujos elementos são argumentos de valor de 1 a 255 correspondentes a uma amostra de uma população.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

varPA(values)

Calcula a variância com base na população total, incluindo valores lógicos e texto. O texto e o valor lógico FALSO têm o valor 0; o valor lógico VERDADEIRO tem o valor 1.

varPA(...values: Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<number>;

Parâmetros

values

Array<number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

Lista de parâmetros, cujos elementos são argumentos de valor de 1 a 255 correspondentes a uma população.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

vdb(cost, salvage, life, startPeriod, endPeriod, factor, noSwitch)

Retorna a depreciação de um ativo para o período que você especificar, incluindo períodos parciais, usando o método balanço declinante duplo ou algum outro método especificado.

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>;

Parâmetros

cost

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o custo inicial do recurso.

salvage

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o valor residual no final da vida útil do ativo.

life

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o número de períodos durante os quais o ativo está a ser depreciado (por vezes denominado vida útil do ativo).

startPeriod

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o período inicial para o qual pretende calcular a depreciação, nas mesmas unidades que a Vida.

endPeriod

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o período de fim para o qual pretende calcular a depreciação, nas mesmas unidades que a Vida.

factor

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É a taxa a que o saldo diminui, 2 (saldo decrescente duplo) se omitido.

noSwitch

boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

Mudar para depreciação linear quando a depreciação for maior do que a amortização degressiva = FALSO ou omitida; não mudar = VERDADEIRO.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

vlookup(lookupValue, tableArray, colIndexNum, rangeLookup)

Procura um valor na coluna mais à esquerda de uma tabela e, em seguida, devolve um valor na mesma linha de uma coluna que especificar. Por predefinição, a tabela tem de ser ordenada por ordem ascendente.

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>;

Parâmetros

lookupValue

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o valor a ser encontrado na primeira coluna da tabela e pode ser um valor, uma referência ou uma cadeia de texto.

tableArray

Excel.Range | number | Excel.RangeReference | Excel.FunctionResult<any>

É uma tabela de texto, números ou valores lógicos, em que os dados são obtidos. tableArray pode ser uma referência a um intervalo ou a um nome de intervalo.

colIndexNum

Excel.Range | number | Excel.RangeReference | Excel.FunctionResult<any>

É o número da coluna em tableArray a partir do qual o valor correspondente deve ser devolvido. A primeira coluna de valores na tabela é a coluna 1.

rangeLookup

boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É um valor lógico: para localizar a correspondência mais próxima na primeira coluna (ordenada por ordem ascendente) = VERDADEIRO ou omitido; localizar uma correspondência exata = FALSO.

Retornos

Excel.FunctionResult<number | string | boolean>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

Exemplos

// 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)

Devolve um número de 1 a 7 identificando o dia da semana de uma data.

weekday(serialNumber: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>, returnType?: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

serialNumber

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É um número que representa uma data.

returnType

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É um número: para domingo=1 a sábado=7, utilize 1; para segunda-feira=1 a domingo=7, utilize 2; para segunda-feira=0 a domingo=6, utilize 3.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

weekNum(serialNumber, returnType)

Devolve o número da semana no ano.

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>;

Parâmetros

serialNumber

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o código de data/hora utilizado pelo Microsoft Excel para cálculo de data e hora.

returnType

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É um número (1 ou 2) que determina o tipo do valor devolvido.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

weibull_Dist(x, alpha, beta, cumulative)

Retorna a distribuição Weibull.

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>;

Parâmetros

x

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o valor no qual se avalia a função, um número não negativo.

alpha

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É um parâmetro para a distribuição, um número positivo.

beta

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É um parâmetro para a distribuição, um número positivo.

cumulative

boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É um valor lógico: para a função de distribuição cumulativa, utilize VERDADEIRO; para a função de densidade de probabilidade, utilize FALSO.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

workDay_Intl(startDate, days, weekend, holidays)

Retorna o número de série da data, antes ou depois de um número especificado de dias úteis, com parâmetros personalizados de final de semana.

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>;

Parâmetros

startDate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É um número de data de série que representa a data de início.

days

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o número de dias sem semana e sem feriados antes ou depois de startDate.

weekend

number | string | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É um número ou cadeia que especifica quando ocorrem fins de semana.

holidays

number | string | Excel.Range | boolean | Excel.RangeReference | Excel.FunctionResult<any>

É uma matriz opcional de um ou mais números de data de série a excluir do calendário de trabalho, como feriados estatais e federais e feriados flutuantes.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

workDay(startDate, days, holidays)

Devolve o número de série da data antes ou depois de um número especificado de dias de trabalho.

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>;

Parâmetros

startDate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É um número de data de série que representa a data de início.

days

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o número de dias sem semana e sem feriados antes ou depois de startDate.

holidays

number | string | Excel.Range | boolean | Excel.RangeReference | Excel.FunctionResult<any>

É uma matriz opcional de um ou mais números de data de série a excluir do calendário de trabalho, como feriados estatais e federais e feriados flutuantes.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

xirr(values, dates, guess)

Devolve a taxa interna de rentabilidade de uma agenda de fluxos monetários.

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>;

Parâmetros

values

number | string | Excel.Range | boolean | Excel.RangeReference | Excel.FunctionResult<any>

É uma série de fluxos monetários que correspondem a uma agenda de pagamentos em datas.

dates

number | string | Excel.Range | boolean | Excel.RangeReference | Excel.FunctionResult<any>

É uma agenda de datas de pagamento que corresponde aos pagamentos de fluxo de caixa.

guess

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É um número que acha que está próximo do resultado de XTIR.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

xnpv(rate, values, dates)

Devolve o valor atual líquido de uma agenda de fluxos monetários.

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>;

Parâmetros

rate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É a taxa de desconto a aplicar aos fluxos monetários.

values

number | string | Excel.Range | boolean | Excel.RangeReference | Excel.FunctionResult<any>

É uma série de fluxos monetários que correspondem a uma agenda de pagamentos em datas.

dates

number | string | Excel.Range | boolean | Excel.RangeReference | Excel.FunctionResult<any>

É uma agenda de datas de pagamento que corresponde aos pagamentos de fluxo de caixa.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

xor(values)

Devolve um "Exclusivo Ou" lógico de todos os argumentos.

xor(...values: Array<boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>): FunctionResult<boolean>;

Parâmetros

values

Array<boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>>

Lista de parâmetros, cujos elementos são 1 a 254 condições que pretende testar que podem ser VERDADEIRO ou FALSO e podem ser valores lógicos, matrizes ou referências.

Retornos

Excel.FunctionResult<boolean>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

year(serialNumber)

Devolve o ano de uma data, um número inteiro no intervalo de 1900 a 9999.

year(serialNumber: number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>): FunctionResult<number>;

Parâmetros

serialNumber

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É um número no código de data/hora utilizado pelo Microsoft Excel.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

yearFrac(startDate, endDate, basis)

Devolve a fração de ano que representa o número de dias inteiros entre start_date e 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>;

Parâmetros

startDate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É um número de data de série que representa a data de início.

endDate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É um número de data de série que representa a data de fim.

basis

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o tipo de base de contagem diária a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

yield(settlement, maturity, rate, pr, redemption, frequency, basis)

Devolve o rendimento de um título que paga juros periódicos.

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>;

Parâmetros

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É a data de liquidação do título, expressa como um número de data de série.

maturity

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É a data de vencimento do título, expressa como um número de data de série.

rate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É a taxa de cupom anual do título.

pr

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o preço do título por valor nominal de 100 $.

redemption

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o valor de resgate do título por valor nominal de 100 $.

frequency

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o número de pagamentos cupom por ano.

basis

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o tipo de base de contagem diária a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

yieldDisc(settlement, maturity, pr, redemption, basis)

Retorna o rendimento anual de um título descontado. Por exemplo, uma obrigação do Tesouro.

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>;

Parâmetros

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É a data de liquidação do título, expressa como um número de data de série.

maturity

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É a data de vencimento do título, expressa como um número de data de série.

pr

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o preço do título por valor nominal de 100 $.

redemption

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o valor de resgate do título por valor nominal de 100 $.

basis

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o tipo de base de contagem diária a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

yieldMat(settlement, maturity, issue, rate, pr, basis)

Retorna o rendimento anual de um título que paga juros no vencimento.

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>;

Parâmetros

settlement

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É a data de liquidação do título, expressa como um número de data de série.

maturity

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É a data de vencimento do título, expressa como um número de data de série.

issue

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É a data de emissão do título, expressa como um número de data de série.

rate

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É a taxa de juros do título na data de emissão.

pr

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o preço do título por valor nominal de 100 $.

basis

number | string | boolean | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o tipo de base de contagem diária a utilizar.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

z_Test(array, x, sigma)

Devolve o valor P unicaudo de um teste z.

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>;

Parâmetros

array

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É a matriz ou intervalo de dados para testar X.

x

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o valor a testar.

sigma

number | Excel.Range | Excel.RangeReference | Excel.FunctionResult<any>

É o desvio-padrão da população (conhecido). Se omitido, será usado o desvio padrão da amostra.

Retornos

Excel.FunctionResult<number>

Comentários

[ Conjunto de API: ExcelApi 1.2 ]