Adding Interval::roundTo method

Author: nyamsprod

CHANGELOG.md

@@ -14,6 +14,7 @@ All Notable changes to `bakame/tokei` will be documented in this file.
 - `IntervalSet::previous`
 - `IntervalSet::nearest`
 - `Interval::fromFormat`
+- `Interval::roundTo`
 - `Duration::fromDateInterval`
 - `Duration::fromFormat`
 - `Duration::format`

src/Interval.php

@@ -274,6 +274,13 @@ public function expand(Duration $duration): self
         return self::between($this->start->shift($duration->negated()), $this->end->shift($duration));
     }
 
+    public function roundTo(Unit $unit, SnapMode $mode = SnapMode::Nearest): self
+    {
+        $rounded = self::between($this->start->roundTo($unit, $mode), $this->end->roundTo($unit, $mode));
+
+        return $rounded->equals($this) ? $this : $rounded;
+    }
+
     /**
      * @throws InvalidDuration
      */

src/IntervalTest.php

@@ -987,4 +987,20 @@ public function test_fixing_split_at_overflow(): void
             $splits->allFormatted(IntervalFormat::Iso80000)
         );
     }
+
+    public function test_roundto_interval(): void
+    {
+        $interval = Interval::between(
+            Time::at(22, 13, 35),
+            Time::at(3, 42, 27)
+        );
+
+        self::assertSame($interval->roundTo(Unit::Second), $interval);
+
+        $updated = $interval->roundTo(Unit::Minute);
+        self::assertNotEquals($updated, $interval);
+
+        self::assertTrue($updated->start->equals(Time::at(22, 14)));
+        self::assertTrue($updated->end->equals(Time::at(3, 42)));
+    }
 }