DateTime: strict setDate() & setTime()

Author: dg

src/Utils/DateTime.php

@@ -127,6 +127,20 @@ public static function validate(
 	}
 
 
+	public function setDate(int $year, int $month, int $day): static
+	{
+		self::validate($year, $month, $day);
+		return parent::setDate($year, $month, $day);
+	}
+
+
+	public function setTime(int $hour, int $minute, int $second = 0, int $microsecond = 0): static
+	{
+		self::validate(hour: $hour, minute: $minute, second: $second, microsecond: $microsecond);
+		return parent::setTime($hour, $minute, $second, $microsecond);
+	}
+
+
 	/**
 	 * Returns JSON representation in ISO 8601 (used by JavaScript).
 	 */

tests/Utils/DateTime.strict.phpt

@@ -0,0 +1,26 @@
+<?php
+
+/**
+ * Test: Nette\Utils\DateTime: strictness.
+ */
+
+declare(strict_types=1);
+
+use Nette\Utils\DateTime;
+use Tester\Assert;
+
+require __DIR__ . '/../bootstrap.php';
+
+
+Assert::exception(
+	fn() => (new DateTime)->setDate(1978, 2, 31),
+	Nette\InvalidArgumentException::class,
+	'The date 1978-02-31 is not valid.',
+);
+
+
+Assert::exception(
+	fn() => (new DateTime)->setTime(0, 60),
+	Nette\InvalidArgumentException::class,
+	'Minute value (60) is out of range.',
+);