Dátum és idő

Az Nette\Utils\DateTime egy osztály, amely kibővíti a natív DateTime osztályt további funkciókkal.

Telepítés:

composer require nette/utils

Minden példa feltételezi a következő alias létrehozását:

use Nette\Utils\DateTime;

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

DateTime objektumot hoz létre stringből, UNIX időbélyegből vagy egy másik DateTimeInterface objektumból. Exception kivételt dob, ha a dátum és idő érvénytelen.

DateTime::from(1138013640); // DateTime-ot hoz létre UNIX időbélyegből az alapértelmezett időzónával
DateTime::from(42); // DateTime-ot hoz létre az aktuális időből plusz 42 másodperccel
DateTime::from('1994-02-26 04:15:32'); // DateTime-ot hoz létre string alapján
DateTime::from('1994-02-26'); // DateTime-ot hoz létre dátum alapján, az idő 00:00:00 lesz

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

DateTime objektumot hoz létre, vagy Nette\InvalidArgumentException kivételt dob, ha a dátum és idő érvénytelen.

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

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

Kibővíti a DateTime::createFromFormat() funkciót azzal a lehetőséggel, hogy az időzónát stringként adjuk meg.

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

modifyClone (string $modify=''): static

Másolatot hoz létre módosított idővel.

$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

Visszaadja a dátumot és időt Y-m-d H:i:s formátumban.

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

implementálja a JsonSerializable-t

Visszaadja a dátumot és időt ISO 8601 formátumban, amit például JavaScriptben használnak.

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