PySpark date_format() - Convert Date to String format

The date_format() function in PySpark is a powerful tool for transforming, formatting date columns and converting date to string within a DataFrame. This function allows you to convert date and timestamp columns into a specified string format, providing flexibility for various date manipulation tasks.

Leveraging date_format(), you can customize the appearance of dates to match different formats required for reporting, visualization, or further data processing. It operates similarly to date formatting functions in SQL and other programming languages, making it a familiar and essential function for data engineers and analysts working with date and time data in PySpark.

<a id="h-pyspark-date-format-usage"></a>

PySpark date_format() Usage

To use date_format() in PySpark, first import the function from pyspark.sql.functions. This function is primarily used to format Date to String format. This function supports all Java Date formats specified in DateTimeFormatter.

Following are the Syntax and Example of date_format() Function:

# Syntax:  
date_format(column,format)

Example:

# Import
from pyspark.sql.functions import *

# Create DataFrame
df=spark.createDataFrame([["1"]],["id"])

# Using date_format()
df.select(current_date().alias("current_date"), \
      date_format(current_timestamp(),"yyyy MM dd").alias("yyyy MM dd"), \
      date_format(current_timestamp(),"MM/dd/yyyy hh:mm").alias("MM/dd/yyyy"), \
      date_format(current_timestamp(),"yyyy MMM dd").alias("yyyy MMMM dd"), \
      date_format(current_timestamp(),"yyyy MMMM dd E").alias("yyyy MMMM dd E") \
   ).show()

Explanation:

• current_date().alias("current_date"):
  • This gets the current date and assigns it to a column named current_date.
• date_format(current_timestamp(), "yyyy MM dd").alias("yyyy MM dd"):
  • This formats the current timestamp to "yyyy MM dd" (e.g., "2024 05 28") and assigns it to a column named yyyy MM dd.
• date_format(current_timestamp(), "MM/dd/yyyy hh:mm").alias("MM/dd/yyyy"):
  • This formats the current timestamp to "MM/dd/yyyy hh" (e.g., "05/28/2024 02:18") and assigns it to a column named MM/dd/yyyy.
• date_format(current_timestamp(), "yyyy MMM dd").alias("yyyy MMMM dd"):
  • This formats the current timestamp to "yyyy MMM dd" (e.g., "2024 May 28") and assigns it to a column named yyyy MMMM dd.
• date_format(current_timestamp(), "yyyy MMMM dd E").alias("yyyy MMMM dd E"):
  • This formats the current timestamp to "yyyy MMMM dd E" (e.g., "2024 May 28 Tue") and assigns it to a column named yyyy MMMM dd E.

# Output:
+------------+----------+----------------+------------+---------------+
|current_date|yyyy MM dd|      MM/dd/yyyy|yyyy MMMM dd| yyyy MMMM dd E|
+------------+----------+----------------+------------+---------------+
|  2024-05-28|2023 04 28|05/28/2024 02:18| 2024 May 28|2024 May 28 Tue|
+------------+----------+----------------+------------+---------------+

<a id="h-using-date-format-with-sql-query"></a>

Using date_format() with SQL Query

Alternatively, using the same functions, you can convert Data to String with SQL.

# SQL
spark.sql("select current_date() as current_date, "+
      "date_format(current_timestamp(),'yyyy MM dd') as yyyy_MM_dd, "+
      "date_format(current_timestamp(),'MM/dd/yyyy hh:mm') as MM_dd_yyyy, "+
      "date_format(current_timestamp(),'yyyy MMM dd') as yyyy_MMMM_dd, "+
      "date_format(current_timestamp(),'yyyy MMMM dd E') as yyyy_MMMM_dd_E").show()

<a id="h-complete-example-of-convert-date-to-string"></a>

Complete Example of Convert Date to String

from pyspark.sql import SparkSession

# Create SparkSession
spark = SparkSession.builder \
               .appName('AIStudyLabs.com') \
               .getOrCreate()

from pyspark.sql.functions import *

df=spark.createDataFrame([["1"]],["id"])
df.select(current_date().alias("current_date"), \
      date_format(current_date(),"yyyy MM dd").alias("yyyy MM dd"), \
      date_format(current_timestamp(),"MM/dd/yyyy hh:mm").alias("MM/dd/yyyy"), \
      date_format(current_timestamp(),"yyyy MMM dd").alias("yyyy MMMM dd"), \
      date_format(current_timestamp(),"yyyy MMMM dd E").alias("yyyy MMMM dd E") \
   ).show()

#SQL

spark.sql("select current_date() as current_date, "+
      "date_format(current_timestamp(),'yyyy MM dd') as yyyy_MM_dd, "+
      "date_format(current_timestamp(),'MM/dd/yyyy hh:mm') as MM_dd_yyyy, "+
      "date_format(current_timestamp(),'yyyy MMM dd') as yyyy_MMMM_dd, "+
      "date_format(current_timestamp(),'yyyy MMMM dd E') as yyyy_MMMM_dd_E").show()

<a id="h-conclusion"></a>

Conclusion:

In this article, you have learned how to convert Date to String format using the Date function date_format().

<a id="h-related-articles"></a>

Related Articles:

• PySpark – How to Get Current Date & Timestamp
• PySpark Convert String to Date Format
• PySpark SQL Date and Timestamp Functions
• Spark – How to get current date & timestamp
• PySpark to_date() – Convert Timestamp to Date
• Py Spark Add a New Column to Data Frame
• Py Spark – Create Data Frame with Examples
• Pyspark to_date() vs date_format()