[PHP-DOC] cvs: phpdoc-es /reference/datetime/functions localtime.xml strtotime.xml

[Rafael Martinez]

rafael          Thu Jun  6 17:57:31 2002 EDT

  Added files:                 
    /phpdoc-es/reference/datetime/functions     localtime.xml strtotime.xml 
  Log:
  Translation updated to PHP 4.x
  
  

Index: phpdoc-es/reference/datetime/functions/localtime.xml
+++ phpdoc-es/reference/datetime/functions/localtime.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.2 Maintainer: victorf Status: ready -->
  <refentry id="function.localtime">
   <refnamediv>
    <refname>localtime</refname>
    <refpurpose>Obtener la hora local</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
      <type>array</type><methodname>localtime</methodname>
      <methodparam choice="opt"><type>int</type><parameter>
        muestra_de_tiempo
       </parameter></methodparam>
      <methodparam choice="opt"><type>bool</type><parameter>
        es_asociativo
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     La funci&oacute;n <function>localtime</function> devuelve un
         vector id&eacute;tico al de la estructura devuelta en C por
         la llamada a la misma funci&oacute;n. El primer par&aacute;metro
     que se le pasa a <function>localtime</function> es 
     el timestamp, una representaci&oacute; de una fecha/hora concretas.
         Si no se proporciona, se utilizar&aacute; la hora actual.
     El segundo argumento de <function>localtime</function> es
     <parameter>es_asociativo</parameter>. Si est&aacute; a 0 o no
         es proporcionado, el vector se devuelve como un vector normal,
         indizado num&eacute;ricamente. Si el argumento est&aacute; a 1,
     el vector devuelto es un vector asociativo conteniendo los diferentes
     elementos de la estructura devuelta por C al llamar a la
         funci&oacute;n localtime. Los nombres de las diferentes claves del
         vector asociativo se encuentran a continuaci&oacute;n:
     <itemizedlist>
      <listitem>
       <simpara>
        "tm_sec" - segundos
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        "tm_min" - minutos
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        "tm_hour" - horas
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        "tm_mday" - d&iacute;a del mes
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        "tm_mon" - mes del a&ntilde;o, empezando en 0 que es Enero
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        "tm_year" - A&ntilde;os que hacen desde 1900
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        "tm_wday" - D&iacute;a de la semana
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        "tm_yday" - D&iacute;a del a&ntilde;o
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        "tm_isdst" - Si el cambio de hora para el ahorro energ&eacute;tico tiene 
efecto o no
       </simpara>
      </listitem>
     </itemizedlist>
    </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:"../../../../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
-->

Index: phpdoc-es/reference/datetime/functions/strtotime.xml
+++ phpdoc-es/reference/datetime/functions/strtotime.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.2 Maintainer: victorf Status: ready -->
  <refentry id="function.strtotime">
   <refnamediv>
    <refname>strtotime</refname>
    <refpurpose>
     Procesar cualquier descripci&oacute;n textual de fecha/hora en Ingl&eacute;s
         convirti&eacute;ndola en una timestamp de UNIX.
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
      <type>int</type><methodname>strtotime</methodname>
      <methodparam><type>string</type><parameter>hora</parameter></methodparam>
      <methodparam 
choice="opt"><type>int</type><parameter>ahora</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     La funci&oacute;n espera que se le pase una cadena conteniendo una fecha
         en formato Ingl&eacute;s e intentar&aacute; procesarla y convertirla a
         una timestamp (muestra de tiempo) de UNIX relativa a la timestamp
         proporcionada en <parameter>ahora</parameter>, o la hora actual si no se
         indica ninguna. Si falla, devolver&aacute; <literal>-1</literal>.
    </simpara>
    <simpara>
     Dado que <function>strtotime</function> obra de acuerdo con la sintaxis
         de fechas de GNU, puede echar un vistazo a la p&aacute;gina del manual
         GNU titulada
     <ulink url="&url.gnu.man.date-input;">Date Input Formats</ulink> (Formatos
         de entrada de fechas).
     La sintaxis descrita ah&iacute; es v&aacute;lida para el par&aacute;tro
         <parameter>hora</parameter>.
    </simpara>
    <para>
     <example>
      <title>Ejemplos con <function>strtotime</function></title>
      <programlisting role="php">
<![CDATA[
echo strtotime ("now"), "\n";
echo strtotime ("10 September 2000"), "\n";
echo strtotime ("+1 day"), "\n";
echo strtotime ("+1 week"), "\n";
echo strtotime ("+1 week 2 days 4 hours 2 seconds"), "\n";
echo strtotime ("next Thursday"), "\n";
echo strtotime ("last Monday"), "\n";
]]>
      </programlisting>
     </example>
    </para>
    <para>
     <example>
      <title>Comprobando si falla</title>
      <programlisting role="php">
<![CDATA[
$str = 'No v&aacute;lida';
if (($timestamp = strtotime($str)) === -1) {
    echo "La cadena ($str) no es v&aacute;lida.";
} else {
    echo "$str == ". date('l dS of F Y h:i:s A',$timestamp);
}
]]>
      </programlisting>
     </example>
    </para>
    <note>
     <para>
      El rango v&aacute;lido de una timestamp suele ser desde Fri,
          13 Dec 1901 20:45:54 GMT (Viernes, 13 de diciembre) a Tue,
          19 Jan 2038 03:14:07 GMT (Martes, 19 de enero). (Estas son las
          fechas que corresponden a los valores m&iacute;nimo y
          m&aacute;ximo de un entero con signo de 32 bits.)
     </para>
    </note>
   </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:"../../../../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
-->