Skip to main content

SQL DATEDIFF

“How long has it been since this customer last ordered with us?”
“What is the average number of days to conversion?”

Business users will have these questions, data people will have to answer these questions, and the only way to solve them is by calculating the time between two different dates. Luckily, there’s a handy DATEDIFF function that can do that for you.

The DATEDIFF function will return the difference in specified units (ex. days, weeks, years) between a start date/time and an end date/time. It’s a simple and widely used function that you’ll find yourself using more often than you expect.

DATEDIFF is a little bit like your favorite pair of socks; you’ll usually find the first one easily and feel like the day is going to be great. But for some reason, the matching sock requires a little digging in the drawer. DATEDIFF is this pair of socks—you’ll inevitably find yourself Googling the syntax almost every time you use it, but you can’t go through your day without using it.

This page will go over how to use the DATEDIFF function across different data warehouses and how to write more standardized DATEDIFF functions using a dbt macro (or successfully find your socks as a pair in one go).

How to use the DATEDIFF function​​

For the DATEDIFF function, there are three elements, or arguments, passed in:

  • The date part: This is the days/months/weeks/years (unit) of the difference calculated
  • The first (start) date/time
  • The second (end) date/time

The DATEDIFF function can be used in SELECT statements and WHERE clauses.

Most, if not all, modern cloud data warehouses support some type of the DATEDIFF function. There may be some minor differences between the argument order and function name for DATEDIFF across data warehouses, but the functionality very much remains the same.

Below, we’ll outline some of the slight differences in the implementation between some data warehouses.

SQL DATEDIFF function syntax in Snowflake, Databricks, and Redshift​

The syntax for using the DATEDIFF function in Snowflake and Amazon Redshift, and Databricks looks like the following:

datediff(<date part>, <start date/time>, <end date/time>)

A note on Databricks: Databricks additionally supports a separate DATEDIFF function that takes only two arguments: a start date and an end date. The function will always return the difference between two dates in days.

DATEDIFF in Google BigQuery​​

The syntax for using the DATEDIFF function in Google BigQuery looks like the following:

  • Unlike in Snowflake, Amazon Redshift, and Databricks where the <date part> is passed as the first argument, the <date part> is passed in as the last argument in Google BigQuery.
  • Google BigQuery also calls the function DATETIME_DIFF with an additional underscore separating the function name. This is on par with Google BigQuery’s preference to have underscores in function names.
  • The DATETIME_DIFF arguments are datetimes, not dates; Snowflake, Redshift, and Databricks’ DATEDIFF functions support multiple date types such as dates and timestamps. BigQuery also supports a separate DATE_DIFF function that will return the difference between two date types, unlike the DATETIME_DIFF that only supports the datetime type.

A hero in the shadows: The DATEDIFF dbt macro!​​

You may be able to memorize the syntax for the DATEDIFF function for the primary data warehouse you use. What happens when you switch to a different one for a new job or a new data stack? Remembering if there’s an underscore in the function name or which argument the <date part> is passed in as is… no fun and leads to the inevitable, countless “datediff in bigquery” Google searches.

Luckily, dbt-core has your back! dbt Core is the open source dbt product that helps data folks write their data transformations following software engineering best practices.

Adapters support cross-database macros to help you write certain functions, like DATE_TRUNC and DATEDIFF, without having to memorize sticky function syntax.

Using the DATEDIFF macro, you can calculate the difference between two dates without having to worry about finicky syntax. Specifically, this means you could successfully run the same code across multiple databases without having to worry about the finicky differences in syntax.

Using the jaffle shop, a simple dataset and dbt project, we can calculate the difference between two dates using the dbt DATEDIFF macro:

select
   *,
   {{ datediff("order_date", "'2022-06-09'", "day") }}
from {{ ref('orders') }}

This would return all fields from the orders table and the difference in days between order dates and June 9, 2022.

Under the hood, this macro is taking your inputs and creating the appropriate SQL syntax for the DATEDIFF function specific to your data warehouse.

0
Edit this page