DateTime: strict constructor, setDate(), setTime()

Author: dg

src/Utils/DateTime.php

@@ -127,6 +127,30 @@ public static function validate(
 	}
 
 
+	public function __construct(string $datetime = 'now', ?\DateTimeZone $timezone = null)
+	{
+		parent::__construct($datetime, $timezone);
+		$errors = self::getLastErrors();
+		if ($errors && $errors['warnings']) {
+			throw new Nette\InvalidArgumentException(Arrays::first($errors['warnings']) . " '$datetime'");
+		}
+	}
+
+
+	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,36 @@
+<?php
+
+/**
+ * Test: Nette\Utils\DateTime: strict.
+ */
+
+declare(strict_types=1);
+
+use Nette\Utils\DateTime;
+use Tester\Assert;
+
+require __DIR__ . '/../bootstrap.php';
+
+
+date_default_timezone_set('Europe/Prague');
+
+
+Assert::exception(
+	fn() => new DateTime('1978-02-31'),
+	Nette\InvalidArgumentException::class,
+	"The parsed date was invalid '1978-02-31'",
+);
+
+
+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.',
+);