Skip to main content
Log inGet a demo
Back to SQL Dictionary
Date functions

SQL DATEPART

What is SQL DATEPART?

The SQL DATEPART function is used to extract specific date and time components, such as the year, month, day, hour, minute, or second, from a datetime or timestamp value. It allows you to work with and manipulate individual date and time elements.

When You Would Use It

You would use the SQL DATEPART function when you need to extract and manipulate specific components of a datetime or timestamp column within your SQL queries. Common use cases include date-based filtering, sorting, grouping, or formatting.

Syntax

The syntax for the SQL DATEPART function varies depending on the database system, but here's a general representation:

DATEPART(datepart, date_expression)
  • datepart: The specific date or time component you want to extract (e.g., 'year', 'month', 'day', 'hour', 'minute', 'second').
  • date_expression: The datetime or timestamp value from which you want to extract the specified date or time component.

Parameter Values

  • datepart: A string that specifies the date or time component you want to extract, such as 'year', 'month', 'day', 'hour', 'minute', 'second', etc.
  • date_expression: A datetime or timestamp value from which you want to extract the specified date or time component. This can be a column from a table or a literal datetime value.

Example Query

Here's an example query using the SQL DATEPART function to extract the year, month, and day from a timestamp column:

SELECT
    DATEPART(year, OrderDate) AS OrderYear,
    DATEPART(month, OrderDate) AS OrderMonth,
    DATEPART(day, OrderDate) AS OrderDay
FROM Orders;

In this query, the DATEPART function is used to extract the year, month, and day from the "OrderDate" column in the "Orders" table.

Example Table Response

The result might look like this:

OrderYearOrderMonthOrderDay
20231019
20230915
20230820

These columns contain the extracted date parts from the "OrderDate" column.

Use Cases

The SQL DATEPART function is useful for a variety of tasks, including:

  1. Date-based filtering: Selecting records based on specific date or time criteria.
  2. Date-based grouping: Grouping records by year, month, day, or other date components.
  3. Calculating time differences: Calculating the duration between two date or time values.
  4. Formatting date values: Presenting dates and times in a human-readable format.

SQL Languages This Is Available For

The SQL DATEPART function or equivalent functions are available in various relational database management systems, but the naming and behavior can vary across systems. Here are some common examples:

  • SQL Server: DATEPART
  • MySQL: YEAR, MONTH, DAY, HOUR, MINUTE, SECOND
  • PostgreSQL: EXTRACT
  • SQLite: strftime
  • Oracle: EXTRACT
  • DB2: EXTRACT

The specific functions and implementation details can differ, so consult the documentation of your specific database system for precise information on using date and time functions.

Related

SQL CURTIME

SQL EXTRACT

SQL DATE_ADD

Ready to put your SQL knowledge to work?

Practice writing SQL to call data from the warehouse and sync it into Google Sheets in this 5 minute interactive demo.

Hightouch Audiences user interface.