doc-fr/reference/datetime/functions/strptime.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8a2141dcc084f72feb4e0ae2feaff3b440e5c59e Maintainer: jpauli Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="function.strptime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>strptime</refname>
  <refpurpose>
   Analyse une date générée par <function>strftime</function>
  </refpurpose>
 </refnamediv>

 <refsynopsisdiv>
  &warn.deprecated.function-8-1-0;
 </refsynopsisdiv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type class="union"><type>array</type><type>false</type></type><methodname>strptime</methodname>
   <methodparam><type>string</type><parameter>timestamp</parameter></methodparam>
   <methodparam><type>string</type><parameter>format</parameter></methodparam>
  </methodsynopsis>
  <para>
   <function>strptime</function> retourne un tableau après avoir
   analysé <parameter>timestamp</parameter>, ou &false; en cas d'erreur.
  </para>
  <para>
   Les noms des mois et jours de la semaine dépendent de la configuration
   locale, choisie avec <function>setlocale</function> 
   (<constant>LC_TIME</constant>).
  </para>
 </refsect1>
 
 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>timestamp</parameter> (&string;)</term>
     <listitem>
      <para>
       La chaîne à analyser (e.g. retournée par <function>strftime</function>)
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>format</parameter> (&string;)</term>
     <listitem>
      <para>
       Le format utilisé par <parameter>timestamp</parameter> (e.g. le
       même que celui qui a été utilisé par <function>strftime</function>).
      </para>
      <para>
       Pour plus d'informations sur les spécificateurs de formats, voyez
       la fonction <function>strftime</function>.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>
 
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Retourne un tableau&return.falseforfailure;.
  </para>
  
  <para>
   <table>
    <title>Les paramètres suivants sont retournés dans le tableau</title>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>Paramètres</entry>
       <entry>Description</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><literal>"tm_sec"</literal></entry>
       <entry>Secondes après la minute (0-61)</entry>
      </row>
      <row>
       <entry><literal>"tm_min"</literal></entry>
       <entry>Minutes après l'heure (0-59)</entry>
      </row>
      <row>
       <entry><literal>"tm_hour"</literal></entry>
       <entry>Heure depuis minuit (0-23)</entry>
      </row>
      <row>
       <entry><literal>"tm_mday"</literal></entry>
       <entry>Jour du mois (1-31)</entry>
      </row>
      <row>
       <entry><literal>"tm_mon"</literal></entry>
       <entry>Mois depuis janvier (0-11)</entry>
      </row>
      <row>
       <entry><literal>"tm_year"</literal></entry>
       <entry>Années depuis 1900</entry>
      </row>
      <row>
       <entry><literal>"tm_wday"</literal></entry>
       <entry>Jours depuis dimanche (0-6)</entry>
      </row>
      <row>
       <entry><literal>"tm_yday"</literal></entry>
       <entry>Jours depuis le 1er janvier (0-365)</entry>
      </row>
      <row>
       <entry><literal>"unparsed"</literal></entry>
       <entry>
        La partie de <parameter>timestamp</parameter> qui n'a pas été
        reconnue par l'analyseur avec le <parameter>format</parameter>
        spécifié.
       </entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
 </refsect1>

 <refsect1 role="changelog">
  &reftitle.changelog;
  <para>
   <informaltable>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>&Version;</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>8.1.0</entry>
       <entry>
        Cette fonction a été rendu obsolète.
        Utiliser <function>date_parse_from_format</function> à la place (pour de l'analyse indépendant à la locale),
        ou <methodname>IntlDateFormatter::parse</methodname> (pour de l'analyse dépendant à la locale)
       </entry>
      </row>
     </tbody>
    </tgroup>
   </informaltable>
  </para>
 </refsect1>
 
 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Exemple avec <function>strptime</function></title>
    <programlisting role="php">
<![CDATA[
<?php
$format = '%d/%m/%Y %H:%M:%S';
$strf = strftime($format);

echo "$strf\n";

print_r(strptime($strf, $format));
?>
]]>
    </programlisting>
    &example.outputs.similar;
    <screen>
<![CDATA[
03/10/2004 15:54:19

Array
(
    [tm_sec] => 19
    [tm_min] => 54
    [tm_hour] => 15
    [tm_mday] => 3
    [tm_mon] => 9
    [tm_year] => 104
    [tm_wday] => 0
    [tm_yday] => 276
    [unparsed] =>
)
]]>
    </screen>
   </example>
  </para>
 </refsect1>
 
 <refsect1 role="notes">
  &reftitle.notes;
  &note.no-windows;
  <note>
   <para>
    En interne, cette fonction appelle la fonction
    <literal>strptime()</literal> fournie par la bibliothèque système C.
    Cette fonction a des comportements bien différents suivants les systèmes
    d'exploitation. L'utilisation de la fonction <function>date_parse_from_format</function>,
    qui elle, ne souffre pas de ces défauts, est recommandée.
   </para>
  </note>
  <note>
   <para>
    <literal>"tm_sec"</literal> inclut toutes les secondes intercalaires
    (actuellement 2 par an). Pour plus d'informations sur les
    secondes intercalaires, reportez-vous à l'<link
    xlink:href="&url.wiki.leap-seconds;">article sur Wikipedia les concernant</link>.
   </para>
  </note>
 </refsect1>
 
 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>checkdate</function></member>
    <member><function>strftime</function></member>
    <member><function>date_parse_from_format</function></member>
    <member><function>DateTime::createFromFormat</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
-->