<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/book.datetime.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'zh',
  ),
  'this' => 
  array (
    0 => 'datetime.constants.php',
    1 => '预定义常量',
    2 => '预定义常量',
  ),
  'up' => 
  array (
    0 => 'book.datetime.php',
    1 => '日期/时间',
  ),
  'prev' => 
  array (
    0 => 'datetime.configuration.php',
    1 => '运行时配置',
  ),
  'next' => 
  array (
    0 => 'datetime.examples.php',
    1 => '示例',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'zh',
    'path' => 'reference/datetime/constants.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="datetime.constants" class="appendix">
 <h1 class="title">预定义常量</h1>

 <p class="para">
  已定义的 <strong><code><a href="datetime.constants.php#constant.date-atom">DATE_<span class="replaceable">*</span></a></code></strong>
  常量提供了一些标准的日期时间的表达，可以用在日期时间格式化的函数中（例如 <span class="function"><a href="function.date.php" class="function">date()</a></span>）。
 </p>

 <dl>
  <strong class="title">
   <span class="function"><a href="function.date-sunrise.php" class="function">date_sunrise()</a></span> 和 <span class="function"><a href="function.date-sunset.php" class="function">date_sunset()</a></span>
   的有效 <code class="parameter">returnFormat</code>
  </strong>

  <div class="warning"><strong class="warning">警告</strong>
   <p class="simpara">
    自 PHP 8.4.0 起，已弃用这些常量。相应的 <span class="function"><a href="function.date-sunrise.php" class="function">date_sunrise()</a></span> 和
    <span class="function"><a href="function.date-sunset.php" class="function">date_sunset()</a></span> 函数自 PHP 8.1.0 起已弃用。
   </p>
  </div>

  
   <dt id="constant.sunfuncs-ret-timestamp">
    <strong><code><a href="datetime.constants.php#constant.sunfuncs-ret-timestamp">SUNFUNCS_RET_TIMESTAMP</a></code></strong>
    （<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>）
   </dt>
   <dd>
    <span class="simpara">
     时间戳
    </span>
   </dd>
  
  
   <dt id="constant.sunfuncs-ret-string">
    <strong><code><a href="datetime.constants.php#constant.sunfuncs-ret-string">SUNFUNCS_RET_STRING</a></code></strong>
    （<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>）
   </dt>
   <dd>
    <span class="simpara">
     小时:分钟（例如：<code class="literal">08:02</code>）
    </span>
   </dd>
  
  
   <dt id="constant.sunfuncs-ret-double">
    <strong><code><a href="datetime.constants.php#constant.sunfuncs-ret-double">SUNFUNCS_RET_DOUBLE</a></code></strong>
    （<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>）
   </dt>
   <dd>
    <span class="simpara">
     浮点数表示的小时（例如：<code class="literal">8.75</code>）
    </span>
   </dd>
  
 </dl>

 <dl>
  <strong class="title"><strong><code><a href="datetime.constants.php#constant.date-atom">DATE_<span class="replaceable">*</span></a></code></strong> constants</strong>
  
   <dt id="constant.date-atom">
    <strong><code><a href="datetime.constants.php#constant.date-atom">DATE_ATOM</a></code></strong>
    (<span class="type"><a href="language.types.string.php" class="type string">string</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     Atom（示例：<code class="literal">2005-08-15T15:52:01+00:00</code>）；兼容 ISO-8601、RFC 3339 和 XML Schema
    </span>
   </dd>
  

  
   <dt id="constant.date-cookie">
    <strong><code><a href="datetime.constants.php#constant.date-cookie">DATE_COOKIE</a></code></strong>
    (<span class="type"><a href="language.types.string.php" class="type string">string</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     HTTP Cookie（示例：<code class="literal">Monday, 15-Aug-2005 15:52:01 UTC</code>）
    </span>
   </dd>
  

  
   <dt id="constant.date-iso8601">
    <strong><code><a href="datetime.constants.php#constant.date-iso8601">DATE_ISO8601</a></code></strong>
    (<span class="type"><a href="language.types.string.php" class="type string">string</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     类似 ISO-8601 格式（示例：<code class="literal">2005-08-15T15:52:01+0000</code>）
    </span>
    <blockquote class="note"><p><strong class="note">注意</strong>: 
     <span class="simpara">
      此格式与 ISO-8601 不兼容，但出于向后兼容的原因，保留了这种格式。使用
      <strong><code><a href="datetime.constants.php#constant.date-iso8601-expanded">DATE_ISO8601_EXPANDED</a></code></strong>、<strong><code><a href="datetime.constants.php#constant.date-atom">DATE_ATOM</a></code></strong> 来兼容
      ISO-8601（参考 ISO8601:2004 第 4.3.3 节第 d 条）。
     </span>
    </p></blockquote>
   </dd>
  

  
   <dt id="constant.date-iso8601-expanded">
    <strong><code><a href="datetime.constants.php#constant.date-iso8601-expanded">DATE_ISO8601_EXPANDED</a></code></strong>
    (<span class="type"><a href="language.types.string.php" class="type string">string</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     ISO-8601 扩充（示例：<code class="literal">+10191-07-26T08:59:52+01:00</code>）
    </span>
    <blockquote class="note"><p><strong class="note">注意</strong>: 
     <span class="simpara">
      此格式允许使用 ISO-8601 正常范围（<code class="literal">0000</code>-<code class="literal">9999</code>）之外的年份范围，只需包含一个字符即可。还确保时区部分 (<code class="literal">+01:00</code>) 与
      ISO-8601 兼容。
     </span>
    </p></blockquote>
   </dd>
  

  
   <dt id="constant.date-rfc822">
    <strong><code><a href="datetime.constants.php#constant.date-rfc822">DATE_RFC822</a></code></strong>
    (<span class="type"><a href="language.types.string.php" class="type string">string</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     RFC 822（示例：<code class="literal">Mon, 15 Aug 05 15:52:01 +0000</code>）
    </span>
   </dd>
  

  
   <dt id="constant.date-rfc850">
    <strong><code><a href="datetime.constants.php#constant.date-rfc850">DATE_RFC850</a></code></strong>
    (<span class="type"><a href="language.types.string.php" class="type string">string</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     RFC 850（示例：<code class="literal">Monday, 15-Aug-05 15:52:01 UTC</code>）
    </span>
   </dd>
  

  
   <dt id="constant.date-rfc1036">
    <strong><code><a href="datetime.constants.php#constant.date-rfc1036">DATE_RFC1036</a></code></strong>
    (<span class="type"><a href="language.types.string.php" class="type string">string</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     RFC 1036（示例：<code class="literal">Mon, 15 Aug 05 15:52:01 +0000</code>）
    </span>
   </dd>
  

  
   <dt id="constant.date-rfc1123">
    <strong><code><a href="datetime.constants.php#constant.date-rfc1123">DATE_RFC1123</a></code></strong>
    (<span class="type"><a href="language.types.string.php" class="type string">string</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     RFC 1123（示例：<code class="literal">Mon, 15 Aug 2005 15:52:01 +0000</code>）
    </span>
   </dd>
  

  
   <dt id="constant.date-rfc7231">
    <strong><code><a href="datetime.constants.php#constant.date-rfc7231">DATE_RFC7231</a></code></strong>
    (<span class="type"><a href="language.types.string.php" class="type string">string</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     RFC 7231（自 PHP 7.0.19 和 7.1.5 起）（示例：<code class="literal">Sat, 30 Apr 2016 17:52:13 GMT</code>）
    </span>
   </dd>
  

  
   <dt id="constant.date-rfc2822">
    <strong><code><a href="datetime.constants.php#constant.date-rfc2822">DATE_RFC2822</a></code></strong>
    (<span class="type"><a href="language.types.string.php" class="type string">string</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     RFC 2822（示例：<code class="literal">Mon, 15 Aug 2005 15:52:01 +0000</code>）
    </span>
   </dd>
  

  
   <dt id="constant.date-rfc3339">
    <strong><code><a href="datetime.constants.php#constant.date-rfc3339">DATE_RFC3339</a></code></strong>
    (<span class="type"><a href="language.types.string.php" class="type string">string</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     与 <strong><code><a href="datetime.constants.php#constant.date-atom">DATE_ATOM</a></code></strong> 相同。
    </span>
   </dd>
  

  
   <dt id="constant.date-rfc3339-extended">
    <strong><code><a href="datetime.constants.php#constant.date-rfc3339-extended">DATE_RFC3339_EXTENDED</a></code></strong>
    (<span class="type"><a href="language.types.string.php" class="type string">string</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     RFC 3339 EXTENDED 格式（示例：<code class="literal">2005-08-15T15:52:01.000+00:00</code>）
    </span>
   </dd>
  

  
   <dt id="constant.date-rss">
    <strong><code><a href="datetime.constants.php#constant.date-rss">DATE_RSS</a></code></strong>
    (<span class="type"><a href="language.types.string.php" class="type string">string</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     RSS（示例：<code class="literal">Mon, 15 Aug 2005 15:52:01 +0000</code>）.
     别名 <strong><code><a href="datetime.constants.php#constant.date-rfc1123">DATE_RFC1123</a></code></strong>.
    </span>
   </dd>
  

  
   <dt id="constant.date-w3c">
    <strong><code><a href="datetime.constants.php#constant.date-w3c">DATE_W3C</a></code></strong>
    (<span class="type"><a href="language.types.string.php" class="type string">string</a></span>)
   </dt>
   <dd>
    <span class="simpara">
     万维网联盟（示例：<code class="literal">2005-08-15T15:52:01+00:00</code>）。别名 <strong><code><a href="datetime.constants.php#constant.date-rfc3339">DATE_RFC3339</a></code></strong>。
    </span>
   </dd>
  

 </dl>
</div>
<?php manual_footer($setup); ?>