日付形式

日付/タイムスタンプ/文字列を、2 番目の引数で指定された日付形式で指定された形式の文字列の値に変換します。

パターンは、たとえばdd.MM.yyyyとなり、「18.03.1993」のような文字列を返す可能性があります。日時パターンのすべてのパターン文字を使用できます。

注記

可能な場合は、 yearのような特殊な関数を使用してください。

対応する Databricks SQL 関数については、 date_format関数を参照してください。

構文

Python

from pyspark.databricks.sql import functions as dbf

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

パラメーター

パラメーター	Type	説明
date	pyspark.sql.Column または str	フォーマットする値の入力列。
format	literal string	日時値を表すために使用する形式。

戻り値

pyspark.sql.Column: フォーマットされた日時を表す文字列値。

例

Python

from pyspark.databricks.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()