On This Page

{#jumplink-list}  
[Markdown](/docs/cybs/en-us/txn-search/developer/all/rest/txn-search/txn-search-intro/txn-filtering/txn-search-filter-submitTimeUtc.md)  
Filter  
FILTER BY TAG

Filtering Using the submitTimeUtc Field {#txn-search-filter-submitTimeUtc}
==========================================================================

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:

* `DAY` or `DAYS`
* `MONTH` or `MONTHS`
* `MINUTE` or `MINUTES`

{#txn-search-filter-submitTimeUtc_ul_xhq_dbl_byb}  
**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]`
  {#txn-search-filter-submitTimeUtc_ul_owb_dbl_byb}  
  RELATED TO THIS PAGE