Skip to main content

NOMINAL

Returns the annual nominal interest rate.

Syntax

expression.NOMINAL(arg1, arg2);

expression - A variable that represents a ApiWorksheetFunction class.

Parameters

NameRequired/OptionalData typeDefaultDescription
arg1RequiredApiRange | ApiName | numberThe effective interest rate of the security.
arg2RequiredApiRange | ApiName | numberThe number of compounding periods per year.

Returns

number

Example

Calculate the annual nominal interest rate in a spreadsheet.

// Find the stated interest rate from effective rate and compounding periods in a spreadsheet.

// Convert compounded interest into annual percentage rate in a spreadsheet.

let worksheet = Api.GetActiveSheet();
let func = Api.WorksheetFunction;
worksheet.GetRange("A1").SetValue(func.NOMINAL(0.7, 4));