<?php /** * This file is part of the Nette Framework (https://nette.org) * Copyright (c) 2004 David Grudl (https://davidgrudl.com) */ declare(strict_types=1); namespace Nette\Utils; use Nette; /** * DateTime. */ class DateTime extends \DateTime implements \JsonSerializable { use Nette\SmartObject; /** minute in seconds */ public const MINUTE = 60; /** hour in seconds */ public const HOUR = 60 * self::MINUTE; /** day in seconds */ public const DAY = 24 * self::HOUR; /** week in seconds */ public const WEEK = 7 * self::DAY; /** average month in seconds */ public const MONTH = 2_629_800; /** average year in seconds */ public const YEAR = 31_557_600; /** * Creates a DateTime object from a string, UNIX timestamp, or other DateTimeInterface object. * @throws \Exception if the date and time are not valid. */ public static function from(string|int|\DateTimeInterface|null $time): static { if ($time instanceof \DateTimeInterface) { return new static($time->format('Y-m-d H:i:s.u'), $time->getTimezone()); } elseif (is_numeric($time)) { if ($time <= self::YEAR) { $time += time(); } return (new static('@' . $time))->setTimezone(new \DateTimeZone(date_default_timezone_get())); } else { // textual or null return new static((string) $time); } } /** * Creates DateTime object. * @throws Nette\InvalidArgumentException if the date and time are not valid. */ public static function fromParts( int $year, int $month, int $day, int $hour = 0, int $minute = 0, float $second = 0.0, ): static { $s = sprintf('%04d-%02d-%02d %02d:%02d:%02.5F', $year, $month, $day, $hour, $minute, $second); if ( !checkdate($month, $day, $year) || $hour < 0 || $hour > 23 || $minute < 0 || $minute > 59 || $second < 0 || $second >= 60 ) { throw new Nette\InvalidArgumentException("Invalid date '$s'"); } return new static($s); } /** * Returns new DateTime object formatted according to the specified format. */ public static function createFromFormat( string $format, string $time, string|\DateTimeZone|null $timezone = null, ): static|false { if ($timezone === null) { $timezone = new \DateTimeZone(date_default_timezone_get()); } elseif (is_string($timezone)) { $timezone = new \DateTimeZone($timezone); } $date = parent::createFromFormat($format, $time, $timezone); return $date ? static::from($date) : false; } /** * Returns JSON representation in ISO 8601 (used by JavaScript). */ public function jsonSerialize(): string { return $this->format('c'); } /** * Returns the date and time in the format 'Y-m-d H:i:s'. */ public function __toString(): string { return $this->format('Y-m-d H:i:s'); } /** * Creates a copy with a modified time. */ public function modifyClone(string $modify = ''): static { $dolly = clone $this; return $modify ? $dolly->modify($modify) : $dolly; } }
Name | Type | Size | Permission | Actions |
---|---|---|---|---|
ArrayHash.php | File | 1.78 KB | 0644 |
|
ArrayList.php | File | 2.54 KB | 0644 |
|
Arrays.php | File | 10.53 KB | 0644 |
|
Callback.php | File | 3.45 KB | 0644 |
|
DateTime.php | File | 2.89 KB | 0644 |
|
FileInfo.php | File | 1.26 KB | 0644 |
|
FileSystem.php | File | 9.09 KB | 0644 |
|
Finder.php | File | 12.81 KB | 0644 |
|
Floats.php | File | 2.07 KB | 0644 |
|
Helpers.php | File | 2.5 KB | 0644 |
|
Html.php | File | 19.02 KB | 0644 |
|
Image.php | File | 21.27 KB | 0644 |
|
Json.php | File | 2.22 KB | 0644 |
|
ObjectHelpers.php | File | 6.85 KB | 0644 |
|
Paginator.php | File | 4.04 KB | 0644 |
|
Random.php | File | 1.07 KB | 0644 |
|
Reflection.php | File | 8.35 KB | 0644 |
|
Strings.php | File | 21.45 KB | 0644 |
|
Type.php | File | 6.2 KB | 0644 |
|
Validators.php | File | 10.08 KB | 0644 |
|
exceptions.php | File | 775 B | 0644 |
|