Calendar and date ranges overview

Last update: 2025-01-31
  • Created for:
  • User
    Admin

In the calendar, you can specify dates and date ranges, or select a preset.

See VideoCheckedOut Calendar and date ranges overview for a demo video.

Calendar selections apply at the panel level, but you have the option to apply them to all panels. When you click a date range in Workspace, the interface displays the current calendar month and the previous calendar month. You can adjust these two calendars by clicking the right and left arrows in each respective upper corner.

Calendar

Select and apply date ranges

The first click on a calendar starts a date range selection. The second click completes a date range selection, which becomes highlighted. If the Shift key is held down (or right-click is used), it appends to the currently selected range.

You can also drag dates (and time dimensions) into a Workspace project. You can select specific days, weeks, months, years, or a rolling date.

Using Date Ranges and Calendar in Analysis Workspace (4:07)

Setting Description
Selected Days Selected days/weeks/months/years.
Make date range components relative to panel calendar If disabled, any date range components used within a table, visualization, or panel drop zone override the panel calendar.

If enabled, any date range components used within a table, visualization, or panel drop zone are in relation to the panel date range. For example, if the panel date range is set to November 1 through November 30, and a Last Week date range component is used in a freeform table, the information in the freeform table refers to the last week in October.
Use rolling dates Rolling dates allow you to generate a dynamic report that looks forward or backward for a set period of time based on when you ran the report. For example, if you want to report on all Orders placed “Last Month” (based on the Created Date field) and ran that report in December, you’d see orders placed in November. If you ran that same report in January, you’d see orders placed in December.
  • Date Preview: Indicates what time period the rolling calendar encompasses.
  • Start: You can choose among current day, current week, current month, current quarter, current year.
  • End: You can choose among current day, current week, current month, current quarter, current year.
To view an example, see Custom date ranges.
Selected by default.
Date Range Lets you pick a preset date range. Last 30 days is the default. This week/month/quarter/year (excluding today) lets you choose from date ranges that do not include partial-day data from today.
Apply to All Panels Lets you not only change the selected date range for the current panel, but also for all other panels within the project.
Apply Applies the date range to this panel only.

About relative panel date ranges

If you’re working in Workspace, you can make the date range components relative to the panel calendar.
Three common use cases where you’ll see relative panel dates take effect are Combo charts, Key metrics summary, and Freeform table date ranges.

To use relative panel date ranges

  1. Select the Workspace tab.

  2. Select Blank project.

  3. Add dimensions, metrics, and segments from the left rail.

  4. Click the panel date range field to toggle the relative panel date range setting.

  5. Select Make date range components relative to panel calendar.

    • Select the option to make the date range components relative to the panel calendar.
      If relative dates are selected, then rolling dates will be based on the start date of the panel calendar and not today’s date.
    • If this option isn’t selected, then rolling dates will be based on today’s date.
    relative panel dates

  6. Click Apply.
    The relative dates are shown in the upper-right.

    relative dates in freeform

Guidelines for relative panel date ranges

Keep in mind the following guidelines when using relative panel date ranges.

Formulas and relative date ranges

If you have relative dates selected, all date formulas will use the panel’s start date as the starting point.

Custom calendars and relative date ranges

When you use a week-based custom calendar and you add months or years, the formula calculates the offset of the day in the given period. The actual date may be different because of the offset. The formula chooses the day landing in the same place in the custom calendar. For example, the third Friday of the third week in a custom calendar.

About segments that use rolling dates and relative panel date ranges

If you build a segment or use a segment with a rolling date, for example, the Last 7 Days or the Last 2 Weeks, and you click on the segment preview, it will start the rolling date from Today instead of the panel start date. As a result the preview for the segment will not match when you actually use the segment in the table. The preview is impacted, not the segment itself.

Guidelines for panel date ranges and previews

  • Starting with the February release, component and data previews will be based on the panel date range and not the last 90 days.
  • All components listed in the left rail will be available based on the panel date range.
  • All date previews in the segment and calculated metric builders will be based on the panel date range (unless accessed from the component managers, which do not have an associated panel, they will still be based on the last 90 days).
  • Any data previews will display data or components based on the panel date range.

On this page