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

From Apache OpenOffice Wiki
Jump to: navigation, search
(→‎See also:)
m
 
(8 intermediate revisions by 4 users not shown)
Line 1: Line 1:
−
__NOTOC__
+
{{DISPLAYTITLE: COUPDAYS function}}
 +
{{Documentation/CalcFunc FinancialTOC
 +
|ShowPrevNext=block
 +
|PrevPage=Documentation/How_Tos/Calc:_COUPDAYBS_function
 +
|NextPage=Documentation/How_Tos/Calc:_COUPDAYSNC_function
 +
}}__NOTOC__
  
 
== COUPDAYS ==
 
== COUPDAYS ==
Line 21: Line 26:
 
=== Example: ===
 
=== Example: ===
 
<tt>'''COUPDAYS("2007-01-25"; "2009-11-15"; 2; 4)'''</tt>
 
<tt>'''COUPDAYS("2007-01-25"; "2009-11-15"; 2; 4)'''</tt>
−
:  returns <tt>'''180'''</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 180 days (= 6 * 30) in the interest period in which the settlement date falls (16 November 2006 to 15 May 2007 inclusive = 6 months).
+
:  returns <tt>'''180'''</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 180 days (= 6 * 30) in the interest period in which the settlement date falls (16 November 2006 to 15 May 2007 inclusive = 6 months).
  
−
=== See also: ===
+
=== Issues: ===
−
[[Documentation/How_Tos/Calc: COUPDAYBS function|'''COUPDAYBS''']],
+
* For any <tt>'''basis'''</tt> except 1, the length of the interest period is calculated from the length of a year. Thus, <tt>'''COUPDAYS'''</tt> returns the same number of days (derived from the number of interest periods in a year), regardless of settlement date, unless <tt>'''basis'''</tt> = 1, when the exact number of days are returned.
−
[[Documentation/How_Tos/Calc: COUPDAYSNC function|'''COUPDAYSNC''']],
+
* Both Calc and Excel can return a non-integer number of days (including a fraction) - for example <tt>'''COUPDAYS("2007-01-25"; "2009-11-15"; 2; 3)'''</tt> returns <tt>'''182.5'''</tt> (= 365/2).
−
[[Documentation/How_Tos/Calc: COUPNCD function|'''COUPNCD''']],
+
−
[[Documentation/How_Tos/Calc: COUPNUM function|'''COUPNUM''']],
+
−
[[Documentation/How_Tos/Calc: COUPPCD function|'''COUPPCD''']]
+
  
−
[[Documentation/How_Tos/Calc: Date & Time functions#Financial date systems|'''Financial date systems''']]
 
  
−
[[Documentation/How_Tos/Calc: Financial functions|'''Financial functions''']]
+
{{SeeAlso|EN|
 +
* [[Documentation/How_Tos/Calc: COUPDAYBS function|COUPDAYBS]]
 +
* [[Documentation/How_Tos/Calc: COUPDAYSNC function|COUPDAYSNC]]
 +
* [[Documentation/How_Tos/Calc: COUPNCD function|COUPNCD]]
 +
* [[Documentation/How_Tos/Calc: COUPNUM function|COUPNUM]]
 +
* [[Documentation/How_Tos/Calc: COUPPCD function|COUPPCD]]
  
−
[[Documentation/How_Tos/Calc: Functions listed alphabetically|'''Functions listed alphabetically''']],
+
* [[Documentation/How_Tos/Calc: Date & Time functions#Financial date systems|Financial date systems]]
−
[[Documentation/How_Tos/Calc: Functions listed by category|'''Functions listed by category''']]
+
  
−
=== Issues: ===
+
* [[Documentation/How_Tos/Calc: Financial functions|Financial functions]]
−
* For any <tt>'''basis'''</tt> except 1, the length of the interest period is calculated from the length of a year. Thus <tt>'''COUPDAYS'''</tt> returns the same number of days (derived from the number of interest periods in a year), regardless of settlement date, unless <tt>'''basis'''</tt> = 1, when the exact number of days are returned.
+
 
−
* Both Calc and Excel can return a non-integer number of days (including a fraction) - for example <tt>'''COUPDAYS("2007-01-25"; "2009-11-15"; 2; 3)'''</tt> returns <tt>'''182.5'''</tt> (= 365/2).
+
* [[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:17, 31 January 2024

COUPDAYS

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

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

Syntax:

COUPDAYS(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:

COUPDAYS("2007-01-25"; "2009-11-15"; 2; 4)

returns 180. 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 (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 180 days (= 6 * 30) in the interest period in which the settlement date falls (16 November 2006 to 15 May 2007 inclusive = 6 months).

Issues:

  • For any basis except 1, the length of the interest period is calculated from the length of a year. Thus, COUPDAYS returns the same number of days (derived from the number of interest periods in a year), regardless of settlement date, unless basis = 1, when the exact number of days are returned.
  • Both Calc and Excel can return a non-integer number of days (including a fraction) - for example COUPDAYS("2007-01-25"; "2009-11-15"; 2; 3) returns 182.5 (= 365/2).



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