​

Overview

The TIMESTAMP_TRUNC() function rounds a timestamp to a specific day_time granularity, resulting in a truncated timestamp.

​

Syntax

SELECT TIMESTAMP_TRUNC(TIMESTAMP 'YYYY-MM-DD hour:min:sec', day_time);

day_time can be replaced with various time values as follows:

• SECOND
• MINUTE
• HOUR
• DAY
• MONTH
• YEAR

​

Examples

​

Case #1: TIMESTAMP_TRUNC() - Hour

The following example shows how to round the hour to the closest value:

SELECT TIMESTAMP_TRUNC(TIMESTAMP '2017-09-18 14:43:39.02322', HOUR) ;

The final result will display the current date and time in your timezone:

+-----------------------------+
| f                           |
+-----------------------------+
| 2017-09-18 14:00:00.00000   |
+-----------------------------+

​

Case #2: TIMESTAMP_TRUNC() - Minute

Here we will truncate the specified timestamp into the nearest value:

SELECT TIMESTAMP_TRUNC(TIMESTAMP '2005-03-18 14:13:13', MINUTE) ;

The result will return the truncated timestamp as shown below:

+-----------------------------+
| f                           |
+-----------------------------+
| 2005-03-18 14:13:00.00000   |
+-----------------------------+

​

Case #3: Basic TIMESTAMP_TRUNC() function - Year

Run the following query to round the date to the closest value:

SELECT TIMESTAMP_TRUNC(TIMESTAMP '2023-03-04', YEAR);

The function will truncate the year and return the following result:

+-----------------------------+
| f                           |
+-----------------------------+
| 2023-01-01 00:00:00.00000   |
+-----------------------------+