Filtering Using the submitTimeUtc Field
The
submitTimeUtc
field uses date math expressions and enables you to
use dates and times relative to a fixed moment, including the current time, which is
represented by NOW
.You can also use UNIX Epoch Time for the start and end time. For example,
submitTimeUtc:[1556712000000 TO 1556757600000]
.Date Math Syntax:
Date math expressions consist of adding some quantity of time in a
specified unit, or rounding the current time by a specified unit. Expressions can be
joined and are evaluated left to right.A slash (
/
) is used to indicate rounding. NOW/HOUR
represents the beginning of the current hour. If the current time is 4:12 p.m.
(NOW
), then NOW/HOUR
would be the start of that
hour, 4:00 p.m. Valid values in date math are:- DAYorDAYS
- MONTHorMONTHS
- MINUTEorMINUTES
Date Math Range:
Date math supports date range searches. The syntax is
[startDate TO endDate}
. A square bracket (
[
) indicates that the date is included in the range; a
curly bracket (}
) indicates that the date is excluded.For example, to search transactions from the previous day, and the current date is May 3,
2019,
[NOW/DAY-1DAY TO NOW/DAY}
would search for transactions with a
date between May 2, 2019, 12:00 AM to May 2, 2019, 11:59 PM.More Examples:
- Last hour:[NOW/HOUR-1HOUR TO NOW/HOUR}
- Today:[NOW/DAY TO NOW/DAY+1DAY}
- Yesterday:[NOW/DAY-1DAY TO NOW/DAY}
- Past 7 days:[NOW/DAY-7DAYS TO NOW/DAY+1DAY}
- Month-to-Date:[NOW/MONTH TO NOW/DAY+1DAY}
- Past month:[NOW/MONTH-1MONTH TO NOW/MONTH}
- Past 6 months:[NOW/DAY-6MONTHS TO NOW/DAY+1DAY}
- Past 12 months:[NOW/DAY-12MONTHS TO NOW/DAY+1DAY]
- Past 13 months:[NOW/DAY-13MONTHS TO NOW/DAY+1DAY]