Aller au contenu principal

date_format

Convertit une date/un timestamp/une chaîne de caractères en une valeur de chaîne de caractères au format spécifié par le format de date donné par le deuxième argument.

Un modèle pourrait être par exemple dd.MM.yyyy et pourrait renvoyer une chaîne comme '18.03.1993'. Toutes les lettres de motif du modèle de date/heure peuvent être utilisées.

remarque

Dans la mesure du possible, utilisez des fonctions spécialisées comme year.

Pour la fonction Databricks SQL correspondante, consultez la fonctiondate_format.

Syntaxe

Python
from pyspark.sql import functions as dbf

dbf.date_format(date=<date>, format=<format>)

parameter

parameter

Type

Description

date

pyspark.sql.Column OU str

colonne d'entrée de valeurs à formater.

format

literal string

format à utiliser pour représenter les valeurs de date et d'heure.

parameter

Type

Description

date

pyspark.sql.Column OU str

colonne d'entrée de valeurs à formater.

format

literal string

format à utiliser pour représenter les valeurs de date et d'heure.

Renvoie

pyspark.sql.Column: valeur de chaîne représentant une date et une heure formatées.

Exemples

Python
from pyspark.sql import functions as dbf
df = spark.createDataFrame([('2015-04-08',), ('2024-10-31',)], ['dt'])
df.select("*", dbf.typeof('dt'), dbf.date_format('dt', 'MM/dd/yyyy')).show()
df = spark.createDataFrame([('2015-04-08 13:08:15',), ('2024-10-31 10:09:16',)], ['ts'])
df.select("*", dbf.typeof('ts'), dbf.date_format('ts', 'yy=MM=dd HH=mm=ss')).show()
Python
import datetime
df = spark.createDataFrame([
(datetime.date(2015, 4, 8),),
(datetime.date(2024, 10, 31),)], ['dt'])
df.select("*", dbf.typeof('dt'), dbf.date_format('dt', 'yy--MM--dd')).show()
Python
import datetime
df = spark.createDataFrame([
(datetime.datetime(2015, 4, 8, 13, 8, 15),),
(datetime.datetime(2024, 10, 31, 10, 9, 16),)], ['ts'])
df.select("*", dbf.typeof('ts'), dbf.date_format('ts', 'yy=MM=dd HH=mm=ss')).show()