Difference between revisions of "Documentation/How Tos/Calc: COUPDAYSNC function"

From Apache OpenOffice Wiki
Jump to: navigation, search
(See also:)
m
 
(10 intermediate revisions by 5 users not shown)
Line 1: Line 1:
__NOTOC__
+
{{DISPLAYTITLE: COUPDAYSNC function}}
 +
{{Documentation/CalcFunc FinancialTOC
 +
|ShowPrevNext=block
 +
|PrevPage=Documentation/How_Tos/Calc:_COUPDAYS_function
 +
|NextPage=Documentation/How_Tos/Calc:_COUPNCD_function
 +
}}__NOTOC__
  
 
== COUPDAYSNC ==
 
== COUPDAYSNC ==
Line 12: Line 17:
 
: <tt>'''maturity'''</tt>: the date on which the security matures (expires).
 
: <tt>'''maturity'''</tt>: the date on which the security matures (expires).
 
: <tt>'''frequency'''</tt>: number of interest payments per year (1, 2 or 4).
 
: <tt>'''frequency'''</tt>: number of interest payments per year (1, 2 or 4).
: <tt>'''basis'''</tt>: is chosen from a list of options and indicates how the year is to be calculated. Defaults to <tt>'''0'''</tt> if omitted.
+
: <tt>'''basis'''</tt>: is the calendar system to use. Defaults to <tt>'''0'''</tt> if omitted.
 
:: 0 - US method (NASD), 12 months of 30 days each
 
:: 0 - US method (NASD), 12 months of 30 days each
 
:: 1 - Actual number of days in months, actual number of days in year
 
:: 1 - Actual number of days in months, actual number of days in year
Line 20: Line 25:
  
 
=== Example: ===
 
=== Example: ===
<tt>'''COUPDAYSNC("2007-01-25"; "2009-11-15"; 2; 4)'''</tt>
+
<tt>'''COUPDAYSNC("2017-01-25"; "2019-11-15"; 2; 4)'''</tt>
:  returns <tt>'''110'''</tt>.  A bond is originally issued on 15 November 1999, with a ten year term; the date of maturity is 15 November 2009. You subsequently purchase it on the secondary market, with a settlement date of 25 January 2007; Interest is paid half-yearly (<tt>'''frequency'''</tt> is 2); thus interest is due on the 15 May and the 15 November each year, during the bond's term. Using basis 4, there are 110 days from the settlement date 25 January 2007 until the next interest payment on 15 May 07.
+
:  returns <tt>'''110'''</tt>.  A bond is originally issued on 15 November 2009, with a ten-year term; the date of maturity is 15 November 2019. You subsequently purchase it on the secondary market, with a settlement date of 25 January 2017; Interest is paid half-yearly (<tt>'''frequency'''</tt> is 2); thus interest is due on the 15 May and the 15 November each year, during the bond's term. Using basis 4, there are 110 days from the settlement date 25 January 2017 until the next interest payment on 15 May 17.
  
=== See also: ===
+
{{SeeAlso|EN|
[[Documentation/How_Tos/Calc: COUPDAYBS function|'''COUPDAYBS''']],
+
* [[Documentation/How_Tos/Calc: COUPDAYBS function|COUPDAYBS]]
[[Documentation/How_Tos/Calc: COUPDAYS function|'''COUPDAYS''']],
+
* [[Documentation/How_Tos/Calc: COUPDAYS function|COUPDAYS]]
[[Documentation/How_Tos/Calc: COUPNCD function|'''COUPNCD''']],
+
* [[Documentation/How_Tos/Calc: COUPNCD function|COUPNCD]]
[[Documentation/How_Tos/Calc: COUPNUM function|'''COUPNUM''']],
+
* [[Documentation/How_Tos/Calc: COUPNUM function|COUPNUM]]
[[Documentation/How_Tos/Calc: COUPPCD function|'''COUPPCD''']]
+
* [[Documentation/How_Tos/Calc: COUPPCD function|COUPPCD]]
  
[[Documentation/How_Tos/Calc: Financial functions|'''Financial functions''']]
+
* [[Documentation/How_Tos/Calc: Date & Time functions#Financial date systems|Financial date systems]]
 +
 
 +
* [[Documentation/How_Tos/Calc: Financial functions|Financial functions]]
 +
 
 +
* [[Documentation/How_Tos/Calc: Functions listed alphabetically|Functions listed alphabetically]]
 +
* [[Documentation/How_Tos/Calc: Functions listed by category|Functions listed by category]]}}
 +
[[Category: Documentation/Reference/Calc/Financial functions]]

Latest revision as of 12:20, 31 January 2024

COUPDAYSNC

Returns the number of days between the settlement date and the next coupon date.

This function is only available if the Analysis AddIn is installed.

Syntax:

COUPDAYSNC(settlement; maturity; frequency; basis)

settlement: the date of purchase of the security.
maturity: the date on which the security matures (expires).
frequency: number of interest payments per year (1, 2 or 4).
basis: is the calendar system to use. Defaults to 0 if omitted.
0 - US method (NASD), 12 months of 30 days each
1 - Actual number of days in months, actual number of days in year
2 - Actual number of days in month, year has 360 days
3 - Actual number of days in month, year has 365 days
4 - European method, 12 months of 30 days each

Example:

COUPDAYSNC("2017-01-25"; "2019-11-15"; 2; 4)

returns 110. A bond is originally issued on 15 November 2009, with a ten-year term; the date of maturity is 15 November 2019. You subsequently purchase it on the secondary market, with a settlement date of 25 January 2017; Interest is paid half-yearly (frequency is 2); thus interest is due on the 15 May and the 15 November each year, during the bond's term. Using basis 4, there are 110 days from the settlement date 25 January 2017 until the next interest payment on 15 May 17.



See Also
Retrieved from "https://wiki.openoffice.org/w/index.php?title=Documentation/How_Tos/Calc:_COUPDAYSNC_function&oldid=259780"
Views
Personal tools
Navigation
Tools
In other languages