Data și ora
***********

.[perex]
[api:Nette\Utils\DateTime] este o clasă care extinde clasa nativă [php:DateTime].


Instalare:

```shell
composer require nette/utils
```

Toate exemplele presupun că este definit următorul alias de clasă:

```php
use Nette\Utils\DateTime;
```


static from(string|int|\DateTimeInterface $time): DateTime .[method]
--------------------------------------------------------------------
Creează un obiect DateTime dintr-un șir de caractere, un timestamp UNIX sau un alt obiect [php:DateTimeInterface]. Lansează un mesaj `Exception` dacă data și ora nu sunt valide.

```php
DateTime::from(1138013640); // creează un DateTime din timestamp-ul UNIX cu un timezamp implicit.
DateTime::from(42); // creează un DateTime din ora curentă plus 42 de secunde
DateTime::from('1994-02-26 04:15:32'); // creează un DateTime pe baza unui șir de caractere
DateTime::from('1994-02-26'); // creează un DateTime în funcție de dată, ora va fi 00:00:00:00
```


static fromParts(int $year, int $month, int $day, int $hour=0, int $minute=0, float $second=0.0): DateTime .[method]
--------------------------------------------------------------------------------------------------------------------
Creează un obiect DateTime sau aruncă o excepție `Nette\InvalidArgumentException` dacă data și ora nu sunt valide.
```php
DateTime::fromParts(1994, 2, 26, 4, 15, 32);
```


static createFromFormat(string $format, string $time, string|\DateTimeZone $timezone=null): DateTime|false .[method]
--------------------------------------------------------------------------------------------------------------------
Extinde [DateTime::createFromFormat() |https://www.php.net/manual/en/datetime.createfromformat.php] cu posibilitatea de a specifica un fus orar sub forma unui șir de caractere.
```php
DateTime::createFromFormat('d.m.Y', '26.02.1994', 'Europe/London'); // creați cu un fus orar personalizat
```


modifyClone(string $modify=''): static .[method]
------------------------------------------------
Creează o copie cu o oră modificată.
```php
$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 .[method]
------------------------------
Returnează data și ora în formatul `Y-m-d H:i:s`.
```php
echo $dateTime; // '2017-02-03 04:15:32'
```


Implementează JsonSerializable .[#toc-implements-jsonserializable]
------------------------------------------------------------------
Returnează data și ora în formatul ISO 8601, care este utilizat în JavaScript, de exemplu.
```php
$date = DateTime::from('2017-02-03');
echo json_encode($date);
```