add duration minutes (#3219)

polars/polars-time/src/chunkedarray/duration.rs

@@ -13,14 +13,17 @@ pub trait DurationMethods {
     /// Extract the days from a `Duration`
     fn days(&self) -> Int64Chunked;
 
+    /// Extract the minutes from a `Duration`
+    fn minutes(&self) -> Int64Chunked;
+
+    /// Extract the seconds from a `Duration`
+    fn seconds(&self) -> Int64Chunked;
+
     /// Extract the milliseconds from a `Duration`
     fn milliseconds(&self) -> Int64Chunked;
 
     /// Extract the nanoseconds from a `Duration`
     fn nanoseconds(&self) -> Int64Chunked;
-
-    /// Extract the seconds from a `Duration`
-    fn seconds(&self) -> Int64Chunked;
 }
 
 impl DurationMethods for DurationChunked {
@@ -42,6 +45,24 @@ impl DurationMethods for DurationChunked {
         }
     }
 
+    /// Extract the seconds from a `Duration`
+    fn minutes(&self) -> Int64Chunked {
+        match self.time_unit() {
+            TimeUnit::Milliseconds => &self.0 / (MILLISECONDS * 60),
+            TimeUnit::Microseconds => &self.0 / (MICROSECONDS * 60),
+            TimeUnit::Nanoseconds => &self.0 / (NANOSECONDS * 60),
+        }
+    }
+
+    /// Extract the seconds from a `Duration`
+    fn seconds(&self) -> Int64Chunked {
+        match self.time_unit() {
+            TimeUnit::Milliseconds => &self.0 / MILLISECONDS,
+            TimeUnit::Microseconds => &self.0 / MICROSECONDS,
+            TimeUnit::Nanoseconds => &self.0 / NANOSECONDS,
+        }
+    }
+
     /// Extract the milliseconds from a `Duration`
     fn milliseconds(&self) -> Int64Chunked {
         match self.time_unit() {
@@ -59,13 +80,4 @@ impl DurationMethods for DurationChunked {
             TimeUnit::Nanoseconds => self.0.clone(),
         }
     }
-
-    /// Extract the seconds from a `Duration`
-    fn seconds(&self) -> Int64Chunked {
-        match self.time_unit() {
-            TimeUnit::Milliseconds => &self.0 / MILLISECONDS,
-            TimeUnit::Microseconds => &self.0 / MICROSECONDS,
-            TimeUnit::Nanoseconds => &self.0 / NANOSECONDS,
-        }
-    }
 }

py-polars/docs/source/reference/expression.rst

@@ -278,6 +278,7 @@ The following methods are available under the `expr.dt` attribute.
     ExprDateTimeNameSpace.cast_time_unit
     ExprDateTimeNameSpace.days
     ExprDateTimeNameSpace.hours
+    ExprDateTimeNameSpace.minutes
     ExprDateTimeNameSpace.seconds
     ExprDateTimeNameSpace.milliseconds
     ExprDateTimeNameSpace.nanoseconds

py-polars/docs/source/reference/series.rst

@@ -235,6 +235,7 @@ The following methods are available under the `Series.dt` attribute.
     DateTimeNameSpace.cast_time_unit
     DateTimeNameSpace.days
     DateTimeNameSpace.hours
+    DateTimeNameSpace.minutes
     DateTimeNameSpace.seconds
     DateTimeNameSpace.milliseconds
     DateTimeNameSpace.nanoseconds

py-polars/polars/internals/expr.py

@@ -4415,6 +4415,16 @@ def hours(self) -> Expr:
         """
         return wrap_expr(self._pyexpr.duration_hours())
 
+    def minutes(self) -> Expr:
+        """
+        Extract the minutes from a Duration type.
+
+        Returns
+        -------
+        A series of dtype Int64
+        """
+        return wrap_expr(self._pyexpr.duration_minutes())
+
     def seconds(self) -> Expr:
         """
         Extract the seconds from a Duration type.

py-polars/polars/internals/series.py

@@ -4896,6 +4896,16 @@ def hours(self) -> Series:
         """
         return pli.select(pli.lit(wrap_s(self._s)).dt.hours()).to_series()
 
+    def minutes(self) -> Series:
+        """
+        Extract the minutes from a Duration type.
+
+        Returns
+        -------
+        A series of dtype Int64
+        """
+        return pli.select(pli.lit(wrap_s(self._s)).dt.minutes()).to_series()
+
     def seconds(self) -> Series:
         """
         Extract the seconds from a Duration type.

py-polars/src/lazy/dsl.rs

@@ -683,6 +683,17 @@ impl PyExpr {
             )
             .into()
     }
+
+    pub fn duration_minutes(&self) -> PyExpr {
+        self.inner
+            .clone()
+            .map(
+                |s| Ok(s.duration()?.minutes().into_series()),
+                GetOutput::from_type(DataType::Int64),
+            )
+            .into()
+    }
+
     pub fn duration_seconds(&self) -> PyExpr {
         self.inner
             .clone()