pyspark.sql.functions.minute

pyspark.sql.functions.minute(col)

Extract the minutes of a given timestamp as integer.

New in version 1.5.0.

Changed in version 3.4.0: Supports Spark Connect.

Changed in version 4.1.0: Added support for time type.

Parameters

colColumn or column name

target date/time/timestamp column to work on.

Returns

Column

minutes part of the timestamp as integer.

See also

pyspark.sql.functions.year()

pyspark.sql.functions.quarter()

pyspark.sql.functions.month()

pyspark.sql.functions.day()

pyspark.sql.functions.hour()

pyspark.sql.functions.second()

pyspark.sql.functions.extract()

pyspark.sql.functions.datepart()

pyspark.sql.functions.date_part()

Examples

Example 1: Extract the minutes from a string column representing timestamp

>>> from pyspark.sql import functions as sf
>>> df = spark.createDataFrame([('2015-04-08 13:08:15',), ('2024-10-31 10:09:16',)], ['ts'])
>>> df.select("*", sf.typeof('ts'), sf.minute('ts')).show()
+-------------------+----------+----------+
|                 ts|typeof(ts)|minute(ts)|
+-------------------+----------+----------+
|2015-04-08 13:08:15|    string|         8|
|2024-10-31 10:09:16|    string|         9|
+-------------------+----------+----------+

Example 2: Extract the minutes from a timestamp column

>>> import datetime
>>> from pyspark.sql import functions as sf
>>> df = spark.createDataFrame([
...     (datetime.datetime(2015, 4, 8, 13, 8, 15),),
...     (datetime.datetime(2024, 10, 31, 10, 9, 16),)], ['ts'])
>>> df.select("*", sf.typeof('ts'), sf.minute('ts')).show()
+-------------------+----------+----------+
|                 ts|typeof(ts)|minute(ts)|
+-------------------+----------+----------+
|2015-04-08 13:08:15| timestamp|         8|
|2024-10-31 10:09:16| timestamp|         9|
+-------------------+----------+----------+

Example 3: Extract the minutes from a time column

>>> import datetime
>>> from pyspark.sql import functions as sf
>>> df = spark.createDataFrame([
...     ("13:08:15",),
...     ("10:09:16",)], ['t']).withColumn("t", sf.col("t").cast("time"))
>>> df.select("*", sf.typeof('t'), sf.minute('t')).show()
+--------+---------+---------+
|       t|typeof(t)|minute(t)|
+--------+---------+---------+
|13:08:15|  time(6)|        8|
|10:09:16|  time(6)|        9|
+--------+---------+---------+