Data e Hora

Nette\Utils\DateTime é uma classe que estende a classe nativa DateTime com funções adicionais.

Instalação:

composer require nette/utils

Todos os exemplos pressupõem a criação de um alias:

use Nette\Utils\DateTime;

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

Cria um objeto DateTime a partir de uma string, timestamp UNIX ou outro objeto DateTimeInterface. Lança uma exceção Exception se a data e hora não forem válidas.

DateTime::from(1138013640); // cria DateTime a partir de timestamp UNIX com fuso horário padrão
DateTime::from(42); // cria DateTime a partir do tempo atual mais 42 segundos
DateTime::from('1994-02-26 04:15:32'); // cria DateTime de acordo com a string
DateTime::from('1994-02-26'); // cria DateTime de acordo com a data, a hora será 00:00:00

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

Cria um objeto DateTime ou lança uma exceção Nette\InvalidArgumentException se a data e hora não forem válidas.

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

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

Estende DateTime::createFromFormat() com a opção de especificar o fuso horário como uma string.

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

modifyClone (string $modify=''): static

Cria uma cópia com a hora modificada.

$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

Retorna a data e hora no formato Y-m-d H:i:s.

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

implementa JsonSerializable

Retorna a data e hora no formato ISO 8601, que é usado, por exemplo, em JavaScript.

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