DateTime::__construct
date_create
(PHP 5 >= 5.2.0)
DateTime::__construct -- date_create — Конструктор класса DateTime
Описание
Объектно-ориентированный стиль
Процедурный стиль
Создает и возвращает новый экземпляр класса DateTime.
Список параметров
-
time -
Строка даты/времени. Объяснение корректных форматов дано в Форматы даты и времени.
Если используется аргумент
$timezone, то для получения текущего времени в новом объекте достаточно передатьNULLв качестве этого аргумента. -
timezone -
Объект класса DateTimeZone представляющий временную зону параметра
$time.Если аргумент
$timezoneне задан, будет использована текущая временная зона.Замечание:
Значение аргумента
$timezoneравно как и текущая временная зона не будут учитываться, если в качестве аргумента$timeпередается метка времени UNIX (напрмер @946684800) или время, в котором временная зона уже содержится (например 2010-01-28T15:00:00+02:00).
Возвращаемые значения
Возвращает созданный объект класса DateTime.
Процедурный стиль возвращает FALSE в случае возникновения ошибки.
Ошибки
В случае ошибки выбрасывает исключение Exception.
Список изменений
| Версия | Описание |
|---|---|
| 5.3.0 |
В случае задания параметру time неверного
формата даты/времени
выбрасывается исключение. Раньше скрипт выдавал ошибку.
|
Примеры
Пример #1 Пример использования DateTime::__construct()
Объектно-ориентированный стиль
<?php
try {
$date = new DateTime('2000-01-01');
} catch (Exception $e) {
echo $e->getMessage();
exit(1);
}
echo $date->format('Y-m-d');
?>
Процедурный стиль
<?php
$date = date_create('2000-01-01');
if (!$date) {
$e = date_get_last_errors();
foreach ($e['errors'] as $error) {
echo "$error\n";
}
exit(1);
}
echo date_format($date, 'Y-m-d');
?>
Результат выполнения данных примеров:
2000-01-01
Пример #2 Хитрости при использовании DateTime::__construct()
<?php
// Дата/время во временной зоне Вашего компьютера.
$date = new DateTime('2000-01-01');
echo $date->format('Y-m-d H:i:sP') . "\n";
// Дата/время в заданной временной зоне.
$date = new DateTime('2000-01-01', new DateTimeZone('Pacific/Nauru'));
echo $date->format('Y-m-d H:i:sP') . "\n";
// Текущие дата и время во временной зоне Вашего компьютера.
$date = new DateTime();
echo $date->format('Y-m-d H:i:sP') . "\n";
// Текущие дата и время в заданной временной зоне.
$date = new DateTime(null, new DateTimeZone('Pacific/Nauru'));
echo $date->format('Y-m-d H:i:sP') . "\n";
// Использование метки времени UNIX.
// Обратите внимание: результат во временной зоне UTC.
$date = new DateTime('@946684800');
echo $date->format('Y-m-d H:i:sP') . "\n";
// Несуществующие значения все равно обрабатываются.
$date = new DateTime('2000-02-30');
echo $date->format('Y-m-d H:i:sP') . "\n";
?>
Результатом выполнения данного примера будет что-то подобное:
2000-01-01 00:00:00-05:00 2000-01-01 00:00:00+12:00 2010-04-24 10:24:16-04:00 2010-04-25 02:24:16+12:00 2000-01-01 00:00:00+00:00 2000-03-01 00:00:00-05:00
Смотрите также
- DateTime::createFromFormat() - Создает и возвращает экземпляр класса DateTime, соответствующий заданному формату
- DateTimeZone::__construct() - Создает новый объект DateTimeZone
- Форматы даты и времени
- date.timezone ini настройка
- date_default_timezone_set() - Устанавливает временную зону по умолчанию для всех функций даты/времени в скрипте
- DateTime::getLastErrors() - Возвращает предупреждения и ошибки
- checkdate() - Проверяет корректность даты по григорианскому календарю
- PHP Руководство
- Функции по категориям
- Индекс функций
- Справочник функций
- Расширения для работы с датой и временем
- Дата и Время
- DateTime::add
- Функция DateTime::__construct() - Конструктор класса DateTime
- Функция DateTime::createFromFormat() - Создает и возвращает экземпляр класса DateTime, соответствующий заданному формату
- Функция DateTime::getLastErrors() - Возвращает предупреждения и ошибки
- Функция DateTime::modify() - Изменение временной метки
- Функция DateTime::__set_state() - Обработчик __set_state
- Функция DateTime::setDate() - Установка даты
- Функция DateTime::setISODate() - Установка ISO даты
- Функция DateTime::setTime() - Установка времени
- Функция DateTime::setTimestamp() - Устанавливает дату и время, основываясь на метке времени Unix
- Функция DateTime::setTimezone() - Установка временной зоны для объекта класса DateTime
- DateTime::sub
Коментарии
it says the default parameter is 'now'.
but it also uses 'now' when you enter an empty string like '' despite it being a valid datetime format, expected an exception.