refactor(datetime): fix return type annotation and parameter order (#1767)

Author: xHeaven

packages/datetime/src/DateTimeInterface.php

@@ -228,7 +228,7 @@ public function getMonthEnum(): Month;
     /**
      * Returns the day.
      *
-     * @return int<0, 31>
+     * @return int<1, 31>
      */
     public function getDay(): int;
 

packages/datetime/src/Exception/UnexpectedValueException.php

@@ -117,8 +117,8 @@ public static function forSeconds(int $provided_seconds, int $calendar_seconds):
     {
         return new self(sprintf(
             'Unexpected seconds value encountered. Provided "%d", but the calendar expects "%d". Ensure the seconds are correct and within the 0-59 range.',
-            $calendar_seconds,
             $provided_seconds,
+            $calendar_seconds,
         ));
     }
 }

packages/datetime/tests/DateTimeTest.php

@@ -164,7 +164,7 @@ public static function provide_invalid_component_parts(): array
                 0,
             ],
             [
-                'Unexpected seconds value encountered. Provided "59", but the calendar expects "-1". Ensure the seconds are correct and within the 0-59 range.',
+                'Unexpected seconds value encountered. Provided "-1", but the calendar expects "59". Ensure the seconds are correct and within the 0-59 range.',
                 2024,
                 1,
                 1,