Add isNotAfter

src/DateTime.php

@@ -112,6 +112,11 @@ public function isAfter(self $dateTime): bool
         return $this->dateTime > $dateTime->dateTime;
     }
 
+    public function isNotAfter(self $dateTime): bool
+    {
+        return $this->dateTime < $dateTime->dateTime;
+    }
+
     public function isAfterOrEqualTo(self $dateTime): bool
     {
         return $this->dateTime >= $dateTime->dateTime;

tests/DateTime/IsNotAfterTest.php

@@ -0,0 +1,86 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DigitalCraftsman\DateTimeParts\DateTime;
+
+use DigitalCraftsman\DateTimeParts\DateTime;
+use PHPUnit\Framework\TestCase;
+
+/** @coversDefaultClass \DigitalCraftsman\DateTimeParts\DateTime */
+final class IsNotAfterTest extends TestCase
+{
+    /**
+     * @test
+     *
+     * @dataProvider dataProvider
+     *
+     * @covers ::isNotAfter
+     */
+    public function is_not_after_works(
+        bool $expectedResult,
+        DateTime $dateTime,
+        DateTime $comparator,
+    ): void {
+        // -- Act & Assert
+        self::assertSame($expectedResult, $dateTime->isNotAfter($comparator));
+    }
+
+    /**
+     * @return array<string, array{
+     *   0: boolean,
+     *   1: DateTime,
+     *   2: DateTime,
+     * }>
+     */
+    public function dataProvider(): array
+    {
+        return [
+            'previous year' => [
+                false,
+                DateTime::fromString('2022-10-08 15:00:00'),
+                DateTime::fromString('2021-10-08 15:00:00'),
+            ],
+            'is equal' => [
+                false,
+                DateTime::fromString('2022-10-08 15:00:00'),
+                DateTime::fromString('2022-10-08 15:00:00'),
+            ],
+            'next year' => [
+                true,
+                DateTime::fromString('2022-10-08 15:00:00'),
+                DateTime::fromString('2023-10-08 15:00:00'),
+            ],
+            'next month' => [
+                true,
+                DateTime::fromString('2022-10-08 15:00:00'),
+                DateTime::fromString('2022-11-08 15:00:00'),
+            ],
+            'next day' => [
+                true,
+                DateTime::fromString('2022-10-08 15:00:00'),
+                DateTime::fromString('2022-10-09 15:00:00'),
+            ],
+            'next hour' => [
+                true,
+                DateTime::fromString('2022-10-08 15:00:00'),
+                DateTime::fromString('2022-10-08 16:00:00'),
+            ],
+            'next minute' => [
+                true,
+                DateTime::fromString('2022-10-08 15:00:00'),
+                DateTime::fromString('2022-10-08 15:01:00'),
+            ],
+            'next second' => [
+                true,
+                DateTime::fromString('2022-10-08 15:00:00'),
+                DateTime::fromString('2022-10-08 15:00:01'),
+            ],
+            'next millisecond' => [
+                true,
+                DateTime::fromString('2022-10-08 15:00:00'),
+                DateTime::fromString('2022-10-08 15:00:00.000001'),
+            ],
+        ];
+    }
+}