How to Use the RECEIVED Function in Google Sheets

Published on

The RECEIVED function in Google Sheets is a financial (category) function for calculating the amount received at maturity for investment in fixed-income securities like bonds, ABS, etc.

You need not be a financial analyst to calculate the return of a bond you purchased! You can use Google Sheets for this by entering the URL https://sheets.new/ on your browser’s address bar.

Entering the input values such as settlement date, maturity date, and the discount rates, you can calculate the maturity amount of the bond you hold using the RECEIVED function in Google Sheets.

To make you ease in using the RECEIVED function, I know I must explain the syntax and arguments of this function in detail.

Google Sheets RECEIVED Function – Syntax and Arguments

Syntax

RECEIVED(settlement, maturity, investment, discount, [day_count_convention])

Arguments

There are three arguments and one optional argument in the function RECEIVED. The details are as follows.

  • settlement – The settlement date of the security. It’s the date after the issue date (date after issuance) when the security is delivered (traded) to the buyer.
    • Assume a 6-year bond is issued on January 1, 2014. If a buyer purchased it after 3 months, the settlement date would be April 1, 2014.
  • maturity – The maturity or expiry date of the security (when it can be redeemed at the face or par value).
    • For your info, the face value (the amount to be paid at maturity) for bonds is often referred to as par value.
    • If you consider the above 6-year bond, the maturity date would be January 1, 2020.
  • discount – The discount rate (rate of return) of the security invested in.
  • day_count_convention – Day count basis. This is an optional argument and 0 is by default.
    • Please refer to the below day count table for more info.

Day Count Table

day_count_conventionDescription
0 or omittedUS (NASD) 30/360 – 30 day months and 360-day years.
1Actual/Actual
2Actual/360
3Actual/365
4European 30/360

RECEIVED Function Example in Google Sheets

In the following example, let’s see how to calculate the maturity for a bond with an initial investment of $10,000 and a discount rate of 4.5%.

The settlement date of the bond is 1-Apr-2014 and the maturity date is 01-Jan-2020.

As a side note, in simple terms, the bond (an instrument of indebtedness) can be defined as loans made by a bondholder to an issuer.

Formula:

=received(C4,C5,C2,C6)
Example to the RECEIVED Function in Google Sheets

In this example to the RECEIVED function in Google Sheets, I have omitted the day_count_convention. So it’s considered as 0; it means US (NASD) 30/360 (see the table above).

When you directly feed the arguments take care of the two arguments they are settlement and maturity dates.

You must specify the dates using the DATE function to avoid unintentional errors. The date should be provided in the DATE(year, month, day) format.

=received(date(2014,4,1),date(2020,1,1),10000,4.5%)

Possible Errors in the RECEIVED Function Use

The #VALUE! and #NUM! are the two possible errors that you may happen to see in the use of the RECEIVED function in Google Sheets. If you are familiar with spreadsheets, you won’t make these errors happen.

Reasons for the #VALUE! Error:

  1. Invalid settlement/maturity date formats.
  2. When investment amount and discount percentage are formatted as texts.

Reasons for #NUM! Error:

  1. When you have forgotten to enter the investment amount or discount % you will see the #NUM! error in the RECEIVED function use.
  2. If the investment or discount is <=0, the formula returns this error.
  3. Invalid day_count_convetion base. It should be omitted, or one of the numbers from 0, 1, 2, 3, and 4.
  4. If the settlement date is >= maturity date, the RECEIVED formula returns the #NUM! error.

That’s all. Enjoy!

Prashanth KV
Prashanth KV
Your Trusted Google Sheets and Excel Guide Prashanth KV brings a wealth of experience in Google Sheets and Excel, cultivated through years of work with multinational corporations in Mumbai and Dubai. As a recognized Google Product Expert in Docs Editors, Prashanth shares his expertise through insightful blogging since 2012. Explore his blog for practical tips and guidance on maximizing your spreadsheet skills.

Reset SCAN by Another Column in Google Sheets and Excel

Resetting SCAN function results based on values in another column is a topic of...

How to Get the Fastest Time for Each Person in Google Sheets

Whether you’re tracking race results, event times, or any other timed activities, finding the...

Highlight the Smallest N Values in a Column in Google Sheets

Want to visually spotlight the lowest values in your data? In this tutorial, you'll...

Sort Each Row Individually in Excel Using a LAMBDA Formula

Sorting rows in Excel typically refers to rearranging entire datasets based on values in...

More like this

How to Get the Fastest Time for Each Person in Google Sheets

Whether you’re tracking race results, event times, or any other timed activities, finding the...

Highlight the Smallest N Values in a Column in Google Sheets

Want to visually spotlight the lowest values in your data? In this tutorial, you'll...

How to Sort Pie Slices in Google Sheets

To sort pie slices in a pie chart, you need to sort the data...

LEAVE A REPLY

Please enter your comment!
Please enter your name here

This site uses Akismet to reduce spam. Learn how your comment data is processed.