Custom Time Frames

Many views in Datadog can be scoped to a specific time frame. Time controls include a list of common time frames and a calendar picker for quick selection.

To increment by month, day, year, hour, or minute, highlight a portion of the time frame and use the [↑] and [↓] keys:

You can also type or paste custom dates and timestamps—including ones copied from elsewhere in Datadog:

Both fixed and relative custom time frames are supported:

Note: Queries are run in UTC time, but the query time range is selected according to your browser. Additionally, you can toggle between displaying the default time zone or UTC from the dashboard settings.

Supported syntaxes

Fixed dates

January 1
{MMM/MMMM} D, h:mm aJan 1, 1:00 pm
January 1, 1:00 pm
{MMM/MMMM} D, YYYY, h:mm aJan 1, 2019, 1:00 pm
January 1, 2019, 1:00 pm
h:mm a1:00 pm
Unix seconds timestamp1577883600
Unix milliseconds timestamp1577883600000
  • Any fixed date can be entered as part of a range. Examples:
    • 1577883600 - 1578009540
    • Jan 1 - Jan 2
    • 6:00 am - 1:00 pm

Relative dates

3 min
3 hours
3 days
3 weeks
3 months
Displays the past N units, for example: the past 3 months
todayDisplays the current calendar day until present
yesterdayDisplays the full previous calendar day
this monthDisplays the current calendar month until present
last monthDisplays the full previous calendar month
this yearDisplays the current calendar year until present
last yearDisplays the full previous calendar year
  • The following strings are accepted for any {unit} in a relative date:
    • Minutes: m, min, mins, minute, minutes
    • Hours: h, hr, hrs, hour, hours
    • Days: d, day, days
    • Weeks: w, week, weeks
    • Months: mo, mos, mon, mons, month, months
  • today, yesterday, this month, this year, and last year are calculated when entered. They won’t continue to update as time passes.