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
Format | Examples |
---|
{MMM/MMMM} D | Jan 1 January 1 |
M/D | 1/1 |
M-D | 1-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 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 3h 3 hours 3d 3 days 3w 3 weeks 3mo 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
- 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.