Custom Time Frames

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:

Supported syntaxes

Fixed dates

Format Examples
{MMM/MMMM} D Jan 1
January 1
M/D 1​/​1
M-D 1-1
M/D/{YY/YYYY} 1/1/19
M-D-{YY/YYYY} 1-1-19
{MMM/MMMM} D, h:mm a Jan 1, 1:00 pm
January 1, 1:00 pm
{MMM/MMMM} D, YYYY, h:mm a Jan 1, 2019, 1:00 pm
January 1, 2019, 1:00 pm
h:mm a 1:00 pm
Unix seconds timestamp 1577883600
Unix milliseconds timestamp 1577883600000
  • 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

Format Examples Notes
N{unit} 3m
3 min
3 hours
3 days
3 months
Displays the past N units, for example: the past 3 months
today Displays the current calendar day until present
yesterday Displays the full previous calendar day
this month Displays the current calendar month until present
last month Displays the full previous calendar month
this year Displays the current calendar year until present
last year Displays 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
    • 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.