DateTime: triggers a warning when time overflow occurs

The next version will throw an exception

Author: dg

src/Utils/DateTime.php

@@ -108,6 +108,43 @@ public static function createFromFormat(
 	}
 
 
+	public function __construct(string $datetime = 'now', ?\DateTimeZone $timezone = null)
+	{
+		parent::__construct($datetime, $timezone);
+		$this->handleErrors($datetime);
+	}
+
+
+	public function modify(string $modifier): static
+	{
+		parent::modify($modifier) && $this->handleErrors($modifier);
+		return $this;
+	}
+
+
+	public function setDate(int $year, int $month, int $day): static
+	{
+		if (!checkdate($month, $day, $year)) {
+			trigger_error(sprintf(self::class . ': The date %04d-%02d-%02d is not valid.', $year, $month, $day), E_USER_WARNING);
+		}
+		return parent::setDate($year, $month, $day);
+	}
+
+
+	public function setTime(int $hour, int $minute, int $second = 0, int $microsecond = 0): static
+	{
+		if (
+			$hour < 0 || $hour > 23
+			|| $minute < 0 || $minute > 59
+			|| $second < 0 || $second >= 60
+			|| $microsecond < 0 || $microsecond >= 1_000_000
+		) {
+			trigger_error(sprintf(self::class . ': The time %02d:%02d:%08.5F is not valid.', $hour, $minute, $second + $microsecond / 1_000_000), E_USER_WARNING);
+		}
+		return parent::setTime($hour, $minute, $second, $microsecond);
+	}
+
+
 	/**
 	 * Returns JSON representation in ISO 8601 (used by JavaScript).
 	 */
@@ -134,4 +171,14 @@ public function modifyClone(string $modify = ''): static
 		$dolly = clone $this;
 		return $modify ? $dolly->modify($modify) : $dolly;
 	}
+
+
+	private function handleErrors(string $value): void
+	{
+		$errors = self::getLastErrors();
+		$errors = array_merge($errors['errors'] ?? [], $errors['warnings'] ?? []);
+		if ($errors) {
+			trigger_error(self::class . ': ' . implode(', ', $errors) . " '$value'", E_USER_WARNING);
+		}
+	}
 }

tests/Utils/DateTime.construct.phpt

@@ -100,4 +100,22 @@ test('Exception handling for invalid input', function () {
 		Throwable::class,
 		'%a%invalid date format%a%',
 	);
+
+	Assert::error(
+		fn() => new DateTime('0000-00-00'),
+		E_USER_WARNING,
+		"Nette\\Utils\\DateTime: The parsed date was invalid '0000-00-00'",
+	);
+
+	Assert::error(
+		fn() => new DateTime('2024-02-31 10:00:00'), // Invalid day for February
+		E_USER_WARNING,
+		"Nette\\Utils\\DateTime: The parsed date was invalid '2024-02-31 10:00:00'",
+	);
+
+	Assert::error(
+		fn() => new DateTime('1978-01-23 23:00:60'),
+		E_USER_WARNING,
+		"Nette\\Utils\\DateTime: The parsed time was invalid '1978-01-23 23:00:60'",
+	);
 });

tests/Utils/DateTime.modify.phpt

@@ -112,4 +112,10 @@ test('Invalid modifier format exceptions', function () {
 			'DateTime::modify(): Failed to parse time string (+) at position 0 (+): Unexpected character',
 		);
 	}
+
+	Assert::error(
+		fn() => (new DateTime)->modify('2024-02-31 10:00:00'), // Invalid day for February
+		E_USER_WARNING,
+		"Nette\\Utils\\DateTime: The parsed date was invalid '2024-02-31 10:00:00'",
+	);
 });

tests/Utils/DateTime.setDateTime.phpt

@@ -0,0 +1,25 @@
+<?php
+
+/**
+ * Test: Nette\Utils\DateTime: strict.
+ */
+
+declare(strict_types=1);
+
+use Nette\Utils\DateTime;
+use Tester\Assert;
+
+require __DIR__ . '/../bootstrap.php';
+
+
+Assert::error(
+	fn() => (new DateTime)->setDate(1978, 2, 31),
+	E_USER_WARNING,
+	'Nette\Utils\DateTime: The date 1978-02-31 is not valid.',
+);
+
+Assert::error(
+	fn() => (new DateTime)->setTime(0, 60),
+	E_USER_WARNING,
+	'Nette\Utils\DateTime: The time 00:60:00.00000 is not valid.',
+);