cvs: phpdoc-es /reference/datetime/functions localtime.xml strtotime.xml
| From: | Rafael Martinez | Date: | Thu, 06 Jun 2002 21:57:31 +0000 |
| Subject: | cvs: phpdoc-es /reference/datetime/functions localtime.xml strtotime.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969346234@lists.php.net to get a copy of this message | ||
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ó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ón <function>localtime</function> devuelve un
vector idético al de la estructura devuelta en C por
la llamada a la misma función. El primer parámetro
que se le pasa a <function>localtime</function> es
el timestamp, una representació de una fecha/hora concretas.
Si no se proporciona, se utilizará la hora actual.
El segundo argumento de <function>localtime</function> es
<parameter>es_asociativo</parameter>. Si está a 0 o no
es proporcionado, el vector se devuelve como un vector normal,
indizado numéricamente. Si el argumento está a 1,
el vector devuelto es un vector asociativo conteniendo los diferentes
elementos de la estructura devuelta por C al llamar a la
función localtime. Los nombres de las diferentes claves del
vector asociativo se encuentran a continuació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ía del mes
</simpara>
</listitem>
<listitem>
<simpara>
"tm_mon" - mes del año, empezando en 0 que es Enero
</simpara>
</listitem>
<listitem>
<simpara>
"tm_year" - Años que hacen desde 1900
</simpara>
</listitem>
<listitem>
<simpara>
"tm_wday" - Día de la semana
</simpara>
</listitem>
<listitem>
<simpara>
"tm_yday" - Día del año
</simpara>
</listitem>
<listitem>
<simpara>
"tm_isdst" - Si el cambio de hora para el ahorro energé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ón textual de fecha/hora en Inglés
convirtiéndola en una timestamp de UNIX.
</refpurpose>
</refnamediv>
<refsect1>
<title>Descripció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ón espera que se le pase una cadena conteniendo una fecha
en formato Inglés e intentará 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á <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á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í es válida para el pará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álida';
if (($timestamp = strtotime($str)) === -1) {
echo "La cadena ($str) no es válida.";
} else {
echo "$str == ". date('l dS of F Y h:i:s A',$timestamp);
}
]]>
</programlisting>
</example>
</para>
<note>
<para>
El rango vá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ínimo y
má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
-->