Invoke Excel function via the Graph API

Did you know that you can invoke the Excel function from the Graph API?

Recently, I worked on a project where I used the Graph API to write data into an Excel file. In the last step of the workflow, I needed to run the Excel function.

I started reading the Graph API documentation to find out

  • how to invoke the Excel function
  • what functions are supported
  • what are their parameters

The documentation contains only one example. Better than nothing.

It means that it's supported by the Graph API.

To invoke the Excel function, you need to send a POST request:

POST /me/drive/items/{id}/workbook/functions/{function_name}
{
  "parameter1": "value",
  ...
  "parameterN": "value"
}

The function parameters are specified in the request body.

The methods return a workbookFunctionResult object in the response body

{
  "error": "string",
.."value": "graph.Json"
}

The doc contains the link where all supported functions are listed.

Nice, but I need to know the parameters and their types for the Graph API. Where to find it?

I did some research and found out that all functions, including their parameters, are described in the Graph API metadata.

The metadata document ($metadata) is published at the service root.

GET https://graph.microsoft.com/v1.0/$metadata
GET https://graph.microsoft.com/beta/$metadata

The metadata allows you to see and understand the Microsoft Graph data model, including the entity types, complex types, and enumerations that make up the resources represented in the request and response packets.

The entity workbook has a navigation property functions of type graph.workbookFunctions.

<EntityType Name="workbook" BaseType="graph.entity">
  <NavigationProperty Name="application" Type="graph.workbookApplication" ContainsTarget="true" />
  <NavigationProperty Name="comments" Type="Collection(graph.workbookComment)" ContainsTarget="true" />
  <NavigationProperty Name="functions" Type="graph.workbookFunctions" ContainsTarget="true" />
  <NavigationProperty Name="names" Type="Collection(graph.workbookNamedItem)" ContainsTarget="true" />
  <NavigationProperty Name="operations" Type="Collection(graph.workbookOperation)" ContainsTarget="true" />
  <NavigationProperty Name="tables" Type="Collection(graph.workbookTable)" ContainsTarget="true" />
  <NavigationProperty Name="worksheets" Type="Collection(graph.workbookWorksheet)" ContainsTarget="true" />
</EntityType>

There is a lot of actions that have a bind parameter of type graph.workbookFunctions.

<Action Name="sum" IsBound="true">
  <Parameter Name="bindparameter" Type="graph.workbookFunctions" />
  <Parameter Name="values" Type="graph.Json" />
  <ReturnType Type="graph.workbookFunctionResult" />
</Action>

Bindparameter has similar semantics to the 'this' keyword in C# extensions methods.

For the case above, you can invoke the function sum at the url /workbook/functions/sum.

It would be nice to have a description of all functions and their parameters.

After quick research, I found the Office JavaScript API Reference documentation repository. The repository contains an autogenerated yml file with description of all Excel funtions, including their parameters.

Now, it should be easy to write a script to generate a list of all functions, including details. The script reads the names of all Excel functions and their parameters from the Graph API and finds the appropriate descriptions in the yml file.

The result of the script is the following list of all functions.

Excel functions

delta

Tests whether two numbers are equal.

POST /me/drive/items/{id}/workbook/functions/delta

Parameters

Parameter Type Description
number1 graph.Json Is the first number.
number2 graph.Json Is the second number.

abs

Returns the absolute value of a number, a number without its sign.

POST /me/drive/items/{id}/workbook/functions/abs

Parameters

Parameter Type Description
number graph.Json Is the real number for which you want the absolute value.

accrInt

Returns the accrued interest for a security that pays periodic interest.

POST /me/drive/items/{id}/workbook/functions/accrInt

Parameters

Parameter Type Description
issue graph.Json Is the security's issue date, expressed as a serial date number.
firstInterest graph.Json Is the security's first interest date, expressed as a serial date number.
settlement graph.Json Is the security's settlement date, expressed as a serial date number.
rate graph.Json Is the security's annual coupon rate.
par graph.Json Is the security's par value.
frequency graph.Json Is the number of coupon payments per year.
basis graph.Json Is the type of day count basis to use.
calcMethod graph.Json Is a logical value: to accrued interest from issue date = TRUE or omitted; to calculate from last coupon payment date = FALSE.

accrIntM

Returns the accrued interest for a security that pays interest at maturity.

POST /me/drive/items/{id}/workbook/functions/accrIntM

Parameters

Parameter Type Description
issue graph.Json Is the security's issue date, expressed as a serial date number.
settlement graph.Json Is the security's maturity date, expressed as a serial date number.
rate graph.Json Is the security's annual coupon rate.
par graph.Json Is the security's par value.
basis graph.Json Is the type of day count basis to use.

acos

Returns the arccosine of a number, in radians in the range 0 to Pi. The arccosine is the angle whose cosine is Number.

POST /me/drive/items/{id}/workbook/functions/acos

Parameters

Parameter Type Description
number graph.Json Is the cosine of the angle you want and must be from -1 to 1.

acosh

Returns the inverse hyperbolic cosine of a number.

POST /me/drive/items/{id}/workbook/functions/acosh

Parameters

Parameter Type Description
number graph.Json Is any real number equal to or greater than 1.

acot

Returns the arccotangent of a number, in radians in the range 0 to Pi.

POST /me/drive/items/{id}/workbook/functions/acot

Parameters

Parameter Type Description
number graph.Json Is the cotangent of the angle you want.

acoth

Returns the inverse hyperbolic cotangent of a number.

POST /me/drive/items/{id}/workbook/functions/acoth

Parameters

Parameter Type Description
number graph.Json Is the hyperbolic cotangent of the angle that you want.

amorDegrc

Returns the prorated linear depreciation of an asset for each accounting period.

POST /me/drive/items/{id}/workbook/functions/amorDegrc

Parameters

Parameter Type Description
cost graph.Json Is the cost of the asset.
datePurchased graph.Json Is the date the asset is purchased.
firstPeriod graph.Json Is the date of the end of the first period.
salvage graph.Json Is the salvage value at the end of life of the asset.
period graph.Json Is the period.
rate graph.Json Is the rate of depreciation.
basis graph.Json Year_basis : 0 for year of 360 days, 1 for actual, 3 for year of 365 days.

amorLinc

Returns the prorated linear depreciation of an asset for each accounting period.

POST /me/drive/items/{id}/workbook/functions/amorLinc

Parameters

Parameter Type Description
cost graph.Json Is the cost of the asset.
datePurchased graph.Json Is the date the asset is purchased.
firstPeriod graph.Json Is the date of the end of the first period.
salvage graph.Json Is the salvage value at the end of life of the asset.
period graph.Json Is the period.
rate graph.Json Is the rate of depreciation.
basis graph.Json Year_basis : 0 for year of 360 days, 1 for actual, 3 for year of 365 days.

and

Checks whether all arguments are TRUE, and returns TRUE if all arguments are TRUE.

POST /me/drive/items/{id}/workbook/functions/and

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 conditions you want to test that can be either TRUE or FALSE and can be logical values, arrays, or references.

arabic

Converts a Roman numeral to Arabic.

POST /me/drive/items/{id}/workbook/functions/arabic

Parameters

Parameter Type Description
text graph.Json Is the Roman numeral you want to convert.

areas

Returns the number of areas in a reference. An area is a range of contiguous cells or a single cell.

POST /me/drive/items/{id}/workbook/functions/areas

Parameters

Parameter Type Description
reference graph.Json Is a reference to a cell or range of cells and can refer to multiple areas.

asc

Changes full-width (double-byte) characters to half-width (single-byte) characters. Use with double-byte character sets (DBCS).

POST /me/drive/items/{id}/workbook/functions/asc

Parameters

Parameter Type Description
text graph.Json Is a text, or a reference to a cell containing a text.

asin

Returns the arcsine of a number in radians, in the range -Pi/2 to Pi/2.

POST /me/drive/items/{id}/workbook/functions/asin

Parameters

Parameter Type Description
number graph.Json Is the sine of the angle you want and must be from -1 to 1.

asinh

Returns the inverse hyperbolic sine of a number.

POST /me/drive/items/{id}/workbook/functions/asinh

Parameters

Parameter Type Description
number graph.Json Is any real number equal to or greater than 1.

atan

Returns the arctangent of a number in radians, in the range -Pi/2 to Pi/2.

POST /me/drive/items/{id}/workbook/functions/atan

Parameters

Parameter Type Description
number graph.Json Is the tangent of the angle you want.

atan2

Returns the arctangent of the specified x- and y- coordinates, in radians between -Pi and Pi, excluding -Pi.

POST /me/drive/items/{id}/workbook/functions/atan2

Parameters

Parameter Type Description
xNum graph.Json Is the x-coordinate of the point.
yNum graph.Json Is the y-coordinate of the point.

atanh

Returns the inverse hyperbolic tangent of a number.

POST /me/drive/items/{id}/workbook/functions/atanh

Parameters

Parameter Type Description
number graph.Json Is any real number between -1 and 1 excluding -1 and 1.

aveDev

Returns the average of the absolute deviations of data points from their mean. Arguments can be numbers or names, arrays, or references that contain numbers.

POST /me/drive/items/{id}/workbook/functions/aveDev

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 arguments for which you want the average of the absolute deviations.

average

Returns the average (arithmetic mean) of its arguments, which can be numbers or names, arrays, or references that contain numbers.

POST /me/drive/items/{id}/workbook/functions/average

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 numeric arguments for which you want the average.

averageA

Returns the average (arithmetic mean) of its arguments, evaluating text and FALSE in arguments as 0; TRUE evaluates as 1. Arguments can be numbers, names, arrays, or references.

POST /me/drive/items/{id}/workbook/functions/averageA

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 arguments for which you want the average.

averageIf

Finds average(arithmetic mean) for the cells specified by a given condition or criteria.

POST /me/drive/items/{id}/workbook/functions/averageIf

Parameters

Parameter Type Description
range graph.Json Is the range of cells you want evaluated.
criteria graph.Json Is the condition or criteria in the form of a number, expression, or text that defines which cells will be used to find the average.
averageRange graph.Json Are the actual cells to be used to find the average. If omitted, the cells in range are used.

averageIfs

Finds average(arithmetic mean) for the cells specified by a given set of conditions or criteria.

POST /me/drive/items/{id}/workbook/functions/averageIfs

Parameters

Parameter Type Description
averageRange graph.Json Are the actual cells to be used to find the average.
values graph.Json List of parameters, where the first element of each pair is the Is the range of cells you want evaluated for the particular condition , and the second element is is the condition or criteria in the form of a number, expression, or text that defines which cells will be used to find the average.

bahtText

Converts a number to text (baht).

POST /me/drive/items/{id}/workbook/functions/bahtText

Parameters

Parameter Type Description
number graph.Json Is a number that you want to convert.

base

Converts a number into a text representation with the given radix (base).

POST /me/drive/items/{id}/workbook/functions/base

Parameters

Parameter Type Description
number graph.Json Is the number that you want to convert.
radix graph.Json Is the base Radix that you want to convert the number into.
minLength graph.Json Is the minimum length of the returned string. If omitted leading zeros are not added.

besselI

Returns the modified Bessel function In(x).

POST /me/drive/items/{id}/workbook/functions/besselI

Parameters

Parameter Type Description
x graph.Json Is the value at which to evaluate the function.
n graph.Json Is the order of the Bessel function.

besselJ

Returns the Bessel function Jn(x).

POST /me/drive/items/{id}/workbook/functions/besselJ

Parameters

Parameter Type Description
x graph.Json Is the value at which to evaluate the function.
n graph.Json Is the order of the Bessel function.

besselK

Returns the modified Bessel function Kn(x).

POST /me/drive/items/{id}/workbook/functions/besselK

Parameters

Parameter Type Description
x graph.Json Is the value at which to evaluate the function.
n graph.Json Is the order of the function.

besselY

Returns the Bessel function Yn(x).

POST /me/drive/items/{id}/workbook/functions/besselY

Parameters

Parameter Type Description
x graph.Json Is the value at which to evaluate the function.
n graph.Json Is the order of the function.

beta_Dist

Returns the beta probability distribution function.

POST /me/drive/items/{id}/workbook/functions/beta_Dist

Parameters

Parameter Type Description
x graph.Json Is the value between A and B at which to evaluate the function.
alpha graph.Json Is a parameter to the distribution and must be greater than 0.
beta graph.Json Is a parameter to the distribution and must be greater than 0.
cumulative graph.Json Is a logical value: for the cumulative distribution function, use TRUE; for the probability density function, use FALSE.
A graph.Json Is an optional lower bound to the interval of x. If omitted, A = 0.
B graph.Json Is an optional upper bound to the interval of x. If omitted, B = 1.

beta_Inv

Returns the inverse of the cumulative beta probability density function (BETA.DIST).

POST /me/drive/items/{id}/workbook/functions/beta_Inv

Parameters

Parameter Type Description
probability graph.Json Is a probability associated with the beta distribution.
alpha graph.Json Is a parameter to the distribution and must be greater than 0.
beta graph.Json Is a parameter to the distribution and must be greater than 0.
A graph.Json Is an optional lower bound to the interval of x. If omitted, A = 0.
B graph.Json Is an optional upper bound to the interval of x. If omitted, B = 1.

bin2Dec

Converts a binary number to decimal.

POST /me/drive/items/{id}/workbook/functions/bin2Dec

Parameters

Parameter Type Description
number graph.Json Is the binary number you want to convert.

bin2Hex

Converts a binary number to hexadecimal.

POST /me/drive/items/{id}/workbook/functions/bin2Hex

Parameters

Parameter Type Description
number graph.Json Is the binary number you want to convert.
places graph.Json Is the number of characters to use.

bin2Oct

Converts a binary number to octal.

POST /me/drive/items/{id}/workbook/functions/bin2Oct

Parameters

Parameter Type Description
number graph.Json Is the binary number you want to convert.
places graph.Json Is the number of characters to use.

binom_Dist

Returns the individual term binomial distribution probability.

POST /me/drive/items/{id}/workbook/functions/binom_Dist

Parameters

Parameter Type Description
numberS graph.Json Is the number of successes in trials.
trials graph.Json Is the number of independent trials.
probabilityS graph.Json Is the probability of success on each trial.
cumulative graph.Json Is a logical value: for the cumulative distribution function, use TRUE; for the probability mass function, use FALSE.

binom_Dist_Range

Returns the probability of a trial result using a binomial distribution.

POST /me/drive/items/{id}/workbook/functions/binom_Dist_Range

Parameters

Parameter Type Description
trials graph.Json Is the number of independent trials.
probabilityS graph.Json Is the probability of success on each trial.
numberS graph.Json Is the number of successes in trials.
numberS2 graph.Json If provided this function returns the probability that the number of successful trials shall lie between numberS and numberS2.

binom_Inv

Returns the smallest value for which the cumulative binomial distribution is greater than or equal to a criterion value.

POST /me/drive/items/{id}/workbook/functions/binom_Inv

Parameters

Parameter Type Description
trials graph.Json Is the number of Bernoulli trials.
probabilityS graph.Json Is the probability of success on each trial, a number between 0 and 1 inclusive.
alpha graph.Json Is the criterion value, a number between 0 and 1 inclusive.

bitand

Returns a bitwise 'And' of two numbers.

POST /me/drive/items/{id}/workbook/functions/bitand

Parameters

