The COUPDAYSNC function in Google Sheets is a powerful tool for financial analysis, particularly in the realm of bonds and fixed income securities. It calculates the number of days between a specified settlement date and the next scheduled coupon payment, allowing investors to assess the timing of cash flows effectively.
Syntax
COUPDAYSNC(settlement, maturity, frequency, [basis])
- settlement: The date on which the bond is purchased or settled.
- maturity: The date when the bond matures or reaches its end.
- frequency: The frequency of the coupon payments per year (1 for annual, 2 for semi-annual, 4 for quarterly).
- [basis]: (Optional) The type of day count basis to use, with 0 as actual/actual, 1 as actual/360, and so forth.
Example #1
COUPDAYSNC("2023-10-01", "2025-10-01", 2)
This formula calculates the number of days from the settlement date of October 1, 2023, to the next coupon payment date, assuming semi-annual payments. Result: 182 days.
Example #2
COUPDAYSNC("2023-10-01", "2025-10-01", 1)
This example determines the days from October 1, 2023, to the next annual coupon payment, resulting in 365 days. Result: 365 days.
Example #3
COUPDAYSNC("2023-10-01", "2025-10-01", 2, 1)
This function calculates the days until the next coupon payment, taking into account an actual/360 day count basis. Result: 182 days.
Error handling
- VALUE!: This error occurs when the input values for settlement or maturity are not valid dates.
- NUM!: This indicates an invalid input for frequency, which should be 1, 2, or 4 only.
- NAME?: This happens if the function name is incorrectly typed, confirming that “COUPDAYSNC” is spelled properly.