Дата и время

Введение
Установка и настройка
- Требования
- Установка
- Настройка во время выполнения
- Типы ресурсов
Предопределённые константы
Примеры
- Арифметика даты/времени
DateTime — Класс DateTime
- DateTime::add — Изменяет объект DateTime, добавляя количество дней, месяцев, лет, часов, минут и секунд
- DateTime::__construct — Конструктор класса DateTime
- DateTime::createFromFormat — Разбирает строку с датой согласно указанному формату
- DateTime::createFromImmutable — Возвращает экземпляр DateTime инкапсулирующий заданный объект DateTimeImmutable
- DateTime::createFromInterface — Возвращает новый объект DateTime, созданный из переданного объекта, реализующего интерфейс DateTimeInterface
- DateTime::getLastErrors — Псевдоним DateTimeImmutable::getLastErrors
- DateTime::modify — Изменение временной метки
- DateTime::__set_state — Обработчик __set_state
- DateTime::setDate — Устанавливает дату
- DateTime::setISODate — Устанавливает дату в формате ISO
- DateTime::setTime — Устанавливает время
- DateTime::setTimestamp — Устанавливает дату и время на основе метки времени Unix
- DateTime::setTimezone — Устанавливает часовой пояс для объекта класса DateTime
- DateTime::sub — Вычитает дни, месяцы, годы, часы, минуты и секунды из объекта DateTime
DateTimeImmutable — Класс DateTimeImmutable
- DateTimeImmutable::add — Возвращает новый объект с добавленным количеством дней, месяцев, лет, часов, минут и секунд
- DateTimeImmutable::__construct — Возвращает новый объект DateTimeImmutable
- DateTimeImmutable::createFromFormat — Разбирает строку с датой согласно указанному формату
- DateTimeImmutable::createFromInterface — Возвращает новый объект DateTimeImmutable, созданный из переданного объекта, реализующего интерфейс DateTimeInterface
- DateTimeImmutable::createFromMutable — Возвращает новый экземпляр DateTimeImmutable, содержащий заданный объект DateTime
- DateTimeImmutable::getLastErrors — Возвращает предупреждения и ошибки
- DateTimeImmutable::modify — Создаёт новый объект с изменённой временной меткой
- DateTimeImmutable::__set_state — Обработчик __set_state
- DateTimeImmutable::setDate — Устанавливает дату
- DateTimeImmutable::setISODate — Устанавливает дату в формате ISO
- DateTimeImmutable::setTime — Устанавливает время
- DateTimeImmutable::setTimestamp — Устанавливает дату и время на основе метки времени Unix
- DateTimeImmutable::setTimezone — Устанавливает часовой пояс
- DateTimeImmutable::sub — Вычитает переданное количество дней, месяцев, лет, часов, минут и секунд
DateTimeInterface — Интерфейс DateTimeInterface
- DateTimeInterface::diff — Возвращает разницу между двумя объектами DateTime
- DateTimeInterface::format — Возвращает дату, отформатированную согласно переданному формату
- DateTimeInterface::getOffset — Возвращает смещение часового пояса
- DateTimeInterface::getTimestamp — Возвращает временную метку Unix
- DateTimeInterface::getTimezone — Возвращает часовой пояс относительно текущего значения DateTime
- DateTime::__wakeup — Обработчик __wakeup
DateTimeZone — Класс DateTimeZone
- DateTimeZone::__construct — Создаёт новый объект DateTimeZone
- DateTimeZone::getLocation — Возвращает информацию о местоположении для часового пояса
- DateTimeZone::getName — Возвращает имя часового пояса
- DateTimeZone::getOffset — Возвращает смещение часового пояса от UTC (GMT)
- DateTimeZone::getTransitions — Возвращает все переходы для часового пояса
- DateTimeZone::listAbbreviations — Возвращает ассоциативный массив, содержащий флаг перехода на летнее время, смещение и имя часового пояса
- DateTimeZone::listIdentifiers — Возвращает численно индексированный массив со всеми идентификаторами часовых поясов
DateInterval — Класс DateInterval
- DateInterval::__construct — Создаёт новый объект DateInterval
- DateInterval::createFromDateString — Создаёт объект класса DateInterval из даты в относительном формате
- DateInterval::format — Форматирует интервал
DatePeriod — Класс DatePeriod
- DatePeriod::__construct — Создаёт новый объект DatePeriod
- DatePeriod::createFromISO8601String — Создаёт новый объект DatePeriod из строки в формате стандарта ISO8601
- DatePeriod::getDateInterval — Возвращает интервал
- DatePeriod::getEndDate — Возвращает конечную дату периода
- DatePeriod::getRecurrences — Получает количество повторов
- DatePeriod::getStartDate — Возвращает начальную дату периода
Функции даты и времени
- checkdate — Проверяет корректность даты по григорианскому календарю
- date_add — Псевдоним DateTime::add
- date_create_from_format — Псевдоним DateTime::createFromFormat
- date_create_immutable_from_format — Псевдоним DateTimeImmutable::createFromFormat
- date_create_immutable — Создаёт новый объект DateTimeImmutable
- date_create — Создаёт новый объект DateTime
- date_date_set — Псевдоним DateTime::setDate
- date_default_timezone_get — Возвращает часовой пояс, используемый по умолчанию всеми функциями даты/времени в скрипте
- date_default_timezone_set — Устанавливает часовой пояс по умолчанию для всех функций даты/времени в скрипте
- date_diff — Псевдоним DateTime::diff
- date_format — Псевдоним DateTime::format
- date_get_last_errors — Псевдоним DateTimeImmutable::getLastErrors
- date_interval_create_from_date_string — Псевдоним DateInterval::createFromDateString
- date_interval_format — Псевдоним DateInterval::format
- date_isodate_set — Псевдоним DateTime::setISODate
- date_modify — Псевдоним DateTime::modify
- date_offset_get — Псевдоним DateTime::getOffset
- date_parse_from_format — Получение информации о заданной в определённом формате дате
- date_parse — Возвращает ассоциативный массив с подробной информацией о заданной дате/времени
- date_sub — Псевдоним DateTime::sub
- date_sun_info — Возвращает массив с информацией о закате/рассвете и начале/окончании сумерек
- date_sunrise — Возвращает время рассвета для заданных дня и местоположения
- date_sunset — Возвращает время захода солнца для заданных дня и местоположения
- date_time_set — Псевдоним DateTime::setTime
- date_timestamp_get — Псевдоним DateTime::getTimestamp
- date_timestamp_set — Псевдоним DateTime::setTimestamp
- date_timezone_get — Псевдоним DateTime::getTimezone
- date_timezone_set — Псевдоним DateTime::setTimezone
- date — Форматирует временную метку Unix
- getdate — Возвращает информацию о дате/времени
- gettimeofday — Возвращает текущее время
- gmdate — Форматирует дату/время по Гринвичу
- gmmktime — Возвращает локальную метку времени Unix для времени по Гринвичу
- gmstrftime — Форматирует дату/время по Гринвичу с учётом текущей локали
- idate — Преобразовывает локальное время/дату в целое число
- localtime — Возвращает локальное время
- microtime — Возвращает текущую метку времени Unix с микросекундами
- mktime — Возвращает метку времени Unix для заданной даты
- strftime — Форматирует текущую дату/время с учётом текущих настроек локали
- strptime — Разбирает строку даты/времени, сгенерированную функцией strftime
- strtotime — Преобразовывает текстовое представление даты на английском языке в метку времени Unix
- time — Возвращает текущую метку системного времени Unix
- timezone_abbreviations_list — Псевдоним DateTimeZone::listAbbreviations
- timezone_identifiers_list — Псевдоним DateTimeZone::listIdentifiers
- timezone_location_get — Псевдоним DateTimeZone::getLocation
- timezone_name_from_abbr — Возвращает название часового пояса, угадывая по аббревиатуре и смещению UTC
- timezone_name_get — Псевдоним DateTimeZone::getName
- timezone_offset_get — Псевдоним DateTimeZone::getOffset
- timezone_open — Псевдоним DateTimeZone::__construct
- timezone_transitions_get — Псевдоним DateTimeZone::getTransitions
- timezone_version_get — Получение номера версии базы данных часовых поясов
Date/Time Errors and Exceptions
Допустимые форматы даты/времени
Список поддерживаемых часовых поясов
- Африка
- Америка
- Антарктика
- Арктика
- Азия
- Атлантика
- Австралия
- Европа
- Индийский
- Тихоокеанский
- Другие
DateError — Класс DateError
DateObjectError — Класс DateObjectError
DateRangeError — Класс DateRangeError
DateException — Класс DateException
DateInvalidOperationException — Класс DateInvalidOperationException
DateInvalidTimeZoneException — Класс DateInvalidTimeZoneException
DateMalformedIntervalStringException — Класс DateMalformedIntervalStringException
DateMalformedPeriodStringException — Класс DateMalformedPeriodStringException
DateMalformedStringException — Класс DateMalformedStringException

User Contributed Notes 2 notes

down

14 years ago


I think it's important to mention with the DateTime class that if you're trying to create a system that should store UNIX timestamps in UTC/GMT, and then convert them to a desired custom time-zone when they need to be displayed, using the following code is a good idea:

<?php
date_default_timezone_set('UTC');
?>

Even if you use something like:

<?php
$date->setTimezone( new DateTimeZone('UTC') );
?>

... before you store the value, it doesn't seem to work because PHP is already trying to convert it to the default timezone.

down

theking2 at king dot ma ¶

2 years ago


If working with SQL databases it is important to realize that where DB normally reserve 0000-00-00 as a special value for indicating not valid date.

If this was converted in PHP, unexpected things happen. 

<?php

$s = "0000-00-00 00:00:00";
$d = \DateTime::createFromFormat('Y-m-d H:i:s',$s);
echo $d-> format("d.m.Y H:i:s");

// 30.11.-0001 00:00:00
?>

Available on https://3v4l.org/jnoIJ

add a note