Nette Documentation Preview

syntax
Datum in čas
************

.[perex]
[api:Nette\Utils\DateTime] je razred, ki razširja izvorni [php:DateTime] z dodatnimi funkcijami.


Namestitev:

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

Vsi primeri predpostavljajo ustvarjen alias:

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


static from(string|int|\DateTimeInterface $time): DateTime .[method]
--------------------------------------------------------------------
Ustvari objekt `DateTime` iz niza, časovnega žiga UNIX ali drugega objekta [php:DateTimeInterface]. Sproži izjemo `Exception`, če datum in čas nista veljavna.

```php
DateTime::from(1138013640); // ustvari DateTime iz časovnega žiga UNIX s privzeto časovno cono
DateTime::from(42); // ustvari DateTime iz trenutnega časa plus 42 sekund
DateTime::from('1994-02-26 04:15:32'); // ustvari DateTime glede na niz
DateTime::from('1994-02-26'); // ustvari DateTime glede na datum, čas bo 00:00:00
```


static fromParts(int $year, int $month, int $day, int $hour=0, int $minute=0, float $second=0.0): DateTime .[method]
--------------------------------------------------------------------------------------------------------------------
Ustvari objekt `DateTime` ali sproži izjemo `Nette\InvalidArgumentException`, če datum in čas nista veljavna.
```php
DateTime::fromParts(1994, 2, 26, 4, 15, 32);
```


static createFromFormat(string $format, string $time, ?string|\DateTimeZone $timezone=null): DateTime|false .[method]
---------------------------------------------------------------------------------------------------------------------
Razširja [DateTime::createFromFormat() |https://www.php.net/manual/en/datetime.createfromformat.php] z možnostjo vnosa časovne cone kot niza.
```php
DateTime::createFromFormat('d.m.Y', '26.02.1994', 'Europe/London');
```


modifyClone(string $modify=''): static .[method]
------------------------------------------------
Ustvari kopijo s prilagojenim časom.
```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]
------------------------------
Vrne datum in čas v formatu `Y-m-d H:i:s`.
```php
echo $dateTime; // '2017-02-03 04:15:32'
```


Implementira `JsonSerializable`
-------------------------------
Vrne datum in čas v formatu ISO 8601, ki se uporablja na primer v JavaScriptu.
```php
$date = DateTime::from('2017-02-03');
echo json_encode($date);
```

Datum in čas

Nette\Utils\DateTime je razred, ki razširja izvorni DateTime z dodatnimi funkcijami.

Namestitev:

composer require nette/utils

Vsi primeri predpostavljajo ustvarjen alias:

use Nette\Utils\DateTime;

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

Ustvari objekt DateTime iz niza, časovnega žiga UNIX ali drugega objekta DateTimeInterface. Sproži izjemo Exception, če datum in čas nista veljavna.

DateTime::from(1138013640); // ustvari DateTime iz časovnega žiga UNIX s privzeto časovno cono
DateTime::from(42); // ustvari DateTime iz trenutnega časa plus 42 sekund
DateTime::from('1994-02-26 04:15:32'); // ustvari DateTime glede na niz
DateTime::from('1994-02-26'); // ustvari DateTime glede na datum, čas bo 00:00:00

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

Ustvari objekt DateTime ali sproži izjemo Nette\InvalidArgumentException, če datum in čas nista veljavna.

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

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

Razširja DateTime::createFromFormat() z možnostjo vnosa časovne cone kot niza.

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

modifyClone(string $modify='')static

Ustvari kopijo s prilagojenim časom.

$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

Vrne datum in čas v formatu Y-m-d H:i:s.

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

Implementira JsonSerializable

Vrne datum in čas v formatu ISO 8601, ki se uporablja na primer v JavaScriptu.

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