Parameter Type Description
number1 graph.Json Is the decimal representation of the binary number you want to evaluate.
number2 graph.Json Is the decimal representation of the binary number you want to evaluate.

bitlshift

Returns a number shifted left by shift_amount bits.

POST /me/drive/items/{id}/workbook/functions/bitlshift

Parameters

Parameter Type Description
number graph.Json Is the decimal representation of the binary number you want to evaluate.
shiftAmount graph.Json Is the number of bits that you want to shift Number left by.

bitor

Returns a bitwise 'Or' of two numbers.

POST /me/drive/items/{id}/workbook/functions/bitor

Parameters

Parameter Type Description
number1 graph.Json Is the decimal representation of the binary number you want to evaluate.
number2 graph.Json Is the decimal representation of the binary number you want to evaluate.

bitrshift

Returns a number shifted right by shift_amount bits.

POST /me/drive/items/{id}/workbook/functions/bitrshift

Parameters

Parameter Type Description
number graph.Json Is the decimal representation of the binary number you want to evaluate.
shiftAmount graph.Json Is the number of bits that you want to shift Number right by.

bitxor

Returns a bitwise 'Exclusive Or' of two numbers.

POST /me/drive/items/{id}/workbook/functions/bitxor

Parameters

Parameter Type Description
number1 graph.Json Is the decimal representation of the binary number you want to evaluate.
number2 graph.Json Is the decimal representation of the binary number you want to evaluate.

ceiling_Math

Rounds a number up, to the nearest integer or to the nearest multiple of significance.

POST /me/drive/items/{id}/workbook/functions/ceiling_Math

Parameters

Parameter Type Description
number graph.Json Is the value you want to round.
significance graph.Json Is the multiple to which you want to round.
mode graph.Json When given and nonzero this function will round away from zero.

ceiling_Precise

Rounds a number up, to the nearest integer or to the nearest multiple of significance.

POST /me/drive/items/{id}/workbook/functions/ceiling_Precise

Parameters

Parameter Type Description
number graph.Json Is the value you want to round.
significance graph.Json Is the multiple to which you want to round.

char

Returns the character specified by the code number from the character set for your computer.

POST /me/drive/items/{id}/workbook/functions/char

Parameters

Parameter Type Description
number graph.Json Is a number between 1 and 255 specifying which character you want.

chiSq_Dist

Returns the left-tailed probability of the chi-squared distribution.

POST /me/drive/items/{id}/workbook/functions/chiSq_Dist

Parameters

Parameter Type Description
x graph.Json Is the value at which you want to evaluate the distribution, a nonnegative number.
degFreedom graph.Json Is the number of degrees of freedom, a number between 1 and 1010, excluding 1010.
cumulative graph.Json Is a logical value for the function to return: the cumulative distribution function = TRUE; the probability density function = FALSE.

chiSq_Dist_RT

Returns the right-tailed probability of the chi-squared distribution.

POST /me/drive/items/{id}/workbook/functions/chiSq_Dist_RT

Parameters

Parameter Type Description
x graph.Json Is the value at which you want to evaluate the distribution, a nonnegative number.
degFreedom graph.Json Is the number of degrees of freedom, a number between 1 and 1010, excluding 1010.

chiSq_Inv

Returns the inverse of the left-tailed probability of the chi-squared distribution.

POST /me/drive/items/{id}/workbook/functions/chiSq_Inv

Parameters

Parameter Type Description
probability graph.Json Is a probability associated with the chi-squared distribution, a value between 0 and 1 inclusive.
degFreedom graph.Json Is the number of degrees of freedom, a number between 1 and 1010, excluding 1010.

chiSq_Inv_RT

Returns the inverse of the right-tailed probability of the chi-squared distribution.

POST /me/drive/items/{id}/workbook/functions/chiSq_Inv_RT

Parameters

Parameter Type Description
probability graph.Json Is a probability associated with the chi-squared distribution, a value between 0 and 1 inclusive.
degFreedom graph.Json Is the number of degrees of freedom, a number between 1 and 1010, excluding 1010.

choose

Chooses a value or action to perform from a list of values, based on an index number.

POST /me/drive/items/{id}/workbook/functions/choose

Parameters

Parameter Type Description
indexNum graph.Json Specifies which value argument is selected. indexNum must be between 1 and 254, or a formula or a reference to a number between 1 and 254.
values graph.Json List of parameters, whose elements are 1 to 254 numbers, cell references, defined names, formulas, functions, or text arguments from which CHOOSE selects.

clean

Removes all nonprintable characters from text.

POST /me/drive/items/{id}/workbook/functions/clean

Parameters

Parameter Type Description
text graph.Json Is any worksheet information from which you want to remove nonprintable characters.

code

Returns a numeric code for the first character in a text string, in the character set used by your computer.

POST /me/drive/items/{id}/workbook/functions/code

Parameters

Parameter Type Description
text graph.Json Is the text for which you want the code of the first character.

columns

Returns the number of columns in an array or reference.

POST /me/drive/items/{id}/workbook/functions/columns

Parameters

Parameter Type Description
array graph.Json Is an array or array formula, or a reference to a range of cells for which you want the number of columns.

combin

Returns the number of combinations for a given number of items.

POST /me/drive/items/{id}/workbook/functions/combin

Parameters

Parameter Type Description
number graph.Json Is the total number of items.
numberChosen graph.Json Is the number of items in each combination.

combina

Returns the number of combinations with repetitions for a given number of items.

POST /me/drive/items/{id}/workbook/functions/combina

Parameters

Parameter Type Description
number graph.Json Is the total number of items.
numberChosen graph.Json Is the number of items in each combination.

complex

Converts real and imaginary coefficients into a complex number.

POST /me/drive/items/{id}/workbook/functions/complex

Parameters

Parameter Type Description
realNum graph.Json Is the real coefficient of the complex number.
iNum graph.Json Is the imaginary coefficient of the complex number.
suffix graph.Json Is the suffix for the imaginary component of the complex number.

concatenate

Joins several text strings into one text string.

POST /me/drive/items/{id}/workbook/functions/concatenate

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 text strings to be joined into a single text string and can be text strings, numbers, or single-cell references.

confidence_Norm

Returns the confidence interval for a population mean, using a normal distribution.

POST /me/drive/items/{id}/workbook/functions/confidence_Norm

Parameters

Parameter Type Description
alpha graph.Json Is the significance level used to compute the confidence level, a number greater than 0 and less than 1.
standardDev graph.Json Is the population standard deviation for the data range and is assumed to be known. standardDev must be greater than 0.
size graph.Json Is the sample size.

confidence_T

Returns the confidence interval for a population mean, using a Student's T distribution.

POST /me/drive/items/{id}/workbook/functions/confidence_T

Parameters

Parameter Type Description
alpha graph.Json Is the significance level used to compute the confidence level, a number greater than 0 and less than 1.
standardDev graph.Json Is the population standard deviation for the data range and is assumed to be known. standardDev must be greater than 0.
size graph.Json Is the sample size.

convert

Converts a number from one measurement system to another.

POST /me/drive/items/{id}/workbook/functions/convert

Parameters

Parameter Type Description
number graph.Json Is the value in from_units to convert.
fromUnit graph.Json Is the units for number.
toUnit graph.Json Is the units for the result.

cos

Returns the cosine of an angle.

POST /me/drive/items/{id}/workbook/functions/cos

Parameters

Parameter Type Description
number graph.Json Is the angle in radians for which you want the cosine.

cosh

Returns the hyperbolic cosine of a number.

POST /me/drive/items/{id}/workbook/functions/cosh

Parameters

Parameter Type Description
number graph.Json Is any real number.

cot

Returns the cotangent of an angle.

POST /me/drive/items/{id}/workbook/functions/cot

Parameters

Parameter Type Description
number graph.Json Is the angle in radians for which you want the cotangent.

coth

Returns the hyperbolic cotangent of a number.

POST /me/drive/items/{id}/workbook/functions/coth

Parameters

Parameter Type Description
number graph.Json Is the angle in radians for which you want the hyperbolic cotangent.

count

Counts the number of cells in a range that contain numbers.

POST /me/drive/items/{id}/workbook/functions/count

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 arguments that can contain or refer to a variety of different types of data, but only numbers are counted.

countA

Counts the number of cells in a range that are not empty.

POST /me/drive/items/{id}/workbook/functions/countA

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 arguments representing the values and cells you want to count. Values can be any type of information.

countBlank

Counts the number of empty cells in a specified range of cells.

POST /me/drive/items/{id}/workbook/functions/countBlank

Parameters

Parameter Type Description
range graph.Json Is the range from which you want to count the empty cells.

countIf

Counts the number of cells within a range that meet the given condition.

POST /me/drive/items/{id}/workbook/functions/countIf

Parameters

Parameter Type Description
range graph.Json Is the range of cells from which you want to count nonblank cells.
criteria graph.Json Is the condition in the form of a number, expression, or text that defines which cells will be counted.

countIfs

Counts the number of cells specified by a given set of conditions or criteria.

POST /me/drive/items/{id}/workbook/functions/countIfs

Parameters

Parameter Type Description
values graph.Json List of parameters, where the first element of each pair is the Is the range of cells you want evaluated for the particular condition , and the second element is is the condition in the form of a number, expression, or text that defines which cells will be counted.

coupDayBs

Returns the number of days from the beginning of the coupon period to the settlement date.

POST /me/drive/items/{id}/workbook/functions/coupDayBs

Parameters

Parameter Type Description
settlement graph.Json Is the security's settlement date, expressed as a serial date number.
maturity graph.Json Is the security's maturity date, expressed as a serial date number.
frequency graph.Json Is the number of coupon payments per year.
basis graph.Json Is the type of day count basis to use.

coupDays

Returns the number of days in the coupon period that contains the settlement date.

POST /me/drive/items/{id}/workbook/functions/coupDays

Parameters

Parameter Type Description
settlement graph.Json Is the security's settlement date, expressed as a serial date number.
maturity graph.Json Is the security's maturity date, expressed as a serial date number.
frequency graph.Json Is the number of coupon payments per year.
basis graph.Json Is the type of day count basis to use.

coupDaysNc

Returns the number of days from the settlement date to the next coupon date.

POST /me/drive/items/{id}/workbook/functions/coupDaysNc

Parameters

Parameter Type Description
settlement graph.Json Is the security's settlement date, expressed as a serial date number.
maturity graph.Json Is the security's maturity date, expressed as a serial date number.
frequency graph.Json Is the number of coupon payments per year.
basis graph.Json Is the type of day count basis to use.

coupNcd

Returns the next coupon date after the settlement date.

POST /me/drive/items/{id}/workbook/functions/coupNcd

Parameters

Parameter Type Description
settlement graph.Json Is the security's settlement date, expressed as a serial date number.
maturity graph.Json Is the security's maturity date, expressed as a serial date number.
frequency graph.Json Is the number of coupon payments per year.
basis graph.Json Is the type of day count basis to use.

coupNum

Returns the number of coupons payable between the settlement date and maturity date.

POST /me/drive/items/{id}/workbook/functions/coupNum

Parameters

Parameter Type Description
settlement graph.Json Is the security's settlement date, expressed as a serial date number.
maturity graph.Json Is the security's maturity date, expressed as a serial date number.
frequency graph.Json Is the number of coupon payments per year.
basis graph.Json Is the type of day count basis to use.

coupPcd

Returns the previous coupon date before the settlement date.

POST /me/drive/items/{id}/workbook/functions/coupPcd

Parameters

Parameter Type Description
settlement graph.Json Is the security's settlement date, expressed as a serial date number.
maturity graph.Json Is the security's maturity date, expressed as a serial date number.
frequency graph.Json Is the number of coupon payments per year.
basis graph.Json Is the type of day count basis to use.

csc

Returns the cosecant of an angle.

POST /me/drive/items/{id}/workbook/functions/csc

Parameters

Parameter Type Description
number graph.Json Is the angle in radians for which you want the cosecant.

csch

Returns the hyperbolic cosecant of an angle.

POST /me/drive/items/{id}/workbook/functions/csch

Parameters

Parameter Type Description
number graph.Json Is the angle in radians for which you want the hyperbolic cosecant.

cumIPmt

Returns the cumulative interest paid between two periods.

POST /me/drive/items/{id}/workbook/functions/cumIPmt

Parameters

Parameter Type Description
rate graph.Json Is the interest rate.
nper graph.Json Is the total number of payment periods.
pv graph.Json Is the present value.
startPeriod graph.Json Is the first period in the calculation.
endPeriod graph.Json Is the last period in the calculation.
type graph.Json Is the timing of the payment.

cumPrinc

Returns the cumulative principal paid on a loan between two periods.

POST /me/drive/items/{id}/workbook/functions/cumPrinc

Parameters

Parameter Type Description
rate graph.Json Is the interest rate.
nper graph.Json Is the total number of payment periods.
pv graph.Json Is the present value.
startPeriod graph.Json Is the first period in the calculation.
endPeriod graph.Json Is the last period in the calculation.
type graph.Json Is the timing of the payment.

date

Returns the number that represents the date in Microsoft Excel date-time code.

POST /me/drive/items/{id}/workbook/functions/date

Parameters

