com doc/zh: add date_parse(): reference/datetime/func tions/date-parse.xml

Commit: 23f0240594dc3fdc566f903112a8dfd92a2c5924 Author: 蒋文健 <jwjbjg@gmail.com> Fri, 5 Feb 2021 17:11:49 +0800 Committer: daijie <daijie@php.net> Sun, 7 Feb 2021 17:34:40 +0800 Parents: 5888baafc7f7e4eb726c186cee04c0d1394aad73 Branches: master Link: http://git.php.net/?p=doc/zh.git;a=commitdiff;h=23f0240594dc3fdc566f903112a8dfd92a2c5924 Log: add date_parse() Changed paths: A reference/datetime/functions/date-parse.xml Diff: diff --git a/reference/datetime/functions/date-parse.xml b/reference/datetime/functions/date-parse.xml new file mode 100644 index 00000000..a344643f --- /dev/null +++ b/reference/datetime/functions/date-parse.xml @@ -0,0 +1,185 @@ +<?xml version="1.0" encoding="utf-8"?> + <!-- $Revision$ --> + <!-- EN-Revision: 34188f8256bdc6f0e6e1965c2be94247997165b6 Maintainer: Status: ready --> + <!-- Reviewed: no --> +<refentry xml:id="function.date-parse" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>date_parse</refname> + <refpurpose>返回指定日期/时间的详细信息的关联数组</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>date_parse</methodname> + <methodparam><type>string</type><parameter>datetime</parameter></methodparam> + </methodsynopsis> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>datetime</parameter></term> + <listitem> + <para> + Date/time 接受的格式以 <function>DateTimeImmutable::__construct</function> 为准。 + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + 成功时返回 <type>array</type>，数组中包含指定日期/时间的信息。&return.falseforfailure;. + </para> + </refsect1> + + <refsect1 role="errors"> + &reftitle.errors; + <para> + 如果 date/time 的格式有错误，则返回数组的 'errors' 键将包含错误信息。 + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>7.2.0</entry> + <entry> + 返回数组的 <literal>zone</literal> 键现在代表秒，而不是分钟。 + 并且正负符号已反转，例如：之前是 <literal>-120</literal> 现在是 <literal>7200</literal>。 + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>date_parse</function> 示例</title> + <programlisting role="php"> +<![CDATA[ +<?php +print_r(date_parse("2006-12-12 10:00:00.5")); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +Array +( + [year] => 2006 + [month] => 12 + [day] => 12 + [hour] => 10 + [minute] => 0 + [second] => 0 + [fraction] => 0.5 + [warning_count] => 0 + [warnings] => Array() + [error_count] => 0 + [errors] => Array() + [is_localtime] => +) +]]> + </screen> + </example> + </para> + <para> + 解析后返回的关联数组不受 <link linkend="datetime.formats.relative">相对格式</link> 影响，相对格式的信息会被解析到 "relative" 键。 + <example> + <title><function>date_parse</function> 使用相对格式</title> + <programlisting role="php"> +<![CDATA[ +<?php +print_r(date_parse("2006-12-12 10:00:00.5 +1 week +1 hour")); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +Array +( + [year] => 2006 + [month] => 12 + [day] => 12 + [hour] => 10 + [minute] => 0 + [second] => 0 + [fraction] => 0.5 + [warning_count] => 0 + [warnings] => Array + ( + ) + + [error_count] => 0 + [errors] => Array + ( + ) + + [is_localtime] => + [relative] => Array + ( + [year] => 0 + [month] => 0 + [day] => 7 + [hour] => 1 + [minute] => 0 + [second] => 0 + ) + +)]]> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>checkdate</function></member> + <member><function>getdate</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"~/.phpdoc/manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +-->