Custom time frames
Security Monitoring is now available Security Monitoring is now available

Custom time frames

Incrementing time frames via keyboard and entering custom time frames is in beta. If you have feedback, contact Datadog support.

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

FormatExamples
{MMM/MMMM} DJan 1
January 1
M/D1​/​1
M-D1-1
M/D/{YY/YYYY}1/1/19
1/1/2019
M-D-{YY/YYYY}1-1-19
1-1-2019
{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

FormatExamplesNotes
N{unit}3m
3 min
3h
3 hours
3d
3 days
3mo
3 months
Displays the past N units (e.g., the past 3 months)
todayDisplays the current calendar day until now
yesterdayDisplays the full previous calendar day
this monthDisplays the current calendar month until now
last monthDisplays the full previous calendar month
this yearDisplays the current calendar year until now
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
    • 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.