Parameter Type Description
year graph.Json Is a number from 1900 or 1904 (depending on the workbook's date system) to 9999.
month graph.Json Is a number from 1 to 12 representing the month of the year.
day graph.Json Is a number from 1 to 31 representing the day of the month.

datevalue

Converts a date in the form of text to a number that represents the date in Microsoft Excel date-time code.

POST /me/drive/items/{id}/workbook/functions/datevalue

Parameters

Parameter Type Description
dateText graph.Json Is text that represents a date in a Microsoft Excel date format, between 1/1/1900 or 1/1/1904 (depending on the workbook's date system) and 12/31/9999.

daverage

Averages the values in a column in a list or database that match conditions you specify.

POST /me/drive/items/{id}/workbook/functions/daverage

Parameters

Parameter Type Description
database graph.Json Is the range of cells that makes up the list or database. A database is a list of related data.
field graph.Json Is either the label of the column in double quotation marks or a number that represents the column's position in the list.
criteria graph.Json Is the range of cells that contains the conditions you specify. The range includes a column label and one cell below the label for a condition.

day

Returns the day of the month, a number from 1 to 31.

POST /me/drive/items/{id}/workbook/functions/day

Parameters

Parameter Type Description
serialNumber graph.Json Is a number in the date-time code used by Microsoft Excel.

days

Returns the number of days between the two dates.

POST /me/drive/items/{id}/workbook/functions/days

Parameters

Parameter Type Description
endDate graph.Json startDate and endDate are the two dates between which you want to know the number of days.
startDate graph.Json startDate and endDate are the two dates between which you want to know the number of days.

days360

Returns the number of days between two dates based on a 360-day year (twelve 30-day months).

POST /me/drive/items/{id}/workbook/functions/days360

Parameters

Parameter Type Description
startDate graph.Json startDate and endDate are the two dates between which you want to know the number of days.
endDate graph.Json startDate and endDate are the two dates between which you want to know the number of days.
method graph.Json Is a logical value specifying the calculation method: U.S. (NASD) = FALSE or omitted; European = TRUE.

db

Returns the depreciation of an asset for a specified period using the fixed-declining balance method.

POST /me/drive/items/{id}/workbook/functions/db

Parameters

Parameter Type Description
cost graph.Json Is the initial cost of the asset.
salvage graph.Json Is the salvage value at the end of the life of the asset.
life graph.Json Is the number of periods over which the asset is being depreciated (sometimes called the useful life of the asset).
period graph.Json Is the period for which you want to calculate the depreciation. Period must use the same units as Life.
month graph.Json Is the number of months in the first year. If month is omitted, it is assumed to be 12.

dbcs

Changes half-width (single-byte) characters within a character string to full-width (double-byte) characters. Use with double-byte character sets (DBCS).

POST /me/drive/items/{id}/workbook/functions/dbcs

Parameters

Parameter Type Description
text graph.Json Is a text, or a reference to a cell containing a text.

dcount

Counts the cells containing numbers in the field (column) of records in the database that match the conditions you specify.

POST /me/drive/items/{id}/workbook/functions/dcount

Parameters

Parameter Type Description
database graph.Json Is the range of cells that makes up the list or database. A database is a list of related data.
field graph.Json Is either the label of the column in double quotation marks or a number that represents the column's position in the list.
criteria graph.Json Is the range of cells that contains the conditions you specify. The range includes a column label and one cell below the label for a condition.

dcountA

Counts nonblank cells in the field (column) of records in the database that match the conditions you specify.

POST /me/drive/items/{id}/workbook/functions/dcountA

Parameters

Parameter Type Description
database graph.Json Is the range of cells that makes up the list or database. A database is a list of related data.
field graph.Json Is either the label of the column in double quotation marks or a number that represents the column's position in the list.
criteria graph.Json Is the range of cells that contains the conditions you specify. The range includes a column label and one cell below the label for a condition.

ddb

Returns the depreciation of an asset for a specified period using the double-declining balance method or some other method you specify.

POST /me/drive/items/{id}/workbook/functions/ddb

Parameters

Parameter Type Description
cost graph.Json Is the initial cost of the asset.
salvage graph.Json Is the salvage value at the end of the life of the asset.
life graph.Json Is the number of periods over which the asset is being depreciated (sometimes called the useful life of the asset).
period graph.Json Is the period for which you want to calculate the depreciation. Period must use the same units as Life.
factor graph.Json Is the rate at which the balance declines. If Factor is omitted, it is assumed to be 2 (the double-declining balance method).

dec2Bin

Converts a decimal number to binary.

POST /me/drive/items/{id}/workbook/functions/dec2Bin

Parameters

Parameter Type Description
number graph.Json Is the decimal integer you want to convert.
places graph.Json Is the number of characters to use.

dec2Hex

Converts a decimal number to hexadecimal.

POST /me/drive/items/{id}/workbook/functions/dec2Hex

Parameters

Parameter Type Description
number graph.Json Is the decimal integer you want to convert.
places graph.Json Is the number of characters to use.

dec2Oct

Converts a decimal number to octal.

POST /me/drive/items/{id}/workbook/functions/dec2Oct

Parameters

Parameter Type Description
number graph.Json Is the decimal integer you want to convert.
places graph.Json Is the number of characters to use.

decimal

Converts a text representation of a number in a given base into a decimal number.

POST /me/drive/items/{id}/workbook/functions/decimal

Parameters

Parameter Type Description
number graph.Json Is the number that you want to convert.
radix graph.Json Is the base Radix of the number you are converting.

degrees

Converts radians to degrees.

POST /me/drive/items/{id}/workbook/functions/degrees

Parameters

Parameter Type Description
angle graph.Json Is the angle in radians that you want to convert.

devSq

Returns the sum of squares of deviations of data points from their sample mean.

POST /me/drive/items/{id}/workbook/functions/devSq

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 arguments, or an array or array reference, on which you want DEVSQ to calculate.

dget

Extracts from a database a single record that matches the conditions you specify.

POST /me/drive/items/{id}/workbook/functions/dget

Parameters

Parameter Type Description
database graph.Json Is the range of cells that makes up the list or database. A database is a list of related data.
field graph.Json Is either the label of the column in double quotation marks or a number that represents the column's position in the list.
criteria graph.Json Is the range of cells that contains the conditions you specify. The range includes a column label and one cell below the label for a condition.

disc

Returns the discount rate for a security.

POST /me/drive/items/{id}/workbook/functions/disc

Parameters

Parameter Type Description
settlement graph.Json Is the security's settlement date, expressed as a serial date number.
maturity graph.Json Is the security's maturity date, expressed as a serial date number.
pr graph.Json Is the security's price per $100 face value.
redemption graph.Json Is the security's redemption value per $100 face value.
basis graph.Json Is the type of day count basis to use.

dmax

Returns the largest number in the field (column) of records in the database that match the conditions you specify.

POST /me/drive/items/{id}/workbook/functions/dmax

Parameters

Parameter Type Description
database graph.Json Is the range of cells that makes up the list or database. A database is a list of related data.
field graph.Json Is either the label of the column in double quotation marks or a number that represents the column's position in the list.
criteria graph.Json Is the range of cells that contains the conditions you specify. The range includes a column label and one cell below the label for a condition.

dmin

Returns the smallest number in the field (column) of records in the database that match the conditions you specify.

POST /me/drive/items/{id}/workbook/functions/dmin

Parameters

Parameter Type Description
database graph.Json Is the range of cells that makes up the list or database. A database is a list of related data.
field graph.Json Is either the label of the column in double quotation marks or a number that represents the column's position in the list.
criteria graph.Json Is the range of cells that contains the conditions you specify. The range includes a column label and one cell below the label for a condition.

dollar

Converts a number to text, using currency format.

POST /me/drive/items/{id}/workbook/functions/dollar

Parameters

Parameter Type Description
number graph.Json Is a number, a reference to a cell containing a number, or a formula that evaluates to a number.
decimals graph.Json Is the number of digits to the right of the decimal point. The number is rounded as necessary; if omitted, Decimals = 2.

dollarDe

Converts a dollar price, expressed as a fraction, into a dollar price, expressed as a decimal number.

POST /me/drive/items/{id}/workbook/functions/dollarDe

Parameters

Parameter Type Description
fractionalDollar graph.Json Is a number expressed as a fraction.
fraction graph.Json Is the integer to use in the denominator of the fraction.

dollarFr

Converts a dollar price, expressed as a decimal number, into a dollar price, expressed as a fraction.

POST /me/drive/items/{id}/workbook/functions/dollarFr

Parameters

Parameter Type Description
decimalDollar graph.Json Is a decimal number.
fraction graph.Json Is the integer to use in the denominator of a fraction.

dproduct

Multiplies the values in the field (column) of records in the database that match the conditions you specify.

POST /me/drive/items/{id}/workbook/functions/dproduct

Parameters

Parameter Type Description
database graph.Json Is the range of cells that makes up the list or database. A database is a list of related data.
field graph.Json Is either the label of the column in double quotation marks or a number that represents the column's position in the list.
criteria graph.Json Is the range of cells that contains the conditions you specify. The range includes a column label and one cell below the label for a condition.

dstDev

Estimates the standard deviation based on a sample from selected database entries.

POST /me/drive/items/{id}/workbook/functions/dstDev

Parameters

Parameter Type Description
database graph.Json Is the range of cells that makes up the list or database. A database is a list of related data.
field graph.Json Is either the label of the column in double quotation marks or a number that represents the column's position in the list.
criteria graph.Json Is the range of cells that contains the conditions you specify. The range includes a column label and one cell below the label for a condition.

dstDevP

Calculates the standard deviation based on the entire population of selected database entries.

POST /me/drive/items/{id}/workbook/functions/dstDevP

Parameters

Parameter Type Description
database graph.Json Is the range of cells that makes up the list or database. A database is a list of related data.
field graph.Json Is either the label of the column in double quotation marks or a number that represents the column's position in the list.
criteria graph.Json Is the range of cells that contains the conditions you specify. The range includes a column label and one cell below the label for a condition.

dsum

Adds the numbers in the field (column) of records in the database that match the conditions you specify.

POST /me/drive/items/{id}/workbook/functions/dsum

Parameters

Parameter Type Description
database graph.Json Is the range of cells that makes up the list or database. A database is a list of related data.
field graph.Json Is either the label of the column in double quotation marks or a number that represents the column's position in the list.
criteria graph.Json Is the range of cells that contains the conditions you specify. The range includes a column label and one cell below the label for a condition.

duration

Returns the annual duration of a security with periodic interest payments.

POST /me/drive/items/{id}/workbook/functions/duration

Parameters

Parameter Type Description
settlement graph.Json Is the security's settlement date, expressed as a serial date number.
maturity graph.Json Is the security's maturity date, expressed as a serial date number.
coupon graph.Json Is the security's annual coupon rate.
yld graph.Json Is the security's annual yield.
frequency graph.Json Is the number of coupon payments per year.
basis graph.Json Is the type of day count basis to use.

dvar

Estimates variance based on a sample from selected database entries.

POST /me/drive/items/{id}/workbook/functions/dvar

Parameters

Parameter Type Description
database graph.Json Is the range of cells that makes up the list or database. A database is a list of related data.
field graph.Json Is either the label of the column in double quotation marks or a number that represents the column's position in the list.
criteria graph.Json Is the range of cells that contains the conditions you specify. The range includes a column label and one cell below the label for a condition.

dvarP

Calculates variance based on the entire population of selected database entries.

POST /me/drive/items/{id}/workbook/functions/dvarP

Parameters

Parameter Type Description
database graph.Json Is the range of cells that makes up the list or database. A database is a list of related data.
field graph.Json Is either the label of the column in double quotation marks or a number that represents the column's position in the list.
criteria graph.Json Is the range of cells that contains the conditions you specify. The range includes a column label and one cell below the label for a condition.

ecma_Ceiling

Rounds a number up, to the nearest integer or to the nearest multiple of significance.

POST /me/drive/items/{id}/workbook/functions/ecma_Ceiling

Parameters

Parameter Type Description
number graph.Json Is the value you want to round.
significance graph.Json Is the multiple to which you want to round.

edate

Returns the serial number of the date that is the indicated number of months before or after the start date.

POST /me/drive/items/{id}/workbook/functions/edate

Parameters

Parameter Type Description
startDate graph.Json Is a serial date number that represents the start date.
months graph.Json Is the number of months before or after startDate.

effect

Returns the effective annual interest rate.

POST /me/drive/items/{id}/workbook/functions/effect

Parameters

Parameter Type Description
nominalRate graph.Json Is the nominal interest rate.
npery graph.Json Is the number of compounding periods per year.

eoMonth

Returns the serial number of the last day of the month before or after a specified number of months.

POST /me/drive/items/{id}/workbook/functions/eoMonth

Parameters

Parameter Type Description
startDate graph.Json Is a serial date number that represents the start date.
months graph.Json Is the number of months before or after the startDate.

erf

Returns the error function.

POST /me/drive/items/{id}/workbook/functions/erf

Parameters

Parameter Type Description
lowerLimit graph.Json Is the lower bound for integrating ERF.
upperLimit graph.Json Is the upper bound for integrating ERF.

erfC

Returns the complementary error function.

POST /me/drive/items/{id}/workbook/functions/erfC

Parameters

Parameter Type Description
x graph.Json Is the lower bound for integrating ERF.

erfC_Precise

Returns the complementary error function.

POST /me/drive/items/{id}/workbook/functions/erfC_Precise

Parameters

Parameter Type Description
X graph.Json Is the lower bound for integrating ERFC.PRECISE.

erf_Precise

Returns the error function.

POST /me/drive/items/{id}/workbook/functions/erf_Precise

Parameters

Parameter Type Description
X graph.Json Is the lower bound for integrating ERF.PRECISE.

error_Type

Returns a number matching an error value.

POST /me/drive/items/{id}/workbook/functions/error_Type

Parameters

Parameter Type Description
errorVal graph.Json Is the error value for which you want the identifying number, and can be an actual error value or a reference to a cell containing an error value.

even

Rounds a positive number up and negative number down to the nearest even integer.

POST /me/drive/items/{id}/workbook/functions/even

Parameters

Parameter Type Description
number graph.Json Is the value to round.

exact

Checks whether two text strings are exactly the same, and returns TRUE or FALSE. EXACT is case-sensitive.

POST /me/drive/items/{id}/workbook/functions/exact

Parameters

Parameter Type Description
text1 graph.Json Is the first text string.
text2 graph.Json Is the second text string.

exp

Returns e raised to the power of a given number.

POST /me/drive/items/{id}/workbook/functions/exp

Parameters

Parameter Type Description
number graph.Json Is the exponent applied to the base e. The constant e equals 2.71828182845904, the base of the natural logarithm.

expon_Dist

Returns the exponential distribution.

POST /me/drive/items/{id}/workbook/functions/expon_Dist

Parameters

Parameter Type Description
x graph.Json Is the value of the function, a nonnegative number.
lambda graph.Json Is the parameter value, a positive number.
cumulative graph.Json Is a logical value for the function to return: the cumulative distribution function = TRUE; the probability density function = FALSE.

fact

Returns the factorial of a number, equal to 123*...* Number.

POST /me/drive/items/{id}/workbook/functions/fact

Parameters

Parameter Type Description
number graph.Json Is the nonnegative number you want the factorial of.

factDouble

Returns the double factorial of a number.

POST /me/drive/items/{id}/workbook/functions/factDouble

Parameters

Parameter Type Description
number graph.Json Is the value for which to return the double factorial.

false

Returns the logical value FALSE.

POST /me/drive/items/{id}/workbook/functions/false

Parameters

Parameter Type Description

find

Returns the starting position of one text string within another text string. FIND is case-sensitive.

POST /me/drive/items/{id}/workbook/functions/find

Parameters

Parameter Type Description
findText graph.Json Is the text you want to find. Use double quotes (empty text) to match the first character in withinText; wildcard characters not allowed.
withinText graph.Json Is the text containing the text you want to find.
startNum graph.Json Specifies the character at which to start the search. The first character in withinText is character number 1. If omitted, startNum = 1.

findB

Finds the starting position of one text string within another text string. FINDB is case-sensitive. Use with double-byte character sets (DBCS).

POST /me/drive/items/{id}/workbook/functions/findB

Parameters

Parameter Type Description
findText graph.Json Is the text you want to find.
withinText graph.Json Is the text containing the text you want to find.
startNum graph.Json Specifies the character at which to start the search.

fisher

Returns the Fisher transformation.

POST /me/drive/items/{id}/workbook/functions/fisher

Parameters

Parameter Type Description
x graph.Json Is the value for which you want the transformation, a number between -1 and 1, excluding -1 and 1.

fisherInv

Returns the inverse of the Fisher transformation: if y = FISHER(x), then FISHERINV(y) = x.

POST /me/drive/items/{id}/workbook/functions/fisherInv

Parameters

Parameter Type Description
y graph.Json Is the value for which you want to perform the inverse of the transformation.

fixed

Rounds a number to the specified number of decimals and returns the result as text with or without commas.

POST /me/drive/items/{id}/workbook/functions/fixed

Parameters

Parameter Type Description
number graph.Json Is the number you want to round and convert to text.
decimals graph.Json Is the number of digits to the right of the decimal point. If omitted, Decimals = 2.
noCommas graph.Json Is a logical value: do not display commas in the returned text = TRUE; do display commas in the returned text = FALSE or omitted.

floor_Math

Rounds a number down, to the nearest integer or to the nearest multiple of significance.

POST /me/drive/items/{id}/workbook/functions/floor_Math

Parameters

Parameter Type Description
number graph.Json Is the value you want to round.
significance graph.Json Is the multiple to which you want to round.
mode graph.Json When given and nonzero this function will round towards zero.

floor_Precise

Rounds a number down, to the nearest integer or to the nearest multiple of significance.

POST /me/drive/items/{id}/workbook/functions/floor_Precise

Parameters

Parameter Type Description
number graph.Json Is the numeric value you want to round.
significance graph.Json Is the multiple to which you want to round.

fv

Returns the future value of an investment based on periodic, constant payments and a constant interest rate.

POST /me/drive/items/{id}/workbook/functions/fv

Parameters

Parameter Type Description
rate graph.Json Is the interest rate per period. For example, use 6%/4 for quarterly payments at 6% APR.
nper graph.Json Is the total number of payment periods in the investment.
pmt graph.Json Is the payment made each period; it cannot change over the life of the investment.
pv graph.Json Is the present value, or the lump-sum amount that a series of future payments is worth now. If omitted, Pv = 0.
type graph.Json Is a value representing the timing of payment: payment at the beginning of the period = 1; payment at the end of the period = 0 or omitted.

fvschedule

Returns the future value of an initial principal after applying a series of compound interest rates.

POST /me/drive/items/{id}/workbook/functions/fvschedule

Parameters

Parameter Type Description
principal graph.Json Is the present value.
schedule graph.Json Is an array of interest rates to apply.

f_Dist

Returns the (left-tailed) F probability distribution (degree of diversity) for two data sets.

POST /me/drive/items/{id}/workbook/functions/f_Dist

Parameters

Parameter Type Description
x graph.Json Is the value at which to evaluate the function, a nonnegative number.
degFreedom1 graph.Json Is the numerator degrees of freedom, a number between 1 and 1010, excluding 1010.
degFreedom2 graph.Json Is the denominator degrees of freedom, a number between 1 and 1010, excluding 1010.
cumulative graph.Json Is a logical value for the function to return: the cumulative distribution function = TRUE; the probability density function = FALSE.

f_Dist_RT

Returns the (right-tailed) F probability distribution (degree of diversity) for two data sets.

POST /me/drive/items/{id}/workbook/functions/f_Dist_RT

Parameters

Parameter Type Description
x graph.Json Is the value at which to evaluate the function, a nonnegative number.
degFreedom1 graph.Json Is the numerator degrees of freedom, a number between 1 and 1010, excluding 1010.
degFreedom2 graph.Json Is the denominator degrees of freedom, a number between 1 and 1010, excluding 1010.

f_Inv

Returns the inverse of the (left-tailed) F probability distribution: if p = F.DIST(x,...), then F.INV(p,...) = x.

POST /me/drive/items/{id}/workbook/functions/f_Inv

Parameters

Parameter Type Description
probability graph.Json Is a probability associated with the F cumulative distribution, a number between 0 and 1 inclusive.
degFreedom1 graph.Json Is the numerator degrees of freedom, a number between 1 and 1010, excluding 1010.
degFreedom2 graph.Json Is the denominator degrees of freedom, a number between 1 and 1010, excluding 1010.

f_Inv_RT

Returns the inverse of the (right-tailed) F probability distribution: if p = F.DIST.RT(x,...), then F.INV.RT(p,...) = x.

POST /me/drive/items/{id}/workbook/functions/f_Inv_RT

Parameters

Parameter Type Description
probability graph.Json Is a probability associated with the F cumulative distribution, a number between 0 and 1 inclusive.
degFreedom1 graph.Json Is the numerator degrees of freedom, a number between 1 and 1010, excluding 1010.
degFreedom2 graph.Json Is the denominator degrees of freedom, a number between 1 and 1010, excluding 1010.

gamma

Returns the Gamma function value.

POST /me/drive/items/{id}/workbook/functions/gamma

Parameters

Parameter Type Description
x graph.Json Is the value for which you want to calculate Gamma.

gammaLn

Returns the natural logarithm of the gamma function.

POST /me/drive/items/{id}/workbook/functions/gammaLn

Parameters

Parameter Type Description
x graph.Json Is the value for which you want to calculate GAMMALN, a positive number.

gammaLn_Precise

Returns the natural logarithm of the gamma function.

POST /me/drive/items/{id}/workbook/functions/gammaLn_Precise

Parameters

Parameter Type Description
x graph.Json Is the value for which you want to calculate GAMMALN.PRECISE, a positive number.

gamma_Dist

Returns the gamma distribution.

POST /me/drive/items/{id}/workbook/functions/gamma_Dist

Parameters

Parameter Type Description
x graph.Json Is the value at which you want to evaluate the distribution, a nonnegative number.
alpha graph.Json Is a parameter to the distribution, a positive number.
beta graph.Json Is a parameter to the distribution, a positive number. If beta = 1, GAMMA.DIST returns the standard gamma distribution.
cumulative graph.Json Is a logical value: return the cumulative distribution function = TRUE; return the probability mass function = FALSE or omitted.

gamma_Inv

Returns the inverse of the gamma cumulative distribution: if p = GAMMA.DIST(x,...), then GAMMA.INV(p,...) = x.

POST /me/drive/items/{id}/workbook/functions/gamma_Inv

Parameters

Parameter Type Description
probability graph.Json Is the probability associated with the gamma distribution, a number between 0 and 1, inclusive.
alpha graph.Json Is a parameter to the distribution, a positive number.
beta graph.Json Is a parameter to the distribution, a positive number. If beta = 1, GAMMA.INV returns the inverse of the standard gamma distribution.

gauss

Returns 0.5 less than the standard normal cumulative distribution.

POST /me/drive/items/{id}/workbook/functions/gauss

Parameters

Parameter Type Description
x graph.Json Is the value for which you want the distribution.

gcd

Returns the greatest common divisor.

POST /me/drive/items/{id}/workbook/functions/gcd

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 values.

geoMean

Returns the geometric mean of an array or range of positive numeric data.

POST /me/drive/items/{id}/workbook/functions/geoMean

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 numbers or names, arrays, or references that contain numbers for which you want the mean.

geStep

Tests whether a number is greater than a threshold value.

POST /me/drive/items/{id}/workbook/functions/geStep

Parameters

Parameter Type Description
number graph.Json Is the value to test against step.
step graph.Json Is the threshold value.

harMean

Returns the harmonic mean of a data set of positive numbers: the reciprocal of the arithmetic mean of reciprocals.

POST /me/drive/items/{id}/workbook/functions/harMean

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 numbers or names, arrays, or references that contain numbers for which you want the harmonic mean.

hex2Bin

Converts a Hexadecimal number to binary.

POST /me/drive/items/{id}/workbook/functions/hex2Bin

Parameters

Parameter Type Description
number graph.Json Is the hexadecimal number you want to convert.
places graph.Json Is the number of characters to use.

hex2Dec

Converts a hexadecimal number to decimal.

POST /me/drive/items/{id}/workbook/functions/hex2Dec

Parameters

Parameter Type Description
number graph.Json Is the hexadecimal number you want to convert.

hex2Oct

Converts a hexadecimal number to octal.

POST /me/drive/items/{id}/workbook/functions/hex2Oct

Parameters

Parameter Type Description
number graph.Json Is the hexadecimal number you want to convert.
places graph.Json Is the number of characters to use.

hlookup

Looks for a value in the top row of a table or array of values and returns the value in the same column from a row you specify.

POST /me/drive/items/{id}/workbook/functions/hlookup

Parameters

Parameter Type Description
lookupValue graph.Json Is the value to be found in the first row of the table and can be a value, a reference, or a text string.
tableArray graph.Json Is a table of text, numbers, or logical values in which data is looked up. tableArray can be a reference to a range or a range name.
rowIndexNum graph.Json Is the row number in tableArray from which the matching value should be returned. The first row of values in the table is row 1.
rangeLookup graph.Json Is a logical value: to find the closest match in the top row (sorted in ascending order) = TRUE or omitted; find an exact match = FALSE.

hour

Returns the hour as a number from 0 (12:00 A.M.) to 23 (11:00 P.M.).

POST /me/drive/items/{id}/workbook/functions/hour

Parameters

Parameter Type Description
serialNumber graph.Json Is a number in the date-time code used by Microsoft Excel, or text in time format, such as 16:48:00 or 4:48:00 PM.

Creates a shortcut or jump that opens a document stored on your hard drive, a network server, or on the Internet.

POST /me/drive/items/{id}/workbook/functions/hyperlink

Parameters

Parameter Type Description
linkLocation graph.Json Is the text giving the path and file name to the document to be opened, a hard drive location, UNC address, or URL path.
friendlyName graph.Json Is text or a number that is displayed in the cell. If omitted, the cell displays the linkLocation text.

hypGeom_Dist

Returns the hypergeometric distribution.

POST /me/drive/items/{id}/workbook/functions/hypGeom_Dist

Parameters

Parameter Type Description
sampleS graph.Json Is the number of successes in the sample.
numberSample graph.Json Is the size of the sample.
populationS graph.Json Is the number of successes in the population.
numberPop graph.Json Is the population size.
cumulative graph.Json Is a logical value: for the cumulative distribution function, use TRUE; for the probability density function, use FALSE.

if

Checks whether a condition is met, and returns one value if TRUE, and another value if FALSE.

POST /me/drive/items/{id}/workbook/functions/if

Parameters

Parameter Type Description
logicalTest graph.Json Is any value or expression that can be evaluated to TRUE or FALSE.
valueIfTrue graph.Json Is the value that is returned if logicalTest is TRUE. If omitted, TRUE is returned. You can nest up to seven IF functions.
valueIfFalse graph.Json Is the value that is returned if logicalTest is FALSE. If omitted, FALSE is returned.

imAbs

Returns the absolute value (modulus) of a complex number.

POST /me/drive/items/{id}/workbook/functions/imAbs

Parameters

Parameter Type Description
inumber graph.Json Is a complex number for which you want the absolute value.

imaginary

Returns the imaginary coefficient of a complex number.

POST /me/drive/items/{id}/workbook/functions/imaginary

Parameters

Parameter Type Description
inumber graph.Json Is a complex number for which you want the imaginary coefficient.

imArgument

Returns the argument q, an angle expressed in radians.

POST /me/drive/items/{id}/workbook/functions/imArgument

Parameters

Parameter Type Description
inumber graph.Json Is a complex number for which you want the argument.

imConjugate

Returns the complex conjugate of a complex number.

POST /me/drive/items/{id}/workbook/functions/imConjugate

Parameters

Parameter Type Description
inumber graph.Json Is a complex number for which you want the conjugate.

imCos

Returns the cosine of a complex number.

POST /me/drive/items/{id}/workbook/functions/imCos

Parameters

Parameter Type Description
inumber graph.Json Is a complex number for which you want the cosine.

imCosh

Returns the hyperbolic cosine of a complex number.

POST /me/drive/items/{id}/workbook/functions/imCosh

Parameters

Parameter Type Description
inumber graph.Json Is a complex number for which you want the hyperbolic cosine.

imCot

Returns the cotangent of a complex number.

POST /me/drive/items/{id}/workbook/functions/imCot

Parameters

Parameter Type Description
inumber graph.Json Is a complex number for which you want the cotangent.

imCsc

Returns the cosecant of a complex number.

POST /me/drive/items/{id}/workbook/functions/imCsc

Parameters

Parameter Type Description
inumber graph.Json Is a complex number for which you want the cosecant.

imCsch

Returns the hyperbolic cosecant of a complex number.

POST /me/drive/items/{id}/workbook/functions/imCsch

Parameters

Parameter Type Description
inumber graph.Json Is a complex number for which you want the hyperbolic cosecant.

imDiv

Returns the quotient of two complex numbers.

POST /me/drive/items/{id}/workbook/functions/imDiv

Parameters

Parameter Type Description
inumber1 graph.Json Is the complex numerator or dividend.
inumber2 graph.Json Is the complex denominator or divisor.

imExp

Returns the exponential of a complex number.

POST /me/drive/items/{id}/workbook/functions/imExp

Parameters

Parameter Type Description
inumber graph.Json Is a complex number for which you want the exponential.

imLn

Returns the natural logarithm of a complex number.

POST /me/drive/items/{id}/workbook/functions/imLn

Parameters

Parameter Type Description
inumber graph.Json Is a complex number for which you want the natural logarithm.

imLog10

Returns the base-10 logarithm of a complex number.

POST /me/drive/items/{id}/workbook/functions/imLog10

Parameters

Parameter Type Description
inumber graph.Json Is a complex number for which you want the common logarithm.

imLog2

Returns the base-2 logarithm of a complex number.

POST /me/drive/items/{id}/workbook/functions/imLog2

Parameters

Parameter Type Description
inumber graph.Json Is a complex number for which you want the base-2 logarithm.

imPower

Returns a complex number raised to an integer power.

POST /me/drive/items/{id}/workbook/functions/imPower

Parameters

Parameter Type Description
inumber graph.Json Is a complex number you want to raise to a power.
number graph.Json Is the power to which you want to raise the complex number.

imProduct

Returns the product of 1 to 255 complex numbers.

POST /me/drive/items/{id}/workbook/functions/imProduct

Parameters

Parameter Type Description
values graph.Json Inumber1, Inumber2,... are from 1 to 255 complex numbers to multiply.

imReal

Returns the real coefficient of a complex number.

POST /me/drive/items/{id}/workbook/functions/imReal

Parameters

Parameter Type Description
inumber graph.Json Is a complex number for which you want the real coefficient.

imSec

Returns the secant of a complex number.

POST /me/drive/items/{id}/workbook/functions/imSec

Parameters

Parameter Type Description
inumber graph.Json Is a complex number for which you want the secant.

imSech

Returns the hyperbolic secant of a complex number.

POST /me/drive/items/{id}/workbook/functions/imSech

Parameters

Parameter Type Description
inumber graph.Json Is a complex number for which you want the hyperbolic secant.

imSin

Returns the sine of a complex number.

POST /me/drive/items/{id}/workbook/functions/imSin

Parameters

Parameter Type Description
inumber graph.Json Is a complex number for which you want the sine.

imSinh

Returns the hyperbolic sine of a complex number.

POST /me/drive/items/{id}/workbook/functions/imSinh

Parameters

Parameter Type Description
inumber graph.Json Is a complex number for which you want the hyperbolic sine.

imSqrt

Returns the square root of a complex number.

POST /me/drive/items/{id}/workbook/functions/imSqrt

Parameters

Parameter Type Description
inumber graph.Json Is a complex number for which you want the square root.

imSub

Returns the difference of two complex numbers.

POST /me/drive/items/{id}/workbook/functions/imSub

Parameters

Parameter Type Description
inumber1 graph.Json Is the complex number from which to subtract inumber2.
inumber2 graph.Json Is the complex number to subtract from inumber1.

imSum

Returns the sum of complex numbers.

POST /me/drive/items/{id}/workbook/functions/imSum

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are from 1 to 255 complex numbers to add.

imTan

Returns the tangent of a complex number.

POST /me/drive/items/{id}/workbook/functions/imTan

Parameters

Parameter Type Description
inumber graph.Json Is a complex number for which you want the tangent.

int

Rounds a number down to the nearest integer.

POST /me/drive/items/{id}/workbook/functions/int

Parameters

Parameter Type Description
number graph.Json Is the real number you want to round down to an integer.

intRate

Returns the interest rate for a fully invested security.

POST /me/drive/items/{id}/workbook/functions/intRate

Parameters

Parameter Type Description
settlement graph.Json Is the security's settlement date, expressed as a serial date number.
maturity graph.Json Is the security's maturity date, expressed as a serial date number.
investment graph.Json Is the amount invested in the security.
redemption graph.Json Is the amount to be received at maturity.
basis graph.Json Is the type of day count basis to use.

ipmt

Returns the interest payment for a given period for an investment, based on periodic, constant payments and a constant interest rate.

POST /me/drive/items/{id}/workbook/functions/ipmt

Parameters

Parameter Type Description
rate graph.Json Is the interest rate per period. For example, use 6%/4 for quarterly payments at 6% APR.
per graph.Json Is the period for which you want to find the interest and must be in the range 1 to Nper.
nper graph.Json Is the total number of payment periods in an investment.
pv graph.Json Is the present value, or the lump-sum amount that a series of future payments is worth now.
fv graph.Json Is the future value, or a cash balance you want to attain after the last payment is made. If omitted, Fv = 0.
type graph.Json Is a logical value representing the timing of payment: at the end of the period = 0 or omitted, at the beginning of the period = 1.

irr

Returns the internal rate of return for a series of cash flows.

POST /me/drive/items/{id}/workbook/functions/irr

Parameters

Parameter Type Description
values graph.Json Is an array or a reference to cells that contain numbers for which you want to calculate the internal rate of return.
guess graph.Json Is a number that you guess is close to the result of IRR; 0.1 (10 percent) if omitted.

isErr

Checks whether a value is an error (#VALUE!, #REF!, #DIV/0!, #NUM!, #NAME?, or #NULL!) excluding #N/A, and returns TRUE or FALSE.

POST /me/drive/items/{id}/workbook/functions/isErr

Parameters

Parameter Type Description
value graph.Json Is the value you want to test. Value can refer to a cell, a formula, or a name that refers to a cell, formula, or value.

isError

Checks whether a value is an error (#N/A, #VALUE!, #REF!, #DIV/0!, #NUM!, #NAME?, or #NULL!), and returns TRUE or FALSE.

POST /me/drive/items/{id}/workbook/functions/isError

Parameters

Parameter Type Description
value graph.Json Is the value you want to test. Value can refer to a cell, a formula, or a name that refers to a cell, formula, or value.

isEven

Returns TRUE if the number is even.

POST /me/drive/items/{id}/workbook/functions/isEven

Parameters

Parameter Type Description
number graph.Json Is the value to test.

isFormula

Checks whether a reference is to a cell containing a formula, and returns TRUE or FALSE.

POST /me/drive/items/{id}/workbook/functions/isFormula

Parameters

Parameter Type Description
reference graph.Json Is a reference to the cell you want to test. Reference can be a cell reference, a formula, or name that refers to a cell.

isLogical

Checks whether a value is a logical value (TRUE or FALSE), and returns TRUE or FALSE.

POST /me/drive/items/{id}/workbook/functions/isLogical

Parameters

Parameter Type Description
value graph.Json Is the value you want to test. Value can refer to a cell, a formula, or a name that refers to a cell, formula, or value.

isNA

Checks whether a value is #N/A, and returns TRUE or FALSE.

POST /me/drive/items/{id}/workbook/functions/isNA

Parameters

Parameter Type Description
value graph.Json Is the value you want to test. Value can refer to a cell, a formula, or a name that refers to a cell, formula, or value.

isNonText

Checks whether a value is not text (blank cells are not text), and returns TRUE or FALSE.

POST /me/drive/items/{id}/workbook/functions/isNonText

Parameters

Parameter Type Description
value graph.Json Is the value you want tested: a cell; a formula; or a name referring to a cell, formula, or value.

isNumber

Checks whether a value is a number, and returns TRUE or FALSE.

POST /me/drive/items/{id}/workbook/functions/isNumber

Parameters

Parameter Type Description
value graph.Json Is the value you want to test. Value can refer to a cell, a formula, or a name that refers to a cell, formula, or value.

isOdd

Returns TRUE if the number is odd.

POST /me/drive/items/{id}/workbook/functions/isOdd

Parameters

Parameter Type Description
number graph.Json Is the value to test.

isoWeekNum

Returns the ISO week number in the year for a given date.

POST /me/drive/items/{id}/workbook/functions/isoWeekNum

Parameters

Parameter Type Description
date graph.Json Is the date-time code used by Microsoft Excel for date and time calculation.

iso_Ceiling

Rounds a number up, to the nearest integer or to the nearest multiple of significance.

POST /me/drive/items/{id}/workbook/functions/iso_Ceiling

Parameters

Parameter Type Description
number graph.Json Is the value you want to round.
significance graph.Json Is the optional multiple to which you want to round.

ispmt

Returns the interest paid during a specific period of an investment.

POST /me/drive/items/{id}/workbook/functions/ispmt

Parameters

Parameter Type Description
rate graph.Json Interest rate per period. For example, use 6%/4 for quarterly payments at 6% APR.
per graph.Json Period for which you want to find the interest.
nper graph.Json Number of payment periods in an investment.
pv graph.Json Lump sum amount that a series of future payments is right now.

isref

Checks whether a value is a reference, and returns TRUE or FALSE.

POST /me/drive/items/{id}/workbook/functions/isref

Parameters

Parameter Type Description
value graph.Json Is the value you want to test. Value can refer to a cell, a formula, or a name that refers to a cell, formula, or value.

isText

Checks whether a value is text, and returns TRUE or FALSE.

POST /me/drive/items/{id}/workbook/functions/isText

Parameters

Parameter Type Description
value graph.Json Is the value you want to test. Value can refer to a cell, a formula, or a name that refers to a cell, formula, or value.

kurt

Returns the kurtosis of a data set.

POST /me/drive/items/{id}/workbook/functions/kurt

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 numbers or names, arrays, or references that contain numbers for which you want the kurtosis.

large

Returns the k-th largest value in a data set. For example, the fifth largest number.

POST /me/drive/items/{id}/workbook/functions/large

Parameters

Parameter Type Description
array graph.Json Is the array or range of data for which you want to determine the k-th largest value.
k graph.Json Is the position (from the largest) in the array or cell range of the value to return.

lcm

Returns the least common multiple.

POST /me/drive/items/{id}/workbook/functions/lcm

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 values for which you want the least common multiple.

left

Returns the specified number of characters from the start of a text string.

POST /me/drive/items/{id}/workbook/functions/left

Parameters

Parameter Type Description
text graph.Json Is the text string containing the characters you want to extract.
numChars graph.Json Specifies how many characters you want LEFT to extract; 1 if omitted.

leftb

Returns the specified number of characters from the start of a text string. Use with double-byte character sets (DBCS).

POST /me/drive/items/{id}/workbook/functions/leftb

Parameters

Parameter Type Description
text graph.Json Is the text string containing the characters you want to extract.
numBytes graph.Json Specifies how many characters you want LEFT to return.

len

Returns the number of characters in a text string.

POST /me/drive/items/{id}/workbook/functions/len

Parameters

Parameter Type Description
text graph.Json Is the text whose length you want to find. Spaces count as characters.

lenb

Returns the number of characters in a text string. Use with double-byte character sets (DBCS).

POST /me/drive/items/{id}/workbook/functions/lenb

Parameters

Parameter Type Description
text graph.Json Is the text whose length you want to find.

ln

Returns the natural logarithm of a number.

POST /me/drive/items/{id}/workbook/functions/ln

Parameters

Parameter Type Description
number graph.Json Is the positive real number for which you want the natural logarithm.

log

Returns the logarithm of a number to the base you specify.

POST /me/drive/items/{id}/workbook/functions/log

Parameters

Parameter Type Description
number graph.Json Is the positive real number for which you want the logarithm.
base graph.Json Is the base of the logarithm; 10 if omitted.

log10

Returns the base-10 logarithm of a number.

POST /me/drive/items/{id}/workbook/functions/log10

Parameters

Parameter Type Description
number graph.Json Is the positive real number for which you want the base-10 logarithm.

logNorm_Dist

Returns the lognormal distribution of x, where ln(x) is normally distributed with parameters Mean and Standard_dev.

POST /me/drive/items/{id}/workbook/functions/logNorm_Dist

Parameters

Parameter Type Description
x graph.Json Is the value at which to evaluate the function, a positive number.
mean graph.Json Is the mean of ln(x).
standardDev graph.Json Is the standard deviation of ln(x), a positive number.
cumulative graph.Json Is a logical value: for the cumulative distribution function, use TRUE; for the probability density function, use FALSE.

logNorm_Inv

Returns the inverse of the lognormal cumulative distribution function of x, where ln(x) is normally distributed with parameters Mean and Standard_dev.

POST /me/drive/items/{id}/workbook/functions/logNorm_Inv

Parameters

Parameter Type Description
probability graph.Json Is a probability associated with the lognormal distribution, a number between 0 and 1, inclusive.
mean graph.Json Is the mean of ln(x).
standardDev graph.Json Is the standard deviation of ln(x), a positive number.

lookup

Looks up a value either from a one-row or one-column range or from an array. Provided for backward compatibility.

POST /me/drive/items/{id}/workbook/functions/lookup

Parameters

Parameter Type Description
lookupValue graph.Json Is a value that LOOKUP searches for in lookupVector and can be a number, text, a logical value, or a name or reference to a value.
lookupVector graph.Json Is a range that contains only one row or one column of text, numbers, or logical values, placed in ascending order.
resultVector graph.Json Is a range that contains only one row or column, the same size as lookupVector.

lower

Converts all letters in a text string to lowercase.

POST /me/drive/items/{id}/workbook/functions/lower

Parameters

Parameter Type Description
text graph.Json Is the text you want to convert to lowercase. Characters in Text that are not letters are not changed.

match

Returns the relative position of an item in an array that matches a specified value in a specified order.

POST /me/drive/items/{id}/workbook/functions/match

Parameters

Parameter Type Description
lookupValue graph.Json Is the value you use to find the value you want in the array, a number, text, or logical value, or a reference to one of these.
lookupArray graph.Json Is a contiguous range of cells containing possible lookup values, an array of values, or a reference to an array.
matchType graph.Json Is a number 1, 0, or -1 indicating which value to return.

max

Returns the largest value in a set of values. Ignores logical values and text.

POST /me/drive/items/{id}/workbook/functions/max

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 numbers, empty cells, logical values, or text numbers for which you want the maximum.

maxA

Returns the largest value in a set of values. Does not ignore logical values and text.

POST /me/drive/items/{id}/workbook/functions/maxA

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 numbers, empty cells, logical values, or text numbers for which you want the maximum.

mduration

Returns the Macauley modified duration for a security with an assumed par value of $100.

POST /me/drive/items/{id}/workbook/functions/mduration

Parameters

Parameter Type Description
settlement graph.Json Is the security's settlement date, expressed as a serial date number.
maturity graph.Json Is the security's maturity date, expressed as a serial date number.
coupon graph.Json Is the security's annual coupon rate.
yld graph.Json Is the security's annual yield.
frequency graph.Json Is the number of coupon payments per year.
basis graph.Json Is the type of day count basis to use.

median

Returns the median, or the number in the middle of the set of given numbers.

POST /me/drive/items/{id}/workbook/functions/median

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 numbers or names, arrays, or references that contain numbers for which you want the median.

mid

Returns the characters from the middle of a text string, given a starting position and length.

POST /me/drive/items/{id}/workbook/functions/mid

Parameters

Parameter Type Description
text graph.Json Is the text string from which you want to extract the characters.
startNum graph.Json Is the position of the first character you want to extract. The first character in Text is 1.
numChars graph.Json Specifies how many characters to return from Text.

midb

Returns characters from the middle of a text string, given a starting position and length. Use with double-byte character sets (DBCS).

POST /me/drive/items/{id}/workbook/functions/midb

Parameters

Parameter Type Description
text graph.Json Is the text string containing the characters you want to extract.
startNum graph.Json Is the position of the first character you want to extract in text.
numBytes graph.Json Specifies how many characters to return from text.

min

Returns the smallest number in a set of values. Ignores logical values and text.

POST /me/drive/items/{id}/workbook/functions/min

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 numbers, empty cells, logical values, or text numbers for which you want the minimum.

minA

Returns the smallest value in a set of values. Does not ignore logical values and text.

POST /me/drive/items/{id}/workbook/functions/minA

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 numbers, empty cells, logical values, or text numbers for which you want the minimum.

minute

Returns the minute, a number from 0 to 59.

POST /me/drive/items/{id}/workbook/functions/minute

Parameters

Parameter Type Description
serialNumber graph.Json Is a number in the date-time code used by Microsoft Excel or text in time format, such as 16:48:00 or 4:48:00 PM.

mirr

Returns the internal rate of return for a series of periodic cash flows, considering both cost of investment and interest on reinvestment of cash.

POST /me/drive/items/{id}/workbook/functions/mirr

Parameters

Parameter Type Description
values graph.Json Is an array or a reference to cells that contain numbers that represent a series of payments (negative) and income (positive) at regular periods.
financeRate graph.Json Is the interest rate you pay on the money used in the cash flows.
reinvestRate graph.Json Is the interest rate you receive on the cash flows as you reinvest them.

mod

Returns the remainder after a number is divided by a divisor.

POST /me/drive/items/{id}/workbook/functions/mod

Parameters

Parameter Type Description
number graph.Json Is the number for which you want to find the remainder after the division is performed.
divisor graph.Json Is the number by which you want to divide Number.

month

Returns the month, a number from 1 (January) to 12 (December).

POST /me/drive/items/{id}/workbook/functions/month

Parameters

Parameter Type Description
serialNumber graph.Json Is a number in the date-time code used by Microsoft Excel.

mround

Returns a number rounded to the desired multiple.

POST /me/drive/items/{id}/workbook/functions/mround

Parameters

Parameter Type Description
number graph.Json Is the value to round.
multiple graph.Json Is the multiple to which you want to round number.

multiNomial

Returns the multinomial of a set of numbers.

POST /me/drive/items/{id}/workbook/functions/multiNomial

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 values for which you want the multinomial.

n

Converts non-number value to a number, dates to serial numbers, TRUE to 1, anything else to 0 (zero).

POST /me/drive/items/{id}/workbook/functions/n

Parameters

Parameter Type Description
value graph.Json Is the value you want converted.

na

Returns the error value #N/A (value not available).

POST /me/drive/items/{id}/workbook/functions/na

Parameters

Parameter Type Description

negBinom_Dist

Returns the negative binomial distribution, the probability that there will be Number_f failures before the Number_s-th success, with Probability_s probability of a success.

POST /me/drive/items/{id}/workbook/functions/negBinom_Dist

Parameters

Parameter Type Description
numberF graph.Json Is the number of failures.
numberS graph.Json Is the threshold number of successes.
probabilityS graph.Json Is the probability of a success; a number between 0 and 1.
cumulative graph.Json Is a logical value: for the cumulative distribution function, use TRUE; for the probability mass function, use FALSE.

networkDays

Returns the number of whole workdays between two dates.

POST /me/drive/items/{id}/workbook/functions/networkDays

Parameters

Parameter Type Description
startDate graph.Json Is a serial date number that represents the start date.
endDate graph.Json Is a serial date number that represents the end date.
holidays graph.Json Is an optional set of one or more serial date numbers to exclude from the working calendar, such as state and federal holidays and floating holidays.

networkDays_Intl

Returns the number of whole workdays between two dates with custom weekend parameters.

POST /me/drive/items/{id}/workbook/functions/networkDays_Intl

Parameters

Parameter Type Description
startDate graph.Json Is a serial date number that represents the start date.
endDate graph.Json Is a serial date number that represents the end date.
weekend graph.Json Is a number or string specifying when weekends occur.
holidays graph.Json Is an optional set of one or more serial date numbers to exclude from the working calendar, such as state and federal holidays and floating holidays.

nominal

Returns the annual nominal interest rate.

POST /me/drive/items/{id}/workbook/functions/nominal

Parameters

Parameter Type Description
effectRate graph.Json Is the effective interest rate.
npery graph.Json Is the number of compounding periods per year.

norm_Dist

Returns the normal distribution for the specified mean and standard deviation.

POST /me/drive/items/{id}/workbook/functions/norm_Dist

Parameters

Parameter Type Description
x graph.Json Is the value for which you want the distribution.
mean graph.Json Is the arithmetic mean of the distribution.
standardDev graph.Json Is the standard deviation of the distribution, a positive number.
cumulative graph.Json Is a logical value: for the cumulative distribution function, use TRUE; for the probability density function, use FALSE.

norm_Inv

Returns the inverse of the normal cumulative distribution for the specified mean and standard deviation.

POST /me/drive/items/{id}/workbook/functions/norm_Inv

Parameters

Parameter Type Description
probability graph.Json Is a probability corresponding to the normal distribution, a number between 0 and 1 inclusive.
mean graph.Json Is the arithmetic mean of the distribution.
standardDev graph.Json Is the standard deviation of the distribution, a positive number.

norm_S_Dist

Returns the standard normal distribution (has a mean of zero and a standard deviation of one).

POST /me/drive/items/{id}/workbook/functions/norm_S_Dist

Parameters

Parameter Type Description
z graph.Json Is the value for which you want the distribution.
cumulative graph.Json Is a logical value for the function to return: the cumulative distribution function = TRUE; the probability density function = FALSE.

norm_S_Inv

Returns the inverse of the standard normal cumulative distribution (has a mean of zero and a standard deviation of one).

POST /me/drive/items/{id}/workbook/functions/norm_S_Inv

Parameters

Parameter Type Description
probability graph.Json Is a probability corresponding to the normal distribution, a number between 0 and 1 inclusive.

not

Changes FALSE to TRUE, or TRUE to FALSE.

POST /me/drive/items/{id}/workbook/functions/not

Parameters

Parameter Type Description
logical graph.Json Is a value or expression that can be evaluated to TRUE or FALSE.

now

Returns the current date and time formatted as a date and time.

POST /me/drive/items/{id}/workbook/functions/now

Parameters

Parameter Type Description

nper

Returns the number of periods for an investment based on periodic, constant payments and a constant interest rate.

POST /me/drive/items/{id}/workbook/functions/nper

Parameters

Parameter Type Description
rate graph.Json Is the interest rate per period. For example, use 6%/4 for quarterly payments at 6% APR.
pmt graph.Json Is the payment made each period; it cannot change over the life of the investment.
pv graph.Json Is the present value, or the lump-sum amount that a series of future payments is worth now.
fv graph.Json Is the future value, or a cash balance you want to attain after the last payment is made. If omitted, zero is used.
type graph.Json Is a logical value: payment at the beginning of the period = 1; payment at the end of the period = 0 or omitted.

npv

Returns the net present value of an investment based on a discount rate and a series of future payments (negative values) and income (positive values).

POST /me/drive/items/{id}/workbook/functions/npv

Parameters

Parameter Type Description
rate graph.Json Is the rate of discount over the length of one period.
values graph.Json List of parameters, whose elements are 1 to 254 payments and income, equally spaced in time and occurring at the end of each period.

numberValue

Converts text to number in a locale-independent manner.

POST /me/drive/items/{id}/workbook/functions/numberValue

Parameters

Parameter Type Description
text graph.Json Is the string representing the number you want to convert.
decimalSeparator graph.Json Is the character used as the decimal separator in the string.
groupSeparator graph.Json Is the character used as the group separator in the string.

oct2Bin

Converts an octal number to binary.

POST /me/drive/items/{id}/workbook/functions/oct2Bin

Parameters

Parameter Type Description
number graph.Json Is the octal number you want to convert.
places graph.Json Is the number of characters to use.

oct2Dec

Converts an octal number to decimal.

POST /me/drive/items/{id}/workbook/functions/oct2Dec

Parameters

Parameter Type Description
number graph.Json Is the octal number you want to convert.

oct2Hex

Converts an octal number to hexadecimal.

POST /me/drive/items/{id}/workbook/functions/oct2Hex

Parameters

Parameter Type Description
number graph.Json Is the octal number you want to convert.
places graph.Json Is the number of characters to use.

odd

Rounds a positive number up and negative number down to the nearest odd integer.

POST /me/drive/items/{id}/workbook/functions/odd

Parameters

Parameter Type Description
number graph.Json Is the value to round.

oddFPrice

Returns the price per $100 face value of a security with an odd first period.

POST /me/drive/items/{id}/workbook/functions/oddFPrice

Parameters

Parameter Type Description
settlement graph.Json Is the security's settlement date, expressed as a serial date number.
maturity graph.Json Is the security's maturity date, expressed as a serial date number.
issue graph.Json Is the security's issue date, expressed as a serial date number.
firstCoupon graph.Json Is the security's first coupon date, expressed as a serial date number.
rate graph.Json Is the security's interest rate.
yld graph.Json Is the security's annual yield.
redemption graph.Json Is the security's redemption value per $100 face value.
frequency graph.Json Is the number of coupon payments per year.
basis graph.Json Is the type of day count basis to use.

oddFYield

Returns the yield of a security with an odd first period.

POST /me/drive/items/{id}/workbook/functions/oddFYield

Parameters

Parameter Type Description
settlement graph.Json Is the security's settlement date, expressed as a serial date number.
maturity graph.Json Is the security's maturity date, expressed as a serial date number.
issue graph.Json Is the security's issue date, expressed as a serial date number.
firstCoupon graph.Json Is the security's first coupon date, expressed as a serial date number.
rate graph.Json Is the security's interest rate.
pr graph.Json Is the security's price.
redemption graph.Json Is the security's redemption value per $100 face value.
frequency graph.Json Is the number of coupon payments per year.
basis graph.Json Is the type of day count basis to use.

oddLPrice

Returns the price per $100 face value of a security with an odd last period.

POST /me/drive/items/{id}/workbook/functions/oddLPrice

Parameters

Parameter Type Description
settlement graph.Json Is the security's settlement date, expressed as a serial date number.
maturity graph.Json Is the security's maturity date, expressed as a serial date number.
lastInterest graph.Json Is the security's last coupon date, expressed as a serial date number.
rate graph.Json Is the security's interest rate.
yld graph.Json Is the security's annual yield.
redemption graph.Json Is the security's redemption value per $100 face value.
frequency graph.Json Is the number of coupon payments per year.
basis graph.Json Is the type of day count basis to use.

oddLYield

Returns the yield of a security with an odd last period.

POST /me/drive/items/{id}/workbook/functions/oddLYield

Parameters

Parameter Type Description
settlement graph.Json Is the security's settlement date, expressed as a serial date number.
maturity graph.Json Is the security's maturity date, expressed as a serial date number.
lastInterest graph.Json Is the security's last coupon date, expressed as a serial date number.
rate graph.Json Is the security's interest rate.
pr graph.Json Is the security's price.
redemption graph.Json Is the security's redemption value per $100 face value.
frequency graph.Json Is the number of coupon payments per year.
basis graph.Json Is the type of day count basis to use.

or

Checks whether any of the arguments are TRUE, and returns TRUE or FALSE. Returns FALSE only if all arguments are FALSE.

POST /me/drive/items/{id}/workbook/functions/or

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 conditions that you want to test that can be either TRUE or FALSE.

pduration

Returns the number of periods required by an investment to reach a specified value.

POST /me/drive/items/{id}/workbook/functions/pduration

Parameters

Parameter Type Description
rate graph.Json Is the interest rate per period.
pv graph.Json Is the present value of the investment.
fv graph.Json Is the desired future value of the investment.

percentile_Exc

Returns the k-th percentile of values in a range, where k is in the range 0..1, exclusive.

POST /me/drive/items/{id}/workbook/functions/percentile_Exc

Parameters

Parameter Type Description
array graph.Json Is the array or range of data that defines relative standing.
k graph.Json Is the percentile value that is between 0 through 1, inclusive.

percentile_Inc

Returns the k-th percentile of values in a range, where k is in the range 0..1, inclusive.

POST /me/drive/items/{id}/workbook/functions/percentile_Inc

Parameters

Parameter Type Description
array graph.Json Is the array or range of data that defines relative standing.
k graph.Json Is the percentile value that is between 0 through 1, inclusive.

percentRank_Exc

Returns the rank of a value in a data set as a percentage of the data set as a percentage (0..1, exclusive) of the data set.

POST /me/drive/items/{id}/workbook/functions/percentRank_Exc

Parameters

Parameter Type Description
array graph.Json Is the array or range of data with numeric values that defines relative standing.
x graph.Json Is the value for which you want to know the rank.
significance graph.Json Is an optional value that identifies the number of significant digits for the returned percentage, three digits if omitted (0.xxx%).

percentRank_Inc

Returns the rank of a value in a data set as a percentage of the data set as a percentage (0..1, inclusive) of the data set.

POST /me/drive/items/{id}/workbook/functions/percentRank_Inc

Parameters

Parameter Type Description
array graph.Json Is the array or range of data with numeric values that defines relative standing.
x graph.Json Is the value for which you want to know the rank.
significance graph.Json Is an optional value that identifies the number of significant digits for the returned percentage, three digits if omitted (0.xxx%).

permut

Returns the number of permutations for a given number of objects that can be selected from the total objects.

POST /me/drive/items/{id}/workbook/functions/permut

Parameters

Parameter Type Description
number graph.Json Is the total number of objects.
numberChosen graph.Json Is the number of objects in each permutation.

permutationa

Returns the number of permutations for a given number of objects (with repetitions) that can be selected from the total objects.

POST /me/drive/items/{id}/workbook/functions/permutationa

Parameters

Parameter Type Description
number graph.Json Is the total number of objects.
numberChosen graph.Json Is the number of objects in each permutation.

phi

Returns the value of the density function for a standard normal distribution.

POST /me/drive/items/{id}/workbook/functions/phi

Parameters

Parameter Type Description
x graph.Json Is the number for which you want the density of the standard normal distribution.

pi

Returns the value of Pi, 3.14159265358979, accurate to 15 digits.

POST /me/drive/items/{id}/workbook/functions/pi

Parameters

Parameter Type Description

pmt

Calculates the payment for a loan based on constant payments and a constant interest rate.

POST /me/drive/items/{id}/workbook/functions/pmt

Parameters

Parameter Type Description
rate graph.Json Is the interest rate per period for the loan. For example, use 6%/4 for quarterly payments at 6% APR.
nper graph.Json Is the total number of payments for the loan.
pv graph.Json Is the present value: the total amount that a series of future payments is worth now.
fv graph.Json Is the future value, or a cash balance you want to attain after the last payment is made, 0 (zero) if omitted.
type graph.Json Is a logical value: payment at the beginning of the period = 1; payment at the end of the period = 0 or omitted.

poisson_Dist

Returns the Poisson distribution.

POST /me/drive/items/{id}/workbook/functions/poisson_Dist

Parameters

Parameter Type Description
x graph.Json Is the number of events.
mean graph.Json Is the expected numeric value, a positive number.
cumulative graph.Json Is a logical value: for the cumulative Poisson probability, use TRUE; for the Poisson probability mass function, use FALSE.

power

Returns the result of a number raised to a power.

POST /me/drive/items/{id}/workbook/functions/power

Parameters

Parameter Type Description
number graph.Json Is the base number, any real number.
power graph.Json Is the exponent, to which the base number is raised.

ppmt

Returns the payment on the principal for a given investment based on periodic, constant payments and a constant interest rate.

POST /me/drive/items/{id}/workbook/functions/ppmt

Parameters

Parameter Type Description
rate graph.Json Is the interest rate per period. For example, use 6%/4 for quarterly payments at 6% APR.
per graph.Json Specifies the period and must be in the range 1 to nper.
nper graph.Json Is the total number of payment periods in an investment.
pv graph.Json Is the present value: the total amount that a series of future payments is worth now.
fv graph.Json Is the future value, or cash balance you want to attain after the last payment is made.
type graph.Json Is a logical value: payment at the beginning of the period = 1; payment at the end of the period = 0 or omitted.

price

Returns the price per $100 face value of a security that pays periodic interest.

POST /me/drive/items/{id}/workbook/functions/price

Parameters

Parameter Type Description
settlement graph.Json Is the security's settlement date, expressed as a serial date number.
maturity graph.Json Is the security's maturity date, expressed as a serial date number.
rate graph.Json Is the security's annual coupon rate.
yld graph.Json Is the security's annual yield.
redemption graph.Json Is the security's redemption value per $100 face value.
frequency graph.Json Is the number of coupon payments per year.
basis graph.Json Is the type of day count basis to use.

priceDisc

Returns the price per $100 face value of a discounted security.

POST /me/drive/items/{id}/workbook/functions/priceDisc

Parameters

Parameter Type Description
settlement graph.Json Is the security's settlement date, expressed as a serial date number.
maturity graph.Json Is the security's maturity date, expressed as a serial date number.
discount graph.Json Is the security's discount rate.
redemption graph.Json Is the security's redemption value per $100 face value.
basis graph.Json Is the type of day count basis to use.

priceMat

Returns the price per $100 face value of a security that pays interest at maturity.

POST /me/drive/items/{id}/workbook/functions/priceMat

Parameters

Parameter Type Description
settlement graph.Json Is the security's settlement date, expressed as a serial date number.
maturity graph.Json Is the security's maturity date, expressed as a serial date number.
issue graph.Json Is the security's issue date, expressed as a serial date number.
rate graph.Json Is the security's interest rate at date of issue.
yld graph.Json Is the security's annual yield.
basis graph.Json Is the type of day count basis to use.

product

Multiplies all the numbers given as arguments.

POST /me/drive/items/{id}/workbook/functions/product

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 numbers, logical values, or text representations of numbers that you want to multiply.

proper

Converts a text string to proper case; the first letter in each word to uppercase, and all other letters to lowercase.

POST /me/drive/items/{id}/workbook/functions/proper

Parameters

Parameter Type Description
text graph.Json Is text enclosed in quotation marks, a formula that returns text, or a reference to a cell containing text to partially capitalize.

pv

Returns the present value of an investment: the total amount that a series of future payments is worth now.

POST /me/drive/items/{id}/workbook/functions/pv

Parameters

Parameter Type Description
rate graph.Json Is the interest rate per period. For example, use 6%/4 for quarterly payments at 6% APR.
nper graph.Json Is the total number of payment periods in an investment.
pmt graph.Json Is the payment made each period and cannot change over the life of the investment.
fv graph.Json Is the future value, or a cash balance you want to attain after the last payment is made.
type graph.Json Is a logical value: payment at the beginning of the period = 1; payment at the end of the period = 0 or omitted.

quartile_Exc

Returns the quartile of a data set, based on percentile values from 0..1, exclusive.

POST /me/drive/items/{id}/workbook/functions/quartile_Exc

Parameters

Parameter Type Description
array graph.Json Is the array or cell range of numeric values for which you want the quartile value.
quart graph.Json Is a number: minimum value = 0; 1st quartile = 1; median value = 2; 3rd quartile = 3; maximum value = 4.

quartile_Inc

Returns the quartile of a data set, based on percentile values from 0..1, inclusive.

POST /me/drive/items/{id}/workbook/functions/quartile_Inc

Parameters

Parameter Type Description
array graph.Json Is the array or cell range of numeric values for which you want the quartile value.
quart graph.Json Is a number: minimum value = 0; 1st quartile = 1; median value = 2; 3rd quartile = 3; maximum value = 4.

quotient

Returns the integer portion of a division.

POST /me/drive/items/{id}/workbook/functions/quotient

Parameters

Parameter Type Description
numerator graph.Json Is the dividend.
denominator graph.Json Is the divisor.

radians

Converts degrees to radians.

POST /me/drive/items/{id}/workbook/functions/radians

Parameters

Parameter Type Description
angle graph.Json Is an angle in degrees that you want to convert.

rand

Returns a random number greater than or equal to 0 and less than 1, evenly distributed (changes on recalculation).

POST /me/drive/items/{id}/workbook/functions/rand

Parameters

Parameter Type Description

randBetween

Returns a random number between the numbers you specify.

POST /me/drive/items/{id}/workbook/functions/randBetween

Parameters

Parameter Type Description
bottom graph.Json Is the smallest integer RANDBETWEEN will return.
top graph.Json Is the largest integer RANDBETWEEN will return.

rank_Avg

Returns the rank of a number in a list of numbers: its size relative to other values in the list; if more than one value has the same rank, the average rank is returned.

POST /me/drive/items/{id}/workbook/functions/rank_Avg

Parameters

Parameter Type Description
number graph.Json Is the number for which you want to find the rank.
ref graph.Json Is an array of, or a reference to, a list of numbers. Nonnumeric values are ignored.
order graph.Json Is a number: rank in the list sorted descending = 0 or omitted; rank in the list sorted ascending = any nonzero value.

rank_Eq

Returns the rank of a number in a list of numbers: its size relative to other values in the list; if more than one value has the same rank, the top rank of that set of values is returned.

POST /me/drive/items/{id}/workbook/functions/rank_Eq

Parameters

Parameter Type Description
number graph.Json Is the number for which you want to find the rank.
ref graph.Json Is an array of, or a reference to, a list of numbers. Nonnumeric values are ignored.
order graph.Json Is a number: rank in the list sorted descending = 0 or omitted; rank in the list sorted ascending = any nonzero value.

rate

Returns the interest rate per period of a loan or an investment. For example, use 6%/4 for quarterly payments at 6% APR.

POST /me/drive/items/{id}/workbook/functions/rate

Parameters

Parameter Type Description
nper graph.Json Is the total number of payment periods for the loan or investment.
pmt graph.Json Is the payment made each period and cannot change over the life of the loan or investment.
pv graph.Json Is the present value: the total amount that a series of future payments is worth now.
fv graph.Json Is the future value, or a cash balance you want to attain after the last payment is made. If omitted, uses Fv = 0.
type graph.Json Is a logical value: payment at the beginning of the period = 1; payment at the end of the period = 0 or omitted.
guess graph.Json Is your guess for what the rate will be; if omitted, Guess = 0.1 (10 percent).

received

Returns the amount received at maturity for a fully invested security.

POST /me/drive/items/{id}/workbook/functions/received

Parameters

Parameter Type Description
settlement graph.Json Is the security's settlement date, expressed as a serial date number.
maturity graph.Json Is the security's maturity date, expressed as a serial date number.
investment graph.Json Is the amount invested in the security.
discount graph.Json Is the security's discount rate.
basis graph.Json Is the type of day count basis to use.

replace

Replaces part of a text string with a different text string.

POST /me/drive/items/{id}/workbook/functions/replace

Parameters

Parameter Type Description
oldText graph.Json Is text in which you want to replace some characters.
startNum graph.Json Is the position of the character in oldText that you want to replace with newText.
numChars graph.Json Is the number of characters in oldText that you want to replace.
newText graph.Json Is the text that will replace characters in oldText.

replaceB

Replaces part of a text string with a different text string. Use with double-byte character sets (DBCS).

POST /me/drive/items/{id}/workbook/functions/replaceB

Parameters

Parameter Type Description
oldText graph.Json Is text in which you want to replace some characters.
startNum graph.Json Is the position of the character in oldText that you want to replace with newText.
numBytes graph.Json Is the number of characters in oldText that you want to replace with newText.
newText graph.Json Is the text that will replace characters in oldText.

rept

Repeats text a given number of times. Use REPT to fill a cell with a number of instances of a text string.

POST /me/drive/items/{id}/workbook/functions/rept

Parameters

Parameter Type Description
text graph.Json Is the text you want to repeat.
numberTimes graph.Json Is a positive number specifying the number of times to repeat text.

Returns the specified number of characters from the end of a text string.

POST /me/drive/items/{id}/workbook/functions/right

Parameters

Parameter Type Description
text graph.Json Is the text string that contains the characters you want to extract.
numChars graph.Json Specifies how many characters you want to extract, 1 if omitted.

rightb

Returns the specified number of characters from the end of a text string. Use with double-byte character sets (DBCS).

POST /me/drive/items/{id}/workbook/functions/rightb

Parameters

Parameter Type Description
text graph.Json Is the text string containing the characters you want to extract.
numBytes graph.Json Specifies how many characters you want to extract.

roman

Converts an Arabic numeral to Roman, as text.

POST /me/drive/items/{id}/workbook/functions/roman

Parameters

Parameter Type Description
number graph.Json Is the Arabic numeral you want to convert.
form graph.Json Is the number specifying the type of Roman numeral you want.

round

Rounds a number to a specified number of digits.

POST /me/drive/items/{id}/workbook/functions/round

Parameters

Parameter Type Description
number graph.Json Is the number you want to round.
numDigits graph.Json Is the number of digits to which you want to round. Negative rounds to the left of the decimal point; zero to the nearest integer.

roundDown

Rounds a number down, toward zero.

POST /me/drive/items/{id}/workbook/functions/roundDown

Parameters

Parameter Type Description
number graph.Json Is any real number that you want rounded down.
numDigits graph.Json Is the number of digits to which you want to round. Negative rounds to the left of the decimal point; zero or omitted, to the nearest integer.

roundUp

Rounds a number up, away from zero.

POST /me/drive/items/{id}/workbook/functions/roundUp

Parameters

Parameter Type Description
number graph.Json Is any real number that you want rounded up.
numDigits graph.Json Is the number of digits to which you want to round. Negative rounds to the left of the decimal point; zero or omitted, to the nearest integer.

rows

Returns the number of rows in a reference or array.

POST /me/drive/items/{id}/workbook/functions/rows

Parameters

Parameter Type Description
array graph.Json Is an array, an array formula, or a reference to a range of cells for which you want the number of rows.

rri

Returns an equivalent interest rate for the growth of an investment.

POST /me/drive/items/{id}/workbook/functions/rri

Parameters

Parameter Type Description
nper graph.Json Is the number of periods for the investment.
pv graph.Json Is the present value of the investment.
fv graph.Json Is the future value of the investment.

sec

Returns the secant of an angle.

POST /me/drive/items/{id}/workbook/functions/sec

Parameters

Parameter Type Description
number graph.Json Is the angle in radians for which you want the secant.

sech

Returns the hyperbolic secant of an angle.

POST /me/drive/items/{id}/workbook/functions/sech

Parameters

Parameter Type Description
number graph.Json Is the angle in radians for which you want the hyperbolic secant.

second

Returns the second, a number from 0 to 59.

POST /me/drive/items/{id}/workbook/functions/second

Parameters

Parameter Type Description
serialNumber graph.Json Is a number in the date-time code used by Microsoft Excel or text in time format, such as 16:48:23 or 4:48:47 PM.

seriesSum

Returns the sum of a power series based on the formula.

POST /me/drive/items/{id}/workbook/functions/seriesSum

Parameters

Parameter Type Description
x graph.Json Is the input value to the power series.
n graph.Json Is the initial power to which you want to raise x.
m graph.Json Is the step by which to increase n for each term in the series.
coefficients graph.Json Is a set of coefficients by which each successive power of x is multiplied.

sheet

Returns the sheet number of the referenced sheet.

POST /me/drive/items/{id}/workbook/functions/sheet

Parameters

Parameter Type Description
value graph.Json Is the name of a sheet or a reference that you want the sheet number of. If omitted the number of the sheet containing the function is returned.

sheets

Returns the number of sheets in a reference.

POST /me/drive/items/{id}/workbook/functions/sheets

Parameters

Parameter Type Description
reference graph.Json Is a reference for which you want to know the number of sheets it contains. If omitted the number of sheets in the workbook containing the function is returned.

sign

Returns the sign of a number: 1 if the number is positive, zero if the number is zero, or -1 if the number is negative.

POST /me/drive/items/{id}/workbook/functions/sign

Parameters

Parameter Type Description
number graph.Json Is any real number.

sin

Returns the sine of an angle.

POST /me/drive/items/{id}/workbook/functions/sin

Parameters

Parameter Type Description
number graph.Json Is the angle in radians for which you want the sine. Degrees * PI()/180 = radians.

sinh

Returns the hyperbolic sine of a number.

POST /me/drive/items/{id}/workbook/functions/sinh

Parameters

Parameter Type Description
number graph.Json Is any real number.

skew

Returns the skewness of a distribution: a characterization of the degree of asymmetry of a distribution around its mean.

POST /me/drive/items/{id}/workbook/functions/skew

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 numbers or names, arrays, or references that contain numbers for which you want the skewness.

skew_p

Returns the skewness of a distribution based on a population: a characterization of the degree of asymmetry of a distribution around its mean.

POST /me/drive/items/{id}/workbook/functions/skew_p

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 254 numbers or names, arrays, or references that contain numbers for which you want the population skewness.

sln

Returns the straight-line depreciation of an asset for one period.

POST /me/drive/items/{id}/workbook/functions/sln

Parameters

Parameter Type Description
cost graph.Json Is the initial cost of the asset.
salvage graph.Json Is the salvage value at the end of the life of the asset.
life graph.Json Is the number of periods over which the asset is being depreciated (sometimes called the useful life of the asset).

small

Returns the k-th smallest value in a data set. For example, the fifth smallest number.

POST /me/drive/items/{id}/workbook/functions/small

Parameters

Parameter Type Description
array graph.Json Is an array or range of numerical data for which you want to determine the k-th smallest value.
k graph.Json Is the position (from the smallest) in the array or range of the value to return.

sqrt

Returns the square root of a number.

POST /me/drive/items/{id}/workbook/functions/sqrt

Parameters

Parameter Type Description
number graph.Json Is the number for which you want the square root.

sqrtPi

Returns the square root of (number * Pi).

POST /me/drive/items/{id}/workbook/functions/sqrtPi

Parameters

Parameter Type Description
number graph.Json Is the number by which p is multiplied.

standardize

Returns a normalized value from a distribution characterized by a mean and standard deviation.

POST /me/drive/items/{id}/workbook/functions/standardize

Parameters

Parameter Type Description
x graph.Json Is the value you want to normalize.
mean graph.Json Is the arithmetic mean of the distribution.
standardDev graph.Json Is the standard deviation of the distribution, a positive number.

stDevA

Estimates standard deviation based on a sample, including logical values and text. Text and the logical value FALSE have the value 0; the logical value TRUE has the value 1.

POST /me/drive/items/{id}/workbook/functions/stDevA

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 values corresponding to a sample of a population and can be values or names or references to values.

stDevPA

Calculates standard deviation based on an entire population, including logical values and text. Text and the logical value FALSE have the value 0; the logical value TRUE has the value 1.

POST /me/drive/items/{id}/workbook/functions/stDevPA

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 values corresponding to a population and can be values, names, arrays, or references that contain values.

stDev_P

Calculates standard deviation based on the entire population given as arguments (ignores logical values and text).

POST /me/drive/items/{id}/workbook/functions/stDev_P

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 numbers corresponding to a population and can be numbers or references that contain numbers.

stDev_S

Estimates standard deviation based on a sample (ignores logical values and text in the sample).

POST /me/drive/items/{id}/workbook/functions/stDev_S

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 numbers corresponding to a sample of a population and can be numbers or references that contain numbers.

substitute

Replaces existing text with new text in a text string.

POST /me/drive/items/{id}/workbook/functions/substitute

Parameters

Parameter Type Description
text graph.Json Is the text or the reference to a cell containing text in which you want to substitute characters.
oldText graph.Json Is the existing text you want to replace. If the case of oldText does not match the case of text, SUBSTITUTE will not replace the text.
newText graph.Json Is the text you want to replace oldText with.
instanceNum graph.Json Specifies which occurrence of oldText you want to replace. If omitted, every instance of oldText is replaced.

subtotal

Returns a subtotal in a list or database.

POST /me/drive/items/{id}/workbook/functions/subtotal

Parameters

Parameter Type Description
functionNum graph.Json Is the number 1 to 11 that specifies the summary function for the subtotal.
values graph.Json List of parameters, whose elements are 1 to 254 ranges or references for which you want the subtotal.

sum

Adds all the numbers in a range of cells.

POST /me/drive/items/{id}/workbook/functions/sum

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 numbers to sum. Logical values and text are ignored in cells, included if typed as arguments.

sumIf

Adds the cells specified by a given condition or criteria.

POST /me/drive/items/{id}/workbook/functions/sumIf

Parameters

Parameter Type Description
range graph.Json Is the range of cells you want evaluated.
criteria graph.Json Is the condition or criteria in the form of a number, expression, or text that defines which cells will be added.
sumRange graph.Json Are the actual cells to sum. If omitted, the cells in range are used.

sumIfs

Adds the cells specified by a given set of conditions or criteria.

POST /me/drive/items/{id}/workbook/functions/sumIfs

Parameters

Parameter Type Description
sumRange graph.Json Are the actual cells to sum.
values graph.Json List of parameters, where the first element of each pair is the Is the range of cells you want evaluated for the particular condition , and the second element is is the condition or criteria in the form of a number, expression, or text that defines which cells will be added.

sumSq

Returns the sum of the squares of the arguments. The arguments can be numbers, arrays, names, or references to cells that contain numbers.

POST /me/drive/items/{id}/workbook/functions/sumSq

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 numbers, arrays, names, or references to arrays for which you want the sum of the squares.

syd

Returns the sum-of-years' digits depreciation of an asset for a specified period.

POST /me/drive/items/{id}/workbook/functions/syd

Parameters

Parameter Type Description
cost graph.Json Is the initial cost of the asset.
salvage graph.Json Is the salvage value at the end of the life of the asset.
life graph.Json Is the number of periods over which the asset is being depreciated (sometimes called the useful life of the asset).
per graph.Json Is the period and must use the same units as Life.

t

Checks whether a value is text, and returns the text if it is, or returns double quotes (empty text) if it is not.

POST /me/drive/items/{id}/workbook/functions/t

Parameters

Parameter Type Description
value graph.Json Is the value to test.

tan

Returns the tangent of an angle.

POST /me/drive/items/{id}/workbook/functions/tan

Parameters

Parameter Type Description
number graph.Json Is the angle in radians for which you want the tangent. Degrees * PI()/180 = radians.

tanh

Returns the hyperbolic tangent of a number.

POST /me/drive/items/{id}/workbook/functions/tanh

Parameters

Parameter Type Description
number graph.Json Is any real number.

tbillEq

Returns the bond-equivalent yield for a treasury bill.

POST /me/drive/items/{id}/workbook/functions/tbillEq

Parameters

Parameter Type Description
settlement graph.Json Is the Treasury bill's settlement date, expressed as a serial date number.
maturity graph.Json Is the Treasury bill's maturity date, expressed as a serial date number.
discount graph.Json Is the Treasury bill's discount rate.

tbillPrice

Returns the price per $100 face value for a treasury bill.

POST /me/drive/items/{id}/workbook/functions/tbillPrice

Parameters

Parameter Type Description
settlement graph.Json Is the Treasury bill's settlement date, expressed as a serial date number.
maturity graph.Json Is the Treasury bill's maturity date, expressed as a serial date number.
discount graph.Json Is the Treasury bill's discount rate.

tbillYield

Returns the yield for a treasury bill.

POST /me/drive/items/{id}/workbook/functions/tbillYield

Parameters

Parameter Type Description
settlement graph.Json Is the Treasury bill's settlement date, expressed as a serial date number.
maturity graph.Json Is the Treasury bill's maturity date, expressed as a serial date number.
pr graph.Json Is the Treasury Bill's price per $100 face value.

text

Converts a value to text in a specific number format.

POST /me/drive/items/{id}/workbook/functions/text

Parameters

Parameter Type Description
value graph.Json Is a number, a formula that evaluates to a numeric value, or a reference to a cell containing a numeric value.
formatText graph.Json Is a number format in text form from the Category box on the Number tab in the Format Cells dialog box (not General).

time

Converts hours, minutes, and seconds given as numbers to an Excel serial number, formatted with a time format.

POST /me/drive/items/{id}/workbook/functions/time

Parameters

Parameter Type Description
hour graph.Json Is a number from 0 to 23 representing the hour.
minute graph.Json Is a number from 0 to 59 representing the minute.
second graph.Json Is a number from 0 to 59 representing the second.

timevalue

Converts a text time to an Excel serial number for a time, a number from 0 (12:00:00 AM) to 0.999988426 (11:59:59 PM). Format the number with a time format after entering the formula.

POST /me/drive/items/{id}/workbook/functions/timevalue

Parameters

Parameter Type Description
timeText graph.Json Is a text string that gives a time in any one of the Microsoft Excel time formats (date information in the string is ignored).

today

Returns the current date formatted as a date.

POST /me/drive/items/{id}/workbook/functions/today

Parameters

Parameter Type Description

trim

Removes all spaces from a text string except for single spaces between words.

POST /me/drive/items/{id}/workbook/functions/trim

Parameters

Parameter Type Description
text graph.Json Is the text from which you want spaces removed.

trimMean

Returns the mean of the interior portion of a set of data values.

POST /me/drive/items/{id}/workbook/functions/trimMean

Parameters

Parameter Type Description
array graph.Json Is the range or array of values to trim and average.
percent graph.Json Is the fractional number of data points to exclude from the top and bottom of the data set.

true

Returns the logical value TRUE.

POST /me/drive/items/{id}/workbook/functions/true

Parameters

Parameter Type Description

trunc

Truncates a number to an integer by removing the decimal, or fractional, part of the number.

POST /me/drive/items/{id}/workbook/functions/trunc

Parameters

Parameter Type Description
number graph.Json Is the number you want to truncate.
numDigits graph.Json Is a number specifying the precision of the truncation, 0 (zero) if omitted.

type

Returns an integer representing the data type of a value: number = 1; text = 2; logical value = 4; error value = 16; array = 64.

POST /me/drive/items/{id}/workbook/functions/type

Parameters

Parameter Type Description
value graph.Json Can be any value.

t_Dist

Returns the left-tailed Student's t-distribution.

POST /me/drive/items/{id}/workbook/functions/t_Dist

Parameters

Parameter Type Description
x graph.Json Is the numeric value at which to evaluate the distribution.
degFreedom graph.Json Is an integer indicating the number of degrees of freedom that characterize the distribution.
cumulative graph.Json Is a logical value: for the cumulative distribution function, use TRUE; for the probability density function, use FALSE.

t_Dist_2T

Returns the two-tailed Student's t-distribution.

POST /me/drive/items/{id}/workbook/functions/t_Dist_2T

Parameters

Parameter Type Description
x graph.Json Is the numeric value at which to evaluate the distribution.
degFreedom graph.Json Is an integer indicating the number of degrees of freedom that characterize the distribution.

t_Dist_RT

Returns the right-tailed Student's t-distribution.

POST /me/drive/items/{id}/workbook/functions/t_Dist_RT

Parameters

Parameter Type Description
x graph.Json Is the numeric value at which to evaluate the distribution.
degFreedom graph.Json Is an integer indicating the number of degrees of freedom that characterize the distribution.

t_Inv

Returns the left-tailed inverse of the Student's t-distribution.

POST /me/drive/items/{id}/workbook/functions/t_Inv

Parameters

Parameter Type Description
probability graph.Json Is the probability associated with the two-tailed Student's t-distribution, a number between 0 and 1 inclusive.
degFreedom graph.Json Is a positive integer indicating the number of degrees of freedom to characterize the distribution.

t_Inv_2T

Returns the two-tailed inverse of the Student's t-distribution.

POST /me/drive/items/{id}/workbook/functions/t_Inv_2T

Parameters

Parameter Type Description
probability graph.Json Is the probability associated with the two-tailed Student's t-distribution, a number between 0 and 1 inclusive.
degFreedom graph.Json Is a positive integer indicating the number of degrees of freedom to characterize the distribution.

unichar

Returns the Unicode character referenced by the given numeric value.

POST /me/drive/items/{id}/workbook/functions/unichar

Parameters

Parameter Type Description
number graph.Json Is the Unicode number representing a character.

unicode

Returns the number (code point) corresponding to the first character of the text.

POST /me/drive/items/{id}/workbook/functions/unicode

Parameters

Parameter Type Description
text graph.Json Is the character that you want the Unicode value of.

upper

Converts a text string to all uppercase letters.

POST /me/drive/items/{id}/workbook/functions/upper

Parameters

Parameter Type Description
text graph.Json Is the text you want converted to uppercase, a reference or a text string.

usdollar

Converts a number to text, using currency format.

POST /me/drive/items/{id}/workbook/functions/usdollar

Parameters

Parameter Type Description
number graph.Json Is a number, a reference to a cell containing a number, or a formula that evaluates to a number.
decimals graph.Json Is the number of digits to the right of the decimal point.

value

Converts a text string that represents a number to a number.

POST /me/drive/items/{id}/workbook/functions/value

Parameters

Parameter Type Description
text graph.Json Is the text enclosed in quotation marks or a reference to a cell containing the text you want to convert.

varA

Estimates variance based on a sample, including logical values and text. Text and the logical value FALSE have the value 0; the logical value TRUE has the value 1.

POST /me/drive/items/{id}/workbook/functions/varA

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 value arguments corresponding to a sample of a population.

varPA

Calculates variance based on the entire population, including logical values and text. Text and the logical value FALSE have the value 0; the logical value TRUE has the value 1.

POST /me/drive/items/{id}/workbook/functions/varPA

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 value arguments corresponding to a population.

var_P

Calculates variance based on the entire population (ignores logical values and text in the population).

POST /me/drive/items/{id}/workbook/functions/var_P

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 numeric arguments corresponding to a population.

var_S

Estimates variance based on a sample (ignores logical values and text in the sample).

POST /me/drive/items/{id}/workbook/functions/var_S

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 255 numeric arguments corresponding to a sample of a population.

vdb

Returns the depreciation of an asset for any period you specify, including partial periods, using the double-declining balance method or some other method you specify.

POST /me/drive/items/{id}/workbook/functions/vdb

Parameters

Parameter Type Description
cost graph.Json Is the initial cost of the asset.
salvage graph.Json Is the salvage value at the end of the life of the asset.
life graph.Json Is the number of periods over which the asset is being depreciated (sometimes called the useful life of the asset).
startPeriod graph.Json Is the starting period for which you want to calculate the depreciation, in the same units as Life.
endPeriod graph.Json Is the ending period for which you want to calculate the depreciation, in the same units as Life.
factor graph.Json Is the rate at which the balance declines, 2 (double-declining balance) if omitted.
noSwitch graph.Json Switch to straight-line depreciation when depreciation is greater than the declining balance = FALSE or omitted; do not switch = TRUE.

vlookup

Looks for a value in the leftmost column of a table, and then returns a value in the same row from a column you specify. By default, the table must be sorted in an ascending order.

POST /me/drive/items/{id}/workbook/functions/vlookup

Parameters

Parameter Type Description
lookupValue graph.Json Is the value to be found in the first column of the table, and can be a value, a reference, or a text string.
tableArray graph.Json Is a table of text, numbers, or logical values, in which data is retrieved. tableArray can be a reference to a range or a range name.
colIndexNum graph.Json Is the column number in tableArray from which the matching value should be returned. The first column of values in the table is column 1.
rangeLookup graph.Json Is a logical value: to find the closest match in the first column (sorted in ascending order) = TRUE or omitted; find an exact match = FALSE.

weekday

Returns a number from 1 to 7 identifying the day of the week of a date.

POST /me/drive/items/{id}/workbook/functions/weekday

Parameters

Parameter Type Description
serialNumber graph.Json Is a number that represents a date.
returnType graph.Json Is a number: for Sunday=1 through Saturday=7, use 1; for Monday=1 through Sunday=7, use 2; for Monday=0 through Sunday=6, use 3.

weekNum

Returns the week number in the year.

POST /me/drive/items/{id}/workbook/functions/weekNum

Parameters

Parameter Type Description
serialNumber graph.Json Is the date-time code used by Microsoft Excel for date and time calculation.
returnType graph.Json Is a number (1 or 2) that determines the type of the return value.

weibull_Dist

Returns the Weibull distribution.

POST /me/drive/items/{id}/workbook/functions/weibull_Dist

Parameters

Parameter Type Description
x graph.Json Is the value at which to evaluate the function, a nonnegative number.
alpha graph.Json Is a parameter to the distribution, a positive number.
beta graph.Json Is a parameter to the distribution, a positive number.
cumulative graph.Json Is a logical value: for the cumulative distribution function, use TRUE; for the probability mass function, use FALSE.

workDay

Returns the serial number of the date before or after a specified number of workdays.

POST /me/drive/items/{id}/workbook/functions/workDay

Parameters

Parameter Type Description
startDate graph.Json Is a serial date number that represents the start date.
days graph.Json Is the number of nonweekend and non-holiday days before or after startDate.
holidays graph.Json Is an optional array of one or more serial date numbers to exclude from the working calendar, such as state and federal holidays and floating holidays.

workDay_Intl

Returns the serial number of the date before or after a specified number of workdays with custom weekend parameters.

POST /me/drive/items/{id}/workbook/functions/workDay_Intl

Parameters

Parameter Type Description
startDate graph.Json Is a serial date number that represents the start date.
days graph.Json Is the number of nonweekend and non-holiday days before or after startDate.
weekend graph.Json Is a number or string specifying when weekends occur.
holidays graph.Json Is an optional array of one or more serial date numbers to exclude from the working calendar, such as state and federal holidays and floating holidays.

xirr

Returns the internal rate of return for a schedule of cash flows.

POST /me/drive/items/{id}/workbook/functions/xirr

Parameters

Parameter Type Description
values graph.Json Is a series of cash flows that correspond to a schedule of payments in dates.
dates graph.Json Is a schedule of payment dates that corresponds to the cash flow payments.
guess graph.Json Is a number that you guess is close to the result of XIRR.

xnpv

Returns the net present value for a schedule of cash flows.

POST /me/drive/items/{id}/workbook/functions/xnpv

Parameters

Parameter Type Description
rate graph.Json Is the discount rate to apply to the cash flows.
values graph.Json Is a series of cash flows that correspond to a schedule of payments in dates.
dates graph.Json Is a schedule of payment dates that corresponds to the cash flow payments.

xor

Returns a logical 'Exclusive Or' of all arguments.

POST /me/drive/items/{id}/workbook/functions/xor

Parameters

Parameter Type Description
values graph.Json List of parameters, whose elements are 1 to 254 conditions you want to test that can be either TRUE or FALSE and can be logical values, arrays, or references.

year

Returns the year of a date, an integer in the range 1900 - 9999.

POST /me/drive/items/{id}/workbook/functions/year

Parameters

Parameter Type Description
serialNumber graph.Json Is a number in the date-time code used by Microsoft Excel.

yearFrac

Returns the year fraction representing the number of whole days between start_date and end_date.

POST /me/drive/items/{id}/workbook/functions/yearFrac

Parameters

Parameter Type Description
startDate graph.Json Is a serial date number that represents the start date.
endDate graph.Json Is a serial date number that represents the end date.
basis graph.Json Is the type of day count basis to use.

yield

Returns the yield on a security that pays periodic interest.

POST /me/drive/items/{id}/workbook/functions/yield

Parameters

Parameter Type Description
settlement graph.Json Is the security's settlement date, expressed as a serial date number.
maturity graph.Json Is the security's maturity date, expressed as a serial date number.
rate graph.Json Is the security's annual coupon rate.
pr graph.Json Is the security's price per $100 face value.
redemption graph.Json Is the security's redemption value per $100 face value.
frequency graph.Json Is the number of coupon payments per year.
basis graph.Json Is the type of day count basis to use.

yieldDisc

Returns the annual yield for a discounted security. For example, a treasury bill.

POST /me/drive/items/{id}/workbook/functions/yieldDisc

Parameters

Parameter Type Description
settlement graph.Json Is the security's settlement date, expressed as a serial date number.
maturity graph.Json Is the security's maturity date, expressed as a serial date number.
pr graph.Json Is the security's price per $100 face value.
redemption graph.Json Is the security's redemption value per $100 face value.
basis graph.Json Is the type of day count basis to use.

yieldMat

Returns the annual yield of a security that pays interest at maturity.

POST /me/drive/items/{id}/workbook/functions/yieldMat

Parameters

Parameter Type Description
settlement graph.Json Is the security's settlement date, expressed as a serial date number.
maturity graph.Json Is the security's maturity date, expressed as a serial date number.
issue graph.Json Is the security's issue date, expressed as a serial date number.
rate graph.Json Is the security's interest rate at date of issue.
pr graph.Json Is the security's price per $100 face value.
basis graph.Json Is the type of day count basis to use.

z_Test

Returns the one-tailed P-value of a z-test.

POST /me/drive/items/{id}/workbook/functions/z_Test

Parameters

Parameter Type Description
array graph.Json Is the array or range of data against which to test X.
x graph.Json Is the value to test.
sigma graph.Json Is the population (known) standard deviation. If omitted, the sample standard deviation is used.

Auto-generated doc source

The script and generated list can be found in the GitHub repository.

0
Buy Me a Coffee at ko-fi.com
An error has occurred. This application may no longer respond until reloaded. Reload x