[]

SpreadJS Overview
Getting Started
JavaScript Frameworks
Best Practices
Features
SpreadJS Designer
SpreadJS Designer Component
Touch Support
Formula Reference
- Formula Overview
- Formula Functions
  - Barcode Functions
  - Compatibility Functions
  - Database Functions
  - Date and Time Functions
  - Engineering Functions
  - Financial Functions
    - ACCRINT
    - ACCRINTM
    - AMORDEGRC
    - AMORLINC
    - COUPDAYBS
    - COUPDAYS
    - COUPDAYSNC
    - COUPNCD
    - COUPNUM
    - COUPPCD
    - CUMIPMT
    - CUMPRINC
    - DB
    - DDB
    - DISC
    - DOLLARDE
    - DOLLARFR
    - DURATION
    - EFFECT
    - FV
    - FVSCHEDULE
    - INTRATE
    - IPMT
    - IRR
    - ISPMT
    - MDURATION
    - MIRR
    - NOMINAL
    - NPER
    - NPV
    - ODDFPRICE
    - ODDFYIELD
    - ODDLPRICE
    - ODDLYIELD
    - PDURATION
    - PMT
    - PPMT
    - PRICE
    - PRICEDISC
    - PRICEMAT
    - PV
    - RATE
    - RECEIVED
    - RRI
    - SLN
    - SYD
    - TBILLEQ
    - TBILLPRICE
    - TBILLYIELD
    - VDB
    - XIRR
    - XNPV
    - YIELD
    - YIELDDISC
    - YIELDMAT
  - Information Functions
  - Logical Functions
  - Lookup and Reference Functions
  - Math and Trigonometric Functions
  - Statistical Functions
  - Sparkline Functions
  - Text Functions
  - Web Functions
  - Other Functions
  - RegEx Functions
Import and Export Reference
Frequently Used Events
API Documentation
Release Notes

DURATION

This function returns the Macauley duration for an assumed par value of $100.

Syntax

DURATION(settlement, maturity, coupon, yield, frequency, basis)

Arguments

This function has these arguments:

Argument	Description
settlement	Settlement date for the security
maturity	Maturity date for the security
coupon	Annual coupon rate
yield	Annual yield for the security
frequency	Frequency of payment, number of coupon payments per year; must be 1, 2, or 4
basis	[Optional] Integer representing the basis for day count (Refer to Day Count Basis.)

Remarks

This function returns a #VALUE! error when settlement or maturity is invalid or a #NUM! error when frequency is a number other than 1, 2, or 4.

Settlement, maturity, frequency, and basis are truncated to integers.

The function returns an error in the following cases:

If coupon is less than 0 or yield is less than 0.
If basis is less than 0 or greater than 4.
If settlement is greater than or equal to maturity.

Data Types

Accepts numeric and DateTime object data. Returns numeric data.

Examples

DURATION(C1,C2,C3,C4,C5,C6)

DURATION(R5C2,R2C4,R3C1,R4C1,R5C1)