elasticsearch/docs/reference/esql/functions/date_trunc.asciidoc

[discrete]
[[esql-date_trunc]]
=== `DATE_TRUNC`
Rounds down a date to the closest interval. Intervals can be expressed using the
<<esql-timespan-literals,timespan literal syntax>>.

[source,esql]
----
FROM employees
| EVAL year_hired = DATE_TRUNC(1 year, hire_date)
| STATS count(emp_no) BY year_hired
| SORT year_hired
----
Restructure ES\|QL docs (#100806) * Break out 'Limitations' into separate page * Add REST API docs * Restructure commands, functions, and operators refs * Add placeholder for getting started guide * Group 'Syntax', 'Metafields', and 'MV fields' under 'Language' * Add placeholder for Kibana page * Add link from landing page * Apply uniform formatting to ACOS, CASE, and DATE_PARSE function refs * Reword default LIMIT * Add support for COUNT() Move 'Commands' and 'Functions and operators' to individual pages --------- Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com> 2023-10-17 23:36:14 +08:00			`[discrete]`
Move each function to its own file 2023-05-11 23:02:27 +08:00			`[[esql-date_trunc]]`
			=== `DATE_TRUNC`
			`Rounds down a date to the closest interval. Intervals can be expressed using the`
			`<<esql-timespan-literals,timespan literal syntax>>.`

			`[source,esql]`
			`----`
			`FROM employees`
ESQL: date_trunc(): swap order of arguments (#98624) Swap arguments order so that the range parameter is first and datetime one second, inline with other languages. 2023-08-23 00:20:05 +08:00			`\| EVAL year_hired = DATE_TRUNC(1 year, hire_date)`
Move each function to its own file 2023-05-11 23:02:27 +08:00			`\| STATS count(emp_no) BY year_hired`
			`\| SORT year_hired`
			`----`