add duration.hms() method

Author: apjanke

CHANGES.txt

@@ -4,7 +4,8 @@ Tablicious Changelog
 0.4.7 (unreleased)
 ------------------
 
-* (nothing here yet)
+* Date/time fixes
+  * Add duration.hms() method.
 
 0.4.6 (2026-02-16)
 ------------------

inst/@datetime/datetime.m

@@ -532,7 +532,9 @@
     ## @node datetime.hms
     ## @deftypefn {Method} {[@var{h}, @var{m}, @var{s}] =} hms (@var{obj})
     ##
-    ## Get the Hour, Minute, and Second components of a @var{obj}.
+    ## Get the Hour, Minute, and Second components of a @var{datetime}. These are the time
+    ## of day components. The Year, Month, and Day components are ignored, and not
+    ## incorporated in to the result.
     ##
     ## For zoned @code{datetime}s, these will be local times in the associated time zone.
     ##

inst/@duration/duration.m

@@ -252,6 +252,25 @@
       out = this.days * (24 * 60 * 60 * 1000);
     endfunction
 
+    ## -*- texinfo -*-
+    ## @node duration.hms
+    ## @deftypefn {Method} {[@var{h}, @var{m}, @var{s}] =} hms (@var{obj})
+    ##
+    ## Get the Hour, Minute, and Second values of a @var{duration}. These are
+    ## the hour, minute, and second values that when combined are equal to the
+    ## same duration value.
+    ##
+    ## Returns double arrays the same size as @code{obj}.
+    ##
+    ## @end deftypefn
+    function [h, m, s] = hms (this)
+      hours = this.days * 24;
+      h = fix(hours);
+      minutes = rem(hours, 1) * 60;
+      m = fix(minutes);
+      s = rem(minutes, 1) * 60;
+    endfunction
+
     function [keysA, keysB] = proxyKeys (a, b)
       #PROXYKEYS Proxy key values for sorting and set operations
       keysA = a.days(:);