---
title: How Do I Get Return Values Within a Specific Period?
description: This will give you a returns array.
---

[Skip to content](https://www.allocator.com/knowledge/how-do-i-get-return-values-within-a-specific-period#main-content)

English

Show submenu for translations

![Allocator_Logo_Colour_Mark.png\]](https://www.allocator.com/hs-fs/hubfs/Branding%20-%20Images%20and%20Logos/Allocator%20logos/Allocator_Logo_Colour_Mark.png?height=40&name=Allocator_Logo_Colour_Mark.png)

- [Knowledge Base](https://www.allocator.com/knowledge)
- [Allocator Platform](https://secure.allocator.com/)
- [Sign out](https://www.allocator.com/_hcms/mem/logout)

Open main navigation

Close main navigation

- [Knowledge Base](https://www.allocator.com/knowledge)
- [Allocator Platform](https://secure.allocator.com/)
- [Sign out](https://www.allocator.com/_hcms/mem/logout)
- English
  
  Show submenu for translations

 Allocator Knowledge Base

- There are no suggestions because the search field is empty.

1. [Allocator Knowledge Base](https://www.allocator.com/knowledge?hsLang=en)
2. [Export Your Data](https://www.allocator.com/knowledge/export-your-data?hsLang=en)
3. [Allocator Excel Add-In](https://www.allocator.com/knowledge/export-your-data?hsLang=en#allocator-excel-add-in)

# How Do I Get Return Values Within a Specific Period?

## This will give you a returns array.

**Formula**

=ALLOCATOR\_RETURNS\_ARRAY( \[Text\] ID, \[Date\] Start Date, \[Date\] End Date, \[Text\] Time Unit, \[Text\] Show Estimate, \[Text\] Show Derived From)

**Arguments**                                                                                           

**ID** - Required - *Text -* ***Eg****: fdedb7                                         * The Fund, Company, Series, Portfolio ID.

**Start Date** - Optional - *Date -* ***Eg****: 2021-01-01                    * The start date in YYYY-MM-DD format.

**End Date** - Optional - *Date -* ***Eg****: 2021-12-31                      * The end date in YYYY-MM-DD format.

**Time Unit** - Optional - *Text -* ***Default****: Monthly*                     The periodicity of the returns.

**Show Estimate** - Optional - *Text -* ***Default:*** *No                   * Whether to show the return if it is an Estimate.

**Show Derived From** - Optional - *Text - **Default:** Yes         * Whether to show the Derived From column.

**Example**

Returns of Fund "fdedb7" within 2021.

=ALLOCATOR\_RETURNS\_ARRAY( "fdedb7","2021-01-01","2021-12-31","Monthly",FALSE,FALSE)

![](https://www.allocator.com/hubfs/image-png-Aug-18-2022-01-05-08-10-PM.png)

**Remarks**

![](https://www.allocator.com/hubfs/image-png-Aug-18-2022-01-05-41-58-PM.png) If the dates are ignored, **Returns Array** will return everything without any date restriction.

![](https://www.allocator.com/hubfs/image-png-Aug-18-2022-01-05-38-30-PM.png) The date field is not format sensitive if you input a cell reference.

*![](https://www.allocator.com/hubfs/image-png-Aug-18-2022-01-05-34-64-PM.png) \[ID\]* If a Fund ID is given, the Default series will be used.

*![](https://www.allocator.com/hubfs/image-png-Aug-18-2022-01-05-32-21-PM.png) \[Start Date\]* If you don't specify the start date, **Returns Array** will return everything before the end date.

*![](https://www.allocator.com/hubfs/image-png-Aug-18-2022-01-05-29-49-PM.png) \[End Date\]* If you don't specify the end date, **Returns Array** will return everything after the start date.

- [Platform Knowledge Base](https://www.allocator.com/knowledge/platform-knowledge-base?hsLang=en#main-content)
  
  
  
  
  
    - [Stay on Top of Your Onboarding](https://www.allocator.com/knowledge/platform-knowledge-base?hsLang=en#stay-on-top-of-your-onboarding)
- [Hedge Funds](https://www.allocator.com/knowledge/hedge-funds?hsLang=en#main-content)
  
  
  
  
  
    - [Calculation Definitions](https://www.allocator.com/knowledge/hedge-funds?hsLang=en#calculation-definitions)
    - [How-To Guides](https://www.allocator.com/knowledge/hedge-funds?hsLang=en#how-to-guides)
- [Private Capital Funds](https://www.allocator.com/knowledge/private-capital-funds?hsLang=en#main-content)
  
  
  
  
  
    - [Calculation Definitions](https://www.allocator.com/knowledge/private-capital-funds?hsLang=en#calculation-definitions)
    - [How-To Guides](https://www.allocator.com/knowledge/private-capital-funds?hsLang=en#how-to-guides)
- [Export Your Data](https://www.allocator.com/knowledge/export-your-data?hsLang=en#main-content)
  
  
  
  
  
    - [Allocator Excel Add-In](https://www.allocator.com/knowledge/export-your-data?hsLang=en#allocator-excel-add-in)
    - [Allocator API](https://www.allocator.com/knowledge/export-your-data?hsLang=en#allocator-api)
- [What's New on Allocator?](https://www.allocator.com/knowledge/whats-new-on-allocator?hsLang=en#main-content)
  
  
  
  
  
    - [Q1 2026](https://www.allocator.com/knowledge/whats-new-on-allocator?hsLang=en#q1-2026)

[![Chill listening crop-3](https://www.allocator.com/hs-fs/hubfs/Branding%20-%20Images%20and%20Logos/Allocator%20logos/Allocator_Logo_Colour%20No%20Background.png?width=171&height=24&name=Allocator_Logo_Colour%20No%20Background.png "Chill listening crop-3")](https://knowledge.allocator.com/knowledge?hsLang=en)

www.allocator.com

<https://twitter.com/Allocator_com> <https://www.linkedin.com/company/hedgepo/>

Copyright © 2026, Allocator