Datum a čas

Nette\Utils\DateTime je třída, která rozšiřuje nativní DateTime o další funkce.

Oproti svému předchůdci je striktní. Zatímco PHP tiše akceptuje nesmyslná data jako 0000-00-00 (převede na -0001-11-30) nebo 2024-02-31 (převede na 2024-03-02), Nette\Utils\DateTime v takových případech vyhodí výjimku.

Zároveň opravuje chování při přechodu na letní/zimní čas, kdy v nativním PHP může přičtení relativního času (např. +100 minutes) vést k dřívějšímu výslednému času než přičtení kratšího úseku (např. +50 minutes). Nette zajišťuje, že aritmetika funguje intuitivně a +100 minutes je vždy více než +50 minutes.

Instalace:

composer require nette/utils

Všechny příklady předpokládají vytvořený alias:

use Nette\Utils\DateTime;

static from (string|int|\DateTimeInterface $time): DateTime

Vytvoří objekt DateTime z řetězce, UNIX timestamp nebo jiného objektu DateTimeInterface. Vyhodí výjimku Exception, pokud datum a čas není platný.

DateTime::from(1138013640); // vytvoří DateTime z UNIX timestamp s výchozí timezone
DateTime::from(42); // vytvoří DateTime z aktuálního času plus 42 sekund
DateTime::from('1994-02-26 04:15:32'); // vytvoří DateTime podle řetězce
DateTime::from('1994-02-26'); // vytvoří DateTime podle data, čas bude 00:00:00

static fromParts (int $year, int $month, int $day, int $hour=0, int $minute=0, float $second=0.0): DateTime

Vytvoří objekt DateTime nebo vyhodí výjimku Nette\InvalidArgumentException, pokud datum a čas není platný.

DateTime::fromParts(1994, 2, 26, 4, 15, 32);

static createFromFormat (string $format, string $time, ?string|\DateTimeZone $timezone=null): DateTime|false

Rozšiřuje DateTime::createFromFormat() o možnost zadat timezone jako řetězec.

DateTime::createFromFormat('d.m.Y', '26.02.1994', 'Europe/London');

static relativeToSeconds (string $str): int

Převede relativní časový údaj na sekundy. Hodí se pro převod časů jako 5 minutes nebo 2 hours na číselnou hodnotu.

DateTime::relativeToSeconds('1 minute'); // 60
DateTime::relativeToSeconds('10 minutes'); // 600
DateTime::relativeToSeconds('-1 hour'); // -3600

modifyClone (string $modify=''): static

Vytvoří kopii s upraveným časem.

$original = DateTime::from('2017-02-03');
$clone = $original->modifyClone('+1 day');
$original->format('Y-m-d'); // '2017-02-03'
$clone->format('Y-m-d');    // '2017-02-04'

__toString(): string

Vrací datum a čas ve formátu Y-m-d H:i:s.

echo $dateTime; // '2017-02-03 04:15:32'

implementuje JsonSerializable

Vrací datum a čas ve formátu ISO 8601, který je používán třeba v JavaScriptu.

$date = DateTime::from('2017-02-03');
echo json_encode($date);