<?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 => 'zh',
  ),
  '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' => 'zh',
    '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">
   还提供了丰富的方法来修改和格式化这些信息，包括处理时区和 DST（夏令时）转换。
  </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 位数字存储的，所以支持所有可能有用的日期（包括负数年份）。其范围覆盖当前时间前后
   2920 亿年的时间。
  </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> — Returns new DateTime instance encapsulating the given DateTimeImmutable object</li><li><a href="datetime.createfrominterface.php">DateTime::createFromInterface</a> — Returns new DateTime object encapsulating the given DateTimeInterface object</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> — The DateTimeImmutable class<ul class="chunklist chunklist_book chunklist_children"><li><a href="datetimeimmutable.add.php">DateTimeImmutable::add</a> — Returns a new object, with added amount of days, months, years, hours, minutes and seconds</li><li><a href="datetimeimmutable.construct.php">DateTimeImmutable::__construct</a> — Returns new DateTimeImmutable object</li><li><a href="datetimeimmutable.createfromformat.php">DateTimeImmutable::createFromFormat</a> — Parses a time string according to a specified format</li><li><a href="datetimeimmutable.createfrominterface.php">DateTimeImmutable::createFromInterface</a> — Returns new DateTimeImmutable object encapsulating the given DateTimeInterface object</li><li><a href="datetimeimmutable.createfrommutable.php">DateTimeImmutable::createFromMutable</a> — Returns new DateTimeImmutable instance encapsulating the given DateTime object</li><li><a href="datetimeimmutable.getlasterrors.php">DateTimeImmutable::getLastErrors</a> — Returns the warnings and errors</li><li><a href="datetimeimmutable.modify.php">DateTimeImmutable::modify</a> — Creates a new object with modified timestamp</li><li><a href="datetimeimmutable.set-state.php">DateTimeImmutable::__set_state</a> — The __set_state handler</li><li><a href="datetimeimmutable.setdate.php">DateTimeImmutable::setDate</a> — Sets the date</li><li><a href="datetimeimmutable.setisodate.php">DateTimeImmutable::setISODate</a> — Sets the ISO date</li><li><a href="datetimeimmutable.settime.php">DateTimeImmutable::setTime</a> — Sets the time</li><li><a href="datetimeimmutable.settimestamp.php">DateTimeImmutable::setTimestamp</a> — Sets the date and time based on a Unix timestamp</li><li><a href="datetimeimmutable.settimezone.php">DateTimeImmutable::setTimezone</a> — Sets the time zone</li><li><a href="datetimeimmutable.sub.php">DateTimeImmutable::sub</a> — Subtracts an amount of days, months, years, hours, minutes and seconds</li></ul></li><li><a href="class.datetimeinterface.php">DateTimeInterface</a> — The DateTimeInterface interface<ul class="chunklist chunklist_book chunklist_children"><li><a href="datetime.diff.php">DateTimeInterface::diff</a> — 返回两个 DateTime 之间的差值</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> — 返回相对于指定 DateTime 的时区</li><li><a href="datetime.serialize.php">DateTime::__serialize</a> — Serialize a DateTime</li><li><a href="datetime.unserialize.php">DateTime::__unserialize</a> — Unserialize an Datetime</li><li><a href="datetime.wakeup.php">DateTime::__wakeup</a> — The __wakeup handler</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> — 返回相对于 GMT 的时差</li><li><a href="datetimezone.gettransitions.php">DateTimeZone::getTransitions</a> — Returns all transitions for the timezone</li><li><a href="datetimezone.listabbreviations.php">DateTimeZone::listAbbreviations</a> — 返回一个包含 dst (夏令时)，时差和时区信息的关联数组。</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> — Creates a new DateInterval object</li><li><a href="dateinterval.createfromdatestring.php">DateInterval::createFromDateString</a> — Sets up a DateInterval from the relative parts of the string</li><li><a href="dateinterval.format.php">DateInterval::format</a> — Formats the interval</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> — Creates a new DatePeriod object</li><li><a href="dateperiod.createfromiso8601string.php">DatePeriod::createFromISO8601String</a> — Creates a new DatePeriod object from an ISO8601 string</li><li><a href="dateperiod.getdateinterval.php">DatePeriod::getDateInterval</a> — Gets the interval</li><li><a href="dateperiod.getenddate.php">DatePeriod::getEndDate</a> — Gets the end date</li><li><a href="dateperiod.getrecurrences.php">DatePeriod::getRecurrences</a> — Gets the number of recurrences</li><li><a href="dateperiod.getstartdate.php">DatePeriod::getStartDate</a> — Gets the start date</li></ul></li><li><a href="ref.datetime.php">Date/Time 函数</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> — create a new DateTime object</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> — create a new DateTimeImmutable object</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> — Get info about given date formatted according to the specified format</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> — Returns an array with information about sunset/sunrise and twilight begin/end</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> — 格式化 GMT/UTC 日期／时间</li><li><a href="function.gmmktime.php">gmmktime</a> — 取得 GMT 日期的 UNIX 时间戳</li><li><a href="function.gmstrftime.php">gmstrftime</a> — 根据区域设置格式化 GMT/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> — Returns a timezone name by guessing from abbreviation and UTC offset</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> — 获取 timezonedb 版本</li></ul></li><li><a href="datetime.error.tree.php">日期/时间 Error 和 Exception</a></li><li><a href="datetime.formats.php">Supported Date and Time Formats</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> — The DateError class</li><li><a href="class.dateobjecterror.php">DateObjectError</a> — The DateObjectError class</li><li><a href="class.daterangeerror.php">DateRangeError</a> — The DateRangeError class</li><li><a href="class.dateexception.php">DateException</a> — The DateException class</li><li><a href="class.dateinvalidoperationexception.php">DateInvalidOperationException</a> — The DateInvalidOperationException class</li><li><a href="class.dateinvalidtimezoneexception.php">DateInvalidTimeZoneException</a> — The DateInvalidTimeZoneException class</li><li><a href="class.datemalformedintervalstringexception.php">DateMalformedIntervalStringException</a> — The DateMalformedIntervalStringException class</li><li><a href="class.datemalformedperiodstringexception.php">DateMalformedPeriodStringException</a> — The DateMalformedPeriodStringException class</li><li><a href="class.datemalformedstringexception.php">DateMalformedStringException</a> — The DateMalformedStringException class</li></ul></div><?php manual_footer($setup); ?>