DateTime: added static method relativeToSeconds() for converting relative time string to seconds

Author: dg

src/Utils/DateTime.php

@@ -145,6 +145,16 @@ public function setTime(int $hour, int $minute, int $second = 0, int $microsecon
 	}
 
 
+	/**
+	 * Converts a relative time string (e.g. '10 minut') to seconds.
+	 */
+	public static function relativeToSeconds(string $relativeTime): int
+	{
+		$now = new \DateTimeImmutable('now', new \DateTimeZone('UTC'));
+		return $now->modify($relativeTime)->getTimestamp() - $now->getTimestamp();
+	}
+
+
 	/**
 	 * Returns JSON representation in ISO 8601 (used by JavaScript).
 	 */

tests/Utils/DateTime.relativeToSeconds.phpt

@@ -0,0 +1,27 @@
+<?php
+
+/**
+ * Test: Nette\Utils\DateTime::relativeToSeconds()
+ */
+
+declare(strict_types=1);
+
+use Nette\Utils\DateTime;
+use Tester\Assert;
+
+require __DIR__ . '/../bootstrap.php';
+
+date_default_timezone_set('Europe/Prague');
+
+
+test('relativeToSeconds basic usage', function () {
+	Assert::same(60, DateTime::relativeToSeconds('1 minute'));
+	Assert::same(600, DateTime::relativeToSeconds('10 minutes'));
+	Assert::same(-60, DateTime::relativeToSeconds('-1 minute'));
+	Assert::same(3600, DateTime::relativeToSeconds('+1 hour'));
+	Assert::same(0, DateTime::relativeToSeconds('now'));
+});
+
+test('relativeToSeconds throws on invalid', function () {
+	Assert::exception(fn() => DateTime::relativeToSeconds('nonsense'), Throwable::class);
+});