<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/refs.calendar.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ru',
  ),
  'this' => 
  array (
    0 => 'book.datetime.php',
    1 => 'Дата и время',
    2 => 'Модуль работы с датой и временем',
  ),
  'up' => 
  array (
    0 => 'refs.calendar.php',
    1 => 'Модули для работы с датой и временем',
  ),
  'prev' => 
  array (
    0 => 'function.unixtojd.php',
    1 => 'unixtojd',
  ),
  'next' => 
  array (
    0 => 'datetime.setup.php',
    1 => 'Установка и настройка',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ru',
    'path' => 'reference/datetime/book.xml',
  ),
  'history' => 
  array (
  ),
  'extra_header_links' => 
  array (
    'rel' => 'alternate',
    'href' => '/manual/en/feeds/book.datetime.atom',
    'type' => 'application/atom+xml',
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="book.datetime" class="book">
 
 <h1 class="title">Модуль работы с датой и временем</h1>
 

 
 <div id="intro.datetime" class="preface">
  <h1 class="title">Введение</h1>
  <p class="para">
   Класс <span class="classname"><a href="class.datetimeimmutable.php" class="classname">DateTimeImmutable</a></span> и классы, которые с ним связаны,
   представляют информацию о дате и времени.
   Объекты даты и времени создают путём передачи строкового представления информации
   о дате и времени или на основе текущего времени системы.
  </p>
  <p class="para">
   Модуль содержит богатый набор методов изменения и форматирования информации о дате и времени,
   включая обработку часовых поясов и переходов на летнее время.
  </p>
  <p class="para">
   Функции даты и времени в PHP реализуют календарь по стандарту ISO 8601 —
   <a href="https://en.wikipedia.org/wiki/Proleptic_Gregorian_calendar" class="link external">&raquo;&nbsp;пролептический григорианский календарь</a>,
   который реализует текущие правила високосных дней, которые действовали до введения григорианского календаря,
   и включает год со значением <code class="literal">0</code> в качестве номера года между значениями
   <code class="literal">-1 до нашей эры</code> и <code class="literal">1 нашей эры</code>.
   Високосные секунды не поддерживаются.
  </p>
  <p class="para">
   Информация о дате и времени хранится в памяти в виде 64-разрядных чисел,
   поэтому поддерживается каждое пригодное представление даты, включая отрицательные годы.
   В диапазон дат входят значения от примерно 292 миллиардов лет в прошлом до такого же количества лет в будущем.
  </p>
  <blockquote class="note"><p><strong class="note">Замечание</strong>: 
   <span class="simpara">
    Часовые пояса, которые описывает раздел, приводит
    «<a href="timezones.php" class="xref">Список поддерживаемых часовых поясов</a>».
   </span>
  </p></blockquote>
 </div>
 

 






 





 






 





 





 





 





 





 






 







 

 





 












 





 





 





 





 





 





 





 





 






<ul class="chunklist chunklist_book"><li><a href="datetime.setup.php">Установка и настройка</a><ul class="chunklist chunklist_book chunklist_children"><li><a href="datetime.installation.php">Установка</a></li><li><a href="datetime.configuration.php">Настройка во время выполнения</a></li></ul></li><li><a href="datetime.constants.php">Предопределённые константы</a></li><li><a href="datetime.examples.php">Примеры</a><ul class="chunklist chunklist_book chunklist_children"><li><a href="datetime.examples-arithmetic.php">Арифметика даты/времени</a></li></ul></li><li><a href="class.datetime.php">DateTime</a> — Класс DateTime<ul class="chunklist chunklist_book chunklist_children"><li><a href="datetime.add.php">DateTime::add</a> — Изменяет объект DateTime, добавляя количество дней, месяцев, лет, часов, минут и секунд</li><li><a href="datetime.construct.php">DateTime::__construct</a> — Конструктор класса DateTime</li><li><a href="datetime.createfromformat.php">DateTime::createFromFormat</a> — Разбирает строку времени по заданному формату</li><li><a href="datetime.createfromimmutable.php">DateTime::createFromImmutable</a> — Создаёт новый объект DateTime на основе объекта DateTimeImmutable</li><li><a href="datetime.createfrominterface.php">DateTime::createFromInterface</a> — Создаёт новый объект DateTime на основе объекта, совместимого с интерфейсом DateTimeInterface</li><li><a href="datetime.getlasterrors.php">DateTime::getLastErrors</a> — Псевдоним DateTimeImmutable::getLastErrors</li><li><a href="datetime.modify.php">DateTime::modify</a> — Изменяет метку времени</li><li><a href="datetime.set-state.php">DateTime::__set_state</a> — Обработчик __set_state</li><li><a href="datetime.setdate.php">DateTime::setDate</a> — Устанавливает дату</li><li><a href="datetime.setisodate.php">DateTime::setISODate</a> — Устанавливает дату в формате ISO</li><li><a href="datetime.settime.php">DateTime::setTime</a> — Устанавливает время</li><li><a href="datetime.settimestamp.php">DateTime::setTimestamp</a> — Устанавливает дату и время на основе метки времени Unix</li><li><a href="datetime.settimezone.php">DateTime::setTimezone</a> — Устанавливает часовой пояс для объекта DateTime</li><li><a href="datetime.sub.php">DateTime::sub</a> — Вычитает дни, месяцы, годы, часы, минуты и секунды из объекта DateTime</li></ul></li><li><a href="class.datetimeimmutable.php">DateTimeImmutable</a> — Класс DateTimeImmutable<ul class="chunklist chunklist_book chunklist_children"><li><a href="datetimeimmutable.add.php">DateTimeImmutable::add</a> — Возвращает новый объект с добавленным количеством дней, месяцев, лет, часов, минут и секунд</li><li><a href="datetimeimmutable.construct.php">DateTimeImmutable::__construct</a> — Возвращает новый объект DateTimeImmutable</li><li><a href="datetimeimmutable.createfromformat.php">DateTimeImmutable::createFromFormat</a> — Разбирает строку времени по заданному формату</li><li><a href="datetimeimmutable.createfrominterface.php">DateTimeImmutable::createFromInterface</a> — Создаёт новый объект DateTimeImmutable на основе объекта, совместимого с интерфейсом DateTimeInterface</li><li><a href="datetimeimmutable.createfrommutable.php">DateTimeImmutable::createFromMutable</a> — Создаёт новый объект DateTimeImmutable на основе объекта DateTime</li><li><a href="datetimeimmutable.getlasterrors.php">DateTimeImmutable::getLastErrors</a> — Возвращает предупреждения и ошибки</li><li><a href="datetimeimmutable.modify.php">DateTimeImmutable::modify</a> — Создаёт новый объект с изменённой временной меткой</li><li><a href="datetimeimmutable.set-state.php">DateTimeImmutable::__set_state</a> — Обработчик метода __set_state</li><li><a href="datetimeimmutable.setdate.php">DateTimeImmutable::setDate</a> — Устанавливает дату</li><li><a href="datetimeimmutable.setisodate.php">DateTimeImmutable::setISODate</a> — Устанавливает дату в формате ISO</li><li><a href="datetimeimmutable.settime.php">DateTimeImmutable::setTime</a> — Устанавливает время</li><li><a href="datetimeimmutable.settimestamp.php">DateTimeImmutable::setTimestamp</a> — Устанавливает дату и время на основе метки времени Unix</li><li><a href="datetimeimmutable.settimezone.php">DateTimeImmutable::setTimezone</a> — Устанавливает часовой пояс</li><li><a href="datetimeimmutable.sub.php">DateTimeImmutable::sub</a> — Вычитает заданное количество дней, месяцев, лет, часов, минут и секунд</li></ul></li><li><a href="class.datetimeinterface.php">DateTimeInterface</a> — Интерфейс DateTimeInterface<ul class="chunklist chunklist_book chunklist_children"><li><a href="datetime.diff.php">DateTimeInterface::diff</a> — Возвращает разницу между двумя объектами даты и времени</li><li><a href="datetime.format.php">DateTimeInterface::format</a> — Форматирует дату в заданном формате</li><li><a href="datetime.getoffset.php">DateTimeInterface::getOffset</a> — Возвращает смещение часового пояса</li><li><a href="datetime.gettimestamp.php">DateTimeInterface::getTimestamp</a> — Возвращает метку времени с начала эпохи Unix</li><li><a href="datetime.gettimezone.php">DateTimeInterface::getTimezone</a> — Возвращает часовой пояс объекта даты и времени</li><li><a href="datetime.serialize.php">DateTime::__serialize</a> — Подготавливает данные объекта даты и времени для сериализации</li><li><a href="datetime.unserialize.php">DateTime::__unserialize</a> — Подготавливает данные для восстановления объекта даты и времени при десериализации</li><li><a href="datetime.wakeup.php">DateTime::__wakeup</a> — Обрабатывает событие __wakeup</li></ul></li><li><a href="class.datetimezone.php">DateTimeZone</a> — Класс DateTimeZone<ul class="chunklist chunklist_book chunklist_children"><li><a href="datetimezone.construct.php">DateTimeZone::__construct</a> — Создаёт новый объект DateTimeZone</li><li><a href="datetimezone.getlocation.php">DateTimeZone::getLocation</a> — Возвращает информацию о местоположении для часового пояса</li><li><a href="datetimezone.getname.php">DateTimeZone::getName</a> — Возвращает имя часового пояса</li><li><a href="datetimezone.getoffset.php">DateTimeZone::getOffset</a> — Возвращает смещение времени часового пояса относительно времени UTC</li><li><a href="datetimezone.gettransitions.php">DateTimeZone::getTransitions</a> — Возвращает информацию о переходах времени для часового пояса</li><li><a href="datetimezone.listabbreviations.php">DateTimeZone::listAbbreviations</a> — Возвращает ассоциативный массив с флагами перехода на летнее время, смещениями и названиями часовых поясов</li><li><a href="datetimezone.listidentifiers.php">DateTimeZone::listIdentifiers</a> — Возвращает индексный массив идентификаторов часовых поясов</li></ul></li><li><a href="class.dateinterval.php">DateInterval</a> — Класс DateInterval<ul class="chunklist chunklist_book chunklist_children"><li><a href="dateinterval.construct.php">DateInterval::__construct</a> — Создаёт новый объект DateInterval</li><li><a href="dateinterval.createfromdatestring.php">DateInterval::createFromDateString</a> — Создаёт объект класса DateInterval из даты в относительном формате</li><li><a href="dateinterval.format.php">DateInterval::format</a> — Форматирует интервал</li></ul></li><li><a href="class.dateperiod.php">DatePeriod</a> — Класс DatePeriod<ul class="chunklist chunklist_book chunklist_children"><li><a href="dateperiod.construct.php">DatePeriod::__construct</a> — Создаёт новый объект DatePeriod</li><li><a href="dateperiod.createfromiso8601string.php">DatePeriod::createFromISO8601String</a> — Создаёт новый объект DatePeriod из строки в формате стандарта ISO8601</li><li><a href="dateperiod.getdateinterval.php">DatePeriod::getDateInterval</a> — Возвращает временной интервал</li><li><a href="dateperiod.getenddate.php">DatePeriod::getEndDate</a> — Возвращает конечную дату периода</li><li><a href="dateperiod.getrecurrences.php">DatePeriod::getRecurrences</a> — Получает количество повторений</li><li><a href="dateperiod.getstartdate.php">DatePeriod::getStartDate</a> — Возвращает начальную дату периода</li></ul></li><li><a href="ref.datetime.php">Функции даты и времени</a><ul class="chunklist chunklist_book chunklist_children"><li><a href="function.checkdate.php">checkdate</a> — Проверяет корректность даты по григорианскому календарю</li><li><a href="function.date.php">date</a> — Форматирует метку времени эпохи Unix</li><li><a href="function.date-add.php">date_add</a> — Псевдоним DateTime::add</li><li><a href="function.date-create.php">date_create</a> — Создаёт новый объект DateTime</li><li><a href="function.date-create-from-format.php">date_create_from_format</a> — Псевдоним DateTime::createFromFormat</li><li><a href="function.date-create-immutable.php">date_create_immutable</a> — Создаёт новый объект DateTimeImmutable</li><li><a href="function.date-create-immutable-from-format.php">date_create_immutable_from_format</a> — Псевдоним DateTimeImmutable::createFromFormat</li><li><a href="function.date-date-set.php">date_date_set</a> — Псевдоним DateTime::setDate</li><li><a href="function.date-default-timezone-get.php">date_default_timezone_get</a> — Возвращает часовой пояс по умолчанию для функций работы с датой и временем
   в скрипте</li><li><a href="function.date-default-timezone-set.php">date_default_timezone_set</a> — Устанавливает часовой пояс по умолчанию для функций работы
   с датой и временем в скрипте</li><li><a href="function.date-diff.php">date_diff</a> — Псевдоним DateTime::diff</li><li><a href="function.date-format.php">date_format</a> — Псевдоним DateTime::format</li><li><a href="function.date-get-last-errors.php">date_get_last_errors</a> — Псевдоним DateTimeImmutable::getLastErrors</li><li><a href="function.date-interval-create-from-date-string.php">date_interval_create_from_date_string</a> — Псевдоним DateInterval::createFromDateString</li><li><a href="function.date-interval-format.php">date_interval_format</a> — Псевдоним DateInterval::format</li><li><a href="function.date-isodate-set.php">date_isodate_set</a> — Псевдоним DateTime::setISODate</li><li><a href="function.date-modify.php">date_modify</a> — Псевдоним DateTime::modify</li><li><a href="function.date-offset-get.php">date_offset_get</a> — Псевдоним DateTime::getOffset</li><li><a href="function.date-parse.php">date_parse</a> — Возвращает ассоциативный массив с подробной информацией о заданной дате/времени</li><li><a href="function.date-parse-from-format.php">date_parse_from_format</a> — Разбирает строку с датой по заданному формату</li><li><a href="function.date-sub.php">date_sub</a> — Псевдоним DateTime::sub</li><li><a href="function.date-sun-info.php">date_sun_info</a> — Возвращает массив с информацией о закате и восходе Солнца, и начале и окончании сумерек</li><li><a href="function.date-sunrise.php">date_sunrise</a> — Возвращает время рассвета для заданных дня и местоположения</li><li><a href="function.date-sunset.php">date_sunset</a> — Возвращает время захода солнца для заданных дня и расположения</li><li><a href="function.date-time-set.php">date_time_set</a> — Псевдоним DateTime::setTime</li><li><a href="function.date-timestamp-get.php">date_timestamp_get</a> — Псевдоним DateTime::getTimestamp</li><li><a href="function.date-timestamp-set.php">date_timestamp_set</a> — Псевдоним DateTime::setTimestamp</li><li><a href="function.date-timezone-get.php">date_timezone_get</a> — Псевдоним DateTime::getTimezone</li><li><a href="function.date-timezone-set.php">date_timezone_set</a> — Псевдоним DateTime::setTimezone</li><li><a href="function.getdate.php">getdate</a> — Возвращает информацию о дате и времени</li><li><a href="function.gettimeofday.php">gettimeofday</a> — Возвращает текущее время</li><li><a href="function.gmdate.php">gmdate</a> — Форматирует дату и время как время UTC</li><li><a href="function.gmmktime.php">gmmktime</a> — Получает метку Unix-времени для времени UTC</li><li><a href="function.gmstrftime.php">gmstrftime</a> — Форматирует дату и время как время UTC с учётом региональных настроек</li><li><a href="function.idate.php">idate</a> — Форматирует компонент даты или времени местного часового пояса как целое число</li><li><a href="function.localtime.php">localtime</a> — Получает местное время</li><li><a href="function.microtime.php">microtime</a> — Возвращает текущую метку времени Unix с микросекундами</li><li><a href="function.mktime.php">mktime</a> — Получает метку Unix-времени для даты</li><li><a href="function.strftime.php">strftime</a> — Форматирует местную дату и время с учётом региональных настроек</li><li><a href="function.strptime.php">strptime</a> — Разбирает строку даты и времени, которую сгенерировала функция strftime</li><li><a href="function.strtotime.php">strtotime</a> — Преобразовывает текстовое представление даты на английском языке в метку времени Unix</li><li><a href="function.time.php">time</a> — Возвращает метку времени Unix на основе текущего системного времени</li><li><a href="function.timezone-abbreviations-list.php">timezone_abbreviations_list</a> — Псевдоним DateTimeZone::listAbbreviations</li><li><a href="function.timezone-identifiers-list.php">timezone_identifiers_list</a> — Псевдоним DateTimeZone::listIdentifiers</li><li><a href="function.timezone-location-get.php">timezone_location_get</a> — Псевдоним DateTimeZone::getLocation</li><li><a href="function.timezone-name-from-abbr.php">timezone_name_from_abbr</a> — Возвращает название часового пояса, угадывая по аббревиатуре и смещению UTC</li><li><a href="function.timezone-name-get.php">timezone_name_get</a> — Псевдоним DateTimeZone::getName</li><li><a href="function.timezone-offset-get.php">timezone_offset_get</a> — Псевдоним DateTimeZone::getOffset</li><li><a href="function.timezone-open.php">timezone_open</a> — Псевдоним DateTimeZone::__construct</li><li><a href="function.timezone-transitions-get.php">timezone_transitions_get</a> — Псевдоним DateTimeZone::getTransitions</li><li><a href="function.timezone-version-get.php">timezone_version_get</a> — Получает номер версии базы данных часовых поясов</li></ul></li><li><a href="datetime.error.tree.php">Ошибки и исключения даты и времени</a></li><li><a href="datetime.formats.php">Допустимые форматы даты и времени</a></li><li><a href="timezones.php">Список поддерживаемых часовых поясов</a><ul class="chunklist chunklist_book chunklist_children"><li><a href="timezones.africa.php">Африка</a></li><li><a href="timezones.america.php">Америка</a></li><li><a href="timezones.antarctica.php">Антарктика</a></li><li><a href="timezones.arctic.php">Арктика</a></li><li><a href="timezones.asia.php">Азия</a></li><li><a href="timezones.atlantic.php">Атлантика</a></li><li><a href="timezones.australia.php">Австралия</a></li><li><a href="timezones.europe.php">Европа</a></li><li><a href="timezones.indian.php">Индийский</a></li><li><a href="timezones.pacific.php">Тихоокеанский</a></li><li><a href="timezones.others.php">Другие</a></li></ul></li><li><a href="class.dateerror.php">DateError</a> — Ошибка DateError</li><li><a href="class.dateobjecterror.php">DateObjectError</a> — Ошибка DateObjectError</li><li><a href="class.daterangeerror.php">DateRangeError</a> — Ошибка DateRangeError</li><li><a href="class.dateexception.php">DateException</a> — Класс DateException</li><li><a href="class.dateinvalidoperationexception.php">DateInvalidOperationException</a> — Класс DateInvalidOperationException</li><li><a href="class.dateinvalidtimezoneexception.php">DateInvalidTimeZoneException</a> — Класс DateInvalidTimeZoneException</li><li><a href="class.datemalformedintervalstringexception.php">DateMalformedIntervalStringException</a> — Класс DateMalformedIntervalStringException</li><li><a href="class.datemalformedperiodstringexception.php">DateMalformedPeriodStringException</a> — Класс DateMalformedPeriodStringException</li><li><a href="class.datemalformedstringexception.php">DateMalformedStringException</a> — Класс DateMalformedStringException</li></ul></div><?php manual_footer($setup); ?>