php/archived-doc-es
1
0
Fork 0
mirror of https://github.com/php/doc-es.git synced 2026-03-23 23:12:09 +01:00
Code Issues Packages Projects Releases Wiki Activity

feat(translation): update revision EN (#244)

Browse Source
This commit is contained in:
Philippe DELENTE
2025-06-29 14:42:02 +02:00
committed by GitHub
parent b493c42c8f
commit 82047b7c0f
250 changed files with 11872 additions and 8592 deletions
Download Patch File Download Diff File Expand all files Collapse all files

41
reference/datetime/dateperiod/getstartdate.xml
View File

@@ -1,57 +1,58 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: c242f63f9a95972f4a1f55c9d37b88529bfbcd42 Maintainer: seros Status: ready -->
<!-- EN-Revision: 02ff7fef5b34cf8f5395180d9d39fb64d9398d00 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<!-- CREDITS: DAnnebicque -->
<refentry xml:id="dateperiod.getstartdate" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>DatePeriod::getStartDate</refname>
<refpurpose>
Obtener la fecha inicial
Obtiene la fecha de inicio
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<para>&style.oop;</para>
<methodsynopsis role="oop">
<methodsynopsis role="DatePeriod">
<modifier>public</modifier> <type>DateTimeInterface</type><methodname>DatePeriod::getStartDate</methodname>
<void />
</methodsynopsis>
<para>
Obtiene la fecha inicial del periodo.
Obtiene la fecha de inicio de un período.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve un objeto <classname>DateTimeImmutable</classname>
cuando el objeto <classname>DatePeriod</classname> se inicializó con un
objeto <classname>DateTimeImmutable</classname>
para el parámetro <parameter>start</parameter>.
Devuelve un <type>object</type> <classname>DateTimeImmutable</classname>
cuando la <classname>DatePeriod</classname> se inicializa con un
<type>object</type> <classname>DateTimeImmutable</classname>
como argumento <parameter>start</parameter>.
</para>
<para>
De lo contrario, devuelve un objeto
<classname>DateTime</classname>.
Devuelve un <type>object</type> <classname>DateTime</classname>
en los demás casos.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Ejemplo de <methodname>DatePeriod::getStartDate</methodname></title>
<title>Ejemplo <methodname>DatePeriod::getStartDate</methodname></title>
<programlisting role="php">
<![CDATA[
<?php
$periodo = new DatePeriod('R7/2016-05-16T00:00:00Z/P1D');
$inicio = $periodo->getStartDate();
echo $inicio->format(DateTime::ISO8601);
$period = new DatePeriod('R7/2016-05-16T00:00:00Z/P1D');
$start = $period->getStartDate();
echo $start->format(DateTime::ISO8601);
?>
]]>
</programlisting>
@@ -63,7 +64,7 @@ echo $inicio->format(DateTime::ISO8601);
</screen>
</example>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
@@ -71,7 +72,7 @@ echo $inicio->format(DateTime::ISO8601);
<member><methodname>DatePeriod::getDateInterval</methodname></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

484
reference/datetime/datetimeinterface/format.xml
View File

@@ -1,112 +1,508 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2479b98e82e96aa310e54bedb846951e34a9208b Maintainer: seros Status: ready -->
<!-- EN-Revision: 7f7fce55c075567a9b964be1d6ff131922930b17 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="datetime.format" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>DateTime::format</refname>
<refname>DateTimeImmutable::format</refname>
<refname>DateTimeInterface::format</refname>
<refname>DateTimeImmutable::format</refname>
<refname>DateTime::format</refname>
<refname>date_format</refname>
<refpurpose>Devuelve la fecha formateada según el formato dado</refpurpose>
<refpurpose>Retorna una fecha formateada según el formato proporcionado</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<para>&style.oop;</para>
<methodsynopsis role="oop">
<modifier>public</modifier> <type>string</type><methodname>DateTime::format</methodname>
<methodsynopsis role="DateTimeInterface">
<modifier>public</modifier> <type>string</type><methodname>DateTimeInterface::format</methodname>
<methodparam><type>string</type><parameter>format</parameter></methodparam>
</methodsynopsis>
<methodsynopsis role="DateTimeImmutable">
<modifier>public</modifier> <type>string</type><methodname>DateTimeImmutable::format</methodname>
<methodparam><type>string</type><parameter>format</parameter></methodparam>
</methodsynopsis>
<methodsynopsis role="DateTimeInterface">
<modifier>public</modifier> <type>string</type><methodname>DateTimeInterface::format</methodname>
<methodsynopsis role="DateTime">
<modifier>public</modifier> <type>string</type><methodname>DateTime::format</methodname>
<methodparam><type>string</type><parameter>format</parameter></methodparam>
</methodsynopsis>
<para>&style.procedural;</para>
<methodsynopsis role="procedural">
<methodsynopsis>
<type>string</type><methodname>date_format</methodname>
<methodparam><type>DateTimeInterface</type><parameter>object</parameter></methodparam>
<methodparam><type>string</type><parameter>format</parameter></methodparam>
</methodsynopsis>
<para>
Devuelve la fecha formateada según el formato dado.
Retorna una fecha formateada según el formato proporcionado.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
&date.datetime.description;
<varlistentry>
<term><parameter>format</parameter></term>
<listitem>
<para>
Formato aceptado por <function>date</function>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>format</parameter></term>
<listitem>
<para>
El formato de la fecha deseada. Ver las opciones de formato a continuación.
Existen también numerosas
<link linkend="datetimeinterface.constants.types">constantes de fechas</link>
que pueden ser utilizadas, lo que hace que <constant>DATE_RSS</constant>
reemplace el formato <literal>"D, d M Y H:i:s"</literal>.
</para>
<para>
<table>
<title>
Los siguientes caracteres son reconocidos en el parámetro
<parameter>format</parameter>
</title>
<tgroup cols="3">
<thead>
<row>
<entry>Caracteres para el parámetro <parameter>format</parameter></entry>
<entry>Descripción</entry>
<entry>Ejemplos de valores retornados</entry>
</row>
</thead>
<tbody>
<row>
<entry align="center"><emphasis>Día</emphasis></entry>
<entry>---</entry>
<entry>---</entry>
</row>
<row>
<entry><literal>d</literal></entry>
<entry>Día del mes, en dos dígitos (con un cero inicial)</entry>
<entry><literal>01</literal> a <literal>31</literal></entry>
</row>
<row>
<entry><literal>D</literal></entry>
<entry>Día de la semana, en tres letras (y en inglés - por defecto: en inglés, o sino, en el idioma local del servidor)</entry>
<entry><literal>Mon</literal> a <literal>Sun</literal></entry>
</row>
<row>
<entry><literal>j</literal></entry>
<entry>Día del mes sin los ceros iniciales</entry>
<entry><literal>1</literal> a <literal>31</literal></entry>
</row>
<row>
<entry><literal>l</literal> ('L' minúscula)</entry>
<entry>Día de la semana, textual, versión larga, en inglés</entry>
<entry><literal>Sunday</literal> a <literal>Saturday</literal></entry>
</row>
<row>
<entry><literal>N</literal></entry>
<entry>Representación numérica ISO 8601 del día de la semana</entry>
<entry><literal>1</literal> (para Lunes) a <literal>7</literal> (para Domingo)</entry>
</row>
<row>
<entry><literal>S</literal></entry>
<entry>Sufijo ordinal de un número para el día del mes, en inglés, en dos letras</entry>
<entry>
<literal>st</literal>, <literal>nd</literal>, <literal>rd</literal> o
<literal>th</literal>. Funciona bien con <literal>j</literal>
</entry>
</row>
<row>
<entry><literal>w</literal></entry>
<entry>Día de la semana en formato numérico</entry>
<entry><literal>0</literal> (para domingo) a <literal>6</literal> (para sábado)</entry>
</row>
<row>
<entry><literal>z</literal></entry>
<entry>Día del año</entry>
<entry><literal>0</literal> a <literal>365</literal></entry>
</row>
<row>
<entry align="center"><emphasis>Semana</emphasis></entry>
<entry>---</entry>
<entry>---</entry>
</row>
<row>
<entry><literal>W</literal></entry>
<entry>Número de semana en el año ISO 8601, las semanas comienzan
el lunes</entry>
<entry>Ejemplo: <literal>42</literal> (la 42ª semana del año)</entry>
</row>
<row>
<entry align="center"><emphasis>Mes</emphasis></entry>
<entry>---</entry>
<entry>---</entry>
</row>
<row>
<entry><literal>F</literal></entry>
<entry>Mes, textual, versión larga; en inglés, como
<literal>January</literal> o <literal>December</literal></entry>
<entry><literal>January</literal> a <literal>December</literal></entry>
</row>
<row>
<entry><literal>m</literal></entry>
<entry>Mes en formato numérico, con ceros iniciales</entry>
<entry><literal>01</literal> a <literal>12</literal></entry>
</row>
<row>
<entry><literal>M</literal></entry>
<entry>Mes, en tres letras, en inglés</entry>
<entry><literal>Jan</literal> a <literal>Dec</literal></entry>
</row>
<row>
<entry><literal>n</literal></entry>
<entry>Mes sin los ceros iniciales</entry>
<entry>&one; a <literal>12</literal></entry>
</row>
<row>
<entry><literal>t</literal></entry>
<entry>Número de días en el mes</entry>
<entry><literal>28</literal> a <literal>31</literal></entry>
</row>
<row>
<entry align="center"><emphasis>Año</emphasis></entry>
<entry>---</entry>
<entry>---</entry>
</row>
<row>
<entry><literal>L</literal></entry>
<entry>¿Es el año bisiesto?</entry>
<entry><literal>1</literal> si es bisiesto, <literal>0</literal> si no.</entry>
</row>
<row>
<entry><literal>o</literal></entry>
<entry>Año de numeración de semanas ISO 8601. Es el mismo valor que
<literal>Y</literal>, excepto si el número de semana ISO
(<literal>W</literal>) pertenece al año anterior o siguiente,
este año será utilizado en su lugar.</entry>
<entry>Ejemplos: <literal>1999</literal> o <literal>2003</literal></entry>
</row>
<row>
<entry><literal>X</literal></entry>
<entry>
Una representación numérica completa extendida de un año, de al menos 4 dígitos,
con un <literal>-</literal> para los años antes de la era común
y un <literal>+</literal> para los años de la era común.
</entry>
<entry>
Ejemplos: <literal>-0055</literal>, <literal>+0787</literal>,
<literal>+1999</literal>, <literal>+10191</literal>
</entry>
</row>
<row>
<entry><literal>x</literal></entry>
<entry>
Una representación numérica completa extendida si es necesario,
o una representación numérica completa estándar si es posible (como <literal>Y</literal>).
Al menos cuatro dígitos. Los años anteriores a la era común son prefijados por un <literal>-</literal>.
Los años más allá (y incluyendo) del <literal>10000</literal> son prefijados por un <literal>+</literal>.
</entry>
<entry>
Ejemplos: <literal>-0055</literal>, <literal>0787</literal>,
<literal>1999</literal>, <literal>+10191</literal>
</entry>
</row>
<row>
<entry><literal>Y</literal></entry>
<entry>Una representación numérica completa de un año, al menos 4 dígitos, con <literal>-</literal> para los años av. J.-C.</entry>
<entry>Ejemplos: <literal>-0055</literal>, <literal>0787</literal>,
<literal>1999</literal>, <literal>2003</literal>, <literal>10191</literal></entry>
</row>
<row>
<entry><literal>y</literal></entry>
<entry>Año en 2 dígitos</entry>
<entry>Ejemplos: <literal>99</literal> o <literal>03</literal></entry>
</row>
<row>
<entry align="center"><emphasis>Hora</emphasis></entry>
<entry>---</entry>
<entry>---</entry>
</row>
<row>
<entry><literal>a</literal></entry>
<entry>Ante meridiem y Post meridiem en minúsculas</entry>
<entry><literal>am</literal> o <literal>pm</literal></entry>
</row>
<row>
<entry><literal>A</literal></entry>
<entry>Ante meridiem y Post meridiem en mayúsculas</entry>
<entry><literal>AM</literal> o <literal>PM</literal></entry>
</row>
<row>
<entry><literal>B</literal></entry>
<entry>Hora Internet Swatch</entry>
<entry><literal>000</literal> a <literal>999</literal></entry>
</row>
<row>
<entry><literal>g</literal></entry>
<entry>Hora, en formato 12h, sin los ceros iniciales</entry>
<entry><literal>1</literal> a <literal>12</literal></entry>
</row>
<row>
<entry><literal>G</literal></entry>
<entry>Hora, en formato 24h, sin los ceros iniciales</entry>
<entry><literal>0</literal> a <literal>23</literal></entry>
</row>
<row>
<entry><literal>h</literal></entry>
<entry>Hora, en formato 12h, con los ceros iniciales</entry>
<entry><literal>01</literal> a <literal>12</literal></entry>
</row>
<row>
<entry><literal>H</literal></entry>
<entry>Hora, en formato 24h, con los ceros iniciales</entry>
<entry><literal>00</literal> a <literal>23</literal></entry>
</row>
<row>
<entry><literal>i</literal></entry>
<entry>Minutos con ceros iniciales</entry>
<entry><literal>00</literal> a <literal>59</literal></entry>
</row>
<row>
<entry><literal>s</literal></entry>
<entry>Segundos con ceros iniciales</entry>
<entry><literal>00</literal> a <literal>59</literal></entry>
</row>
<row>
<entry><literal>u</literal></entry>
<entry>
Microsegundos. Tenga en cuenta que la función
<function>date</function> generará siempre
<literal>000000</literal> ya que toma un parámetro de tipo
entero, mientras que el método <methodname>DateTimeInterface::format</methodname>
soporta microsegundos si <classname>DateTime</classname> ha
sido creada con microsegundos.
</entry>
<entry>Ejemplo: <literal>654321</literal></entry>
</row>
<row>
<entry><literal>v</literal></entry>
<entry>
Milisegundos. Misma nota que para
<literal>u</literal>.
</entry>
<entry>Ejemplo: <literal>654</literal></entry>
</row>
<row>
<entry align="center"><emphasis>Zona horaria</emphasis></entry>
<entry>---</entry>
<entry>---</entry>
</row>
<row>
<entry><literal>e</literal></entry>
<entry>El identificador de la zona horaria</entry>
<entry>Ejemplos: <literal>UTC</literal>, <literal>GMT</literal>, <literal>Atlantic/Azores</literal></entry>
</row>
<row>
<entry><literal>I</literal> (i mayúscula)</entry>
<entry>La hora de verano está activada o no</entry>
<entry><literal>1</literal> si sí, <literal>0</literal> si no.</entry>
</row>
<row>
<entry><literal>O</literal></entry>
<entry>Diferencia de horas con la hora de Greenwich (GMT), sin
dos puntos entre las horas y los minutos</entry>
<entry>Ejemplo: <literal>+0200</literal></entry>
</row>
<row>
<entry><literal>P</literal></entry>
<entry>Diferencia con la hora Greenwich (GMT) con un dos puntos
entre las horas y los minutos</entry>
<entry>Ejemplo: <literal>+02:00</literal></entry>
</row>
<row>
<entry><literal>p</literal></entry>
<entry>
Idéntico a <literal>P</literal>, pero retorna <literal>Z</literal> en lugar de <literal>+00:00</literal>
(disponible a partir de PHP 8.0.0)
</entry>
<entry>Ejemplos: <literal>Z</literal> o <literal>+02:00</literal></entry>
</row>
<row>
<entry><literal>T</literal></entry>
<entry>Abreviación de la zona horaria, si es conocida; sino, desplazamiento desde GMT</entry>
<entry>Ejemplos: <literal>EST</literal>, <literal>MDT</literal>, <literal>+05</literal></entry>
</row>
<row>
<entry><literal>Z</literal></entry>
<entry>Desplazamiento horario en segundos. El desplazamiento de zonas al oeste
de la zona UTC es negativo, y al este, es positivo.</entry>
<entry><literal>-43200</literal> a <literal>50400</literal></entry>
</row>
<row>
<entry align="center"><emphasis>Fecha y Hora completa</emphasis></entry>
<entry>---</entry>
<entry>---</entry>
</row>
<row>
<entry><literal>c</literal></entry>
<entry>Fecha en formato ISO 8601</entry>
<entry>2004-02-12T15:19:21+00:00</entry>
</row>
<row>
<entry><literal>r</literal></entry>
<entry>Formato de fecha <link xlink:href="&url.rfc;2822">RFC 2822</link>/<link xlink:href="&url.rfc;5322">RFC 5322</link></entry>
<entry>Ejemplo: <literal>Thu, 21 Dec 2000 16:01:070200</literal></entry>
</row>
<row>
<entry><literal>U</literal></entry>
<entry>Segundos desde la época Unix (1 de Enero de 1970, 0h00 00s GMT)</entry>
<entry>Ver también <function>time</function></entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<para>
Los caracteres no reconocidos serán impresos tal cual.
"<literal>Z</literal>" retornará siempre <literal>0</literal> cuando se utiliza con
<function>gmdate</function>.
</para>
<note>
<para>
Sabiendo que esta función solo acepta enteros en forma de timestamp,
el carácter <literal>u</literal> solo es útil al utilizar la función
<function>date_format</function> con un timestamp de usuario creado con la función
<function>date_create</function>.
</para>
</note>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve la fecha formateada en caso de éxito &return.falseforfailure;.
Retorna la fecha formateada, en forma de string,
en caso de éxito.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.2.0</entry>
<entry>
Los caracteres de formato <literal>X</literal> o <literal>x</literal>
han sido añadidos.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
El carácter de formato <literal>p</literal> ha sido añadido.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Ejemplo de <function>DateTime::format</function></title>
<para>&style.oop;</para>
<programlisting role="php">
<para>
<example>
<title>Ejemplo con <function>DateTime::format</function></title>
<para>&style.oop;</para>
<programlisting role="php">
<![CDATA[
<?php
$date = new DateTime('2000-01-01');
$date = new DateTimeImmutable('2000-01-01');
echo $date->format('Y-m-d H:i:s');
?>
]]>
</programlisting>
<para>&style.procedural;</para>
<programlisting role="php">
</programlisting>
<para>&style.procedural;</para>
<programlisting role="php">
<![CDATA[
<?php
$date = date_create('2000-01-01');
echo date_format($date, 'Y-m-d H:i:s');
?>
]]>
</programlisting>
&example.outputs;
<screen>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
2000-01-01 00:00:00
]]>
</screen>
</example>
</screen>
</example>
</para>
<para>
<example>
<title>Más ejemplos</title>
<programlisting role="php">
<![CDATA[
<?php
// set the default timezone to use.
date_default_timezone_set('UTC');
// now
$date = new DateTimeImmutable();
// Imprime algo como: Wednesday
echo $date->format('l'), "\n";
// Imprime algo como: Wednesday 19th of October 2022 08:40:48 AM
echo $date->format('l jS \o\f F Y h:i:s A'), "\n";
/* use the constants in the format parameter */
// imprime algo como: Wed, 19 Oct 2022 08:40:48 +0000
echo $date->format(DateTimeInterface::RFC2822), "\n";
?>
]]>
</programlisting>
</example>
</para>
<para>
Es posible evitar el desarrollo de un carácter reconocido en la cadena de formato
precediéndolo con un antislash. Si el carácter con antislash es ya una secuencia especial,
será necesario también escapar el antislash.
<example>
<title>Escape de caracteres durante el formato</title>
<programlisting role="php">
<![CDATA[
<?php
$date = new DateTimeImmutable();
// imprime algo como: Wednesday the 19th
echo $date->format('l \t\h\e jS');
?>
]]>
</programlisting>
</example>
</para>
<para>
Para formatear fechas en otros idiomas,
<methodname>IntlDateFormatter::format</methodname>
puede ser utilizada en lugar de <methodname>DateTimeInterface::format</methodname>.
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<para>
Este método no usa configuraciones regionales. Todas las salidas están en inglés.
Este método no utiliza locales. Todos los despliegues
serán en inglés.
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><function>date</function></member>
<member><methodname>IntlDateFormatter::format</methodname></member>
</simplelist>
</refsect1>
</refentry>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

59
reference/datetime/datetimeinterface/getoffset.xml
View File

@@ -1,70 +1,68 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2479b98e82e96aa310e54bedb846951e34a9208b Maintainer: seros Status: ready -->
<!-- EN-Revision: e057f1f552548a68030830e96ae1bdf313b1794e Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="datetime.getoffset" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>DateTime::getOffset</refname>
<refname>DateTimeImmutable::getOffset</refname>
<refname>DateTimeInterface::getOffset</refname>
<refname>DateTimeImmutable::getOffset</refname>
<refname>DateTime::getOffset</refname>
<refname>date_offset_get</refname>
<refpurpose>Devuelve el índice de la zona horaria</refpurpose>
<refpurpose>Devuelve el desplazamiento horario</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<para>&style.oop;</para>
<methodsynopsis role="oop">
<modifier>public</modifier> <type>int</type><methodname>DateTime::getOffset</methodname>
<void />
<methodsynopsis role="DateTimeInterface">
<modifier>public</modifier> <type>int</type><methodname>DateTimeInterface::getOffset</methodname>
<void/>
</methodsynopsis>
<methodsynopsis role="DateTimeImmutable">
<modifier>public</modifier> <type>int</type><methodname>DateTimeImmutable::getOffset</methodname>
<void />
<void/>
</methodsynopsis>
<methodsynopsis role="DateTimeInterface">
<modifier>public</modifier> <type>int</type><methodname>DateTimeInterface::getOffset</methodname>
<void />
<methodsynopsis role="DateTime">
<modifier>public</modifier> <type>int</type><methodname>DateTime::getOffset</methodname>
<void/>
</methodsynopsis>
<para>&style.procedural;</para>
<methodsynopsis role="procedural">
<methodsynopsis>
<type>int</type><methodname>date_offset_get</methodname>
<methodparam><type>DateTimeInterface</type><parameter>object</parameter></methodparam>
</methodsynopsis>
<para>
Devuelve el índice de la zona horaria.
Devuelve el desplazamiento horario.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
&date.datetime.description;
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve el índice de la zona horaria en segundos desde UTC en caso de éxito
&return.falseforfailure;.
Devuelve el desplazamiento horario en segundos, desde UTC en caso de éxito.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Ejemplo de <function>DateTime::getOffset</function></title>
<title>Ejemplo con <function>DateTime::getOffset</function></title>
<para>&style.oop;</para>
<programlisting role="php">
<![CDATA[
<?php
$invierno = new DateTime('2010-12-21', new DateTimeZone('America/New_York'));
$verano = new DateTime('2008-06-21', new DateTimeZone('America/New_York'));
$winter = new DateTimeImmutable('2010-12-21', new DateTimeZone('America/New_York'));
$summer = new DateTimeImmutable('2008-06-21', new DateTimeZone('America/New_York'));
echo $invierno->getOffset() . "\n";
echo $verano->getOffset() . "\n";
echo $winter->getOffset() . "\n";
echo $summer->getOffset() . "\n";
?>
]]>
</programlisting>
@@ -72,11 +70,11 @@ echo $verano->getOffset() . "\n";
<programlisting role="php">
<![CDATA[
<?php
$invierno = date_create('2010-12-21', timezone_open('America/New_York'));
$verano = date_create('2008-06-21', timezone_open('America/New_York'));
$winter = date_create('2010-12-21', timezone_open('America/New_York'));
$summer = date_create('2008-06-21', timezone_open('America/New_York'));
echo date_offset_get($invierno) . "\n";
echo date_offset_get($verano) . "\n";
echo date_offset_get($winter) . "\n";
echo date_offset_get($summer) . "\n";
?>
]]>
</programlisting>
@@ -92,9 +90,8 @@ echo date_offset_get($verano) . "\n";
</para>
</example>
</refsect1>
</refentry>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

117
reference/datetime/datetimeinterface/gettimestamp.xml
View File

@@ -1,39 +1,37 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2479b98e82e96aa310e54bedb846951e34a9208b Maintainer: seros Status: ready -->
<!-- EN-Revision: 8859c8b96cd9e80652813f7bcf561432a5e9f934 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="datetime.gettimestamp" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>DateTime::getTimestamp</refname>
<refname>DateTimeImmutable::getTimestamp</refname>
<refname>DateTimeInterface::getTimestamp</refname>
<refname>DateTimeImmutable::getTimestamp</refname>
<refname>DateTime::getTimestamp</refname>
<refname>date_timestamp_get</refname>
<refpurpose>Obtiene la marca de tiempo Unix</refpurpose>
<refpurpose>Obtiene el timestamp Unix</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<para>&style.oop;</para>
<methodsynopsis role="oop">
<modifier>public</modifier> <type>int</type><methodname>DateTime::getTimestamp</methodname>
<void />
<methodsynopsis role="DateTimeInterface">
<modifier>public</modifier> <type>int</type><methodname>DateTimeInterface::getTimestamp</methodname>
<void/>
</methodsynopsis>
<methodsynopsis role="DateTimeImmutable">
<modifier>public</modifier> <type>int</type><methodname>DateTimeImmutable::getTimestamp</methodname>
<void />
<void/>
</methodsynopsis>
<methodsynopsis role="DateTimeInterface">
<modifier>public</modifier> <type>int</type><methodname>DateTimeInterface::getTimestamp</methodname>
<void />
<methodsynopsis role="DateTime">
<modifier>public</modifier> <type>int</type><methodname>DateTime::getTimestamp</methodname>
<void/>
</methodsynopsis>
<para>&style.procedural;</para>
<methodsynopsis role="procedural">
<methodsynopsis>
<type>int</type><methodname>date_timestamp_get</methodname>
<methodparam><type>DateTimeInterface</type><parameter>object</parameter></methodparam>
</methodsynopsis>
<para>
Obtiene la marca de tiempo Unix.
Obtiene el timestamp Unix.
</para>
</refsect1>
@@ -45,20 +43,61 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve la marca de tiempo Unix que representa la fecha.
Devuelve el timestamp Unix que representa la fecha.
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<para>
Si el sello de tiempo no puede ser representado como un &integer;,
se lanza una <classname>DateRangeError</classname>.
Anterior a PHP 8.3.0, se lanzaba una <exceptionname>ValueError</exceptionname>.
Y anterior a PHP 8.0.0, se devolvía &false; en este caso.
Sin embargo, el sello de tiempo puede ser obtenido como un &string; utilizando
<methodname>DateTimeInterface::format</methodname> con el formato <literal>U</literal>.
</para>
</refsect1>
<refsect1 role="changelog"><!-- {{{ -->
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.3.0</entry>
<entry>
La excepción de fuera de rango ahora es una
<exceptionname>DateRangeError</exceptionname>.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Estas funciones ya no devuelven &false; en caso de fallo.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1><!-- }}} -->
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Ejemplo de <function>DateTime::getTimestamp</function></title>
<title>Ejemplo con <function>DateTime::getTimestamp</function></title>
<para>&style.oop;</para>
<programlisting role="php">
<![CDATA[
<?php
$fecha = new DateTime();
echo $fecha->getTimestamp();
$date = new DateTimeImmutable();
echo $date->getTimestamp();
?>
]]>
</programlisting>
@@ -66,8 +105,8 @@ echo $fecha->getTimestamp();
<programlisting role="php">
<![CDATA[
<?php
$fecha = date_create();
echo date_timestamp_get($fecha);
$date = date_create();
echo date_timestamp_get($date);
?>
]]>
</programlisting>
@@ -78,27 +117,45 @@ echo date_timestamp_get($fecha);
]]>
</screen>
</example>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<para>
Usar <literal>U</literal> como parámetro de
<function>DateTime::format</function>
es una alternativa cuando se utliza PHP 5.2.
Para obtener el sello de tiempo con precisión
en milisegundos o microsegundos, es posible utilizar
la función <function>DateTimeInterface::format</function>.
</para>
<example>
<title>Obtención del sello de tiempo con precisión en milisegundos y microsegundos</title>
<para>&style.oop;</para>
<programlisting role="php">
<![CDATA[
<?php
$date = new DateTimeImmutable();
$milli = (int) $date->format('Uv'); // Timestamp en milisegundos
$micro = (int) $date->format('Uu'); // Timestamp en microsegundos
echo $milli, "\n", $micro, "\n";
?>
]]>
</programlisting>
&examples.outputs.similar;
<screen>
<![CDATA[
1674057635586
1674057635586918
]]>
</screen>
</example>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><function>DateTime::setTimestamp</function></member>
<member><function>DateTime::format</function></member>
<member><function>DateTimeImmutable::setTimestamp</function></member>
<member><function>DateTimeInterface::format</function></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

38
reference/datetime/datetimeinterface/gettimezone.xml
View File

@@ -1,39 +1,39 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2479b98e82e96aa310e54bedb846951e34a9208b Maintainer: seros Status: ready -->
<!-- EN-Revision: 02ff7fef5b34cf8f5395180d9d39fb64d9398d00 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="datetime.gettimezone" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>DateTime::getTimezone</refname>
<refname>DateTimeImmutable::getTimezone</refname>
<refname>DateTimeInterface::getTimezone</refname>
<refname>DateTimeImmutable::getTimezone</refname>
<refname>DateTime::getTimezone</refname>
<refname>date_timezone_get</refname>
<refpurpose>Develve la zona horaria relativa al objeto DateTime dado</refpurpose>
<refpurpose>Devuelve la zona horaria relativa al DateTime proporcionado</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<para>&style.oop;</para>
<methodsynopsis role="oop">
<modifier>public</modifier> <type>DateTimeZone</type><methodname>DateTime::getTimezone</methodname>
<methodsynopsis role="DateTimeInterface">
<modifier>public</modifier> <type class="union"><type>DateTimeZone</type><type>false</type></type><methodname>DateTimeInterface::getTimezone</methodname>
<void/>
</methodsynopsis>
<methodsynopsis role="DateTimeImmutable">
<modifier>public</modifier> <type>DateTimeZone</type><methodname>DateTimeImmutable::getTimezone</methodname>
<modifier>public</modifier> <type class="union"><type>DateTimeZone</type><type>false</type></type><methodname>DateTimeImmutable::getTimezone</methodname>
<void/>
</methodsynopsis>
<methodsynopsis role="DateTimeInterface">
<modifier>public</modifier> <type>DateTimeZone</type><methodname>DateTimeInterface::getTimezone</methodname>
<methodsynopsis role="DateTime">
<modifier>public</modifier> <type class="union"><type>DateTimeZone</type><type>false</type></type><methodname>DateTime::getTimezone</methodname>
<void/>
</methodsynopsis>
<para>&style.procedural;</para>
<methodsynopsis role="procedural">
<type>DateTimeZone</type><methodname>date_timezone_get</methodname>
<methodsynopsis>
<type class="union"><type>DateTimeZone</type><type>false</type></type><methodname>date_timezone_get</methodname>
<methodparam><type>DateTimeInterface</type><parameter>object</parameter></methodparam>
</methodsynopsis>
<para>
Develve la zona horaria relativa al objeto DateTime dado.
Devuelve la zona horaria relativa al DateTime proporcionado.
</para>
</refsect1>
@@ -55,14 +55,14 @@
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Ejemplo de <function>DateTime::getTimezone</function></title>
<title>Ejemplo con <function>DateTime::getTimezone</function></title>
<para>&style.oop;</para>
<programlisting role="php">
<![CDATA[
<?php
$fecha = new DateTime(null, new DateTimeZone('Europe/London'));
$zh = $fecha->getTimezone();
echo $zh->getName();
$date = new DateTimeImmutable(null, new DateTimeZone('Europe/London'));
$tz = $date->getTimezone();
echo $tz->getName();
?>
]]>
</programlisting>
@@ -70,9 +70,9 @@ echo $zh->getName();
<programlisting role="php">
<![CDATA[
<?php
$fecha = date_create(null, timezone_open('Europe/London'));
$zh = date_timezone_get($fecha);
echo timezone_name_get($zh);
$date = date_create(null, timezone_open('Europe/London'));
$tz = date_timezone_get($date);
echo timezone_name_get($tz);
?>
]]>
</programlisting>

22
reference/datetime/datetimeinterface/wakeup.xml
View File

@@ -1,32 +1,31 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b89d5b4683bafebb6cdc47aa8f1845b119d503f0 Maintainer: seros Status: ready -->
<!-- EN-Revision: 02ff7fef5b34cf8f5395180d9d39fb64d9398d00 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="datetime.wakeup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>DateTime::__wakeup</refname>
<refname>DateTimeImmutable::__wakeup</refname>
<refname>DateTimeInterface::__wakeup</refname>
<refpurpose>El gestor __wakeup</refpurpose>
<refpurpose>El manejador __wakeup</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="oop">
<modifier>public</modifier> <methodname>DateTime::__wakeup</methodname>
<void />
<methodsynopsis role="DateTime">
<modifier>public</modifier> <type>void</type><methodname>DateTime::__wakeup</methodname>
<void/>
</methodsynopsis>
<methodsynopsis role="DateTimeImmutable">
<modifier>public</modifier> <methodname>DateTimeImmutable::__wakeup</methodname>
<void />
<modifier>public</modifier> <type>void</type><methodname>DateTimeImmutable::__wakeup</methodname>
<void/>
</methodsynopsis>
<methodsynopsis role="DateTimeInterface">
<modifier>public</modifier> <methodname>DateTimeInterface::__wakeup</methodname>
<void />
<modifier>public</modifier> <type>void</type><methodname>DateTimeInterface::__wakeup</methodname>
<void/>
</methodsynopsis>
<para>
El gestor <link linkend="object.wakeup">__wakeup()</link>.
El manejador <link linkend="object.wakeup">__wakeup()</link>.
</para>
</refsect1>
@@ -43,7 +42,6 @@
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

105
reference/datetime/datetimezone/construct.xml
View File

@@ -1,32 +1,42 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 400f2c8445459bcd44b1ee0b62a18e607c206123 Maintainer: seros Status: ready -->
<!-- Reviewed: yes Maintainer: seros -->
<!-- EN-Revision: d9ac376dbee6e45ef775059456caf0ec348ada6a Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="datetimezone.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>DateTimeZone::__construct</refname>
<refname>timezone_open</refname>
<refpurpose>Crea un nuevo objeto DateTimeZone</refpurpose>
<refpurpose>Crea un nuevo objeto <classname>DateTimeZone</classname></refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<para>&style.oop;</para>
<constructorsynopsis role="oop">
<constructorsynopsis role="DateTimeZone">
<modifier>public</modifier> <methodname>DateTimeZone::__construct</methodname>
<methodparam><type>string</type><parameter>timezone</parameter></methodparam>
</constructorsynopsis>
<para>&style.procedural;</para>
<methodsynopsis role="procedural">
<type>DateTimeZone</type><methodname>timezone_open</methodname>
<methodsynopsis>
<type class="union"><type>DateTimeZone</type><type>false</type></type><methodname>timezone_open</methodname>
<methodparam><type>string</type><parameter>timezone</parameter></methodparam>
</methodsynopsis>
<para>
Crea un nuevo objeto DateTimeZone.
Crea un nuevo objeto <classname>DateTimeZone</classname>.
</para>
<para>
Un objeto DateTimeZone proporciona acceso a tres tipos diferentes de reglas
de zona horaria: un desplazamiento UTC (tipo <literal>1</literal>), una
abreviatura de zona horaria (tipo <literal>2</literal>), y un
<link linkend="timezones">identificador de zona horaria</link> tal como
se publica en la base de datos de zonas horarias IANA (tipo <literal>3</literal>).
</para>
<para>
El objeto DateTimeZone puede ser adjuntado a los objetos <classname>DateTime</classname>
y <classname>DateTimeImmutable</classname> con el fin de poder representar
la zona horaria encapsulada por estos objetos en una zona horaria local.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
@@ -35,31 +45,32 @@
<term><parameter>timezone</parameter></term>
<listitem>
<para>
Uno de los <link linkend="timezones">nombres de zonas horarias</link> admitidos
o un índice válido (+0200).
Una de las <link linkend="timezones">zonas horarias</link> soportadas,
un valor de desplazamiento (+0200), o una abreviatura de zona (BST).
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve un objeto <classname>DateTimeZone</classname> si tuvo éxito.
&return.falseforfailure.style.procedural;
Devuelve un objeto <classname>DateTimeZone</classname> en caso de éxito.
&return.falseforfailure.style.procedural;.
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<para>
Este método lanza una <classname>Exception</classname> si la zona horaria suministrada no es
reconocida como una zona horaria válida.
Este método lanza una <classname>DateInvalidTimeZoneException</classname>
si la zona horaria proporcionada no es reconocida como una zona horaria válida.
Anteriormente a PHP 8.3, esto era una <exceptionname>Exception</exceptionname>.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
@@ -73,9 +84,11 @@
</thead>
<tbody>
<row>
<entry>5.5.10</entry>
<entry>8.3.0</entry>
<entry>
El parámetro <parameter>timezone</parameter> acepta valores de índice.
Los valores inválidos ahora lanzan una
<exceptionname>DateInvalidTimeZoneException</exceptionname> en lugar
de una <exceptionname>Exception</exceptionname> genérica.
</entry>
</row>
</tbody>
@@ -83,21 +96,50 @@
</informaltable>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Atrapar errores cuando se instancia un <classname>DateTimeZone</classname></title>
<title>Creación y adjuntado de DateTimeZone a un DateTimeImmutable</title>
<programlisting role="php">
<![CDATA[
<?php
// Manejo de errores atrapando excepciones
$zonas_horarias = array('Europe/London', 'Mars/Phobos', 'Jupiter/Europa');
$d = new DateTimeImmutable("2022-06-02 15:44:48 UTC");
foreach ($zonas_horarias as $zh) {
$timezones = [ 'Europe/London', 'GMT+04:45', '-06:00', 'CEST' ];
foreach ($timezones as $tz) {
$tzo = new DateTimeZone($tz);
$local = $d->setTimezone($tzo);
echo $local->format(DateTimeInterface::RFC2822 . ' — e'), "\n";
}
?>
]]>
</programlisting>
&example.outputs;
<screen>
Thu, 02 Jun 2022 16:44:48 +0100 — Europe/London
Thu, 02 Jun 2022 20:29:48 +0445 — +04:45
Thu, 02 Jun 2022 09:44:48 -0600 — -06:00
Thu, 02 Jun 2022 17:44:48 +0200 — CEST
</screen>
</example>
</para>
<para>
<example>
<title>Intercepción de errores con <classname>DateTimeZone</classname></title>
<programlisting role="php">
<![CDATA[
<?php
// Manejo de errores por intercepción de excepciones
$timezones = array('Europe/London', 'Mars/Phobos', 'Jupiter/Europa');
foreach ($timezones as $tz) {
try {
$marte = new DateTimeZone($zh);
$mars = new DateTimeZone($tz);
} catch(Exception $e) {
echo $e->getMessage() . '<br />';
}
@@ -113,11 +155,10 @@ DateTimeZone::__construct() [datetimezone.--construct]: Unknown or bad timezone
]]>
</screen>
</example>
</para>
</refsect1>
</refentry>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

54
reference/datetime/datetimezone/getlocation.xml
View File

@@ -1,31 +1,34 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: eee609624d6727eb4218937314bf8f9ff5627975 Maintainer: chuso Status: ready -->
<!-- EN-Revision: 02ff7fef5b34cf8f5395180d9d39fb64d9398d00 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<!-- CREDITS: DAnnebicque -->
<refentry xml:id="datetimezone.getlocation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>DateTimeZone::getLocation</refname>
<refname>timezone_location_get</refname>
<refpurpose>Devuelve la información de la ubicación para una zona horaria</refpurpose>
<refpurpose>Devuelve las informaciones geográficas de una zona horaria</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<para>&style.oop;</para>
<methodsynopsis role="oop">
<modifier>public</modifier> <type>array</type><methodname>DateTimeZone::getLocation</methodname>
<void />
<methodsynopsis role="DateTimeZone">
<modifier>public</modifier> <type class="union"><type>array</type><type>false</type></type><methodname>DateTimeZone::getLocation</methodname>
<void/>
</methodsynopsis>
<para>&style.procedural;</para>
<methodsynopsis role="procedural">
<type>array</type><methodname>timezone_location_get</methodname>
<methodsynopsis>
<type class="union"><type>array</type><type>false</type></type><methodname>timezone_location_get</methodname>
<methodparam><type>DateTimeZone</type><parameter>object</parameter></methodparam>
</methodsynopsis>
<para>
Devuelve la información de la ubicación para una zona horaria, incluyendo el código de país, latitud/longitud y comentarios.
Devuelve las informaciones geográficas de una zona horaria, incluyendo el
código del país, la latitud y la longitud, y comentarios.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
@@ -34,25 +37,25 @@
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Una matriz que contiene la información de la ubicación acerca de una zona horaria&return.falseforfailure;.
Array que contiene las informaciones de localización de la zona horaria &return.falseforfailure;.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo de <function>DateTimeZone::getLocation</function></title>
<title>Ejemplo con <function>DateTimeZone::getLocation</function></title>
<programlisting role="php">
<![CDATA[
<?php
$zh = new DateTimeZone("Europe/Prague");
print_r($zh->getLocation());
print_r(timezone_location_get($zh));
$tz = new DateTimeZone("Europe/Prague");
print_r($tz->getLocation());
print_r(timezone_location_get($tz));
?>
]]>
</programlisting>
@@ -60,26 +63,35 @@ print_r(timezone_location_get($zh));
<screen>
<![CDATA[
Array
Array
(
[country_code] => CZ
[latitude] => 50.08333
[longitude] => 14.43333
[comments] =>
[comments] =>
)
Array
(
[country_code] => CZ
[latitude] => 50.08333
[longitude] => 14.43333
[comments] =>
[comments] =>
)
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member>
<function>DateTimeZone::listIdentifiers</function> para obtener una lista
completa o parcial de todos los identificadores de zonas horarias soportadas
</member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

29
reference/datetime/datetimezone/getname.xml
View File

@@ -1,23 +1,23 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 086dc12715921d77fe42d7cf578b6254c743aa3e Maintainer: chuso Status: ready -->
<!-- EN-Revision: 02ff7fef5b34cf8f5395180d9d39fb64d9398d00 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="datetimezone.getname" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>DateTimeZone::getName</refname>
<refname>timezone_name_get</refname>
<refpurpose>Devuelve el nombre de la zona horaria</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<para>&style.oop;</para>
<methodsynopsis role="oop">
<methodsynopsis role="DateTimeZone">
<modifier>public</modifier> <type>string</type><methodname>DateTimeZone::getName</methodname>
<void />
</methodsynopsis>
<para>&style.procedural;</para>
<methodsynopsis role="procedural">
<methodsynopsis>
<type>string</type><methodname>timezone_name_get</methodname>
<methodparam><type>DateTimeZone</type><parameter>object</parameter></methodparam>
</methodsynopsis>
@@ -25,7 +25,7 @@
Devuelve el nombre de la zona horaria.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
@@ -33,21 +33,28 @@
<term><parameter>object</parameter></term>
<listitem>
<para>
El <classname>DateTimeZone</classname> del cual desera obtener el nombre.
El objeto <classname>DateTimeZone</classname> utilizado para recuperar
el nombre de la zona horaria.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Una de los nombres de zona horaria en la
<link linkend="timezones">lista de zonas horarias</link>.
Según el tipo de zona, el desplazamiento UTC (tipo 1), la abreviatura
de zona horaria (tipo 2) y los identificadores de zona horaria
tales como se publican en la base de datos de zonas horarias IANA
(tipo 3), la cadena de descripción para crear un nuevo objeto
<classname>DateTimeZone</classname> con el mismo desplazamiento y/o
las mismas reglas. Por ejemplo <literal>02:00</literal>,
<literal>CEST</literal> o uno de los nombres de zonas horarias
en la <link linkend="timezones">lista de zonas horarias</link>.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

51
reference/datetime/datetimezone/getoffset.xml
View File

@@ -1,33 +1,34 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 086dc12715921d77fe42d7cf578b6254c743aa3e Maintainer: chuso Status: ready -->
<!-- EN-Revision: e057f1f552548a68030830e96ae1bdf313b1794e Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="datetimezone.getoffset" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>DateTimeZone::getOffset</refname>
<refname>timezone_offset_get</refname>
<refpurpose>Devuelve el índice de la zona horaria de GMT</refpurpose>
<refpurpose>Retorna el desplazamiento GMT de una zona horaria</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<para>&style.oop;</para>
<methodsynopsis role="oop">
<methodsynopsis role="DateTimeZone">
<modifier>public</modifier> <type>int</type><methodname>DateTimeZone::getOffset</methodname>
<methodparam><type>DateTime</type><parameter>datetime</parameter></methodparam>
<methodparam><type>DateTimeInterface</type><parameter>datetime</parameter></methodparam>
</methodsynopsis>
<para>&style.procedural;</para>
<methodsynopsis role="procedural">
<methodsynopsis>
<type>int</type><methodname>timezone_offset_get</methodname>
<methodparam><type>DateTimeZone</type><parameter>object</parameter></methodparam>
<methodparam><type>DateTime</type><parameter>datetime</parameter></methodparam>
<methodparam><type>DateTimeInterface</type><parameter>datetime</parameter></methodparam>
</methodsynopsis>
<para>
Esta función devuelve el índice GMT para la fecha/hora especificada en el
parámetro <parameter>datetime</parameter>. El índice GMT se calcula
con la información de la zona horaria contenida en el objeto DateTimeZone que se va a utilizar.
<function>timezone_offset_get</function> retorna el desplazamiento horario
respecto al GMT para el argumento <parameter>datetime</parameter>. El
desplazamiento GMT se calcula a partir de las informaciones de zona horaria
contenidas en el objeto <classname>DateTime</classname>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
@@ -37,45 +38,46 @@
<term><parameter>datetime</parameter></term>
<listitem>
<para>
El objeto DateTime que contiene la fecha/hora desde la que se va a computar el índice.
Objeto <classname>DateTime</classname> que contiene la fecha
para la cual se debe calcular el desplazamiento.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve el índice de la zona horaria en segundos si tiene éxito &return.falseforfailure;.
Retorna el desplazamiento horario, expresado en segundos, en caso de éxito.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo de <function>DateTimeZone::getOffset</function></title>
<title>Ejemplo con <function>DateTimeZone::getOffset</function></title>
<programlisting role="php">
<![CDATA[
<?php
// Crear dos objetos de zona horaria, uno para Taipéi (Taiwán) y otro para
// Tokyo (Japón)
// Crea dos objetos zona horaria, uno para Taipei (Taiwán) y uno para
// Tokio (Japón)
$dateTimeZoneTaipei = new DateTimeZone("Asia/Taipei");
$dateTimeZoneJapan = new DateTimeZone("Asia/Tokyo");
// Crear dos objetos DateTime que contendrán la misma fecha Unix, pero
// tendrán diferentes zonas horarias adjuntas.
// Crea dos objetos DateTime que contienen el mismo timestamp Unix,
// pero están situados en dos zonas horarias diferentes.
$dateTimeTaipei = new DateTime("now", $dateTimeZoneTaipei);
$dateTimeJapan = new DateTime("now", $dateTimeZoneJapan);
// Calcular el índice GMT para la fecha/hora contenida en el objeto $dateTimeTaipei,
// pero usando las normas de la zona horaria definidas en Tokyo
// Calcula el desplazamiento horario GMT para el objeto $dateTimeTaipei
// pero utilizando la zona horaria de Tokio
// ($dateTimeZoneJapan).
$timeOffset = $dateTimeZoneJapan->getOffset($dateTimeTaipei);
// Debería mostrar int(32400) (para fechas después de Sat Sep 8 01:00:00 1951 JST).
// Debería mostrar int(32400) (para las fechas posteriores al Sat Sep 8 01:00:00 1951 JST).
var_dump($timeOffset);
?>
]]>
@@ -83,9 +85,8 @@ var_dump($timeOffset);
</example>
</para>
</refsect1>
</refentry>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

177
reference/datetime/datetimezone/gettransitions.xml
View File

@@ -1,99 +1,124 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 09e22695159478cae928a19fc14d2447d56a8b09 Maintainer: chuso Status: ready -->
<!-- ES-Revision: 02ff7fef5b34cf8f5395180d9d39fb64d9398d00 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="datetimezone.gettransitions" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>DateTimeZone::getTransitions</refname>
<refname>timezone_transitions_get</refname>
<refpurpose>Devuelve todas las transiciones para una zona horaria</refpurpose>
<refpurpose>Devuelve todas las transiciones de una zona horaria</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<para>&style.oop;</para>
<methodsynopsis role="oop">
<modifier>public</modifier> <type>array</type><methodname>DateTimeZone::getTransitions</methodname>
<methodparam choice="opt"><type>int</type><parameter>timestamp_begin</parameter><initializer><constant>PHP_INT_MIN</constant></initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>timestamp_end</parameter><initializer><constant>PHP_INT_MAX</constant></initializer></methodparam>
<methodsynopsis role="DateTimeZone">
<modifier>public</modifier> <type class="union"><type>array</type><type>false</type></type><methodname>DateTimeZone::getTransitions</methodname>
<methodparam choice="opt"><type>int</type><parameter>timestampBegin</parameter><initializer><constant>PHP_INT_MIN</constant></initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>timestampEnd</parameter><initializer><constant>PHP_INT_MAX</constant></initializer></methodparam>
</methodsynopsis>
<para>&style.procedural;</para>
<methodsynopsis role="procedural">
<type>array</type><methodname>timezone_transitions_get</methodname>
<methodsynopsis>
<type class="union"><type>array</type><type>false</type></type><methodname>timezone_transitions_get</methodname>
<methodparam><type>DateTimeZone</type><parameter>object</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>timestamp_begin</parameter><initializer><constant>PHP_INT_MIN</constant></initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>timestamp_end</parameter><initializer><constant>PHP_INT_MAX</constant></initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>timestampBegin</parameter><initializer><constant>PHP_INT_MIN</constant></initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>timestampEnd</parameter><initializer><constant>PHP_INT_MAX</constant></initializer></methodparam>
</methodsynopsis>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
&date.datetimezone.description;
<varlistentry>
<term><parameter>timestamp_begin</parameter></term>
<term><parameter>timestampBegin</parameter></term>
<listitem>
<para>
Marca de tiempo de inicio.
Inicio del timestamp.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>timestamp_end</parameter></term>
<term><parameter>timestampEnd</parameter></term>
<listitem>
<para>
Marca de tiempo final.
Fin del timestamp.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Deveulve una matriz numérica que contiene una matriz asociativa con todas las
transiciones si se tuvo éxito &return.falseforfailure;.
Devuelve un array indexado numéricamente de arrays
de transición en caso de éxito, &return.falseforfailure;.
Los objetos DateTimeZone que envuelven zonas horarias de tipo 1 (desplazamiento UTC)
y tipo 2 (abreviaturas) no contienen transiciones y llamar
a este método sobre ellos devolverá &false;.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
Si <parameter>timestampBegin</parameter> es proporcionado, la primera entrada
en el array devuelto contendrá un elemento de transición al tiempo de
<parameter>timestampBegin</parameter>.
</para>
<para>
<table>
<title>Estructura de los arrays de transición</title>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
<entry>Clave</entry>
<entry>Tipo</entry>
<entry>Descripción</entry>
</row>
</thead>
<tbody>
<row>
<entry>5.3.0</entry>
<entry>
Se añadieron los parámetros opcionales <parameter>timestamp_begin</parameter> y
<parameter>timestamp_end</parameter>.
</entry>
<entry><literal>ts</literal></entry>
<entry><type>int</type></entry>
<entry>timestamp Unix</entry>
</row>
<row>
<entry><literal>time</literal></entry>
<entry><type>string</type></entry>
<entry>Cadena de tiempo <constant>DateTimeInterface::ISO8601_EXPANDED</constant> (PHP
8.2 y superior), o <constant>DateTimeInterface::ISO8601</constant> (PHP
8.1 e inferior)</entry>
</row>
<row>
<entry><literal>offset</literal></entry>
<entry><type>int</type></entry>
<entry>Desplazamiento horario hacia UTC en segundos</entry>
</row>
<row>
<entry><literal>isdst</literal></entry>
<entry><type>bool</type></entry>
<entry>Si la hora de verano está activada</entry>
</row>
<row>
<entry><literal>abbr</literal></entry>
<entry><type>string</type></entry>
<entry>Abreviatura de la zona horaria</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</table>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Un ejemplo de <function>timezone_transitions_get</function></title>
<title>Ejemplo con <function>timezone_transitions_get</function></title>
<programlisting role="php">
<![CDATA[
<?php
$zona_horaria = new DateTimeZone("Europe/London");
$transiciones = $zona_horaria->getTransitions();
print_r(array_slice($transiciones, 0, 3));
$timezone = new DateTimeZone("Europe/London");
$transitions = $timezone->getTransitions();
print_r(array_slice($transitions, 0, 3));
?>
]]>
</programlisting>
@@ -104,8 +129,57 @@ Array
(
[0] => Array
(
[ts] => -2147483648
[time] => 1901-12-13T20:45:52+0000
[ts] => -9223372036854775808
[time] => -292277022657-01-27T08:29:52+0000
[offset] => 3600
[isdst] => 1
[abbr] => BST
)
[1] => Array
(
[ts] => -1691964000
[time] => 1916-05-21T02:00:00+0000
[offset] => 3600
[isdst] => 1
[abbr] => BST
)
[2] => Array
(
[ts] => -1680472800
[time] => 1916-10-01T02:00:00+0000
[offset] => 0
[isdst] =>
[abbr] => GMT
)
)
]]>
</screen>
</example>
<example>
<title>Un ejemplo de <function>timezone_transitions_get</function> con
<parameter>timestampBegin</parameter> definido</title>
<programlisting role="php">
<![CDATA[
<?php
$timezone = new DateTimeZone("Europe/London");
$transitions = $timezone->getTransitions(time());
print_r(array_slice($transitions, 0, 3));
?>
]]>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
Array
(
[0] => Array
(
[ts] => 1654184161
[time] => 2022-06-02T15:36:01+0000
[offset] => 3600
[isdst] => 1
[abbr] => BST
@@ -113,20 +187,20 @@ Array
[1] => Array
(
[ts] => -1691964000
[time] => 1916-05-21T02:00:00+0000
[offset] => 3600
[isdst] => 1
[abbr] => BST
[ts] => 1667091600
[time] => 2022-10-30T01:00:00+0000
[offset] => 0
[isdst] =>
[abbr] => GMT
)
[2] => Array
(
[ts] => -1680472800
[time] => 1916-10-01T02:00:00+0000
[offset] => 0
[isdst] =>
[abbr] => GMT
[ts] => 1679792400
[time] => 2023-03-26T01:00:00+0000
[offset] => 3600
[isdst] => 1
[abbr] => BST
)
)
@@ -135,9 +209,8 @@ Array
</example>
</para>
</refsect1>
</refentry>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

46
reference/datetime/datetimezone/listabbreviations.xml
View File

@@ -1,39 +1,60 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 086dc12715921d77fe42d7cf578b6254c743aa3e Maintainer: chuso Status: ready -->
<!-- EN-Revision: 02ff7fef5b34cf8f5395180d9d39fb64d9398d00 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="datetimezone.listabbreviations" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>DateTimeZone::listAbbreviations</refname>
<refname>timezone_abbreviations_list</refname>
<refpurpose>Devuelve una matriz asociativa que contiene el horario de verano (dst), el índice y el nombre de la zona horaria</refpurpose>
<refpurpose>Devuelve un array asociativo que describe una zona horaria</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<para>&style.oop;</para>
<methodsynopsis role="oop">
<methodsynopsis role="DateTimeZone">
<modifier>public</modifier> <modifier>static</modifier> <type>array</type><methodname>DateTimeZone::listAbbreviations</methodname>
<void/>
</methodsynopsis>
<para>&style.procedural;</para>
<methodsynopsis role="procedural">
<methodsynopsis>
<type>array</type><methodname>timezone_abbreviations_list</methodname>
<void/>
</methodsynopsis>
<para>
La lista de abreviaturas devuelta contiene todos los usos históricos
de las abreviaturas, lo que puede dar lugar a entradas correctas, pero
confusas. Asimismo, existen conflictos, ya que <literal>PST</literal> se utiliza tanto
en Estados Unidos como en Filipinas.
</para>
<para>
La lista que devuelve esta función no es adecuada para construir un
menú de opciones que presente una selección de zonas horarias a los usuarios.
</para>
<note>
<para>
Los datos para esta función están precompilados por razones de
rendimiento y no se actualizan al utilizar una
<link xlink:href="&url.pecl.package;timezonedb">timezonedb</link> más reciente.
</para>
</note>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve una matriz si se tuvo éxito &return.falseforfailure;.
Devuelve el &array; de abreviaturas de zonas horarias.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Un ejemplo de <function>timezone_abbreviations_list</function></title>
<title>Ejemplo con <function>timezone_abbreviations_list</function></title>
<programlisting role="php">
<![CDATA[
<?php
@@ -81,7 +102,7 @@ Array
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -90,9 +111,8 @@ Array
</simplelist>
</para>
</refsect1>
</refentry>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

157
reference/datetime/datetimezone/listidentifiers.xml
View File

@@ -1,52 +1,52 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 9826ef1ad338ec6b1bfba8da59b137f17894422f Maintainer: seros Status: ready -->
<!-- EN-Revision: 02ff7fef5b34cf8f5395180d9d39fb64d9398d00 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="datetimezone.listidentifiers" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>DateTimeZone::listIdentifiers</refname>
<refname>timezone_identifiers_list</refname>
<refpurpose>Devuelve un array indexado numéricamente que contiene todos los identificadores de zonas horarias definidos</refpurpose>
<refpurpose>Devuelve un array numérico que contiene todos los identificadores de zonas horarias definidos</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<para>&style.oop;</para>
<methodsynopsis role="oop">
<methodsynopsis role="DateTimeZone">
<modifier>public</modifier> <modifier>static</modifier> <type>array</type><methodname>DateTimeZone::listIdentifiers</methodname>
<methodparam choice="opt"><type>int</type><parameter>what</parameter><initializer>DateTimeZone::ALL</initializer></methodparam>
<methodparam choice="opt"><type>string</type><parameter>country</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>timezoneGroup</parameter><initializer>DateTimeZone::ALL</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>countryCode</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>&style.procedural;</para>
<methodsynopsis role="procedural">
<methodsynopsis>
<type>array</type><methodname>timezone_identifiers_list</methodname>
<methodparam choice="opt"><type>int</type><parameter>what</parameter><initializer>DateTimeZone::ALL</initializer></methodparam>
<methodparam choice="opt"><type>string</type><parameter>country</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>timezoneGroup</parameter><initializer>DateTimeZone::ALL</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>countryCode</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>what</parameter></term>
<term><parameter>timezoneGroup</parameter></term>
<listitem>
<para>
Una de las constantes de la clase <classname>DateTimeZone</classname>.
Una (o una combinación) de las constantes de clase <classname>DateTimeZone</classname>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>country</parameter></term>
<term><parameter>countryCode</parameter></term>
<listitem>
<para>
Un código de país de dos letras compatible con ISO 3166-1.
Un código de país de dos letras (en mayúsculas), compatible con ISO 3166-1.
</para>
<note>
<simpara>
Esta opción sólo se usa cuando el parámetro <parameter>what</parameter> está
establecido a <constant>DateTimeZone::PER_COUNTRY</constant>.
Esta opción solo está disponible cuando el argumento
<parameter>timezoneGroup</parameter> toma el valor de
<constant>DateTimeZone::PER_COUNTRY</constant>.
</simpara>
</note>
</listitem>
@@ -54,14 +54,18 @@
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve una matriz si se tuvo éxito &return.falseforfailure;.
Devuelve el &array; de identificadores de zonas horarias.
Solo se devuelven los elementos no obsoletos. Para obtener todo,
incluyendo los identificadores de zonas horarias obsoletos, utilice
<literal>DateTimeZone::ALL_WITH_BC</literal> como valor para
<parameter>timezoneGroup</parameter>.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
@@ -75,10 +79,15 @@
</thead>
<tbody>
<row>
<entry>5.3.0</entry>
<entry>8.0.0</entry>
<entry>
Añadidos los parámteros opcionales <parameter>what</parameter> y
<parameter>country</parameter>.
Anterior a esta versión, &false; se devolvía en caso de error.
</entry>
</row>
<row>
<entry>7.1.0</entry>
<entry>
<parameter>countryCode</parameter> ahora es nullable.
</entry>
</row>
</tbody>
@@ -86,12 +95,12 @@
</informaltable>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Un ejemplo de <function>timezone_identifiers_list</function></title>
<title>Ejemplo con <methodname>DateTimeZone::listIdentifiers</methodname></title>
<programlisting role="php">
<![CDATA[
<?php
@@ -110,12 +119,107 @@ Africa/Accra
Africa/Addis_Ababa
Africa/Algiers
Africa/Asmara
]]>
</screen>
</example>
</para>
<para>
<example>
<title>Listar identificadores para una región específica</title>
<programlisting role="php">
<![CDATA[
<?php
$timezone_identifiers = DateTimeZone::listIdentifiers( DateTimeZone::ASIA );
for ($i=0; $i < 5; $i++) {
echo "$timezone_identifiers[$i]\n";
}
?>
]]>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
Asia/Aden
Asia/Almaty
Asia/Amman
Asia/Anadyr
Asia/Aqtau
]]>
</screen>
</example>
</para>
<para>
<example>
<title>Listar identificadores de múltiples regiones</title>
<programlisting role="php">
<![CDATA[
<?php
$timezone_identifiers = DateTimeZone::listIdentifiers( DateTimeZone::ASIA | DateTimeZone::PACIFIC );
echo join( ', ', $timezone_identifiers );
?>
]]>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
Asia/Aden, Asia/Almaty, Asia/Amman, Asia/Anadyr, Asia/Aqtau, Asia/Aqtobe,
Asia/Ashgabat, Asia/Atyrau, Asia/Baghdad, Asia/Bahrain, Asia/Baku,
Asia/Bangkok, Asia/Barnaul, Asia/Beirut, Asia/Bishkek, Asia/Brunei,
Asia/Chita, Asia/Choibalsan, Asia/Colombo, Asia/Damascus, Asia/Dhaka,
Asia/Dili, Asia/Dubai, Asia/Dushanbe, Asia/Famagusta, Asia/Gaza, Asia/Hebron,
Asia/Ho_Chi_Minh, Asia/Hong_Kong, Asia/Hovd, Asia/Irkutsk, Asia/Jakarta,
Asia/Jayapura, Asia/Jerusalem, Asia/Kabul, Asia/Kamchatka, Asia/Karachi,
Asia/Kathmandu, Asia/Khandyga, Asia/Kolkata, Asia/Krasnoyarsk,
Asia/Kuala_Lumpur, Asia/Kuching, Asia/Kuwait, Asia/Macau, Asia/Magadan,
Asia/Makassar, Asia/Manila, Asia/Muscat, Asia/Nicosia, Asia/Novokuznetsk,
Asia/Novosibirsk, Asia/Omsk, Asia/Oral, Asia/Phnom_Penh, Asia/Pontianak,
Asia/Pyongyang, Asia/Qatar, Asia/Qostanay, Asia/Qyzylorda, Asia/Riyadh,
Asia/Sakhalin, Asia/Samarkand, Asia/Seoul, Asia/Shanghai, Asia/Singapore,
Asia/Srednekolymsk, Asia/Taipei, Asia/Tashkent, Asia/Tbilisi, Asia/Tehran,
Asia/Thimphu, Asia/Tokyo, Asia/Tomsk, Asia/Ulaanbaatar, Asia/Urumqi,
Asia/Ust-Nera, Asia/Vientiane, Asia/Vladivostok, Asia/Yakutsk, Asia/Yangon,
Asia/Yekaterinburg, Asia/Yerevan, Pacific/Apia, Pacific/Auckland,
Pacific/Bougainville, Pacific/Chatham, Pacific/Chuuk, Pacific/Easter,
Pacific/Efate, Pacific/Fakaofo, Pacific/Fiji, Pacific/Funafuti,
Pacific/Galapagos, Pacific/Gambier, Pacific/Guadalcanal, Pacific/Guam,
Pacific/Honolulu, Pacific/Kanton, Pacific/Kiritimati, Pacific/Kosrae,
Pacific/Kwajalein, Pacific/Majuro, Pacific/Marquesas, Pacific/Midway,
Pacific/Nauru, Pacific/Niue, Pacific/Norfolk, Pacific/Noumea,
Pacific/Pago_Pago, Pacific/Palau, Pacific/Pitcairn, Pacific/Pohnpei,
Pacific/Port_Moresby, Pacific/Rarotonga, Pacific/Saipan, Pacific/Tahiti,
Pacific/Tarawa, Pacific/Tongatapu, Pacific/Wake, Pacific/Wallis
]]>
</screen>
</example>
</para>
<para>
<example>
<title>Listar identificadores de un solo país</title>
<programlisting role="php">
<![CDATA[
<?php
$timezone_identifiers = DateTimeZone::listIdentifiers( DateTimeZone::PER_COUNTRY, "UA" );
foreach( $timezone_identifiers as $identifier ) {
echo "$identifier\n";
}
?>
]]>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
Europe/Kyiv
Europe/Simferopol
Europe/Uzhgorod
Europe/Zaporozhye
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -124,9 +228,8 @@ Africa/Asmara
</simplelist>
</para>
</refsect1>
</refentry>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

40
reference/datetime/functions/date-create-immutable.xml
View File

@@ -1,18 +1,48 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: f65a959cffbedd3ea28377346c3e98631accbc28 Maintainer: seros Status: ready -->
<!-- Reviewed: yes Maintainer: seros -->
<!-- EN-Revision: 71692b6f4cace8dca72a18ccd80d4cd7305e5d4e Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="function.date-create-immutable" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>date_create_immutable</refname>
<refpurpose>&Alias; <methodname>DateTimeImmutable::__construct</methodname></refpurpose>
<refpurpose>Crea un nuevo objeto <classname>DateTimeImmutable</classname></refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type class="union"><type>DateTimeImmutable</type><type>false</type></type><methodname>date_create_immutable</methodname>
<methodparam choice="opt"><type>string</type><parameter>datetime</parameter><initializer>"now"</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>DateTimeZone</type><type>null</type></type><parameter>timezone</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
&info.function.alias; <methodname>DateTimeImmutable::__construct</methodname>
Versión procedimental de <methodname>DateTimeImmutable::__construct</methodname>.
</para>
<para>
A diferencia del constructor de <classname>DateTimeImmutable</classname>, esta función
devolverá &false; en lugar de una excepción si la cadena
<parameter>datetime</parameter> proporcionada no es válida.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
Ver <link linkend="datetimeimmutable.construct">DateTimeImmutable::__construct</link>.
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve una nueva instancia DateTimeImmutable &return.falseforfailure;
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><methodname>DateTimeImmutable::createFromFormat</methodname></member>
</simplelist>
</refsect1>
</refentry>

46
reference/datetime/functions/date-create.xml
View File

@@ -1,21 +1,53 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 03ab3321ba6104386f2b470abd56e1e1f33c39bd Maintainer: seros Status: ready -->
<!-- EN-Revision: 71692b6f4cace8dca72a18ccd80d4cd7305e5d4e Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.date-create" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>date_create</refname>
<refpurpose>&Alias; <methodname>DateTime::__construct</methodname></refpurpose>
<refpurpose>Creación de un objeto <classname>DateTime</classname></refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type class="union"><type>DateTime</type><type>false</type></type><methodname>date_create</methodname>
<methodparam choice="opt"><type>string</type><parameter>datetime</parameter><initializer>"now"</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>DateTimeZone</type><type>null</type></type><parameter>timezone</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
&info.function.alias; <methodname>DateTime::__construct</methodname>
Versión procedimental de <methodname>DateTime::__construct</methodname>
</para>
<para>
A diferencia del constructor de <classname>DateTime</classname>,
devolverá &false; en lugar de una excepción si la cadena
<parameter>datetime</parameter> no es válida.
</para>
</refsect1>
</refentry>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
Ver <link linkend="datetimeimmutable.construct">DateTimeImmutable::__construct</link>.
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve una nueva instancia DateTime &return.falseforfailure;
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><methodname>DateTimeImmutable::__construct</methodname></member>
<member><methodname>DateTimeImmutable::createFromFormat</methodname></member>
<member><methodname>DateTime::__construct</methodname></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

93
reference/datetime/functions/date-default-timezone-get.xml
View File

@@ -1,13 +1,15 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: e8964e3b43d31aa29a94c3f87b9ebfd90c39bae3 Maintainer: andresdzphp Status: ready -->
<!-- EN-Revision: 4bf21e8867650755d5dea13e01049d2825486ea2 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no Maintainer: PhilDaiguille -->
<refentry xml:id="function.date-default-timezone-get" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>date_default_timezone_get</refname>
<refpurpose>
Obtiene la zona horaria predeterminada usada por todas las funciones de fecha/hora en un script
Recupera el huso horario por defecto utilizado por todas las funciones de fecha/hora de un script
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
@@ -15,97 +17,57 @@
<void/>
</methodsynopsis>
<para>
En orden de preferencia, esta función devuelve la zona horaria predeternimada mediante:
Esta función devuelve el huso horario siguiendo el siguiente orden de preferencia:
<itemizedlist>
<listitem>
<para>
Leer la zona horaria usando la función
<function>date_default_timezone_set</function> (si hay alguna)
Lectura del huso horario definido utilizando la función
<function>date_default_timezone_set</function> (si existe)
</para>
</listitem>
<listitem>
<para>
<emphasis>Sólo</emphasis> antes de PHP 5.4.0: Leer la variable de
entorno <varname>TZ</varname> (si no está vacía)
</para>
</listitem>
<listitem>
<para>
Leer el valor de la opción ini <link linkend="ini.date.timezone">date.timezone</link>
(si está establecida)
</para>
</listitem>
<listitem>
<para>
<emphasis>Sólo</emphasis> antes de PHP 5.4.0: Preguntar al sistema operativo (siempre que el SO lo soporte y lo permita).
Utiliza un algoritmo que debe <emphasis>estimar</emphasis> la zona horaria. No funcionará de forma necesariamente correcta
en todas las situaciones posibles. Si se diera este caso, se mostrará una alerta. No se aconseja depender de esta función.
En su lugar, debe establecerse la zona horaria correcta con <link linkend="ini.date.timezone">date.timezone</link>
Lectura del valor de la opción de configuración
<link linkend="ini.date.timezone">date.timezone</link>
(si está definida)
</para>
</listitem>
</itemizedlist>
</para>
<para>
Si nada de lo de arriba sucedió, <methodname>date_default_timezone_get</methodname>
devolverá una zona horaria predeterminada de <literal>UTC</literal>.
Si todo lo anterior falla, <methodname>date_default_timezone_get</methodname>
devolverá el huso horario por defecto de <literal>UTC</literal>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve un <type>string</type>.
Devuelve un &string;.
</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>5.4.0</entry>
<entry>
La variable de entorno <literal>TZ</literal> ya no se usa para
adivinar la zona horaria.
</entry>
</row>
<row>
<entry>5.4.0</entry>
<entry>
La zona horaria ya no se adivina de la información disponible a
través del sistema operativo, la zona horaria adivinada no puede invocarse.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Obtener la zona horaria por defecto</title>
<title>Recuperación del huso horario por defecto</title>
<programlisting role="php">
<![CDATA[
<?php
date_default_timezone_set('Europe/London');
if (date_default_timezone_get()) {
echo 'date_default_timezone_set: ' . date_default_timezone_get() . '<br />';
echo 'date_default_timezone_set : ' . date_default_timezone_get() . '<br />';
}
if (ini_get('date.timezone')) {
echo 'date.timezone: ' . ini_get('date.timezone');
echo 'date.timezone : ' . ini_get('date.timezone');
}
?>
@@ -114,15 +76,15 @@ if (ini_get('date.timezone')) {
&example.outputs.similar;
<screen>
<![CDATA[
date_default_timezone_set: Europe/London
date.timezone: Europe/London
date_default_timezone_set : Europe/London
date.timezone : Europe/London
]]>
</screen>
</example>
</para>
<para>
<example>
<title>Obtener la abreviatura de una zona horaria</title>
<title>Recuperación de la abreviatura de un huso horario</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -140,7 +102,7 @@ America/Los_Angeles => America/Los_Angeles => PST
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -151,7 +113,6 @@ America/Los_Angeles => America/Los_Angeles => PST
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

92
reference/datetime/functions/date-default-timezone-set.xml
View File

@@ -1,72 +1,65 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bc8c8ab759cad03c35545ddc5ccfa13585b8d89b Maintainer: seros Status: ready -->
<!-- EN-Revision: 0a10abc50524fcbb21807b5e6ebffb3b86d45907 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes Maintainer: PhilDaiguille -->
<refentry xml:id="function.date-default-timezone-set" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>date_default_timezone_set</refname>
<refpurpose>
Establece la zona horaria predeterminada usada por todas las funciones de fecha/hora en un script
Establece la zona horaria por defecto para todas las funciones de fecha/hora
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>date_default_timezone_set</methodname>
<methodparam><type>string</type><parameter>timezone_identifier</parameter></methodparam>
<methodparam><type>string</type><parameter>timezoneId</parameter></methodparam>
</methodsynopsis>
<para>
<function>date_default_timezone_set</function> establece la zona horaria predetermiada usada
por todas las funciones de fecha/hora.
La función <function>date_default_timezone_set</function>
establece la zona horaria por defecto utilizada por todas
las funciones de fecha/hora.
</para>
<note>
<para>
A partir de PHP 5.1.0 (cuando las funciones de fecha/hora fueron reescritas), cada llamada
a la función de fecha/hora generará un <constant>E_NOTICE</constant> si
la zona horaria no es válida, y/o un mensaje <constant>E_WARNING</constant>
si se usa la configuración del sistema o la variable de entorno
<varname>TZ</varname>.
</para>
</note>
<para>
En vez de usar esta función para establecer la zona horaria predeterminada en su script,
puede usar también la configuración INI <link
linkend="ini.date.timezone">date.timezone</link> para establecer la zona horaria
predeterminada.
En lugar de utilizar esta función para establecer la zona horaria
por defecto en su script, también puede utilizarse
la configuración INI <link linkend="ini.date.timezone">date.timezone</link>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>timezone_identifier</parameter></term>
<term><parameter>timezoneId</parameter></term>
<listitem>
<para>
El indentificador de la zona horaria, como <literal>UTC</literal> o
<literal>Europe/Lisbon</literal>. La lista de los identificadores válidos está
disponible en la <xref linkend="timezones"/>.
El identificador de zona horaria, como <literal>UTC</literal>,
<literal>Africa/Lagos</literal>, <literal>Asia/Hong_Kong</literal>, o
<literal>Europe/Lisbon</literal>. La lista de identificadores válidos está
disponible en el <xref linkend="timezones"/>.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Esta función devuelve &false; si
<parameter>timezone_identifier</parameter> no es válido, o &true;
de otro modo.
Esta función devuelve &false; si <parameter>timezoneId</parameter>
no es válido, &true; en caso contrario.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Obtener la zona horaria por defecto</title>
<title>Obtención de la zona horaria por defecto</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -75,9 +68,9 @@ date_default_timezone_set('America/Los_Angeles');
$script_tz = date_default_timezone_get();
if (strcmp($script_tz, ini_get('date.timezone'))){
echo 'La zona horaria del script difiere de la zona horaria de la configuracion ini.';
echo 'La zona horaria del script difiere de la zona horaria definida en el archivo ini.';
} else {
echo 'La zona horaria del script y la zona horaria de la configuración ini coinciden.';
echo 'La zona horaria del script es equivalente a la definida en el archivo ini.';
}
?>
]]>
@@ -85,50 +78,17 @@ if (strcmp($script_tz, ini_get('date.timezone'))){
</example>
</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>5.3.0</entry>
<entry>
Ahora se lanza un <constant>E_WARNING</constant> en vez de un
<constant>E_STRICT</constant>.
</entry>
</row>
<row>
<entry>5.1.2</entry>
<entry>
La función comenzo a validar el parámetro
<parameter>timezone_identifier</parameter>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>date_default_timezone_get</function></member>
<member><xref linkend="timezones" /></member>
<member><xref linkend="timezones"/></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

7
reference/datetime/functions/date-get-last-errors.xml
View File

@@ -1,17 +1,18 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: seros Status: ready -->
<!-- EN-Revision: 35b75f06bcfe6ac452b8db82b4fb58d3b33180b9 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes Maintainer: PhilDaiguille -->
<refentry xml:id="function.date-get-last-errors" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>date_get_last_errors</refname>
<refpurpose>&Alias; <methodname>DateTime::getLastErrors</methodname></refpurpose>
<refpurpose>&Alias; <methodname>DateTimeImmutable::getLastErrors</methodname></refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<para>
&info.function.alias; <methodname>DateTime::getLastErrors</methodname>
&info.function.alias; <methodname>DateTimeImmutable::getLastErrors</methodname>
</para>
</refsect1>

197
reference/datetime/functions/date-parse-from-format.xml
View File

@@ -1,25 +1,27 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 18731686eae05a911f4da304528ebcbb45f5ab37 Maintainer: agarzon Status: ready -->
<!-- EN-Revision: 4d13f5e4b45f699eb855a5e84736aeda2ebd142a Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.date-parse-from-format" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>date_parse_from_format</refname>
<refpurpose>Obtiene información de una fecha dada formateada de acuerdo al formato especificado</refpurpose>
<refpurpose>Recupera las informaciones de una fecha dada siguiendo un formato específico</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>array</type><methodname>date_parse_from_format</methodname>
<methodparam><type>string</type><parameter>format</parameter></methodparam>
<methodparam><type>string</type><parameter>date</parameter></methodparam>
<methodparam><type>string</type><parameter>datetime</parameter></methodparam>
</methodsynopsis>
<para>
Devuelve una matriz asociativa con información detallada acerca de la fecha dada.
Devuelve un array asociativo que contiene informaciones
detalladas sobre una fecha/hora dada.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
@@ -28,64 +30,121 @@
<term><parameter>format</parameter></term>
<listitem>
<para>
Un formato aceptado por <function>DateTime::createFromFormat</function>.
Documentación sobre el uso del <parameter>format</parameter>,
por favor referirse a la documentación de
<function>DateTimeImmutable::createFromFormat</function>. Las
mismas reglas se aplican.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>date</parameter></term>
<term><parameter>datetime</parameter></term>
<listitem>
<para>
Una cadena que representa la fecha.
Cadena que representa la fecha/hora.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<!-- See also &return.success; -->
<para>
Devuelve una matriz asociativa con información detallada de la fecha dada.
Devuelve un array asociativo con informaciones detalladas
sobre la fecha/hora dada.
</para>
<para>
El array devuelto tiene claves para <literal>year</literal>,
<literal>month</literal>, <literal>day</literal>, <literal>hour</literal>,
<literal>minute</literal>, <literal>second</literal>,
<literal>fraction</literal>, y <literal>is_localtime</literal>.
</para>
<para>
Si <literal>is_localtime</literal> está presente, entonces
<literal>zone_type</literal> indica el tipo de zona horaria. Para el tipo
<literal>1</literal> (desplazamiento UTC) se añaden los campos
<literal>zone</literal> y <literal>is_dst</literal>. Para el tipo
<literal>2</literal> (abreviatura) se añaden los campos
<literal>tz_abbr</literal> y <literal>is_dst</literal>. Para el tipo
<literal>3</literal> (identificador de zona horaria) se añaden los campos
<literal>tz_abbr</literal> y <literal>tz_id</literal>.
</para>
<para>
El array incluye los campos <literal>warning_count</literal> y
<literal>warnings</literal>. El primero indica el número
de advertencias. Las claves del array <literal>warnings</literal>
indican la posición en el parámetro <parameter>datetime</parameter>
donde ocurrió la advertencia, con el valor de cadena que describe
la advertencia misma. Un ejemplo a continuación muestra tal advertencia.
</para>
<para>
El array incluye también los campos <literal>error_count</literal> y
<literal>errors</literal>. El primero indica el número
de errores. Las claves del array <literal>errors</literal> indican
la posición en el parámetro <parameter>datetime</parameter> donde ocurrió el error,
con el valor de cadena que describe la advertencia misma. Un ejemplo a continuación muestra tal advertencia.
</para>
<warning>
<para>
El número de elementos de array en los arrays <literal>warnings</literal> y
<literal>errors</literal> puede ser inferior a <literal>warning_count</literal>
o <literal>error_count</literal> si ocurrieron en la misma posición.
</para>
</warning>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<para>
Esta función lanza una <exceptionname>ValueError</exceptionname> cuando el
<parameter>datetime</parameter> contiene bytes NULL.
</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>
El elemento de <literal>zone</literal> devuelto representa ahora segundos en lugar de minutos, y su signo está invertido. Por ejemplo
<literal>-120</literal> es ahora <literal>7200</literal>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.21, 8.1.8, 8.2.0</entry>
<entry>
Ahora lanza una <exceptionname>ValueError</exceptionname> cuando se pasan bytes NULL
en <parameter>datetime</parameter>, lo cual antes era ignorado silenciosamente.
</entry>
</row>
<row>
<entry>7.2.0</entry>
<entry>
El elemento <literal>zone</literal> del array devuelto representa segundos
en lugar de minutos ahora, y su signo es invertido. Por ejemplo
<literal>-120</literal> ahora es igual a <literal>7200</literal>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo de <function>date_parse_from_format</function></title>
<title>Ejemplo con <function>date_parse_from_format</function></title>
<programlisting role="php">
<![CDATA[
<?php
$fecha = "6.1.2009 13:00+01:00";
print_r(date_parse_from_format("j.n.Y H:iP", $fecha));
$date = "6.1.2009 13:00+01:00";
print_r(date_parse_from_format("j.n.Y H:iP", $date));
?>
]]>
</programlisting>
@@ -100,7 +159,7 @@ Array
[hour] => 13
[minute] => 0
[second] => 0
[fraction] =>
[fraction] =>
[warning_count] => 0
[warnings] => Array
(
@@ -114,18 +173,76 @@ Array
[is_localtime] => 1
[zone_type] => 1
[zone] => 3600
[is_dst] =>
[is_dst] =>
)
]]>
</screen>
</example>
</para>
<para>
<example>
<title>
Ejemplo de <function>date_parse_from_format</function>
con advertencias
</title>
<programlisting role="php">
<![CDATA[
<?php
$date = "26 August 2022 22:30 pm";
$parsed = date_parse_from_format("j F Y G:i a", $date);
echo "Warnings count: ", $parsed['warning_count'], "\n";
foreach ($parsed['warnings'] as $position => $message) {
echo "\tOn position {$position}: {$message}\n";
}
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Warnings count: 1
On position 23: The parsed time was invalid
]]>
</screen>
</example>
</para>
<para>
<example>
<title>
Ejemplo de <function>date_parse_from_format</function>
con errores
</title>
<programlisting role="php">
<![CDATA[
<?php
$date = "26 August 2022 CEST";
$parsed = date_parse_from_format("j F Y H:i", $date);
echo "Errors count: ", $parsed['error_count'], "\n";
foreach ($parsed['errors'] as $position => $message) {
echo "\tOn position {$position}: {$message}\n";
}
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Errors count: 3
On position 15: A two digit hour could not be found
On position 19: Data missing
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>DateTime::createFromFormat</function></member>
<member><function>DateTimeImmutable::createFromFormat</function></member>
<member><function>checkdate</function></member>
</simplelist>
</para>

471
reference/datetime/functions/date-parse.xml
View File

@@ -1,150 +1,483 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 8d6a0d5257c38a844ef29a2b71ac4fcb1bd0ca87 Maintainer: seros Status: ready -->
<!-- EN-Revision: 50dcf55ce543220dd8375df2fdb4f7db702b9c9f Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.date-parse" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>date_parse</refname>
<refpurpose>Devuelve un array asociativo con información detallada acerca de una fecha dada</refpurpose>
<refpurpose>Retorna un array asociativo con información detallada sobre una fecha/hora dada</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>array</type><methodname>date_parse</methodname>
<methodparam><type>string</type><parameter>date</parameter></methodparam>
<methodparam><type>string</type><parameter>datetime</parameter></methodparam>
</methodsynopsis>
<para>
<function>date_parse</function> analiza la cadena
<parameter>datetime</parameter> dada según las mismas reglas
<function>strtotime</function> y
<function>DateTimeImmutable::__construct</function>. En lugar de
devolver un timestamp Unix (con <function>strtotime</function>) o
un objeto <classname>DateTimeImmutable</classname> (con
<function>DateTimeImmutable::__construct</function>), devuelve un
array asociativo con la información que podría detectar en
la cadena <parameter>datetime</parameter> dada.
</para>
<para>
Si no se puede encontrar información sobre un cierto grupo de elementos, estos
elementos del array serán definidos como &false; o estarán ausentes. Si es necesario
para construir un timestamp o un objeto <classname>DateTimeImmutable</classname> a partir
de la misma cadena <parameter>datetime</parameter>, varios campos pueden ser definidos
con un valor no-&false;. Ver los ejemplos a continuación para los casos en que esto ocurre.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>date</parameter></term>
<term><parameter>datetime</parameter></term>
<listitem>
<para>
La fecha en un formato aceptado por <function>strtotime</function>.
Fecha/hora en un formato aceptado por
<function>DateTimeImmutable::__construct</function>.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve un <type>array</type> con información sobre la fecha analizada si
tuvo éxito &return.falseforfailure;.
Retorna un &array; que contiene información sobre la fecha/hora analizada.
</para>
<para>
El array retornado tiene claves para <literal>year</literal>,
<literal>month</literal>, <literal>day</literal>, <literal>hour</literal>,
<literal>minute</literal>, <literal>second</literal>,
<literal>fraction</literal>, y <literal>is_localtime</literal>.
</para>
<para>
Si <literal>is_localtime</literal> está presente, entonces
<literal>zone_type</literal> indica el tipo de zona horaria. Para el tipo
<literal>1</literal> (desplazamiento UTC) los campos
<literal>zone</literal> y <literal>is_dst</literal> son añadidos. Para el tipo
<literal>2</literal> (abreviatura) los campos
<literal>tz_abbr</literal> y <literal>is_dst</literal> son añadidos. Para el tipo
<literal>3</literal> (identificador de zona horaria) los campos
<literal>tz_abbr</literal> y <literal>tz_id</literal> son añadidos.
</para>
<para>
El array incluye los campos <literal>warning_count</literal> y
<literal>warnings</literal>. El primero indica el número
de advertencias. Las claves del array <literal>warnings</literal>
indican la posición en el parámetro <parameter>datetime</parameter>
donde ocurrió la advertencia, con el valor de cadena describiendo
la advertencia misma. Un ejemplo a continuación muestra tal advertencia.
</para>
<para>
El array incluye también los campos <literal>error_count</literal> y
<literal>errors</literal>. El primero indica el número
de errores. Las claves del array <literal>errors</literal> indican
la posición en el parámetro <parameter>datetime</parameter> donde ocurrió
el error, con el valor de cadena describiendo la advertencia
misma. Un ejemplo a continuación muestra tal advertencia.
</para>
<warning>
<para>
El número de elementos de array en los arrays <literal>warnings</literal> y
<literal>errors</literal> puede ser inferior a <literal>warning_count</literal>
o <literal>error_count</literal> si ocurrieron en la misma posición.
</para>
</warning>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<para>
En caso de que el formato de fecha tenga un error, el elemento 'errors'
En el caso de que la función retorne un error, el elemento <literal>"errors"</literal>
contendrá los mensajes de error.
</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>
El elemento <literal>zone</literal> del array retornado ahora representa
segundos en lugar de minutos, y su signo es invertido. Por ejemplo,
<literal>-120</literal> ahora es <literal>7200</literal>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Un ejemplo de <function>date_parse</function></title>
<title><function>date_parse</function> con una cadena
<parameter>datetime</parameter> completa</title>
<programlisting role="php">
<![CDATA[
<?php
print_r(date_parse("2006-12-12 10:00:00.5"));
var_dump(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] =>
)
array(12) {
["year"]=>
int(2006)
["month"]=>
int(12)
["day"]=>
int(12)
["hour"]=>
int(10)
["minute"]=>
int(0)
["second"]=>
int(0)
["fraction"]=>
float(0.5)
["warning_count"]=>
int(0)
["warnings"]=>
array(0) {
}
["error_count"]=>
int(0)
["errors"]=>
array(0) {
}
["is_localtime"]=>
bool(false)
}
]]>
</screen>
</example>
</para>
<para>
Los elementos de zona horaria solo aparecen si están incluidos
en la cadena <parameter>datetime</parameter> dada. En este caso,
siempre habrá un elemento <literal>zone_type</literal> y algunos otros
dependiendo de su valor.
<example>
<title><function>date_parse</function> con información abreviada sobre la zona horaria</title>
<programlisting role="php">
<![CDATA[
<?php
var_dump(date_parse("June 2nd, 2022, 10:28:17 BST"));
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
array(16) {
["year"]=>
int(2022)
["month"]=>
int(6)
["day"]=>
int(2)
["hour"]=>
int(10)
["minute"]=>
int(28)
["second"]=>
int(17)
["fraction"]=>
float(0)
["warning_count"]=>
int(0)
["warnings"]=>
array(0) {
}
["error_count"]=>
int(0)
["errors"]=>
array(0) {
}
["is_localtime"]=>
bool(true)
["zone_type"]=>
int(2)
["zone"]=>
int(0)
["is_dst"]=>
bool(true)
["tz_abbr"]=>
string(3) "BST"
}
]]>
</screen>
</example>
<example>
<title><function>date_parse</function> con información abreviada sobre la zona horaria</title>
<programlisting role="php">
<![CDATA[
<?php
var_dump(date_parse("June 2nd, 2022, 10:28:17 Europe/London"));
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
array(14) {
["year"]=>
int(2022)
["month"]=>
int(6)
["day"]=>
int(2)
["hour"]=>
int(10)
["minute"]=>
int(28)
["second"]=>
int(17)
["fraction"]=>
float(0)
["warning_count"]=>
int(0)
["warnings"]=>
array(0) {
}
["error_count"]=>
int(0)
["errors"]=>
array(0) {
}
["is_localtime"]=>
bool(true)
["zone_type"]=>
int(3)
["tz_id"]=>
string(13) "Europe/London"
}
]]>
</screen>
</example>
</para>
<para>
Los <link linkend="datetime.formats.relative">formatos relativos</link> no
influyen en los valores de los formatos absolutos, aunque son convertidos en el
elemento "relative".
Si se analiza una cadena <parameter>datetime</parameter> más mínima,
hay menos información disponible. En este ejemplo, todas las partes
temporales son retornadas como &false;.
<example>
<title><function>date_parse</function> con formatos relativos</title>
<title>
<function>date_parse</function> con
una cadena mínima
</title>
<programlisting role="php">
<![CDATA[
<?php
print_r(date_parse("2006-12-12 10:00:00.5 +1 week +1 hour"));
var_dump(date_parse("June 2nd, 2022"));
?>
]]>
</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
)
)]]>
array(12) {
["year"]=>
int(2022)
["month"]=>
int(6)
["day"]=>
int(2)
["hour"]=>
bool(false)
["minute"]=>
bool(false)
["second"]=>
bool(false)
["fraction"]=>
bool(false)
["warning_count"]=>
int(0)
["warnings"]=>
array(0) {
}
["error_count"]=>
int(0)
["errors"]=>
array(0) {
}
["is_localtime"]=>
bool(false)
}
]]>
</screen>
</example>
</para>
<para>
<link linkend="datetime.formats.relative">Los formatos relativos</link>
no influyen en los valores analizados desde formatos absolutos, pero
son analizados en el elemento "relativo".
<example>
<title>Ejemplo con <function>date_parse</function> y formatos relativos</title>
<programlisting role="php">
<![CDATA[
<?php
var_dump(date_parse("2006-12-12 10:00:00.5 +1 week +1 hour"));
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
array(13) {
["year"]=>
int(2006)
["month"]=>
int(12)
["day"]=>
int(12)
["hour"]=>
int(10)
["minute"]=>
int(0)
["second"]=>
int(0)
["fraction"]=>
float(0.5)
["warning_count"]=>
int(0)
["warnings"]=>
array(0) {
}
["error_count"]=>
int(0)
["errors"]=>
array(0) {
}
["is_localtime"]=>
bool(false)
["relative"]=>
array(6) {
["year"]=>
int(0)
["month"]=>
int(0)
["day"]=>
int(7)
["hour"]=>
int(1)
["minute"]=>
int(0)
["second"]=>
int(0)
}
}
]]>
</screen>
</example>
</para>
<para>
Algunas estrofas, tales como <literal>Thursday</literal> (jueves) definirán
la parte hora de la cadena como <literal>0</literal>. Si <literal>Thursday</literal>
(jueves) se pasa a <function>DateTimeImmutable::__construct</function> la hora,
el minuto, el segundo y la fracción también serán definidos como
<literal>0</literal>. En el ejemplo a continuación, el elemento año
sin embargo es dejado como &false;.
<example>
<title><function>date_parse</function> con efectos secundarios</title>
<programlisting role="php">
<![CDATA[
<?php
var_dump(date_parse("Thursday, June 2nd"));
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
array(13) {
["year"]=>
bool(false)
["month"]=>
int(6)
["day"]=>
int(2)
["hour"]=>
int(0)
["minute"]=>
int(0)
["second"]=>
int(0)
["fraction"]=>
float(0)
["warning_count"]=>
int(0)
["warnings"]=>
array(0) {
}
["error_count"]=>
int(0)
["errors"]=>
array(0) {
}
["is_localtime"]=>
bool(false)
["relative"]=>
array(7) {
["year"]=>
int(0)
["month"]=>
int(0)
["day"]=>
int(0)
["hour"]=>
int(0)
["minute"]=>
int(0)
["second"]=>
int(0)
["weekday"]=>
int(4)
}
}
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>checkdate</function></member>
<member><function>date_parse_from_format</function> para analizar
el parámetro <parameter>datetime</parameter> con un formato específico</member>
<member><function>checkdate</function> para una validación de fecha Gregoriana</member>
<member><function>getdate</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

14
reference/datetime/functions/date-sub.xml
View File

@@ -1,6 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: seros Status: ready -->
<!-- EN-Revision: 5c951013ca04161992efed8b86fb40f55669958e Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes Maintainer: PhilDaiguille -->
<refentry xml:id="function.date-sub" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>date_sub</refname>
@@ -14,6 +16,16 @@
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>DateTimeImmutable::sub</function></member>
<member><function>DateTime::sub</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

234
reference/datetime/functions/date-sun-info.xml
View File

@@ -1,16 +1,18 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: seros Status: ready -->
<!-- EN-Revision: 03b6583a4ade7a2b68b57fe958d2d9022b15a873 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.date-sun-info" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>date_sun_info</refname>
<refpurpose>Devuelve una matriz con información sobre la puesta/salida del sol y el comienzo/final del crepúsculo</refpurpose>
<refpurpose>Retorna un array con las informaciones sobre el amanecer/atardecer
así como el inicio y el fin del amanecer</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>array</type><methodname>date_sun_info</methodname>
<methodparam><type>int</type><parameter>time</parameter></methodparam>
<methodparam><type>int</type><parameter>timestamp</parameter></methodparam>
<methodparam><type>float</type><parameter>latitude</parameter></methodparam>
<methodparam><type>float</type><parameter>longitude</parameter></methodparam>
</methodsynopsis>
@@ -21,10 +23,10 @@
<para>
<variablelist>
<varlistentry>
<term><parameter>time</parameter></term>
<term><parameter>timestamp</parameter></term>
<listitem>
<para>
Marca de tiempo.
Timestamp Unix.
</para>
</listitem>
</varlistentry>
@@ -32,7 +34,7 @@
<term><parameter>latitude</parameter></term>
<listitem>
<para>
Latitud en grados.
Latitud, en grados.
</para>
</listitem>
</varlistentry>
@@ -40,7 +42,7 @@
<term><parameter>longitude</parameter></term>
<listitem>
<para>
Longitud en grados.
Longitud, en grados.
</para>
</listitem>
</varlistentry>
@@ -51,7 +53,119 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve una matriz si se tuvo éxito &return.falseforfailure;.
Retorna un array cuya estructura del array se detalla en la lista siguiente:
</para>
<para>
<variablelist>
<varlistentry>
<term><literal>sunrise</literal></term>
<listitem>
<simpara>
El timestamp del amanecer (ángulo de zenit = 90°35').
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>sunset</literal></term>
<listitem>
<simpara>
El timestamp del atardecer (ángulo de zenit = 90°35').
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>transit</literal></term>
<listitem>
<simpara>
El timestamp donde el sol está en su cenit, es decir ha
alcanzado su punto más alto.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>civil_twilight_begin</literal></term>
<listitem>
<simpara>
El inicio del amanecer civil (ángulo de zenit = 96°). Termina en el
<literal>sunrise</literal>.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>civil_twilight_end</literal></term>
<listitem>
<simpara>
El fin del crepúsculo civil (ángulo de zenit = 96°). Comienza en el
<literal>sunset</literal>.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>nautical_twilight_begin</literal></term>
<listitem>
<simpara>
El inicio del amanecer náutico (ángulo de zenit = 102°). Termina en el
<literal>civil_twilight_begin</literal>.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>nautical_twilight_end</literal></term>
<listitem>
<simpara>
El fin del crepúsculo náutico (ángulo de zenit = 102°). Comienza en
<literal>civil_twilight_end</literal>.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>astronomical_twilight_begin</literal></term>
<listitem>
<simpara>
El inicio del amanecer astronómico (ángulo de zenit = 108°). Termina en el
<literal>nautical_twilight_begin</literal>.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>astronomical_twilight_end</literal></term>
<listitem>
<simpara>
El fin del crepúsculo astronómico (ángulo de zenit = 108°). Comienza en
<literal>nautical_twilight_end</literal>.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
Los valores de los elementos del array son timestamps UNIX, &false;, si el sol está bajo el zenit
respectivo durante todo el día, o &true;, si el sol está sobre el zenit respectivo durante todo el día.
</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>7.2.0</entry>
<entry>
El cálculo ha sido corregido teniendo en cuenta la medianoche local en lugar del mediodía local,
lo que modifica ligeramente los resultados.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
@@ -59,13 +173,13 @@
&reftitle.examples;
<para>
<example>
<title>Un ejemplo de <function>date_sun_info</function></title>
<title>Ejemplo con <function>date_sun_info</function></title>
<programlisting role="php">
<![CDATA[
<?php
$sun_info = date_sun_info(strtotime("2006-12-12"), 31.7667, 35.2333);
foreach ($sun_info as $clave => $valor) {
echo "$clave: " . date("H:i:s", $valor) . "\n";
foreach ($sun_info as $key => $val) {
echo "$key: " . date("H:i:s", $val) . "\n";
}
?>
]]>
@@ -86,20 +200,102 @@ astronomical_twilight_end: 17:12:00
</screen>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>date_sunrise</function></member>
<member><function>date_sunset</function></member>
</simplelist>
<example>
<title>Noche polar con un poco de tratamiento</title>
<programlisting role="php">
<![CDATA[
<?php
$tz = new \DateTimeZone('America/Anchorage');
$si = date_sun_info(strtotime("2022-12-21"), 70.21, -148.51);
foreach ($si as $key => $value) {
echo
match ($value) {
true => 'always',
false => 'never',
default => date_create("@{$value}")->setTimeZone($tz)->format( 'H:i:s T' ),
},
": {$key}",
"\n";
}
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
never: sunrise
never: sunset
12:52:18 AKST: transit
10:53:19 AKST: civil_twilight_begin
14:51:17 AKST: civil_twilight_end
09:01:47 AKST: nautical_twilight_begin
16:42:48 AKST: nautical_twilight_end
07:40:47 AKST: astronomical_twilight_begin
18:03:49 AKST: astronomical_twilight_end
]]>
</screen>
</example>
</para>
<para>
<example>
<title>Sol de medianoche (Tromso, Noruega)</title>
<programlisting role="php">
<![CDATA[
<?php
$si = date_sun_info(strtotime("2022-06-26"), 69.68, 18.94);
print_r($si);
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Array
(
[sunrise] => 1
[sunset] => 1
[transit] => 1656240426
[civil_twilight_begin] => 1
[civil_twilight_end] => 1
[nautical_twilight_begin] => 1
[nautical_twilight_end] => 1
[astronomical_twilight_begin] => 1
[astronomical_twilight_end] => 1
)
]]>
</screen>
</example>
</para>
<para>
<example>
<title>Cálculo de la duración del día (Kiev)</title>
<programlisting role="php">
<![CDATA[
<?php
$si = date_sun_info(strtotime('2022-08-26'), 50.45, 30.52);
$diff = $si['sunset'] - $si['sunrise'];
echo "Duración del día: ",
floor($diff / 3600), "h ",
floor(($diff % 3600) / 60), "s\n";
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Duración del día: 13h 56s
]]>
</screen>
</example>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

161
reference/datetime/functions/date-sunrise.xml
View File

@@ -1,26 +1,39 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 14af302c9c0e561fa6f9cdd956268758ba9a89c5 Maintainer: seros Status: ready -->
<refentry xml:id="function.date-sunrise" xmlns="http://docbook.org/ns/docbook">
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.date-sunrise" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>date_sunrise</refname>
<refpurpose>Devuelve la hora de la salida del sol de un día y ubicación dados</refpurpose>
<refpurpose>Devuelve la hora de salida del sol para un día y un lugar dados</refpurpose>
</refnamediv>
<refsynopsisdiv>
<warning>
<para>
Esta función está <emphasis>DEPRECADA</emphasis> a partir de PHP 8.1.0.
Depender de esta función se desaconseja fuertemente. Se recomienda
el uso de <function>date_sun_info</function> en su lugar.
</para>
</warning>
</refsynopsisdiv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>mixed</type><methodname>date_sunrise</methodname>
<modifier role="attribute">#[\Deprecated]</modifier>
<type class="union"><type>string</type><type>int</type><type>float</type><type>false</type></type><methodname>date_sunrise</methodname>
<methodparam><type>int</type><parameter>timestamp</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>format</parameter><initializer>SUNFUNCS_RET_STRING</initializer></methodparam>
<methodparam choice="opt"><type>float</type><parameter>latitude</parameter><initializer>ini_get("date.default_latitude")</initializer></methodparam>
<methodparam choice="opt"><type>float</type><parameter>longitude</parameter><initializer>ini_get("date.default_longitude")</initializer></methodparam>
<methodparam choice="opt"><type>float</type><parameter>zenith</parameter><initializer>ini_get("date.sunrise_zenith")</initializer></methodparam>
<methodparam choice="opt"><type>float</type><parameter>gmt_offset</parameter><initializer>0</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>returnFormat</parameter><initializer><constant>SUNFUNCS_RET_STRING</constant></initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>float</type><type>null</type></type><parameter>latitude</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>float</type><type>null</type></type><parameter>longitude</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>float</type><type>null</type></type><parameter>zenith</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>float</type><type>null</type></type><parameter>utcOffset</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<function>date_sunrise</function> devuelve la hora de la salida del sol para un día
(especificado como <parameter>timestamp</parameter>) y ubicación dados.
<function>date_sunrise</function> devuelve la hora de salida del sol para un día
(especificado por el argumento <parameter>timestamp</parameter>) y un lugar dados.
</para>
</refsect1>
@@ -32,39 +45,38 @@
<term><parameter>timestamp</parameter></term>
<listitem>
<para>
La marca de tiempo <parameter>timestamp</parameter> del día del que se va a tomar
la salida del sol.
El timestamp Unix del día para el cual se proporciona la hora de salida del sol.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>format</parameter></term>
<term><parameter>returnFormat</parameter></term>
<listitem>
<para>
<table>
<title>Constantes <parameter>format</parameter></title>
<title>Constantes para el argumento <parameter>format</parameter></title>
<tgroup cols="2">
<thead>
<row>
<entry>constante</entry>
<entry>descripción</entry>
<entry>ejemplo</entry>
<entry>Constante</entry>
<entry>Descripción</entry>
<entry>Ejemplo</entry>
</row>
</thead>
<tbody>
<row>
<entry>SUNFUNCS_RET_STRING</entry>
<entry>devuelve el resultado como <type>string</type></entry>
<entry>Devuelve el resultado como &string;</entry>
<entry>16:46</entry>
</row>
<row>
<entry>SUNFUNCS_RET_DOUBLE</entry>
<entry>devuelve el resultado como <type>float</type></entry>
<entry>Devuelve el resultado como &float;</entry>
<entry>16.78243132</entry>
</row>
<row>
<entry>SUNFUNCS_RET_TIMESTAMP</entry>
<entry>devuelve el resultado como <type>integer</type> (timestamp)</entry>
<entry>Devuelve el resultado como &integer; (timestamp)</entry>
<entry>1095034606</entry>
</row>
</tbody>
@@ -77,8 +89,8 @@
<term><parameter>latitude</parameter></term>
<listitem>
<para>
La latitud, por defecto a Norte, y como valor negativo a Sur.
Vea también: <literal>date.default_latitude</literal>
Por defecto, es el Norte. Pase un valor negativo para el Sur.
Ver también <link linkend="ini.date.default-latitude">date.default_latitude</link>.
</para>
</listitem>
</varlistentry>
@@ -86,8 +98,8 @@
<term><parameter>longitude</parameter></term>
<listitem>
<para>
La longitud, por defecto a Este, y como valor negativo a Oeste.
Vea tambien: <literal>date.default_longitude</literal>
Por defecto, es el Este. Pase un valor negativo para el Oeste.
Ver también <link linkend="ini.date.default-longitude">date.default_longitude</link>.
</para>
</listitem>
</varlistentry>
@@ -95,15 +107,49 @@
<term><parameter>zenith</parameter></term>
<listitem>
<para>
El cénit, por defecto: <literal>date.sunset_zenith</literal>
<parameter>zenith</parameter> es el ángulo entre el centro del
sol y la línea perpendicular a la superficie de la tierra. Por defecto
<link linkend="ini.date.sunrise-zenith">date.sunrise_zenith</link>
<table>
<title>Valores comunes del ángulo <parameter>zenith</parameter></title>
<tgroup cols="2">
<thead>
<row>
<entry>Ángulo</entry>
<entry>Descripción</entry>
</row>
</thead>
<tbody>
<row>
<entry>90°50'</entry>
<entry>Salida del sol: el punto donde el sol se vuelve visible.</entry>
</row>
<row>
<entry>96°</entry>
<entry>Crepúsculo civil: convencionalmente utilizado para significar el inicio del amanecer.</entry>
</row>
<row>
<entry>102°</entry>
<entry>Crepúsculo náutico: el punto donde el horizonte comienza a ser visible en el mar.</entry>
</row>
<row>
<entry>108°</entry>
<entry>Crepúsculo astronómico: el punto donde el sol comienza a ser la fuente de toda iluminación.</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>gmtoffset</parameter></term>
<term><parameter>utcOffset</parameter></term>
<listitem>
<para>
El índice GMT especificado en horas.
Especificado en horas.
El <parameter>utcOffset</parameter> se ignora si
<parameter>returnFormat</parameter> es
<constant>SUNFUNCS_RET_TIMESTAMP</constant>.
</para>
</listitem>
</varlistentry>
@@ -114,16 +160,17 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve la hora de la salida del sol en un formato <parameter>format</parameter> especificado
si se tuvo éxito &return.falseforfailure;.
Devuelve la hora de salida del sol en el <parameter>returnFormat</parameter>
especificado en caso de éxito&return.falseforfailure;.
Una razón posible del fallo es que el sol no salga
en absoluto, lo cual ocurre dentro de los círculos
polares durante parte del año.
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
&date.timezone.errors.description;
&date.timezone.errors.description;
</refsect1>
<refsect1 role="changelog">
@@ -138,9 +185,19 @@
</row>
</thead>
<tbody>
&date.timezone.errors.changelog;
<row>
<entry>8.1.0</entry>
<entry>
Esta función ha sido marcada como obsoleta en favor de <function>date_sun_info</function>.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
<parameter>latitude</parameter>, <parameter>longitude</parameter>,
<parameter>zenith</parameter> y <parameter>utcOffset</parameter> ahora son nullable.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
@@ -151,19 +208,19 @@
&reftitle.examples;
<para>
<example>
<title>Ejemplo de <function>date_sunrise</function></title>
<title>Ejemplo con <function>date_sunrise</function></title>
<programlisting role="php">
<![CDATA[
<?php
/* calcular la salida del sol para Lisboa, Portugal
/* Calcula la hora de salida del sol para Lisboa, Portugal
Latitud: 38.4 Norte
Longitud: 9 Oeste
Cenit ~= 90
Índice: +1 GMT
Zenith ~= 90
offset: +1 GMT
*/
echo date("D M d Y"). ', hora de la salida del sol : ' .date_sunrise(time(), SUNFUNCS_RET_STRING, 38.4, -9, 90, 1);
echo date("D M d Y"). ', hora de salida del sol: ' .date_sunrise(time(), SUNFUNCS_RET_STRING, 38.4, -9, 90, 1);
?>
]]>
@@ -171,7 +228,24 @@ echo date("D M d Y"). ', hora de la salida del sol : ' .date_sunrise(time(), SUN
&example.outputs.similar;
<screen>
<![CDATA[
Mon Dec 20 2004, hora de la salida del sol : 08:54
Mon Dec 20 2004, hora de salida del sol: 08:54
]]>
</screen>
</example>
<example>
<title>Sin salida del sol</title>
<programlisting role="php">
<![CDATA[
<?php
$solstice = strtotime('2017-12-21');
var_dump(date_sunrise($solstice, SUNFUNCS_RET_STRING, 69.245833, -53.537222));
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
bool(false)
]]>
</screen>
</example>
@@ -182,12 +256,11 @@ Mon Dec 20 2004, hora de la salida del sol : 08:54
&reftitle.seealso;
<para>
<simplelist>
<member><function>date_sunset</function></member>
<member><function>date_sun_info</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

182
reference/datetime/functions/date-sunset.xml
View File

@@ -1,30 +1,43 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 14af302c9c0e561fa6f9cdd956268758ba9a89c5 Maintainer: seros Status: ready -->
<refentry xml:id="function.date-sunset" xmlns="http://docbook.org/ns/docbook">
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.date-sunset" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>date_sunset</refname>
<refpurpose>
Devuelve la hora de la puesta de sol de un día y ubicación dados
Devuelve la hora de puesta del sol para un día y un lugar dados
</refpurpose>
</refnamediv>
<refsynopsisdiv>
<warning>
<para>
Esta función está <emphasis>DEPRECADA</emphasis> a partir de PHP 8.1.0.
Depender de esta función se desaconseja fuertemente. Se recomienda el uso
de <function>date_sun_info</function> en su lugar.
</para>
</warning>
</refsynopsisdiv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>mixed</type><methodname>date_sunset</methodname>
<modifier role="attribute">#[\Deprecated]</modifier>
<type class="union"><type>string</type><type>int</type><type>float</type><type>false</type></type><methodname>date_sunset</methodname>
<methodparam><type>int</type><parameter>timestamp</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>format</parameter><initializer>SUNFUNCS_RET_STRING</initializer></methodparam>
<methodparam choice="opt"><type>float</type><parameter>latitude</parameter><initializer>ini_get("date.default_latitude")</initializer></methodparam>
<methodparam choice="opt"><type>float</type><parameter>longitude</parameter><initializer>ini_get("date.default_longitude")</initializer></methodparam>
<methodparam choice="opt"><type>float</type><parameter>zenith</parameter><initializer>ini_get("date.sunset_zenith")</initializer></methodparam>
<methodparam choice="opt"><type>float</type><parameter>gmt_offset</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<para>
<function>date_sunset</function> devuelve la hora de la puesta de sol para un día
(especificado como <parameter>timestamp</parameter>) y ubicación dados.
</para>
</refsect1>
<methodparam choice="opt"><type>int</type><parameter>returnFormat</parameter><initializer><constant>SUNFUNCS_RET_STRING</constant></initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>float</type><type>null</type></type><parameter>latitude</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>float</type><type>null</type></type><parameter>longitude</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>float</type><type>null</type></type><parameter>zenith</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>float</type><type>null</type></type><parameter>utcOffset</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
La función <function>date_sunset</function> devuelve la hora de puesta
del sol para un día (especificado como <parameter>timestamp</parameter>
Unix) y un lugar dados.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -34,39 +47,38 @@
<term><parameter>timestamp</parameter></term>
<listitem>
<para>
La marca de tiempo <parameter>timestamp</parameter> del día del que se va a tomar
la puesta de sol.
El <parameter>timestamp</parameter> Unix del día para el cual se proporciona la hora de puesta del sol.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>format</parameter></term>
<term><parameter>returnFormat</parameter></term>
<listitem>
<para>
<table>
<title>Constantes <parameter>format</parameter></title>
<title>Constantes para el parámetro <parameter>returnFormat</parameter></title>
<tgroup cols="2">
<thead>
<row>
<entry>constante</entry>
<entry>descripción</entry>
<entry>ejemplo</entry>
<entry>Constante</entry>
<entry>Descripción</entry>
<entry>Ejemplo</entry>
</row>
</thead>
<tbody>
<row>
<entry>SUNFUNCS_RET_STRING</entry>
<entry>devuelve el resultado como <type>string</type></entry>
<entry>Devuelve el resultado en forma de &string;</entry>
<entry>16:46</entry>
</row>
<row>
<entry>SUNFUNCS_RET_DOUBLE</entry>
<entry>devuelve el resultado como <type>float</type></entry>
<entry>Devuelve el resultado en forma de &float;</entry>
<entry>16.78243132</entry>
</row>
<row>
<entry>SUNFUNCS_RET_TIMESTAMP</entry>
<entry>devuelve el resultado como <type>integer</type> (timestamp)</entry>
<entry>Devuelve el resultado en forma de &integer; (timestamp)</entry>
<entry>1095034606</entry>
</row>
</tbody>
@@ -79,8 +91,8 @@
<term><parameter>latitude</parameter></term>
<listitem>
<para>
La latitud, por defecto a Norte, y como valor negativo a Sur.
Vea también: <literal>date.default_latitude</literal>
Por omisión, es el Norte. Pase un valor negativo para el Sur.
Ver también <link linkend="ini.date.default-latitude">date.default_latitude</link>.
</para>
</listitem>
</varlistentry>
@@ -88,8 +100,8 @@
<term><parameter>longitude</parameter></term>
<listitem>
<para>
La longitud, por defecto a Este, y como valor negativo a Oeste.
Vea tambien: <literal>date.default_longitude</literal>
Por omisión, es el Este. Pase un valor negativo para el Oeste.
Ver también <link linkend="ini.date.default-longitude">date.default_longitude</link>.
</para>
</listitem>
</varlistentry>
@@ -97,15 +109,50 @@
<term><parameter>zenith</parameter></term>
<listitem>
<para>
El cénit, por defecto: <literal>date.sunset_zenith</literal>
<parameter>zenith</parameter> es el ángulo entre el
centro del sol y la línea perpendicular a la superficie de la tierra.
Por omisión
<link linkend="ini.date.sunset-zenith">date.sunset_zenith</link>
<table>
<title>Valores comunes de ángulo <parameter>zenith</parameter></title>
<tgroup cols="2">
<thead>
<row>
<entry>Ángulo</entry>
<entry>Descripción</entry>
</row>
</thead>
<tbody>
<row>
<entry>90°50'</entry>
<entry>Puesta del sol: El punto donde el sol se vuelve invisible.</entry>
</row>
<row>
<entry>96°</entry>
<entry>Crepúsculo civil: convencionalmente utilizado para significar el fin del crepúsculo.</entry>
</row>
<row>
<entry>102°</entry>
<entry>Crepúsculo náutico: el punto de fin del horizonte siendo visible en el mar.</entry>
</row>
<row>
<entry>108°</entry>
<entry>Crepúsculo astronómico: el punto donde el sol deja de ser la fuente de toda iluminación.</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>gmtoffset</parameter></term>
<term><parameter>utcOffset</parameter></term>
<listitem>
<para>
El índice GMT especificado en horas.
Especificado en horas.
El <parameter>utcOffset</parameter> es ignorado, si
<parameter>returnFormat</parameter> es
<constant>SUNFUNCS_RET_TIMESTAMP</constant>.
</para>
</listitem>
</varlistentry>
@@ -113,11 +160,19 @@
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve la hora de puesta del sol en el <parameter>returnFormat</parameter>
especificado&return.falseforfailure;. Una razón posible del fallo es que
el sol no se pone, lo cual ocurre dentro de los círculos
polares durante parte del año.
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
&date.timezone.errors.description;
&date.timezone.errors.description;
</refsect1>
<refsect1 role="changelog">
@@ -132,40 +187,42 @@
</row>
</thead>
<tbody>
&date.timezone.errors.changelog;
<row>
<entry>8.1.0</entry>
<entry>
Esta función ha sido marcada como obsoleta en favor de <function>date_sun_info</function>.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
<parameter>latitude</parameter>, <parameter>longitude</parameter>,
<parameter>zenith</parameter> y <parameter>utcOffset</parameter> ahora son nullable.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve la hora de la puesta de sol en un formato <parameter>format</parameter> especificado
si se tuvo éxito &return.falseforfailure;.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo de <function>date_sunset</function></title>
<title>Ejemplo con <function>date_sunset</function></title>
<programlisting role="php">
<![CDATA[
<?php
/* calcular la puesta de sol para Lisboa, Portugal
/* Calcula la hora de puesta del sol para Lisboa, Portugal
Latitud: 38.4 Norte
Longitud: 9 Oeste
Cenit ~= 90
Índice: +1 GMT
Zenith ~= 90
offset:1 GMT
*/
echo date("D M d Y"). ', hora de la puesta de sol : ' .date_sunset(time(), SUNFUNCS_RET_STRING, 38.4, -9, 90, 1);
echo date("D M d Y"). ', hora de puesta del sol : ' .date_sunset(time(), SUNFUNCS_RET_STRING, 38.4, -9, 90, 1);
?>
]]>
@@ -173,7 +230,24 @@ echo date("D M d Y"). ', hora de la puesta de sol : ' .date_sunset(time(), SUNFU
&example.outputs.similar;
<screen>
<![CDATA[
Mon Dec 20 2004, hora de la puesta de sol : 18:13
Mon Dec 20 2004, hora de puesta del sol : 18:13
]]>
</screen>
</example>
<example>
<title>Sin puesta de sol</title>
<programlisting role="php">
<![CDATA[
<?php
$solstice = strtotime('2017-12-21');
var_dump(date_sunset($solstice, SUNFUNCS_RET_STRING, 69.245833, -53.537222));
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
bool(false)
]]>
</screen>
</example>
@@ -184,13 +258,11 @@ Mon Dec 20 2004, hora de la puesta de sol : 18:13
&reftitle.seealso;
<para>
<simplelist>
<member><function>date_sunrise</function></member>
<member><function>date_sun_info</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

126
reference/datetime/functions/getdate.xml
View File

@@ -1,113 +1,110 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: e84c1f221cc8ad527ec2e37e9dd50e0d85499668 Maintainer: seros Status: ready -->
<!-- EN-Revision: 34188f8256bdc6f0e6e1965c2be94247997165b6 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="function.getdate" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>getdate</refname>
<refpurpose>Obtener información de la fecha/hora</refpurpose>
<refpurpose>Devuelve la fecha/hora</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>array</type><methodname>getdate</methodname>
<methodparam choice="opt"><type>int</type><parameter>timestamp</parameter><initializer>time()</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>timestamp</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
Devuelve un <type>array</type> asociativo que contiene la información
de la fecha de <parameter>timestamp</parameter>, o el momento
local actual si no se da <parameter>timestamp</parameter>.
Devuelve un <type>array</type> asociativo que contiene las
informaciones de fecha y hora del <parameter>timestamp</parameter>, o la fecha/hora
actual local si <parameter>timestamp</parameter> es omitido o &null;.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
&date.timestamp.description;
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve un <type>array</type> asociativo con información relacionada con la
marca de tiempo <parameter>timestamp</parameter>. Los elementos devueltos de la
matriz asociativa son los siguientes:
Devuelve un array asociativo que contiene las informaciones
de fecha y hora del timestamp <parameter>timestamp</parameter>.
Los elementos del array asociativo devuelto son los siguientes:
</para>
<para>
<table>
<title>Las claves de la matriz asociativa devuelta</title>
<title>Nombres de las claves del array asociativo devuelto</title>
<tgroup cols="3">
<thead>
<row>
<entry>Clave</entry>
<entry>Descripción</entry>
<entry>Ejemplo de valores devueltos</entry>
<entry>Ejemplo de valor devuelto</entry>
</row>
</thead>
<tbody>
<row>
<entry><literal>"seconds"</literal></entry>
<entry>Representacion numérica de los segundos</entry>
<entry>Representación numérica de los segundos</entry>
<entry><literal>0</literal> a <literal>59</literal></entry>
</row>
<row>
<entry><literal>"minutes"</literal></entry>
<entry>Representacion numérica de los minutos</entry>
<entry>Representación numérica de los minutos</entry>
<entry><literal>0</literal> a <literal>59</literal></entry>
</row>
<row>
<entry><literal>"hours"</literal></entry>
<entry>Representacion numérica de las horas</entry>
<entry>Representación numérica de las horas</entry>
<entry><literal>0</literal> a <literal>23</literal></entry>
</row>
<row>
<entry><literal>"mday"</literal></entry>
<entry>Representacion numérica del día del mes</entry>
<entry>Representación numérica del día del mes actual</entry>
<entry><literal>1</literal> a <literal>31</literal></entry>
</row>
<row>
<entry><literal>"wday"</literal></entry>
<entry>Representacion numérica del día de la semana</entry>
<entry><literal>0</literal> (para Domingo) hasta <literal>6</literal> (para Sábado)</entry>
<entry>Representación numérica del día de la semana actual</entry>
<entry><literal>0</literal> (para Domingo) a <literal>6</literal> (para Sábado)</entry>
</row>
<row>
<entry><literal>"mon"</literal></entry>
<entry>Representacion numérica de un mes</entry>
<entry><literal>1</literal> hasta <literal>12</literal></entry>
<entry>Representación numérica del mes</entry>
<entry><literal>1</literal> a <literal>12</literal></entry>
</row>
<row>
<entry><literal>"year"</literal></entry>
<entry>Una representacion numérica completa de una año, 4 dígitos</entry>
<entry>Año, con 4 dígitos</entry>
<entry>Ejemplos: <literal>1999</literal> o <literal>2003</literal></entry>
</row>
<row>
<entry><literal>"yday"</literal></entry>
<entry>Representacion numérica del día del año</entry>
<entry><literal>0</literal> hasta <literal>365</literal></entry>
<entry>Representación numérica del día del año</entry>
<entry><literal>0</literal> a <literal>365</literal></entry>
</row>
<row>
<entry><literal>"weekday"</literal></entry>
<entry>Una representación textual completa del día de la semana</entry>
<entry><literal>Sunday</literal> hasta <literal>Saturday</literal></entry>
<entry>Versión en texto del día de la semana</entry>
<entry><literal>Sunday</literal> a <literal>Saturday</literal></entry>
</row>
<row>
<entry><literal>"month"</literal></entry>
<entry>Una representación textual completa de un mes, como January o March</entry>
<entry><literal>January</literal> hasta <literal>December</literal></entry>
<entry>Versión en texto del mes, como <literal>January</literal> o <literal>March</literal></entry>
<entry><literal>January</literal> a <literal>December</literal></entry>
</row>
<row>
<entry><literal>0</literal></entry>
<entry>
Los segundos desde la Época Unix, similar a los valores devueltos por
<function>time</function> y usados por <function>date</function>.
<entry>Número de segundos desde la época Unix, similar al valor devuelto
por la función <function>time</function> y utilizado por <function>date</function>.
</entry>
<entry>
Dependiente del Sistema, típicamente <literal>-2147483648</literal> hasta
<entry>Depende del sistema, típicamente de <literal>-2147483648</literal> a
<literal>2147483647</literal>.
</entry>
</row>
@@ -116,17 +113,41 @@
</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.0.0</entry>
<entry>
<parameter>timestamp</parameter> ahora es nullable.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo de <function>getdate</function></title>
<title>Ejemplo con <function>getdate</function></title>
<programlisting role="php">
<![CDATA[
<?php
$hoy = getdate();
print_r($hoy);
$today = getdate();
print_r($today);
?>
]]>
</programlisting>
@@ -135,24 +156,24 @@ print_r($hoy);
<![CDATA[
Array
(
[seconds] => 40
[minutes] => 58
[hours] => 21
[mday] => 17
[wday] => 2
[mon] => 6
[year] => 2003
[yday] => 167
[weekday] => Tuesday
[month] => June
[0] => 1055901520
[seconds] => 40
[minutes] => 58
[hours] => 21
[mday] => 17
[wday] => 2
[mon] => 6
[year] => 2003
[yday] => 167
[weekday] => Tuesday
[month] => June
[0] => 1055901520
)
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -166,7 +187,6 @@ Array
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

77
reference/datetime/functions/gettimeofday.xml
View File

@@ -1,103 +1,81 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b8758b0605e80c4e3610137b7502a6abeea5c69b Maintainer: seros Status: ready -->
<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<!-- CREDITS: DAnnebicque -->
<refentry xml:id="function.gettimeofday" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>gettimeofday</refname>
<refpurpose>Obtener la hora actual</refpurpose>
<refpurpose>Devuelve la hora actual</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>mixed</type><methodname>gettimeofday</methodname>
<methodparam choice="opt"><type>bool</type><parameter>return_float</parameter><initializer>&false;</initializer></methodparam>
<type class="union"><type>array</type><type>float</type></type><methodname>gettimeofday</methodname>
<methodparam choice="opt"><type>bool</type><parameter>as_float</parameter><initializer>&false;</initializer></methodparam>
</methodsynopsis>
<para>
Esta es una interfaz a gettimeofday(2). Devuelve una
matriz asociativa que contiene la información devuelta por la llamada
al sistema.
Es una interfaz con gettimeofday(2). Devuelve un array
asociativo que contiene las informaciones devueltas por el sistema.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>return_float</parameter></term>
<term><parameter>as_float</parameter></term>
<listitem>
<para>
Cuando se establece a &true;, se devuelve un float en vez de un array.
Cuando se define como &true;, se devuelve un &float; en lugar de un array.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Por defecto se devuelve un <type>array</type>. Si <parameter>return_float</parameter>
está establecido, se devuelve un <type>float</type>.
Por omisión, se devuelve un &array;. Si el argumento <parameter>as_float</parameter>
está definido, entonces se devolverá un &float;.
</para>
<para>
Claves de la matriz:
Claves del array :
<itemizedlist>
<listitem>
<simpara>
"sec" - segundos desde la Época Unix
"sec" : segundos desde la época Unix
</simpara>
</listitem>
<listitem>
<simpara>
"usec" - microsegundos
"usec" : microsegundos
</simpara>
</listitem>
<listitem>
<simpara>
"minuteswest" - minutos al oeste de Greenwich
"minuteswest" : minutos de desfase respecto a Greenwich,
hacia el Oeste.
</simpara>
</listitem>
<listitem>
<simpara>
"dsttime" - tipo de corrección del horario de verano (dst)
"dsttime" : tipo de corrección dst
</simpara>
</listitem>
</itemizedlist>
</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>5.1.0</entry>
<entry>
Se añadió el parámetro <parameter>return_float</parameter>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo de <function>gettimeofday</function></title>
<title>Ejemplo con <function>gettimeofday</function></title>
<programlisting role="php">
<![CDATA[
<?php
@@ -112,10 +90,10 @@ echo gettimeofday(true);
<![CDATA[
Array
(
[sec] => 1073504408
[usec] => 238215
[minuteswest] => 0
[dsttime] => 1
[sec] => 1073504408
[usec] => 238215
[minuteswest] => 0
[dsttime] => 1
)
1073504408.23910
@@ -125,7 +103,6 @@ Array
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

72
reference/datetime/functions/gmdate.xml
View File

@@ -1,26 +1,27 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 83c927f576b72abb11701326d9e33eb2fdfce8e3 Maintainer: seros Status: ready -->
<!-- Reviewed: yes Maintainer: yago -->
<!-- EN-Revision: 5c951013ca04161992efed8b86fb40f55669958e Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.gmdate" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>gmdate</refname>
<refpurpose>Formatea una fecha/hora GMT/UTC</refpurpose>
<refpurpose>Formatea una fecha/hora GMT/TUC</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>gmdate</methodname>
<methodparam><type>string</type><parameter>format</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>timestamp</parameter><initializer>time()</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>timestamp</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
Idéntica a la función <function>date</function> excepto que
la fecha/hora devuelta es en Greenwich Mean Time (GMT).
<function>gmdate</function> es idéntico a la función
<function>date</function>, excepto que el tiempo
devuelto es GMT (<literal>Greenwich Mean Time</literal>).
</para>
</refsect1>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
@@ -29,27 +30,25 @@
<term><parameter>format</parameter></term>
<listitem>
<para>
El formato de la fecha (<type>string</type>) a mostrar. Ver las opciones de
formato de la función <function>date</function>.
El formato de la fecha de salida. Ver las opciones de formato para la función
<function>date</function>.
</para>
</listitem>
</varlistentry>
&date.timestamp.description;
</variablelist>
</para>
</refsect1>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve una fecha en formato GMT. Si se usa un valor no numérico en
<parameter>timestamp</parameter>, devolverá &false; y se lanzará
un error de nivel <constant>E_WARNING</constant>.
Devuelve una fecha formateada.
</para>
</refsect1>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
@@ -63,21 +62,9 @@
</thead>
<tbody>
<row>
<entry>5.1.0</entry>
<entry>8.0.0</entry>
<entry>
El rango válido de una marca de tiempo es típicamente desde Fri, 13 Dec
1901 20:45:54 GMT a Tue, 19 Jan 2038 03:14:07 GMT. (Estas son
las fechas que corresponden a los valores mínimo y máximo de
un entero con signo de 32-bit). Sin embargo, antes de PHP 5.1.0 este rango estaba limitado
desde 01-01-1970 a 19-01-2038 en algunos sistemas (p.ej. Windows).
</entry>
</row>
<row>
<entry>5.1.1</entry>
<entry>
Hay <link linkend="datetime.constants">constantes</link> útiles
de formatos de fecha/hora estándar que se pueden usar para especificar el
parámetro <parameter>format</parameter>.
<parameter>timestamp</parameter> ahora es nullable.
</entry>
</row>
</tbody>
@@ -85,15 +72,17 @@
</informaltable>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo de <function>gmdate</function></title>
<title>Ejemplo con <function>gmdate</function></title>
<para>
Cuando se ejecuta en Finlandia (GMT +0200), la primera línea de abajo imprimirá "Jan 01
1998 00:00:00", mientras que la segunda imprimirá "Dec 31 1997 22:00:00".
Cuando esta función se ejecuta en Finlandia (GMT0200), la primera
línea a continuación mostrará <literal>"Jan 01 1998 00:00:00"</literal>,
mientras que la segunda mostrará
<literal>"Dec 31 1997 22:00:00"</literal>.
</para>
<programlisting role="php">
<![CDATA[
@@ -106,20 +95,21 @@ echo gmdate("M d Y H:i:s", mktime(0, 0, 0, 1, 1, 1998));
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><methodname>DateTimeImmutable::__construct</methodname></member>
<member><methodname>DateTimeInterface::format</methodname></member>
<member><function>date</function></member>
<member><function>mktime</function></member>
<member><function>gmmktime</function></member>
<member><function>strftime</function></member>
<member><methodname>IntlDateFormatter::format</methodname></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

126
reference/datetime/functions/gmmktime.xml
View File

@@ -1,37 +1,41 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bce4e5f7d7979c5b672e9375a17860b0ced5eef3 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<!-- EN-Revision: 57e27d2a7615da2ee6de57ed27eb40b473d487cb Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes Maintainer: PhilDaiguille -->
<refentry xml:id="function.gmmktime" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>gmmktime</refname>
<refpurpose>Obtener la marca temporal de Unix para una fecha GMT</refpurpose>
<refpurpose>Retorna el timestamp UNIX de una fecha GMT</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>int</type><methodname>gmmktime</methodname>
<methodparam choice="opt"><type>int</type><parameter>hour</parameter><initializer>gmdate("H")</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>minute</parameter><initializer>gmdate("i")</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>second</parameter><initializer>gmdate("s")</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>month</parameter><initializer>gmdate("n")</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>day</parameter><initializer>gmdate("j")</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>year</parameter><initializer>gmdate("Y")</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>is_dst</parameter><initializer>-1</initializer></methodparam>
<type class="union"><type>int</type><type>false</type></type><methodname>gmmktime</methodname>
<methodparam><type>int</type><parameter>hour</parameter></methodparam>
<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>minute</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>second</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>month</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>day</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>year</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
Idéntica a <function>mktime</function> excepto que los parámetros pasados representan una
fecha GMT. <function>gmmktime</function> internamente usa <function>mktime</function>
por lo que sólo los momento válidos derivados del momento local se pueden usar.
Similar a la función <function>mktime</function> excepto que los argumentos
opcionales pasados son GMT. <function>gmmktime</function> utiliza internamente
la función <function>mktime</function>, por lo tanto, solo los tiempos válidos
en la zona horaria local derivada pueden ser utilizados.
</para>
<para>
Como en <function>mktime</function>, los argumentos pueden ser expuestos en orden
de derecha a izquierda, con cualquier argumento que se omita establecido al
valor GMT correspondiente actual.
Al igual que <function>mktime</function>, los argumentos restantes pueden
ser omitidos. En ese caso, tomarán los valores GMT actuales.
</para>
<simpara>
Llamar a <function>gmmktime</function> sin argumentos no es soportado.
Esto resultará en lanzar una <classname>ArgumentCountError</classname>.
<function>time</function> puede ser utilizado para obtener el timestamp actual.
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
@@ -40,10 +44,10 @@
<term><parameter>hour</parameter></term>
<listitem>
<para>
El número de la hora relativo al inicio del día determinado por
El número de horas desde el inicio del día establecido por los parámetros
<parameter>month</parameter>, <parameter>day</parameter> y <parameter>year</parameter>.
Los valores negativos referencias la hora antes de la media noche del día en cuestión.
Los valores mayores que 23 referencian la hora apropiada en el/los día/s siguiente/s.
Los valores negativos hacen referencia a las horas antes de la medianoche del día en cuestión.
Los valores superiores a 23 hacen referencia a las horas asociadas al(dos) día(s) siguiente(s).
</para>
</listitem>
</varlistentry>
@@ -51,9 +55,10 @@
<term><parameter>minute</parameter></term>
<listitem>
<para>
El número del minuto relativo al inicio de <parameter>hour</parameter>.
Los valores negativos referencian el minuto en la hora previa.
Los valores maayores que 59 referencian el minuto apropiado en la/s hora/s siguiente/s.
El número de minutos desde el inicio de la hora <parameter>hour</parameter>.
Los valores negativos hacen referencia a los minutos de la hora anterior.
Los valores superiores a 59 hacen referencia a los minutos asociados
a la(s) hora(s) siguiente(s).
</para>
</listitem>
</varlistentry>
@@ -61,9 +66,10 @@
<term><parameter>second</parameter></term>
<listitem>
<para>
El número de segundos relativo al inicio de <parameter>minute</parameter>.
Los valores negativos referencian el segundo en el minuto previo.
Los valores mayores que 59 referencian el segundo apropiado en el/los minuto/s siguiente/s.
El número de segundos desde el inicio del minuto <parameter>minute</parameter>.
Los valores negativos hacen referencia a los segundos del minuto anterior.
Los valores superiores a 59 hacen referencia a los segundos asociados a
el(la) minuto(s) siguiente(s).
</para>
</listitem>
</varlistentry>
@@ -71,10 +77,12 @@
<term><parameter>month</parameter></term>
<listitem>
<para>
El número del mes relativo al inicio del año previo.
Los valores de 1 a 12 referencian los meses del calendario normal del año en cuestión.
Los valores menores que 1 (incluyendo valores negativos) referencian los meses del año previo en orden inverso, por lo que 0 es December, -1 es November, etc.
Los valores mayores que 12 referencian el mes apropiado en el/los año/s siguiente/s.
El número de meses desde el final del año anterior.
Los valores comprendidos entre 1 y 12 hacen referencia a los meses
del calendario normal del año en cuestión. Los valores inferiores a
1 (incluyendo los valores negativos) hacen referencia a los meses del año
anterior en orden inverso, por lo tanto, 0 corresponde a diciembre, -1 a noviembre, etc.
Los valores superiores a 12 hacen referencia al mes correspondiente en el(la) año(s) siguiente(s).
</para>
</listitem>
</varlistentry>
@@ -82,10 +90,12 @@
<term><parameter>day</parameter></term>
<listitem>
<para>
El número del día relativo al final del mes previo.
Los valores del 1 al 28, 29, 30 o 31 (dependiendo del mes) referenciacn los días normales del mes relevante.the normal days in the relevant month.
Los valores menores que 1 (incluyendo valores negativos) referencian los días del mes previo por lo que 0 es el último día del mes previo, -1 es el día anterior a ese, etc.
Los valores mayores que el número de días del mes relevante referencian el día apropiado en el/los mes/es siguiente/s.
El número de días desde el final del mes anterior. Los valores comprendidos
entre 1 y 28, 29, 30, 31 (según el mes) hacen referencia a los días normales
en el mes actual. Los valores inferiores a 1 (incluyendo los valores negativos)
hacen referencia a los días del mes anterior, por lo tanto, 0 corresponde al último día del
mes anterior, -1, el día anterior, etc. Los valores superiores al número
de días del mes actual hacen referencia a los días correspondientes del(la) mes(es) siguiente(s).
</para>
</listitem>
</varlistentry>
@@ -97,31 +107,18 @@
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>is_dst</parameter></term>
<listitem>
<para>
Los parámetros siempre representan una fecha GMT por lo que <parameter>is_dst</parameter>
no influye en el resultado.
</para>
<note>
<para>
Este parámetro ha sido eliminado en PHP 7.0.0.
</para>
</note>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve una marca de tiempo Unix de tipo <type>integer</type>.
Retorna un timestamp Unix, en forma de un &integer;, o &false; si
el timestamp no cabe en un entero PHP.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
@@ -135,17 +132,18 @@
</thead>
<tbody>
<row>
<entry>7.0.0</entry>
<entry>8.0.0</entry>
<entry>
El parámetro <parameter>is_dst</parameter> ha sido eliminado.
<parameter>hour</parameter> ya no es opcional.
Para obtener un timestamp unix, se deberá utilizar la
función <function>time</function>.
</entry>
</row>
<row>
<entry>5.1.0</entry>
<entry>8.0.0</entry>
<entry>
A partir de PHP 5.1.0, el parámetro <parameter>is_dst</parameter> se volvió
obsoleto. Como resultado, se podría usar en su lugar las nuevas características
de manejo de zonas horarias.
<parameter>minute</parameter>, <parameter>second</parameter>, <parameter>month</parameter>,
<parameter>day</parameter> y <parameter>year</parameter> ahora son nullable.
</entry>
</row>
</tbody>
@@ -153,16 +151,16 @@
</informaltable>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo básico de <function>gmmktime</function></title>
<title>Ejemplo con <function>gmmktime</function></title>
<programlisting role="php">
<![CDATA[
<?php
// Imprime: July 1, 2000 is on a Saturday
// Muestra: July 1, 2000 is on a Saturday
echo "July 1, 2000 is on a " . date("l", gmmktime(0, 0, 0, 7, 1, 2000));
?>
]]>
@@ -170,11 +168,12 @@ echo "July 1, 2000 is on a " . date("l", gmmktime(0, 0, 0, 7, 1, 2000));
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member>La clase <classname>DateTimeImmutable</classname></member>
<member><function>mktime</function></member>
<member><function>date</function></member>
<member><function>time</function></member>
@@ -182,7 +181,6 @@ echo "July 1, 2000 is on a " . date("l", gmmktime(0, 0, 0, 7, 1, 2000));
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

93
reference/datetime/functions/gmstrftime.xml
View File

@@ -1,29 +1,48 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: seros Status: ready -->
<!-- Reviewed: yes Maintainer: seros -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.gmstrftime" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>gmstrftime</refname>
<refpurpose>Formatear una fecha/hora GMT/UTC según la configuración local</refpurpose>
<refpurpose>Formatea una fecha/hora GMT/TUC según la configuración local</refpurpose>
</refnamediv>
<refsynopsisdiv>
&warn.deprecated.function-8-1-0.alternatives;
<simplelist role="alternatives">
<member><function>gmdate</function></member>
<member><methodname>IntlDateFormatter::format</methodname></member>
</simplelist>
</refsynopsisdiv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>gmstrftime</methodname>
<modifier role="attribute">#[\Deprecated]</modifier>
<type class="union"><type>string</type><type>false</type></type><methodname>gmstrftime</methodname>
<methodparam><type>string</type><parameter>format</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>timestamp</parameter><initializer>time()</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>timestamp</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
Se comporta como <function>strftime</function>, excepto que el
instante devuelto es Tiempo medio de Greenwich (GMT). Por ejemplo, cuando se ejecuta
en Hora estándar oriental (GMT -0500), la primera línea de abajo imprime
"Dec 31 1998 20:00:00", mientras que la segunda imprime "Jan 01 1999
01:00:00".
<function>gmstrftime</function> se comporta exactamente como
<function>strftime</function> con la excepción de que la hora utilizada
es la de Greenwich (<literal>Greenwich Mean Time</literal>, GMT).
Por ejemplo, en la zona <literal>Eastern Standard Time</literal>
(este de USA) es GMT -0500, la primera línea del ejemplo a continuación
muestra <literal>"Dec 31 1998 20:00:00"</literal>, mientras que
la segunda muestra <literal>"Jan 01 1999 01:00:00"</literal>.
</para>
<warning>
<para>
Esta función depende de la información local del sistema
operativo, que puede ser inconsistente o no estar disponible.
Se recomienda utilizar el método
<methodname>IntlDateFormatter::format</methodname>.
</para>
</warning>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
@@ -32,7 +51,8 @@
<term><parameter>format</parameter></term>
<listitem>
<para>
Véase la descripción de <function>strftime</function>.
Ver la descripción de la función
<function>strftime</function>.
</para>
</listitem>
</varlistentry>
@@ -40,23 +60,49 @@
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve una cadena formateada según la cadena de formato dada
empleando la marca temporal <parameter>timestamp</parameter> dada o el instante
local actual si no se da una marca temporal. Los nombres del mes y del día de la semana y
otras cadenas dependientes del lenguaje respetan el localismo establecido
con <function>setlocale</function>.
Devuelve un &string; formateado según el formato dado por el
argumento <parameter>timestamp</parameter> o la fecha actual
si no se proporciona ningún argumento <parameter>timestamp</parameter>.
Los nombres de los meses, días de la semana y otras cadenas
dependientes de una localización dada, respetan la localización
actual definida por la función <function>setlocale</function>.
En caso de error, se devuelve &false;.
</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.0.0</entry>
<entry>
<parameter>timestamp</parameter> ahora es nullable.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo de <function>gmstrftime</function></title>
<title>Ejemplo con <function>gmstrftime</function></title>
<programlisting role="php">
<![CDATA[
<?php
@@ -69,17 +115,18 @@ echo gmstrftime("%b %d %Y %H:%M:%S", mktime(20, 0, 0, 12, 31, 98)) . "\n";
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><methodname>IntlDateFormatter::format</methodname></member>
<member><methodname>DateTimeInterface::format</methodname></member>
<member><function>strftime</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

121
reference/datetime/functions/idate.xml
View File

@@ -1,28 +1,31 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 14af302c9c0e561fa6f9cdd956268758ba9a89c5 Maintainer: seros Status: ready -->
<!-- EN-Revision: 5c951013ca04161992efed8b86fb40f55669958e Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes Maintainer: PhilDaiguille -->
<refentry xml:id="function.idate" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>idate</refname>
<refpurpose>Formatea una fecha/hora local como un entero</refpurpose>
<refpurpose>Formatea una parte de la hora/fecha local como un entero</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>int</type><methodname>idate</methodname>
<type class="union"><type>int</type><type>false</type></type><methodname>idate</methodname>
<methodparam><type>string</type><parameter>format</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>timestamp</parameter><initializer>time()</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>timestamp</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
Devuelve un número formateado según la cadena de formato dada usando la marca de
tiempo <parameter>timestamp</parameter> de tipo entero dado o el momento local actual
si no se da la marca de tiempo. En otras palabras, <parameter>timestamp</parameter>
es opcional y su valor por defecto es el de <function>time</function>.
<function>idate</function> devuelve un número formateado con el
formato <parameter>format</parameter> y que representa el timestamp
<parameter>timestamp</parameter> o la hora actual si
<parameter>timestamp</parameter> es omitido.
En otras palabras, el parámetro <parameter>timestamp</parameter> es opcional
y el valor por omisión es el valor devuelto por la función <function>time</function>.
</para>
<para>
A diferencia de <function>date</function>, <function>idate</function>
acepta un sólo carácter en el parámetro <parameter>format</parameter>.
A diferencia de la función <function>date</function>, <function>idate</function>
acepta solo un carácter como parámetro <parameter>format</parameter>.
</para>
</refsect1>
@@ -35,49 +38,60 @@
<listitem>
<para>
<table>
<title>Los siguientes caracteres son reconocidos por el
parámetro de cadena <parameter>format</parameter></title>
<title>Los siguientes caracteres son reconocidos en el string
del parámetro <parameter>format</parameter></title>
<tgroup cols="2">
<thead>
<row>
<entry>Caracter <parameter>format</parameter></entry>
<entry>Caracteres de <parameter>format</parameter></entry>
<entry>Descripción</entry>
</row>
</thead>
<tbody>
<row>
<entry><literal>B</literal></entry>
<entry>Swatch Beat/Hora Internet</entry>
<entry>Tiempo Internet Swatch Beat</entry>
</row>
<row>
<entry><literal>d</literal></entry>
<entry>Día del mes</entry>
<entry>El día del mes</entry>
</row>
<row>
<entry><literal>h</literal></entry>
<entry>Hora (formato de 12 horas)</entry>
<entry>Hora (formato 12 horas)</entry>
</row>
<row>
<entry><literal>H</literal></entry>
<entry>Hora (formato de 24 horas)</entry>
<entry>Hora (formato 24 horas)</entry>
</row>
<row>
<entry><literal>i</literal></entry>
<entry>Minutos</entry>
</row>
<row>
<entry><literal>I</literal> (i mayúscula)</entry>
<entry>devuelve <literal>1</literal> si el horario de verano (DST) está activado,
<literal>0</literal> si no</entry>
<entry><literal>I</literal>(i, en mayúscula)</entry>
<entry>Devuelve <literal>1</literal> si el horario de verano está activado,
<literal>0</literal> en caso contrario</entry>
</row>
<row>
<entry><literal>L</literal> (l mayúscula)</entry>
<entry>devuelve <literal>1</literal> para años bisiestos,
<literal>0</literal> si no</entry>
<entry><literal>L</literal>(l, en mayúscula)</entry>
<entry>Devuelve <literal>1</literal> para un año bisiesto,
<literal>0</literal> en caso contrario</entry>
</row>
<row>
<entry><literal>m</literal></entry>
<entry>Número de mes</entry>
<entry>Número del mes</entry>
</row>
<row>
<entry><literal>N</literal></entry>
<entry>
Día de la semana ISO-8601 (<literal>1</literal> para
el lunes a <literal>7</literal> para el domingo)
</entry>
</row>
<row>
<entry><literal>o</literal></entry>
<entry>Año ISO-8601 (4 dígitos)</entry>
</row>
<row>
<entry><literal>s</literal></entry>
@@ -85,12 +99,12 @@
</row>
<row>
<entry><literal>t</literal></entry>
<entry>Días en el mes actual</entry>
<entry>Día del mes actual</entry>
</row>
<row>
<entry><literal>U</literal></entry>
<entry>Segundos desde la Época Unix - 1 de enero de 1970 00:00:00 UTC -
esto es lo mismo que en <function>time</function></entry>
<entry>Segundos desde la época Unix - 1 de Enero de 1970 00:00:00 UTC -
esto es lo mismo que la función <function>time</function></entry>
</row>
<row>
<entry><literal>w</literal></entry>
@@ -98,16 +112,16 @@
</row>
<row>
<entry><literal>W</literal></entry>
<entry>Número del mes del año ISO-8601, las semanas comienzan en
Lunes</entry>
<entry>El número de semana del año; según ISO-8601, las semanas comienzan
el Lunes</entry>
</row>
<row>
<entry><literal>y</literal></entry>
<entry>Año (1 ó 2 dígitos - comprobar la anotación de abajo)</entry>
<entry>Año en 1 o 2 dígitos, ver la nota más abajo</entry>
</row>
<row>
<entry><literal>Y</literal></entry>
<entry>Año (4 dígitos)</entry>
<entry>Año en 4 dígitos</entry>
</row>
<row>
<entry><literal>z</literal></entry>
@@ -115,7 +129,7 @@
</row>
<row>
<entry><literal>Z</literal></entry>
<entry>Ínidce de la zona horaria en segundos</entry>
<entry>Desplazamiento horario, en segundos</entry>
</row>
</tbody>
</tgroup>
@@ -123,9 +137,9 @@
</para>
</listitem>
</varlistentry>
&date.timestamp.description;
</variablelist>
</para>
</refsect1>
@@ -133,20 +147,19 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve un <type>integer</type>.
Devuelve un <type>int</type> en caso de éxito, &return.falseforfailure;.
</para>
<para>
Ya que <function>idate</function> devuelve siempre un <type>integer</type> y
como éste nunca puede empezar por un "0", <function>idate</function> puede devolver
menos dígitos de los que se esperarían. Vea el ejemplo de abajo.
Dado que <function>idate</function> siempre devuelve un &integer;
y no puede comenzar con <literal>0</literal>,
<function>idate</function> puede devolver menos dígitos de los
que se podrían esperar. Ver el ejemplo a continuación.
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
&date.timezone.errors.description;
&date.timezone.errors.description;
</refsect1>
<refsect1 role="changelog">
@@ -161,9 +174,19 @@
</row>
</thead>
<tbody>
&date.timezone.errors.changelog;
<row>
<entry>8.2.0</entry>
<entry>
Añade los caracteres de formato <literal>N</literal> (día de la semana ISO-8601)
y <literal>o</literal> (año ISO-8601).
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
<parameter>timestamp</parameter> ahora es nullable.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
@@ -174,15 +197,15 @@
&reftitle.examples;
<para>
<example>
<title>Ejemplo de <function>idate</function></title>
<title>Ejemplo con <function>idate</function></title>
<programlisting role="php">
<![CDATA[
<?php
$timestamp = strtotime('1st January 2004'); //1072915200
// esto imprime el año en un formato de dos dígitos
// sin embargo, ya que éste podría empezar con un "0",
// sólo se imprime "4"
// esto muestra el año en dos dígitos
// sin embargo, dado que este dígito comenzará con "0",
// solo "4" será mostrado
echo idate('y', $timestamp);
?>
]]>
@@ -195,6 +218,7 @@ echo idate('y', $timestamp);
&reftitle.seealso;
<para>
<simplelist>
<member><methodname>DateTimeInterface::format</methodname></member>
<member><function>date</function></member>
<member><function>getdate</function></member>
<member><function>time</function></member>
@@ -202,7 +226,6 @@ echo idate('y', $timestamp);
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

169
reference/datetime/functions/localtime.xml
View File

@@ -1,95 +1,40 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b8758b0605e80c4e3610137b7502a6abeea5c69b Maintainer: yago Status: ready -->
<!-- EN-Revision: a4ba07f273fd7d34520a8d02052a746076094e32 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<!-- CREDITS: DAnnebicque -->
<refentry xml:id="function.localtime" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>localtime</refname>
<refpurpose>Obtiene fecha y hora local</refpurpose>
<refpurpose>Obtiene la hora local</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>array</type><methodname>localtime</methodname>
<methodparam choice="opt"><type>int</type><parameter>timestamp</parameter><initializer>time()</initializer></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>is_associative</parameter><initializer>&false;</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>timestamp</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>associative</parameter><initializer>&false;</initializer></methodparam>
</methodsynopsis>
<para>
La función <function>localtime</function> devuelve un array
con la estructura idéntica a la devuelta por la llamada a la función
en C.
<function>localtime</function> devuelve un array idéntico a
la estructura devuelta por la función C localtime.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
&date.timestamp.description;
<varlistentry>
<term><parameter>is_associative</parameter></term>
<term><parameter>associative</parameter></term>
<listitem>
<para>
Si está defindo como &false; o no se proporciona, el array es devuelto como un
array indexado numéricamente. Si el argumento está definido como &true;,
<function>localtime</function> devuelve un array asociativo que contiene
todos los diferentes elementos de la estructura devuelta por la llamada a la
fucnión de C localtime. Los nombres de las diferentes claves del
array asociativo son los siguientes:
</para>
<para>
<itemizedlist>
<listitem>
<simpara>
"tm_sec" - segundos, <literal>0</literal> a <literal>59</literal>
</simpara>
</listitem>
<listitem>
<simpara>
"tm_min" - minutos, <literal>0</literal> a <literal>59</literal>
</simpara>
</listitem>
<listitem>
<simpara>
"tm_hour" - horas, <literal>0</literal> a <literal>23</literal>
</simpara>
</listitem>
<listitem>
<simpara>
"tm_mday" - día del mes, <literal>1</literal> a <literal>31</literal>
</simpara>
</listitem>
<listitem>
<simpara>
"tm_mon" - mes del año, <literal>0</literal> (Ene) a <literal>11</literal> (Dic)
</simpara>
</listitem>
<listitem>
<simpara>
"tm_year" - años desde 1900
</simpara>
</listitem>
<listitem>
<simpara>
"tm_wday" - día de la semana, <literal>0</literal> (Domingo) a <literal>6</literal> (Sábado)
</simpara>
</listitem>
<listitem>
<simpara>
"tm_yday" - día del año, <literal>0</literal> to <literal>365</literal>
</simpara>
</listitem>
<listitem>
<simpara>
"tm_isdst" - ¿Está en horario de verano?
</simpara>
<simpara>
Valor positivo si es que sí, <literal>0</literal> si es que no, negativo en caso que no se sepa.
</simpara>
</listitem>
</itemizedlist>
Determina si la función debe devolver un array regular, indexado
numéricamente, o un array asociativo.
</para>
</listitem>
</varlistentry>
@@ -97,11 +42,75 @@
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Si <parameter>associative</parameter> está definido como &false; o no se proporciona,
entonces el array se devuelve como un array indexado numéricamente estándar.
Si <parameter>associative</parameter> está definido como &true; entonces
<function>localtime</function> devuelve un array asociativo que contiene
los elementos de la estructura devuelta por la llamada a la
función localtime de C
Las claves del array asociativo son las siguientes:
</para>
<para>
<itemizedlist>
<listitem>
<simpara>
"tm_sec" : segundos, de <literal>0</literal> a <literal>59</literal>
</simpara>
</listitem>
<listitem>
<simpara>
"tm_min" : minutos, de <literal>0</literal> a <literal>59</literal>
</simpara>
</listitem>
<listitem>
<simpara>
"tm_hour" : hora, de <literal>0</literal> a <literal>23</literal>
</simpara>
</listitem>
<listitem>
<simpara>
"tm_mday" : día del mes, de <literal>1</literal> a <literal>31</literal>
</simpara>
</listitem>
<listitem>
<simpara>
"tm_mon" : mes del año, de <literal>0</literal> (Ene) a <literal>11</literal> (Dic)
</simpara>
</listitem>
<listitem>
<simpara>
"tm_year" : Año desde 1900
</simpara>
</listitem>
<listitem>
<simpara>
"tm_wday" : Día de la semana, de <literal>0</literal> (Dom) a <literal>6</literal> (Sáb)
</simpara>
</listitem>
<listitem>
<simpara>
"tm_yday" : Día del año, de <literal>0</literal> a <literal>365</literal>
</simpara>
</listitem>
<listitem>
<simpara>
"tm_isdst" : ¿Está en vigor el horario de verano?
</simpara>
<simpara>
Valor positivo si es así, <literal>0</literal> en caso contrario,
valor negativo si el resultado no ha podido determinarse.
</simpara>
</listitem>
</itemizedlist>
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
&date.timezone.errors.description;
&date.timezone.errors.description;
</refsect1>
<refsect1 role="changelog">
@@ -116,9 +125,12 @@
</row>
</thead>
<tbody>
&date.timezone.errors.changelog;
<row>
<entry>8.0.0</entry>
<entry>
<parameter>timestamp</parameter> ahora es nullable.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
@@ -129,7 +141,7 @@
&reftitle.examples;
<para>
<example>
<title>Ejemplo de <function>localtime</function></title>
<title>Ejemplo con <function>localtime</function></title>
<programlisting role="php">
<![CDATA[
<?php
@@ -173,7 +185,7 @@ Array
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -182,9 +194,8 @@ Array
</simplelist>
</para>
</refsect1>
</refentry>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

99
reference/datetime/functions/microtime.xml
View File

@@ -1,139 +1,116 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b8758b0605e80c4e3610137b7502a6abeea5c69b Maintainer: seros Status: ready -->
<!-- EN-Revision: 5c951013ca04161992efed8b86fb40f55669958e Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.microtime" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>microtime</refname>
<refpurpose>Devuelve la fecha Unix actual con microsegundos</refpurpose>
<refpurpose>Devuelve el timestamp UNIX actual con microsegundos</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>mixed</type><methodname>microtime</methodname>
<methodparam choice="opt"><type>bool</type><parameter>get_as_float</parameter><initializer>&false;</initializer></methodparam>
<type class="union"><type>string</type><type>float</type></type><methodname>microtime</methodname>
<methodparam choice="opt"><type>bool</type><parameter>as_float</parameter><initializer>&false;</initializer></methodparam>
</methodsynopsis>
<para>
<function>microtime</function> devuelve la fecha Unix actual con
microsegundos. Esta función sólo está disponible en sistemas operativos que
soportan la llamada al sistema de gettimeofday().
<function>microtime</function> devuelve el timestamp Unix, con
microsegundos. Esta función está únicamente disponible en
los sistemas que soportan la función gettimeofday().
</para>
<para>
Para medir el rendimiento, se recomienda el uso de <function>hrtime</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>get_as_float</parameter></term>
<term><parameter>as_float</parameter></term>
<listitem>
<para>
Si se usa y se establece a &true;, <function>microtime</function> devolverá un
<type>float</type> en vez de un <type>string</type>, como está descrito en
la sección de valores de retorno de abajo.
Si se utiliza y se define como &true;, <function>microtime</function> devolverá
un número de coma flotante en lugar de un &string;, tal como se describe
en la sección de valores devueltos a continuación.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Por omisión, <function>microtime</function> devuelve un <type>string</type> en
la forma "mseg seg", donde <literal>seg</literal> es el número de segundos
desde la época Unix (0:00:00 January 1, 1970 GMT), y <literal>msec</literal>
es el número de microsegundos que han transcurrido desde <literal>sec</literal>,
expresado en segundos.
Por omisión, <function>microtime</function> devuelve un &string; en
el formato "msec sec", donde <literal>sec</literal> es el número de segundos
desde la época Unix (1 de Enero de 1970, 00:00:00 GMT),
y <literal>msec</literal> es el número de microsegundos que han transcurrido
desde <literal>sec</literal>, expresado en segundos en forma de fracción
decimal.
</para>
<para>
Si <parameter>get_as_float</parameter> está establecido a &true;,
<function>microtime</function> devuelve un <type>float</type>, que
representa el momento actual en segundos desde la época Unix con precisión al
microsegundo más cercano.
Si <parameter>as_float</parameter> se define como &true;, entonces
<function>microtime</function> devuelve un número de coma flotante,
que representa el tiempo actual, en segundos, desde la época Unix, con precisión
de microsegundo.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejecución de un script de cronometraje con <function>microtime</function></title>
<programlisting role="php">
<![CDATA[
<?php
/**
* Función sencilla para repetir el comportamiento de PHP 5
*/
function microtime_float()
{
list($usec, $sec) = explode(" ", microtime());
return ((float)$usec + (float)$sec);
}
$time_start = microtime_float();
// Dormir por un momento
usleep(100);
$time_end = microtime_float();
$time = $time_end - $time_start;
echo "No se hizo nada en $time segundos\n";
?>
]]>
</programlisting>
</example>
<example>
<title>Ejecución de un script de cronometraje en PHP 5</title>
<title>Duración de ejecución de un script en PHP</title>
<programlisting role="php">
<![CDATA[
<?php
$time_start = microtime(true);
// Dormir por un momento
// Espera durante un momento
usleep(100);
$time_end = microtime(true);
$time = $time_end - $time_start;
echo "No se hizo nada en $time segundos\n";
echo "No hacer nada durante $time segundos\n";
?>
]]>
</programlisting>
</example>
<example>
<title><function>microtime</function> y <literal>REQUEST_TIME_FLOAT</literal> (desde PHP 5.4.0)</title>
<title>Ejemplo con <function>microtime</function> y <literal>REQUEST_TIME_FLOAT</literal></title>
<programlisting role="php">
<![CDATA[
<?php
// Tiempo de espera aleatorio
// Duración de espera aleatoria
usleep(mt_rand(100, 10000));
// A partir de PHP 5.4.0, REQUEST_TIME_FLOAT está disponible en el array superglobal $_SERVER
// Contiene la fecha Unix en la que se realizó la petición con precisión de milisegundos.
// REQUEST_TIME_FLOAT está disponible en el array superglobal $_SERVER.
// Contiene el timestamp del inicio de la petición, con precisión de microsegundo.
$time = microtime(true) - $_SERVER["REQUEST_TIME_FLOAT"];
echo "No se hizo nada en $time segundos\n";
echo "No hacer nada durante $time segundos\n";
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>time</function></member>
<member><function>hrtime</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

595
reference/datetime/functions/strftime.xml
View File

@@ -1,38 +1,52 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 9cc4767b2ddf65c4ed592c9deb818cbb2c9def7b Maintainer: seros Status: ready -->
<!-- Reviewed: yes Maintainer: seros -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.strftime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>strftime</refname>
<refpurpose>Formatea una fecha/hora local según una configuración local</refpurpose>
<refpurpose>Formatea una fecha/hora local con la configuración local</refpurpose>
</refnamediv>
<refsynopsisdiv>
&warn.deprecated.function-8-1-0.alternatives;
<simplelist role="alternatives">
<member><function>date</function></member>
<member><methodname>IntlDateFormatter::format</methodname></member>
</simplelist>
</refsynopsisdiv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>strftime</methodname>
<modifier role="attribute">#[\Deprecated]</modifier>
<type class="union"><type>string</type><type>false</type></type><methodname>strftime</methodname>
<methodparam><type>string</type><parameter>format</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>timestamp</parameter><initializer>time()</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>timestamp</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
Formatea una fecha/hora local según la configuración local. Los nombres del mes y del día
de la semana y otras cadenas dependientes del lenguaje respetan el localismo establecido
con <function>setlocale</function>.
</para>
<para>
No todos los especificadores de conversión pueden estar soportados por su biblioteca C, en cuyo
caso no estarán soportados por la función <function>strftime</function> de PHP.
Además, no todas las plataformas soportan marcas temporales negativas, por lo que el
rango de fechas puede estar limitado a fechas que no sean anteriores a la época Unix.
Eso significa que %e, %T, %R y, %D (y posiblemente otros), así como las fechas anteriores al
<literal>1 de enero de 1970</literal>, no funcionarán en Windows, en algunas distribucioes de Linux,
y en otros pocos sistemas operativos. Para los sistemas Windows, se puede encontrar un resumen
de los especificadores de conversión soportados en
<link xlink:href="&url.strftime.win32;"><acronym>MSDN</acronym></link>.
Formatea una fecha y/o una hora según la localización local. Los nombres
de los meses, de los días de la semana pero también de otras cadenas dependientes
de la localización, respetarán la localización actual definida por la función
<function>setlocale</function>.
</para>
<warning>
<para>
Todos los caracteres modificadores no siempre son soportados por
todas las bibliotecas C. En este caso, no serán soportados por PHP tampoco. Además, todas las plataformas no soportan
los timestamps negativos, y sus fechas podrían estar limitadas por el
inicio de la época Unix. Esto significa que
<literal>%e</literal>, <literal>%T</literal>, <literal>%R</literal> y <literal>%D</literal>
(y puede que otros) y las fechas anteriores al
<literal>1 de Enero de 1970</literal> no funcionarán bajo Windows,
en algunas distribuciones de Linux, y en algunos sistemas operativos.
Para Windows, una lista completa de las opciones de conversión está disponible
en el <link xlink:href="&url.strftime.win32;">sitio de <acronym>MSDN</acronym></link>.
Utilice en su lugar el método <methodname>IntlDateFormatter::format</methodname>.
</para>
</warning>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
@@ -42,8 +56,8 @@
<listitem>
<para>
<table>
<title>Los siguientes caracteres están reconocidos en el
parámetro de cadena <parameter>format</parameter></title>
<title>Los siguientes caracteres son reconocidos en el argumento
<parameter>format</parameter></title>
<tgroup cols="3">
<thead>
<row>
@@ -60,41 +74,39 @@
</row>
<row>
<entry><literal>%a</literal></entry>
<entry>Una representación textual abreviada del día</entry>
<entry><literal>dom</literal> hasta <literal>sáb</literal></entry>
<entry>Nombre abreviado del día de la semana</entry>
<entry>De <literal>Sun</literal> a <literal>Sat</literal></entry>
</row>
<row>
<entry><literal>%A</literal></entry>
<entry>Una representación textual completa del día</entry>
<entry><literal>domingo</literal> hasta <literal>sábado</literal></entry>
<entry>Nombre completo del día de la semana</entry>
<entry>De <literal>Sunday</literal> a <literal>Saturday</literal></entry>
</row>
<row>
<entry><literal>%d</literal></entry>
<entry>El día del mes con dos dígitos (con ceros iniciales)</entry>
<entry><literal>01</literal> a <literal>31</literal></entry>
<entry>Día del mes en formato numérico, con 2 dígitos (con el cero inicial)</entry>
<entry>De <literal>01</literal> a <literal>31</literal></entry>
</row>
<row>
<entry><literal>%e</literal></entry>
<entry>
El día del mes, con un espacio precediendo a los dígitos simples. No
está implementado como está descrito en Windows. Véase más abajo para más información.
</entry>
<entry><literal> 1</literal> a <literal>31</literal></entry>
<entry>Día del mes, con un espacio precediendo al primer dígito.
La implementación de Windows es diferente, véase más abajo para más información.</entry>
<entry>De <literal> 1</literal> a <literal>31</literal></entry>
</row>
<row>
<entry><literal>%j</literal></entry>
<entry>Día del año, tres dígitos con ceros iniciales</entry>
<entry>Día del año, con 3 dígitos con cero inicial</entry>
<entry><literal>001</literal> a <literal>366</literal></entry>
</row>
<row>
<entry><literal>%u</literal></entry>
<entry>Representación numérica del día de la semana del ISO-8601</entry>
<entry><literal>1</literal> (para lunes) hasta <literal>7</literal> (para domingo)</entry>
<entry>Representación ISO-8601 del día de la semana</entry>
<entry>De <literal>1</literal> (para Lunes) a <literal>7</literal> (para Domingo)</entry>
</row>
<row>
<entry><literal>%w</literal></entry>
<entry>Representación numérica del día de la semana</entry>
<entry><literal>0</literal> (para domingo) hasta <literal>6</literal> (para sábado)</entry>
<entry>De <literal>0</literal> (para Domingo) a <literal>6</literal> (para Sábado)</entry>
</row>
<row>
<entry align="center"><emphasis>Semana</emphasis></entry>
@@ -103,24 +115,24 @@
</row>
<row>
<entry><literal>%U</literal></entry>
<entry>Número de semana del año dado, comenzando con el primer
domingo como la primera semana</entry>
<entry>Número de la semana del año dado, comenzando por el primer
Lunes como primera semana</entry>
<entry><literal>13</literal> (para la 13ª semana completa del año)</entry>
</row>
<row>
<entry><literal>%V</literal></entry>
<entry>Número de semana del año dado del ISO-8601:1988, comenzando con
la primera semana del año con al menos 4 días de semana, con el lunes
como principio de la semana</entry>
<entry><literal>01</literal> hasta <literal>53</literal> (donde 53
cuenta para una semana traslapada)</entry>
<entry>Número de la semana del año, siguiendo la norma ISO-8601:1988,
comenzando como primera semana, la semana del año que contiene al menos
4 días, y donde Lunes es el inicio de la semana</entry>
<entry>De <literal>01</literal> a <literal>53</literal> (donde 53
cuenta como semana de solapamiento)</entry>
</row>
<row>
<entry><literal>%W</literal></entry>
<entry>Una representación numérica de la semana del año, comenzando
con el primer domingo como la primera semana</entry>
<entry><literal>46</literal> (para la 46ª semana del año comenzando
con un lunes)</entry>
por el primer Lunes de la primera semana</entry>
<entry><literal>46</literal> (para la 46ª semana de la semana comenzando
por un Lunes)</entry>
</row>
<row>
<entry align="center"><emphasis>Mes</emphasis></entry>
@@ -129,23 +141,23 @@
</row>
<row>
<entry><literal>%b</literal></entry>
<entry>Nombre del mes abreviado, basado en el localismo</entry>
<entry><literal>ene</literal> hasta <literal>dic</literal></entry>
<entry>Nombre del mes, abreviado, según la localización</entry>
<entry>De <literal>Jan</literal> a <literal>Dec</literal></entry>
</row>
<row>
<entry><literal>%B</literal></entry>
<entry>Nombre del mes completo, basado en el localismo</entry>
<entry><literal>enero</literal> hasta <literal>diciembre</literal></entry>
<entry>Nombre completo del mes, según la localización</entry>
<entry>De <literal>January</literal> a <literal>December</literal></entry>
</row>
<row>
<entry><literal>%h</literal></entry>
<entry>Nombre del mes abreviado, basado en el localismo (un alias de %b)</entry>
<entry><literal>ene</literal> hasta <literal>dic</literal></entry>
<entry>Nombre del mes abreviado, según la localización (alias de %b)</entry>
<entry>De <literal>Jan</literal> a <literal>Dec</literal></entry>
</row>
<row>
<entry><literal>%m</literal></entry>
<entry>Representación de dos dígitos del mes</entry>
<entry><literal>01</literal> (para enero) hasta <literal>12</literal> (para diciembre)</entry>
<entry>Mes, con 2 dígitos</entry>
<entry>De <literal>01</literal> (para Enero) a <literal>12</literal> (para Diciembre)</entry>
</row>
<row>
<entry align="center"><emphasis>Año</emphasis></entry>
@@ -154,27 +166,27 @@
</row>
<row>
<entry><literal>%C</literal></entry>
<entry>Representación de dos dígitos del siglo (año dividido entre 100, truncado a un entero)</entry>
<entry><literal>19</literal> para el Siglo XX</entry>
<entry>Representación, con 2 dígitos, del siglo (año dividido por 100, reducido a un entero)</entry>
<entry><literal>19</literal> para el siglo 20</entry>
</row>
<row>
<entry><literal>%g</literal></entry>
<entry>Representación de dos dígitos del año por el estándar ISO-8601:1988 (véase %V)</entry>
<entry>Representación, con 2 dígitos, del año, compatible con los estándares ISO-8601:1988 (véase %V)</entry>
<entry>Ejemplo: <literal>09</literal> para la semana del 6 de enero de 2009</entry>
</row>
<row>
<entry><literal>%G</literal></entry>
<entry>La versión completa de cuatro dígitos de %g</entry>
<entry>Ejemplo: <literal>2008</literal> para la semana del 3 de Enero de 2009</entry>
<entry>La versión completa de 4 dígitos de %g</entry>
<entry>Ejemplo: <literal>2009</literal> para la semana del 3 de enero de 2009</entry>
</row>
<row>
<entry><literal>%y</literal></entry>
<entry>Representación de dos dígitos del año</entry>
<entry>El año, con 2 dígitos</entry>
<entry>Ejemplo: <literal>09</literal> para 2009, <literal>79</literal> para 1979</entry>
</row>
<row>
<entry><literal>%Y</literal></entry>
<entry>Representación de cuatro dígitos del año</entry>
<entry>El año, con 4 dígitos</entry>
<entry>Ejemplo: <literal>2038</literal></entry>
</row>
<row>
@@ -184,196 +196,210 @@
</row>
<row>
<entry><literal>%H</literal></entry>
<entry>Representación de dos dígitos de la hora en formato de 24 horas</entry>
<entry><literal>00</literal> hasta <literal>23</literal></entry>
<entry>La hora, con 2 dígitos, en formato 24 horas</entry>
<entry>De <literal>00</literal> a <literal>23</literal></entry>
</row>
<row>
<entry><literal>%k</literal></entry>
<entry>La hora en format de 24 horas, con un espacio precediendo a las horas de un dígito</entry>
<entry><literal> 0</literal> hasta <literal>23</literal></entry>
<entry>La hora en formato 24 horas, con un espacio precediendo a
un solo dígito</entry>
<entry>De <literal> 0</literal> a <literal>23</literal></entry>
</row>
<row>
<entry><literal>%I</literal></entry>
<entry>Representación de dos dígitos de la hora en formato de 12 horas</entry>
<entry><literal>01</literal> hasta <literal>12</literal></entry>
<entry>Hora, con 2 dígitos, en formato 12 horas</entry>
<entry>De <literal>01</literal> a <literal>12</literal></entry>
</row>
<row>
<entry><literal>%l ('L' minúscula)</literal></entry>
<entry>La hora en formato de 12 horas, con un espacio precediendo a los dígitos simples</entry>
<entry><literal> 1</literal> hasta <literal>12</literal></entry>
<entry><literal>%l</literal> ('L' minúscula)</entry>
<entry>Hora, en formato 12 horas, con un espacio precediendo a un solo dígito</entry>
<entry>De <literal> 1</literal> a <literal>12</literal></entry>
</row>
<row>
<entry><literal>%M</literal></entry>
<entry>Representación de dos dígitos de los minutos</entry>
<entry><literal>00</literal> hasta <literal>59</literal></entry>
<entry>Minuto, con 2 dígitos</entry>
<entry>De <literal>00</literal> a <literal>59</literal></entry>
</row>
<row>
<entry><literal>%p</literal></entry>
<entry>"AM" o "PM" en MAYÚSCULAS basados en la hora dada</entry>
<entry>Ejemplo: <literal>AM</literal> para 00:31, <literal>PM</literal> para 22:23</entry>
<entry>'AM' o 'PM', en mayúsculas, basado en la hora proporcionada</entry>
<entry>
Ejemplo: <literal>AM</literal> para 00:31, <literal>PM</literal> para 22:23.
El resultado exacto depende del sistema operativo, y pueden devolver también variantes en minúsculas,
o variantes con puntos (como <literal>a.m.</literal>).
</entry>
</row>
<row>
<entry><literal>%P</literal></entry>
<entry>"am" o "pm" en minúsculas basados en la hora dada</entry>
<entry>Ejemplo: <literal>am</literal> para 00:31, <literal>pm</literal> para 22:23</entry>
<entry>'am' o 'pm', en minúsculas, basado en la hora proporcionada</entry>
<entry>
Ejemplo: <literal>am</literal> para 00:31, <literal>pm</literal> para 22:23.
No soportado por todos los sistemas operativos.
</entry>
</row>
<row>
<entry><literal>%r</literal></entry>
<entry>Lo mismo que "%I:%M:%S %p"</entry>
<entry>Idéntico a "%I:%M:%S %p"</entry>
<entry>Ejemplo: <literal>09:34:17 PM</literal> para 21:34:17</entry>
</row>
<row>
<entry><literal>%R</literal></entry>
<entry>Lo mismo que "%H:%M"</entry>
<entry>Idéntico a "<literal>%H:%M</literal>"</entry>
<entry>Ejemplo: <literal>00:35</literal> para 12:35 AM, <literal>16:44</literal> para 4:44 PM</entry>
</row>
<row>
<entry><literal>%S</literal></entry>
<entry>Representación de dos dígitos de los segundos</entry>
<entry><literal>00</literal> hasta <literal>59</literal></entry>
<entry>Segundo, con 2 dígitos</entry>
<entry>De <literal>00</literal> a <literal>59</literal></entry>
</row>
<row>
<entry><literal>%T</literal></entry>
<entry>Lo mismo que "%H:%M:%S"</entry>
<entry>Idéntico a "<literal>%H:%M:%S</literal>"</entry>
<entry>Ejemplo: <literal>21:34:17</literal> para 09:34:17 PM</entry>
</row>
<row>
<entry><literal>%X</literal></entry>
<entry>Representación preferida de la hora basda en el localismo, sin la fecha</entry>
<entry>Representación de la hora, basada en la localización, sin la fecha</entry>
<entry>Ejemplo: <literal>03:59:16</literal> o <literal>15:59:16</literal></entry>
</row>
<row>
<entry><literal>%z</literal></entry>
<entry>El índice de la zona horaria. No implementado como está descrito en
Windows. Véase más abajo para más información.</entry>
<entry>Ejemplo: <literal>-0500</literal> para Hora del Este de EEUU</entry>
<entry>
El desplazamiento horario. No implementado tal como se describe en Windows.
Ver más abajo para más información.</entry>
<entry>Ejemplo: <literal>-0500</literal> para la hora del este de EE.UU.</entry>
</row>
<row>
<entry><literal>%Z</literal></entry>
<entry>La abreviatura de la zona horaria No implementado como está descrito en
Windows. Véase más abajo para más información.</entry>
<entry>Ejemplo: <literal>EST</literal> para Hora del Este</entry>
<entry>
La abreviación del desplazamiento horario. No implementado tal como se describe en
Windows. Ver más abajo para más información.
</entry>
<entry>
Ejemplo: <literal>EST</literal> para la hora del este
</entry>
</row>
<row>
<entry align="center"><emphasis>Marcas de fecha y hora</emphasis></entry>
<entry align="center"><emphasis>Hora y fecha</emphasis></entry>
<entry>---</entry>
<entry>---</entry>
</row>
<row>
<entry><literal>%c</literal></entry>
<entry>Marca preferida de la fecha y hora basadas en el localismo</entry>
<entry>Fecha y hora preferidas, basadas en la localización</entry>
<entry>Ejemplo: <literal>Tue Feb 5 00:45:10 2009</literal> para
el 5 de febrero de 2009 a las 12:45:10 AM</entry>
</row>
<row>
<entry><literal>%D</literal></entry>
<entry>Lo mismo que "%m/%d/%y"</entry>
<entry>Idéntico a "<literal>%m/%d/%y</literal>"</entry>
<entry>Ejemplo: <literal>02/05/09</literal> para el 5 de febrero de 2009</entry>
</row>
<row>
<entry><literal>%F</literal></entry>
<entry>Lo mismo que "%Y-%m-%d" (normalmente usado en las marcas de fecha de bases de datos)</entry>
<entry>
Idéntico a "<literal>%Y-%m-%d</literal>"
(usado habitualmente por las bases de datos)
</entry>
<entry>Ejemplo: <literal>2009-02-05</literal> para el 5 de febrero de 2009</entry>
</row>
<row>
<entry><literal>%s</literal></entry>
<entry>Marca temporal del instante de la Época Unix (lo mismo que la función
<function>time</function>)</entry>
<entry>Timestamp de la época Unix (idéntico a la función <function>time</function>)</entry>
<entry>Ejemplo: <literal>305815200</literal> para el 10 de septiembre de 1979 08:40:00 AM</entry>
</row>
<row>
<entry><literal>%x</literal></entry>
<entry>Representación preferida de la fecha basda en la configuración local, sin la hora</entry>
<entry>Representación preferida de la fecha, basada en la localización, sin la hora</entry>
<entry>Ejemplo: <literal>02/05/09</literal> para el 5 de febrero de 2009</entry>
</row>
<row>
<entry align="center"><emphasis>Miscelánea</emphasis></entry>
<entry align="center"><emphasis>Varios</emphasis></entry>
<entry>---</entry>
<entry>---</entry>
</row>
<row>
<entry><literal>%n</literal></entry>
<entry>Un carácter de nueva línea ("\n")</entry>
<entry>Una nueva línea ("\n")</entry>
<entry>---</entry>
</row>
<row>
<entry><literal>%t</literal></entry>
<entry>Un carácter de tabulación ("\t")</entry>
<entry>Una tabulación ("\t")</entry>
<entry>---</entry>
</row>
<row>
<entry><literal>%%</literal></entry>
<entry>Un carácter de porcentaje literal ("%")</entry>
<entry>El carácter de porcentaje ("<literal>%</literal>")</entry>
<entry>---</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<para>
La longitud máxima de este parámetro es de 1023 caracteres.
</para>
<warning>
<simpara>
A diferencia del ISO-9899:1999, Solaris de Sun comienza con el domingo como 1. Como
resultado, <literal>%u</literal> podría no funcionar como está descrito en este
manual.
A diferencia de la norma <literal>ISO-9899:1999</literal>, Sun Solaris
comienza con el Domingo a 1. También, el formato <literal>%u</literal>
no funcionará tal como se describe en este manual.
</simpara>
</warning>
<warning>
<para>
<emphasis>Solamente para Windows:</emphasis>
<emphasis>Solo Windows:</emphasis>
</para>
<para>
El modificador <literal>%e</literal> no está soportado en la implementación
para Windows de esta función. Para obtener este valor se puede usar
en su lugar el modificador <literal>%#d</literal>. El ejemplo de abajo
ilustra cómo escribir una función multiplataforma compatible.
El modificador <literal>%e</literal>
no es soportado bajo Windows. Para calcular el valor, el modificador
<literal>%#d</literal> puede ser utilizado en su lugar. El ejemplo de abajo ilustra la
manera de escribir un código multiplataforma.
</para>
<para>
Los modificadores <literal>%z</literal> y <literal>%Z</literal>
devuelven el nombre de la zona horaria en lugar del índice o de la abreviatura.
devuelven ambos el nombre de la zona horaria en lugar del desplazamiento
o de la abreviación.
</para>
</warning>
<warning>
<simpara>
<emphasis>Solamente para macOS:</emphasis> El modificador <literal>%P</literal>
no está soportado en la implementación para macOS de esta función.
<emphasis>Solo macOS y musl:</emphasis> El modificador <literal>%P</literal>
no es soportado por la implementación de esta función bajo macOS.
</simpara>
</warning>
</warning>
</listitem>
</varlistentry>
&date.timestamp.description;
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve una cadena formateada según <parameter>format</parameter>
empleando el parámetro <parameter>timestamp</parameter> dado o el instante
local actual si no se da una marca temporal. Los nombres del mes y del día de la semana y
otras cadenas dependientes del lenguaje respetan el localismo establecido
con <function>setlocale</function>.
Devuelve una &string; formateada según el argumento <parameter>format</parameter>
dado, utilizando el argumento <parameter>timestamp</parameter> o la fecha local
actual si no se proporciona ningún timestamp. Los nombres de los meses, de los días de la
semana pero también de otras cadenas dependientes de la localización, respetarán
la localización actual definida por la función <function>setlocale</function>.
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
&date.timezone.errors.description;
<para>
Ya que la salida depende de la biblioteca C subyacente, algunos especificadores
de conversión no están soportados. En Windows, proporcionar especificadores de
conversión desconocidos resultará en 5 mensajes <constant>E_WARNING</constant> y
devolverá &false;. En otros sistemas operativos podría no obtenerse ningún
mensaje <constant>E_WARNING</constant> y la salida podría contener los
especificadores de conversión no convertidos.
Dado que la salida depende de la biblioteca C subyacente, algunos
especificadores de conversión no son soportados. Bajo Windows,
el hecho de proporcionar un especificador de conversión desconocido devolverá
5 mensajes de nivel <constant>E_WARNING</constant> y devolverá &false;
al final. Bajo otros sistemas operativos, no recibirá ningún
mensaje de nivel <constant>E_WARNING</constant> y la salida contendrá los
especificadores no convertidos.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
@@ -386,33 +412,36 @@
</row>
</thead>
<tbody>
&date.timezone.errors.changelog;
<row>
<entry>8.0.0</entry>
<entry>
<parameter>timestamp</parameter> ahora es nullable.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
Este ejemplo funcionará si se tienen instalados los localismos respectivos
en el sistema.
Este ejemplo solo funcionará si tiene las localizaciones respectivas
instaladas en su sistema.
<example>
<title>Ejemplos de localismos con <function>strftime</function></title>
<title>Ejemplo con <function>strftime</function></title>
<programlisting role="php">
<![CDATA[
<?php
setlocale(LC_TIME, "C");
echo strftime("%A");
setlocale(LC_TIME, "fi_FI");
echo strftime(" en finlandés es %A,");
echo strftime(" in Finnish is %A,");
setlocale(LC_TIME, "fr_FR");
echo strftime(" en francés %A y");
echo strftime(" in French %A and");
setlocale(LC_TIME, "de_DE");
echo strftime(" en alemán %A.\n");
echo strftime(" in German %A.\n");
?>
]]>
</programlisting>
@@ -420,18 +449,18 @@ echo strftime(" en alemán %A.\n");
</para>
<para>
<example>
<title>Ejemplo de número de semana del ISO 8601:1988</title>
<title>Ejemplo en formato de fecha ISO 8601:1988</title>
<programlisting role="php">
<![CDATA[
<?php
/* Diciembre 2002 / Enero 2003
SemISO L M X J V S D
------ ----------------------------
51 16 17 18 19 20 21 22
52 23 24 25 26 27 28 29
1 30 31 1 2 3 4 5
2 6 7 8 9 10 11 12
3 13 14 15 16 17 18 19 */
ISOWk L M X J V S D
----- ----------------------------
51 16 17 18 19 20 21 22
52 23 24 25 26 27 28 29
1 30 31 1 2 3 4 5
2 6 7 8 9 10 11 12
3 13 14 15 16 17 18 19 */
// Muestra: 12/28/2002 - %V,%G,%Y = 52,2002,2002
echo "12/28/2002 - %V,%G,%Y = " . strftime("%V,%G,%Y", strtotime("12/28/2002")) . "\n";
@@ -445,16 +474,14 @@ echo "1/3/2003 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/3/2003")) . "\n
// Muestra: 1/10/2003 - %V,%G,%Y = 2,2003,2003
echo "1/10/2003 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/10/2003")) . "\n";
/* Diciembre 2004 / Enero 2005
SemISO L M X J V S D
------ ----------------------------
51 13 14 15 16 17 18 19
52 20 21 22 23 24 25 26
53 27 28 29 30 31 1 2
1 3 4 5 6 7 8 9
2 10 11 12 13 14 15 16 */
ISOWk L M X J V S D
----- ----------------------------
51 13 14 15 16 17 18 19
52 20 21 22 23 24 25 26
53 27 28 29 30 31 1 2
1 3 4 5 6 7 8 9
2 10 11 12 13 14 15 16 */
// Muestra: 12/23/2004 - %V,%G,%Y = 52,2004,2004
echo "12/23/2004 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/23/2004")) . "\n";
@@ -475,21 +502,21 @@ echo "1/3/2005 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/3/2005")) . "\n
</para>
<para>
<example>
<title>Ejemplo multiplataforma compatible del modificador <literal>%e</literal></title>
<title><literal>%e</literal> funcionando en toda plataforma</title>
<programlisting role="php">
<![CDATA[
<?php
// Jan 1: resulta en: '%e%1%' (%%, e, %%, %e, %%)
$formato = '%%e%%%e%%';
// 1 de Enero: resultados en: '%e%1%' (%%, e, %%, %e, %%)
$format = '%%e%%%e%%';
// Comprobación para Windows para hallar y remplazar el
// modificador %e adecuadamente
// Verifica bajo Windows, para encontrar y reemplazar el modificador %e
// correctamente
if (strtoupper(substr(PHP_OS, 0, 3)) == 'WIN') {
$formato = preg_replace('#(?<!%)((?:%%)*)%e#', '\1%#d', $formato);
$format = preg_replace('#(?<!%)((?:%%)*)%e#', '\1%#d', $format);
}
echo strftime($formato);
echo strftime($format);
?>
]]>
</programlisting>
@@ -497,88 +524,89 @@ echo strftime($formato);
</para>
<para>
<example>
<title>Mostrar todos los formatos conocidos y desconocidos.</title>
<title>Muestra todos los formatos conocidos o no</title>
<programlisting role="php">
<![CDATA[
<?php
// Describir los formatos.
$formatos_strftime = array(
// Describe los formatos
$strftimeFormats = array(
'A' => 'Una representación textual completa del día',
'B' => 'Nombre del mes completo, basado en el localismo',
'C' => 'Representación de dos dígitos del siglo (año dividido entre 100, truncado a un entero)',
'D' => 'Lo mismo que "%m/%d/%y"',
'B' => 'Nombre del mes completo, basado en la localización',
'C' => 'Representación con 2 dígitos del año (año, dividido por 100, truncado a entero)',
'D' => 'Idéntico a "%m/%d/%y"',
'E' => '',
'F' => 'Lo mismo que "%Y-%m-%d"',
'G' => 'La versión completa de cuatro dígitos de %g',
'H' => 'Representación de dos dígitos de la hora en formato de 24 horas',
'I' => 'Representación de dos dígitos de la hora en formato de 12 horas',
'F' => 'Idéntico a "%Y-%m-%d"',
'G' => 'La versión completa, con 4 dígitos de %g',
'H' => 'Una representación con 2 dígitos de la hora en formato 24-horas',
'I' => 'Una representación con 2 dígitos de la hora en formato 12-horas',
'J' => '',
'K' => '',
'L' => '',
'M' => 'Representación de dos dígitos de los minutos',
'M' => 'Una representación con 2 dígitos de los minutos',
'N' => '',
'O' => '',
'P' => '"am" o "pm" en minúsculas basados en la hora dada',
'P' => '"am" o "pm" (en minúsculas) basado en la hora actual',
'Q' => '',
'R' => 'Lo mismo que "%H:%M"',
'S' => 'Representación de dos dígitos de los segundos',
'T' => 'Lo mismo que "%H:%M:%S"',
'U' => 'Número de semana del año dado, comenzando con el primer domingo como la primera semana',
'V' => 'Número de semana del año dado del ISO-8601:1988, comenzando con la primera semana del año con al menos 4 días de semana, con el lunes como principio de la semana',
'W' => 'Una representación numérica de la semana del año, comenzando con el primer domingo como la primera semana',
'X' => 'Representación preferida de la hora basda en el localismo, sin la fecha',
'Y' => 'Representación de cuatro dígitos del año',
'Z' => 'La opción de índice/abreviatura de la zona horaria NO dada por %z (depende del sistema operativo)',
'a' => 'Una representación textual abreviada del día',
'b' => 'Nombre del mes abreviado, basado en el localismo',
'c' => 'Marca preferida de la fecha y hora basadas en el localismo',
'd' => 'El día del mes con dos dígitos (con ceros iniciales)',
'e' => 'El día del mes, con un espacio precediendo a los dígitos simples',
'R' => 'Idéntico a "%H:%M"',
'S' => 'Una representación con 2 dígitos de los segundos',
'T' => 'Idéntico a "%H:%M:%S"',
'U' => 'Número de la semana para el año actual, comenzando por el primer Domingo como primera semana',
'V' => 'Número ISO-8601:1988 de la semana del año actual, comenzando por la primera semana del año con al menos 4 días de semana, con el Lunes como inicio de semana',
'W' => 'Una representación numérica de la semana del año, comenzando por el primer Lunes como primera semana',
'X' => 'Representación preferida para la hora, basada en la localización, sin la fecha',
'Y' => 'Una representación con 4 dígitos del año',
'Z' => 'La abreviación del desplazamiento horario, no proporcionada por %z (depende del sistema operativo)',
'a' => 'La abreviación de la representación textual del día',
'b' => 'La abreviación del nombre del mes, basada en la localización',
'c' => 'Timestamp preferido basado en la localización',
'd' => 'Día del mes con 2 dígitos (con el cero inicial)',
'e' => 'Día del mes, con un espacio precediendo a un solo dígito',
'f' => '',
'g' => 'Representación de dos dígitos del año por el estándar ISO-8601:1988 (véase %V)',
'h' => 'Nombre del mes abreviado, basado en el localismo (un alias de %b)',
'g' => 'Una representación con 2 dígitos del año en formato ISO-8601:1988 (ver %V)',
'h' => 'Abreviación del nombre del mes, basada en la localización (alias de %b)',
'i' => '',
'j' => 'Día del año, tres dígitos con ceros iniciales',
'k' => 'La hora en formato de 24 horas, con un espacio precediendo a los dígitos simples',
'l' => 'La hora en formato de 12 horas, con un espacio precediendo a los dígitos simples',
'm' => 'Representación de dos dígitos del mes',
'j' => 'Día del año, con 3 dígitos con cero inicial',
'k' => 'Hora, en formato 24-horas, con un espacio precediendo a un solo dígito',
'l' => 'Hora, en formato 12-horas, con un espacio precediendo a un solo dígito',
'm' => 'Una representación del mes con 2 dígitos',
'n' => 'Un carácter de nueva línea ("\n")',
'o' => '',
'p' => '"AM" o "PM" en MAYÚSCULAS basados en la hora dada',
'p' => '"AM" o "PM" (en mayúsculas) basado en la hora actual',
'q' => '',
'r' => 'Lo mismo que "%I:%M:%S %p"',
's' => 'Marca temporal del instante de la Época Unix',
'r' => 'Idéntico a "%I:%M:%S %p"',
's' => 'Timestamp respecto a la época Unix',
't' => 'Un carácter de tabulación ("\t")',
'u' => 'Representación numérica del día de la semana del ISO-8601',
'u' => 'Representación numérica del día de la semana en formato ISO-8601',
'v' => '',
'w' => 'Representación numérica del día de la semana',
'x' => 'Representación preferida de la fecha basda en la configuración local, sin la hora',
'y' => 'Representación de dos dígitos del año',
'z' => 'El índice de la zona horaria UTC o la abreviatura (depende del sistema operativo)',
'%' => 'Un carácter de porcentaje literal ("%")',
'x' => 'Representación preferida de la fecha, basada en la localización, sin la hora',
'y' => 'Representación del año con 2 dígitos',
'z' => 'O bien el desplazamiento horario desde UTC o su abreviación (según el sistema operativo)',
'%' => 'Un carácter porcentaje ("%")',
);
// Resultados.
$valores_strftime = array();
// Resultados
$strftimeValues = array();
// Evaluar los formatos, mientras suprime cualquier error.
foreach($formatos_strftime as $formato => $descripción){
if (False !== ($valor = @strftime("%{$formato}"))){
$valores_strftime[$formato] = $valor;
// 2value los formatos mientras se eliminan los errores
foreach ($strftimeFormats as $format => $description) {
if (false !== ($value = @strftime("%{$format}"))) {
$strftimeValues[$format] = $value;
}
}
// Encontrar el valor más largo.
$longitudValorMáx = 2 + max(array_map('strlen', $valores_strftime));
// Encuentra el valor más largo
$maxValueLength = 2 + max(array_map('strlen', $strftimeValues));
// Notificar los formatos conocidos.
foreach($valores_strftime as $formato => $valor){
echo "Formato conocido : '{$formato}' = ", str_pad("'{$valor}'", $longitudValorMáx), " ( {$formatos_strftime[$formato]} )\n";
// Muestra todos los formatos conocidos
foreach ($strftimeValues as $format => $value) {
echo "Formato conocido: '{$format}' = ", str_pad("'{$value}'", $maxValueLength), " ( {$strftimeFormats[$format]} )\n";
}
// Notificar los formatos desconocidos.
foreach(array_diff_key($formatos_strftime, $valores_strftime) as $formato => $descripción){
echo "Formato desconocido : '{$formato}' ", str_pad(' ', $longitudValorMáx), ($descripción ? " ( {$descripción} )" : ''), "\n";
// Muestra todos los formatos no conocidos
foreach (array_diff_key($strftimeFormats, $strftimeValues) as $format => $description) {
echo "Formato desconocido: '{$format}' ", str_pad(' ', $maxValueLength), ($description ? " ( {$description} )" : ''), "\n";
}
?>
]]>
@@ -586,91 +614,94 @@ foreach(array_diff_key($formatos_strftime, $valores_strftime) as $formato => $de
&example.outputs.similar;
<screen>
<![CDATA[
Formato conocido : 'A' = 'Friday' ( Una representación textual completa del día )
Formato conocido : 'B' = 'December' ( Nombre del mes completo, basado en el localismo )
Formato conocido : 'H' = '11' ( Representación de dos dígitos de la hora en formato de 24 horas )
Formato conocido : 'I' = '11' ( Representación de dos dígitos de la hora en formato de 12 horas )
Formato conocido : 'M' = '24' ( Representación de dos dígitos de los minutos )
Formato conocido : 'S' = '44' ( Representación de dos dígitos de los segundos )
Formato conocido : 'U' = '48' ( Número de semana del año dado, comenzando con el primer domingo como la primera semana )
Formato conocido : 'W' = '48' ( Una representación numérica de la semana del año, comenzando con el primer domingo como la primera semana )
Formato conocido : 'X' = '11:24:44' ( Representación preferida de la hora basda en el localismo, sin la fecha )
Formato conocido : 'Y' = '2010' ( Representación de cuatro dígitos del año )
Formato conocido : 'Z' = 'GMT Standard Time' ( La opción de índice/abreviatura de la zona horaria NO dada por %z (depende del sistema operativo) )
Formato conocido : 'a' = 'Fri' ( Una representación textual abreviada del día )
Formato conocido : 'b' = 'Dec' ( Nombre del mes abreviado, basado en el localismo )
Formato conocido : 'c' = '12/03/10 11:24:44' ( Marca preferida de la fecha y hora basadas en el localismo )
Formato conocido : 'd' = '03' ( El día del mes con dos dígitos (con ceros iniciales) )
Formato conocido : 'j' = '337' ( Día del año, tres dígitos con ceros iniciales )
Formato conocido : 'm' = '12' ( Representación de dos dígitos del mes )
Formato conocido : 'p' = 'AM' ( "AM" o "PM" en MAYÚSCULAS basados en la hora dada )
Formato conocido : 'w' = '5' ( Representación numérica del día de la semana )
Formato conocido : 'x' = '12/03/10' ( Representación preferida de la fecha basda en la configuración local, sin la hora )
Formato conocido : 'y' = '10' ( Representación de dos dígitos del año )
Formato conocido : 'z' = 'GMT Standard Time' ( El índice de la zona horaria UTC o la abreviatura (depende del sistema operativo) )
Formato conocido : '%' = '%' ( Un carácter de porcentaje literal ("%") )
Formato desconocido : 'C' ( Representación de dos dígitos del siglo (año dividido entre 100, truncado a un entero) )
Formato desconocido : 'D' ( Lo mismo que "%m/%d/%y" )
Formato desconocido : 'E'
Formato desconocido : 'F' ( Lo mismo que "%Y-%m-%d" )
Formato desconocido : 'G' ( La versión completa de cuatro dígitos de %g )
Formato desconocido : 'J'
Formato desconocido : 'K'
Formato desconocido : 'L'
Formato desconocido : 'N'
Formato desconocido : 'O'
Formato desconocido : 'P' ( "am" o "pm" en minúsculas basados en la hora dada )
Formato desconocido : 'Q'
Formato desconocido : 'R' ( Lo mismo que "%H:%M" )
Formato desconocido : 'T' ( Lo mismo que "%H:%M:%S" )
Formato desconocido : 'V' ( Número de semana del año dado del ISO-8601:1988, comenzando con la primera semana del año con al menos 4 días de semana, con el lunes como principio de la semana )
Formato desconocido : 'e' ( El día del mes, con un espacio precediendo a los dígitos simples )
Formato desconocido : 'f'
Formato desconocido : 'g' ( Representación de dos dígitos del año por el estándar ISO-8601:1988 (véase %V) )
Formato desconocido : 'h' ( Nombre del mes abreviado, basado en el localismo (un alias de %b) )
Formato desconocido : 'i'
Formato desconocido : 'k' ( La hora en formato de 24 horas, con un espacio precediendo a los dígitos simples )
Formato desconocido : 'l' ( La hora en formato de 12 horas, con un espacio precediendo a los dígitos simples )
Formato desconocido : 'n' ( Un carácter de nueva línea ("\n") )
Formato desconocido : 'o'
Formato desconocido : 'q'
Formato desconocido : 'r' ( Lo mismo que "%I:%M:%S %p" )
Formato desconocido : 's' ( Marca temporal del instante de la Época Unix )
Formato desconocido : 't' ( Un carácter de tabulación ("\t") )
Formato desconocido : 'u' ( Representación numérica del día de la semana del ISO-8601 )
Formato desconocido : 'v'
Formato conocido: 'A' = 'Friday' ( Una representación textual completa del día )
Formato conocido: 'B' = 'December' ( Nombre del mes completo, basado en la localización )
Formato conocido: 'H' = '11' ( Una representación con 2 dígitos de la hora en formato 24-horas )
Formato conocido: 'I' = '11' ( Una representación con 2 dígitos de la hora en formato 12-horas )
Formato conocido: 'M' = '24' ( Una representación con 2 dígitos de los minutos )
Formato conocido: 'S' = '44' ( Una representación con 2 dígitos de los segundos )
Formato conocido: 'U' = '48' ( Número de la semana para el año actual, comenzando por el primer Domingo como primera semana )
Formato conocido: 'W' = '48' ( Una representación numérica de la semana del año, comenzando por el primer Lunes como primera semana )
Formato conocido: 'X' = '11:24:44' ( Representación preferida para la hora, basada en la localización, sin la fecha )
Formato conocido: 'Y' = '2010' ( Una representación con 4 dígitos del año )
Formato conocido: 'Z' = 'GMT Standard Time' ( La abreviación del desplazamiento horario, no proporcionada por %z (depende del sistema operativo) )
Formato conocido: 'a' = 'Fri' ( La abreviación de la representación textual del día )
Formato conocido: 'b' = 'Dec' ( La abreviación del nombre del mes, basada en la localización )
Formato conocido: 'c' = '12/03/10 11:24:44' ( Timestamp preferido basado en la localización )
Formato conocido: 'd' = '03' ( Día del mes con 2 dígitos (con el cero inicial) )
Formato conocido: 'j' = '337' ( Día del año, con 3 dígitos con cero inicial )
Formato conocido: 'm' = '12' ( Una representación del mes con 2 dígitos )
Formato conocido: 'p' = 'AM' ( "AM" o "PM" (en mayúsculas) basado en la hora actual )
Formato conocido: 'w' = '5' ( Representación numérica del día de la semana )
Formato conocido: 'x' = '12/03/10' ( Representación preferida de la fecha, basada en la localización, sin la hora )
Formato conocido: 'y' = '10' ( Representación del año con 2 dígitos )
Formato conocido: 'z' = 'GMT Standard Time' ( O bien el desplazamiento horario desde UTC o su abreviación (según el sistema operativo) )
Formato conocido: '%' = '%' ( Un carácter porcentaje ("%") )
Formato desconocido: 'C' ( Representación con 2 dígitos del año (año, dividido por 100, truncado a entero) )
Formato desconocido: 'D' ( Idéntico a "%m/%d/%y" )
Formato desconocido: 'E'
Formato desconocido: 'F' ( Idéntico a "%Y-%m-%d" )
Formato desconocido: 'G' ( La versión completa, con 4 dígitos de %g )
Formato desconocido: 'J'
Formato desconocido: 'K'
Formato desconocido: 'L'
Formato desconocido: 'N'
Formato desconocido: 'O'
Formato desconocido: 'P' ( "am" o "pm" (en minúsculas) basado en la hora actual )
Formato desconocido: 'Q'
Formato desconocido: 'R' ( Idéntico a "%H:%M" )
Formato desconocido: 'T' ( Idéntico a "%H:%M:%S" )
Formato desconocido: 'V' ( Número ISO-8601:1988 de la semana del año actual, comenzando por la primera semana del año con al menos 4 días de semana, con el Lunes como inicio de semana )
Formato desconocido: 'e' ( Día del mes, con un espacio precediendo a un solo dígito )
Formato desconocido: 'f'
Formato desconocido: 'g' ( Una representación con 2 dígitos del año en formato ISO-8601:1988 (ver %V) )
Formato desconocido: 'h' ( Abreviación del nombre del mes, basada en la localización (alias de %b) )
Formato desconocido: 'i'
Formato desconocido: 'k' ( Hora, en formato 24-horas, con un espacio precediendo a un solo dígito )
Formato desconocido: 'l' ( Hora, en formato 12-horas, con un espacio precediendo a un solo dígito )
Formato desconocido: 'n' ( Un carácter de nueva línea ("\n") )
Formato desconocido: 'o'
Formato desconocido: 'q'
Formato desconocido: 'r' ( Idéntico a "%I:%M:%S %p" )
Formato desconocido: 's' ( Timestamp respecto a la época Unix )
Formato desconocido: 't' ( Un carácter de tabulación ("\t") )
Formato desconocido: 'u' ( Representación numérica del día de la semana en formato ISO-8601 )
Formato desconocido: 'v'
]]>
</screen>
</example>
</para>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<simpara>
%G y %V, los cuales están basados en el número de semana del ISO 8601:1988, pueden
dar resultados inesperados (aunque correctos) si el sistema numérico
no se entendió perfectamente. Véanse los ejemplos de %V en esta página del manual.
<literal>%G</literal> y <literal>%V</literal>, que están basadas
en la semana <literal>ISO 8601:1988</literal>, pueden conducir
a resultados inesperados (aunque correctos) si el
sistema de numeración no es conocido. Ver el ejemplo
<literal>%V</literal> de esta página.
</simpara>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><link xlink:href="&url.strftime.format.designer;">Herramienta de diseño del formato de strftime() en línea</link></member>
<member><methodname>IntlDateFormatter::format</methodname></member>
<member><methodname>DateTimeInterface::format</methodname></member>
<member><link xlink:href="&url.strftime.format.designer;">Herramienta de formato strftime() en línea</link></member>
<member><function>setlocale</function></member>
<member><function>mktime</function></member>
<member><function>strptime</function></member>
<member><function>gmstrftime</function></member>
<member><link xlink:href="&spec.strftime;">Especificación de <function>strftime</function> del Open Group</link></member>
<member><link xlink:href="&spec.strftime;">grupo de especificaciones de <function>strftime</function></link></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

203
reference/datetime/functions/strtotime.xml
View File

@@ -1,74 +1,83 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 866b749d19ee0b4df802cc6751855311364521ed Maintainer: seros Status: ready -->
<!-- Reviewed: no Maintainer: andresdzphp -->
<!-- splitted from ./en/functions/datetime.xml, last change in rev 1.8 -->
<!-- EN-Revision: 5c951013ca04161992efed8b86fb40f55669958e Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.strtotime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>strtotime</refname>
<refpurpose>Convierte una descripción de fecha/hora textual en Inglés a una fecha Unix</refpurpose>
<refpurpose>Transforma un texto inglés en timestamp</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>int</type><methodname>strtotime</methodname>
<methodparam><type>string</type><parameter>time</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>now</parameter><initializer>time()</initializer></methodparam>
<type class="union"><type>int</type><type>false</type></type><methodname>strtotime</methodname>
<methodparam><type>string</type><parameter>datetime</parameter></methodparam>
<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>baseTimestamp</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<simpara>
Esta función espera que se proporcione una cadena que contenga un formato de fecha
en Inglés US e intentará convertir ese formato a una fecha Unix (el
número de segundos desde el 1 de Enero del 1970 00:00:00 UTC), relativa
a la marca de tiempo dada en <parameter>now</parameter>, o la marca de tiempo
actual si <parameter>now</parameter> no se proporciona.
La función <function>strtotime</function> intenta leer una
fecha en formato inglés proporcionada por el parámetro <parameter>time</parameter>,
y transformarla en un timestamp Unix (el número de segundos desde
el 1 de enero de 1970 a 00:00:00 UTC), relativo al timestamp
<parameter>baseTimestamp</parameter>, o a la fecha actual si este último
es omitido. El análisis de la cadena de fecha está definido en
<link linkend="datetime.formats">los formatos de fecha y hora</link>
y presenta varias consideraciones sutiles. Se recomienda encarecidamente
examinar todos los detalles.
</simpara>
<warning>
<para>
El timestamp Unix que devuelve esta función no contiene información
sobre los husos horarios. Para realizar cálculos con información de
fecha/hora, es preferible utilizar
<classname>DateTimeImmutable</classname> que es más capaz.
</para>
</warning>
<para>
Cada parámetro de esta función utiliza la zona horaria predeterminada a menos que
se especifique una en ese parámetro. Se ha de tener cuidado de no usar
diferentes zonas horarias en cada parámetro a menos que sea esa la intención.
Véase la función <function>date_default_timezone_get</function> para las diferentes
maneras de definir la zona horaria predeterminada.
Cada parámetro de la función utiliza el desplazamiento horario por defecto
a menos que se especifique explícitamente un desplazamiento horario.
Tenga cuidado de no utilizar un desplazamiento horario diferente para
cada parámetro a menos que sea lo que se necesita.
Consulte la función <function>date_default_timezone_get</function>
para saber cómo definir un desplazamiento horario por defecto.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>time</parameter></term>
<term><parameter>datetime</parameter></term>
<listitem>
<para>&date.formats.parameter;</para>
<para>&date.formats.parameter;</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>now</parameter></term>
<term><parameter>baseTimestamp</parameter></term>
<listitem>
<para>
La marca de tiempo que se usa como base para el cálculo de las
fechas relativas.
El timestamp, que representa la fecha actual, utilizado para el cálculo
relativo de fechas.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve una marca de tiempo si se tuvo éxito, &false; si no. Antes de PHP 5.1.0,
esta funcion devolvía <literal>-1</literal> si fallaba.
Devuelve un timestamp en caso de éxito, &false; en caso contrario.
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
&date.timezone.errors.description;
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
@@ -82,56 +91,9 @@
</thead>
<tbody>
<row>
<entry>5.3.0</entry>
<entry>
Antes de PHP 5.3.0, formatos de tiempo relativo que se suministran al
parámetro <parameter>time</parameter> de la función <function>strtotime</function>
como <literal>this week</literal>, <literal>previous week</literal>,
<literal>last week</literal>, y <literal>next week</literal> se interpreta como
un período de 7 días en relación con la fecha y hora actual, en lugar de un período de
semana de <literal>Monday</literal> a <literal>Sunday</literal>.
</entry>
</row>
<row>
<entry>5.3.0</entry>
<entry>8.0.0</entry>
<entry>
Antes de PHP 5.3.0, <literal>24:00</literal> no era un formato válido y
<function>strtotime</function> devolvía &false;.
</entry>
</row>
<row>
<entry>5.2.7</entry>
<entry>
En PHP 5 anterior a 5.2.7, las peticiones de una incidencia de un
día de la semana dado en un mes donde ese día de la semana era el primer día
del mes, añadía incorrectamente una semana a la marca de tiempo devuelta.
Esto ha sido corregido en 5.2.7 y versiones
posteriores.
</entry>
</row>
<row>
<entry>5.1.0</entry>
<entry>
Ahora devuelve &false; si falla, en vez
de <literal>-1</literal>.
</entry>
</row>
&date.timezone.errors.changelog;
<row>
<entry>5.0.2</entry>
<entry>
En PHP 5 hasta 5.0.2, <literal>"now"</literal> y otros
momentos relativos son computados erróneamente como la medianoche de
hoy. Esto difiere de otras versiones donde es
computado como el momento actual.
</entry>
</row>
<row>
<entry>5.0.0</entry>
<entry>
Los microsegundos comenzaron a estar permitidos, pero son ignorados.
<parameter>baseTimestamp</parameter> ahora es nullable.
</entry>
</row>
</tbody>
@@ -139,12 +101,12 @@
</informaltable>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Un ejemplo de <function>strtotime</function></title>
<title>Ejemplo con <function>strtotime</function></title>
<programlisting role="php">
<![CDATA[
<?php
@@ -162,17 +124,16 @@ echo strtotime("last Monday"), "\n";
</para>
<para>
<example>
<title>Comprobar si falla</title>
<title>Verificación de error</title>
<programlisting role="php">
<![CDATA[
<?php
$cadena = 'No Válida';
$str = 'No es válido';
// antes de PHP 5.1.0 se debería de comparar con -1, en vez de con false
if (($timestamp = strtotime($cadena)) === false) {
echo "La cadena ($cadena) es falsa";
if (($timestamp = strtotime($str)) === false) {
echo "La cadena ($str) está corrupta";
} else {
echo "$cadena == " . date('l dS \o\f F Y h:i:s A', $timestamp);
echo "$str == " . date('l dS \o\f F Y h:i:s A', $timestamp);
}
?>
]]>
@@ -180,77 +141,65 @@ if (($timestamp = strtotime($cadena)) === false) {
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
Si el número del año se especifica en un formato de dos dígitos, los valores
entre 00-69 hacen referencia a 2000-2069 y 70-99 a 1970-1999. Vea las notas de abajo
para las posibles diferencias en sistemas de 32 bit (las fechas posibles podrían terminar en
2038-01-19 03:14:07).
En este caso, la fecha "relativa" significa también que si un componente
particular del timestamp no es proporcionado, será extraído textualmente de
<parameter>baseTimestamp</parameter>. En otras palabras,
<code>strtotime('February')</code>, si se ejecuta el 31 de mayo de 2022, será
interpretado como el <literal>31 de febrero de 2022</literal>, lo que
desbordará a un timestamp el <literal>3 de marzo</literal>. (En un año bisiesto,
sería el <literal>2 de marzo</literal>.) El uso de
<code>strtotime('1 February')</code> o <code>strtotime('first day of February')</code>
evitaría este problema.
</para>
</note>
<note>
<para>
El rango válido de una marca de tiempo es típicamente desde Fri, 13 Dec
1901 20:45:54 UTC a Tue, 19 Jan 2038 03:14:07 UTC. (Estas son
las fechas que se corresponden con los valores máximo y mínimo de
un entero con signo de 32 bit.)
</para>
<para>
Antes de PHP 5.1.0, no todas las plataformas admitían marcas de tiempo negativas, por lo que
el rango de fechas puede estar limitado a no anteriores a la época Unix. Esto
significa que, p.ej., las fechas anteriores al 1 de enero de 1970 no funcionarán en Windows,
en algunas distribuciones de Linux, y en otros pocos sistemas operativos.
</para>
<para>
Para PHP versión 64-bit, el rángo válido de fechas es en la práctica infinito,
ya que 64 bits pueden representar aproximadamente 293.000 millones de años en
cualquier dirección.
Si el número de años se especifica en dos dígitos, los valores entre
00-69 corresponden a 2000-2069 y 70-99 a 1970-1999. Consulte las notas
posteriores sobre las posibles diferencias entre sistemas de 32 bits (las fechas
pueden fallar después del 19/01/2038 a 03:14:07).
</para>
</note>
<note>
<para>
Las fechas en los formatos <literal>m/d/y</literal> o <literal>d-m-y</literal>
no son ambiguas al observar el separador entre los distintos
componentes: si el separador es una barra (<literal>/</literal>), se asume
el formato norteamericano <literal>m/d/y</literal>; mientras que si el separador es un
guion (<literal>-</literal>) o un punto (<literal>.</literal>), se asume
el formato europeo <literal>d-m-y</literal>.
Si, sin embargo, el año se proporciona en un formato de dos dígitos y el separador es un
guion (<literal>-</literal>), la cadena de la fecha se analiza como
<literal>y-m-d</literal>.
El intervalo de validez de un timestamp va del
Viernes 13 de diciembre de 1901 20:45:54 UTC al Martes 19 de enero de 2038 03:14:07 UTC.
(Esto corresponde a las fechas máximas y mínimas para un
entero de 32 bits firmado).
</para>
<para>
Para evitar esta ambigüedad potencial es mejor usar fechas ISO 8601
(<literal>YYYY-MM-DD</literal>) o
<methodname>DateTime::createFromFormat</methodname> cuando sea posible.
Para las versiones de 64 bits de PHP, el intervalo válido de un timestamp
es realmente infinito, sabiendo que 64 bits puede representar aproximadamente
293 mil millones de años en cualquier dirección.
</para>
</note>
<note>
<para>
No es aconsejable utililzar esta función para operaciones matemáticas.
Es mejor usar los métodos <methodname>DateTime::add</methodname> y
<methodname>DateTime::sub</methodname> de PHP 5.3 y posterior, o
el método <methodname>DateTime::modify</methodname> de PHP 5.2.
El uso de esta función en operaciones matemáticas no está recomendado.
Es preferible utilizar en este caso
<methodname>DateTime::add</methodname> y <methodname>DateTime::sub</methodname>.
</para>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><link linkend="datetime.formats">Formatos de Fecha y Hora</link></member>
<member><methodname>DateTime::createFromFormat</methodname></member>
<member><classname>DateTimeImmutable</classname></member>
<member><methodname>DateTimeImmutable::createFromFormat</methodname></member>
<member><link linkend="datetime.formats">Los formatos sobre fechas</link></member>
<member><function>checkdate</function></member>
<member><function>strptime</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

57
reference/datetime/functions/time.xml
View File

@@ -1,13 +1,14 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 9edaff269c660085fd710bea5ee099e284c025e4 Maintainer: seros Status: ready -->
<!-- Reviewed: yes Maintainer: seros -->
<!-- EN-Revision: 5c951013ca04161992efed8b86fb40f55669958e Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.time" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>time</refname>
<refpurpose>Devuelve la fecha Unix actual</refpurpose>
<refpurpose>Devuelve el timestamp UNIX actual</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
@@ -15,54 +16,68 @@
<void/>
</methodsynopsis>
<para>
Devuelve el momento actual medido como el número de segundos desde
la Época Unix (1 de Enero de 1970 00:00:00 GMT).
<function>time</function> devuelve la hora actual, medida
en segundos desde el inicio de la época UNIX, (1 de
enero de 1970 00:00:00 GMT).
</para>
<note>
<para>
Los timestamps Unix no contienen información alguna sobre el huso horario local.
Se recomienda utilizar la clase <classname>DateTimeImmutable</classname> para manipular
información relativa a la fecha y la hora, a fin de evitar los problemas asociados a los timestamps Unix.
</para>
</note>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve el timestamp actual.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo de <function>time</function></title>
<title>Ejemplo con <function>time</function></title>
<programlisting role="php">
<![CDATA[
<?php
$semanaSiguiente = time() + (7 * 24 * 60 * 60);
// 7 días; 24 horas; 60 minutos; 60 segundos
echo 'Ahora: '. date('Y-m-d') ."\n";
echo 'Semana Siguiente: '. date('Y-m-d', $semanaSiguiente) ."\n";
// o usar strtotime():
echo 'Semana Siguiente: '. date('Y-m-d', strtotime('+1 week')) ."\n";
echo 'Hoy : '. time();
?>
]]>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
Ahora: 2005-03-30
Semana Siguiente: 2005-04-06
Semana Siguiente: 2005-04-06
Hoy : 1660338149
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<tip>
<para>
La marca de tiempo del inicio de la petición está disponible en
<varname>$_SERVER['REQUEST_TIME']</varname> desde PHP 5.1.
Un timestamp que representa el inicio de la petición está disponible en
la variable <varname>$_SERVER['REQUEST_TIME']</varname>.
</para>
</tip>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><classname>DateTimeImmutable</classname></member>
<member><function>date</function></member>
<member><function>microtime</function></member>
</simplelist>

57
reference/datetime/functions/timezone-name-from-abbr.xml
View File

@@ -1,21 +1,23 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 49d9c2bfe70626dbb338db0943d305c01ba2522b Maintainer: seros Status: ready -->
<!-- EN-Revision: 5c951013ca04161992efed8b86fb40f55669958e Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="function.timezone-name-from-abbr" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>timezone_name_from_abbr</refname>
<refpurpose>Devuelve el nombre de la zona horaria desde su abreviatura</refpurpose>
<refpurpose>Devuelve el nombre de una zona horaria a partir de su abreviatura y del desplazamiento UTC</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>timezone_name_from_abbr</methodname>
<type class="union"><type>string</type><type>false</type></type><methodname>timezone_name_from_abbr</methodname>
<methodparam><type>string</type><parameter>abbr</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>gmtOffset</parameter><initializer>-1</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>isdst</parameter><initializer>-1</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>utcOffset</parameter><initializer>-1</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>isDST</parameter><initializer>-1</initializer></methodparam>
</methodsynopsis>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
@@ -24,53 +26,52 @@
<term><parameter>abbr</parameter></term>
<listitem>
<para>
La abreviatura de la zona horaria.
Abreviatura de la zona horaria.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>gmtOffset</parameter></term>
<term><parameter>utcOffset</parameter></term>
<listitem>
<para>
Índice de GMT en segundos. Por defecto es -1 lo que significa que la primera zona
horaria buscada que se corresponda con <parameter>abbr</parameter> es devuelta.
De otro modo se busca el índice exacto y, sólo si no se encuentra, se devuelve la
priemra zona horaria con cualquier índice.
Desplazamiento respecto al GMT en segundos. El valor por omisión es -1 lo que
significa que se devuelve la primera zona horaria encontrada que corresponda a
<parameter>abbr</parameter>. De lo contrario, se busca el desplazamiento exacto y solo si no se
encuentra, se devuelve la primera zona horaria con cualquier desplazamiento.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>isdst</parameter></term>
<term><parameter>isDST</parameter></term>
<listitem>
<para>
Indicador del horario de verano. Por defecto a -1, lo que significa que
si la zona horaria tiene horario de verano no se toma encosideración
en la búsqueda. Si está establecido a 1, entonces se asuma que
el parámetro <parameter>gmtOffset</parameter> es un índice con
el horario de verano en efecto; si es 0, entonces se asume que
<parameter>gmtOffset</parameter> es un índice sin horario de verano en efecto. Si
<parameter>abbr</parameter> no existe, la zona horaria se
busca únicamente mediante <parameter>gmtOffset</parameter> y
<parameter>isdst</parameter>.
Indicador de hora de verano/hora de invierno. Por omisión -1 que significa que
el desplazamiento de hora de verano/hora de invierno no se tiene en cuenta en la
búsqueda aunque la zona horaria lo gestione. Si se establece en 1, entonces el
<parameter>utcOffset</parameter> se asume que incluye el desplazamiento de hora de verano
/hora de invierno; si es 0 entonces <parameter>utcOffset</parameter>
se asume que representa un desplazamiento que no tiene en cuenta la hora de verano/invierno.
Si <parameter>abbr</parameter> no existe entonces la zona horaria se busca
únicamente mediante <parameter>utcOffset</parameter> y <parameter>isDST</parameter>.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve el nombre de la zona horaria si se tuvo éxito &return.falseforfailure;.
Devuelve un nombre de zona horaria en caso de éxito&return.falseforfailure;.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Un ejemplo de <function>timezone_name_from_abbr</function></title>
<title>Ejemplo con <function>timezone_name_from_abbr</function></title>
<programlisting role="php">
<![CDATA[
<?php
@@ -89,7 +90,7 @@ Europe/Paris
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -98,7 +99,7 @@ Europe/Paris
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

39
reference/datetime/functions/timezone-version-get.xml
View File

@@ -1,11 +1,13 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 14af302c9c0e561fa6f9cdd956268758ba9a89c5 Maintainer: seros Status: ready -->
<refentry xml:id="function.timezone-version-get" xmlns="http://docbook.org/ns/docbook">
<!-- EN-Revision: b7ac6fa547cef108d56729fa322677eec4882285 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.timezone-version-get" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>timezone_version_get</refname>
<refpurpose>
Obtiene la versión de la base de datos timezonedb
Lee la versión de la timezonedb
</refpurpose>
</refnamediv>
<refsect1 role="description">
@@ -15,14 +17,35 @@
<void/>
</methodsynopsis>
<para>
Devuelve la versión actual de timezonedb.
<function>timezone_version_get</function> lee la versión de la timezonedb.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve un <type>string</type>.
Devuelve un &string; en formato <literal>YYYY.increment</literal>,
como <literal>2022.2</literal>.
</para>
<para>
Si se tiene una versión antigua de la base de datos de zonas horarias
(por ejemplo, no muestra el año actual), se pueden actualizar
las informaciones de zona horaria actualizando la versión de PHP o
instalando el paquete PECL <link xlink:href="&url.pecl.package;timezonedb">
timezonedb</link> PECL.
</para>
<para>
Algunas distribuciones Linux corrigen el soporte de fecha/hora de PHP para
usar una fuente alternativa para las informaciones de zona horaria.
En este caso, esta función devolverá <literal>0.system</literal>. Asimismo,
se recomienda instalar el paquete PECL
<link xlink:href="&url.pecl.package;timezonedb">timezonedb</link>
en este caso.
</para>
</refsect1>
@@ -30,7 +53,7 @@
&reftitle.examples;
<para>
<example>
<title>Obtener la versión de timezonedb</title>
<title>Lectura de la versión de la timezonedb</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -41,7 +64,7 @@ echo timezone_version_get();
&example.outputs.similar;
<screen>
<![CDATA[
2009.7
2022.2
]]>
</screen>
</example>
@@ -52,7 +75,7 @@ echo timezone_version_get();
&reftitle.seealso;
<para>
<simplelist>
<member><link linkend="timezones">Lista de la Zonas Horarias Soportadas</link></member>
<member><link linkend="timezones">Lista de zonas horarias válidas</link></member>
</simplelist>
</para>
</refsect1>

31
reference/dba/book.xml
View File

@@ -1,36 +1,40 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1634a886415d0ab4df195fe49d18a1c150b70758 Maintainer: chuso Status: ready -->
<!-- Reviewed: yes Maintainer: seros -->
<!-- EN-Revision: 1a53c22773e4e08ab5b67ba3d4d91cc011047da5 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes Maintainer: PhilDaiguille -->
<book xml:id="book.dba" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<?phpdoc extension-membership="bundled" ?>
<title>Capa de Abstracción de Base de Datos (estilo dbm)</title>
<title>Capa de abstracción de base de datos (estilo dbm)</title>
<titleabbrev>DBA</titleabbrev>
<!-- {{{ preface -->
<preface xml:id="intro.dba">
&reftitle.intro;
<para>
Estas funciones construyen los cimientos para acceder a las bases de datos
estilo Berkeley DB.
Estas funciones permiten el acceso a las bases de datos del estilo
Berkeley DB.
</para>
<para>
Es una capa de abstracción general para varias bases de datos basadas en ficheros.
Como tal, la funcionalidad está limitada a un subconjunto común de características
admitidas por las bases de datos modernas como
Se trata de una capa de abstracción general para varias bases
de datos, basadas en ficheros. Por esta razón
las funcionalidades se limitan a acciones comunes soportadas
por las bases de datos modernas, como
<link xlink:href="&url.berkeleydb;">Oracle Berkeley DB</link>.
</para>
</preface>
<!-- }}} -->
&reference.dba.setup;
&reference.dba.constants;
&reference.dba.examples;
&reference.dba.reference;
</book>
<!-- Dba\Connection class -->
&reference.dba.dba.connection;
<!-- dba_*() functions -->
&reference.dba.reference;
</book>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -51,4 +55,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

252
reference/dba/configure.xml
View File

@@ -1,36 +1,40 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 8ef6cf9b7c88b81e2ba378eb61e0781016592125 Maintainer: seros Status: ready -->
<!-- EN-Revision: a0ae28d3bc85f927c22649ebd9a590b921534b7d Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes Maintainer: PhilDaiguille -->
<section xml:id="dba.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.install;
<para>
Usando la opción de configuración <option role="configure">--enable-dba=shared</option>
se puede construir un módulo cargable dinámico para habilitar PHP
para el soporte básico de bases de datos estilo dbm. También se tiene que añadir soporte
para al menos uno de los siguientes gestores especificando el
conmutador <option role="configure">--with-XXXX</option> de configure a la línea de
configuración de PHP.
Al utilizar la opción de compilación <option role="configure">--enable-dba=shared</option>,
puede compilarse un módulo dinámico que active el soporte
de las bases de datos de estilo DBM para PHP. Asimismo, debe añadirse el soporte
de al menos uno de los siguientes gestores, especificando la opción de
configuración <option role="configure">--with-XXXX</option> o
<option role="configure">--enable-XXXX</option> durante la configuración de
PHP.
</para>
<warning>
<para>
Después de configurar y compilar PHP debe ejecutar la siguiente prueba
desde la línea de comandos: <literal>php run-tests.php ext/dba</literal>. Esto muestra
si la combinación de gestores funciona. Los más problemáticos son
<literal>dbm</literal> y <literal>ndbm</literal> ya que entran en conflicto con
muchas instalaciones. La razón de esto es que en muchos sistemas estas
bibliotecas son parte de más de una biblioteca. La prueba de configuración
sólo previene del malfuncionamiento de configuración de gestores únicos, pero no
de combinaciones.
Tras configurar y compilar PHP, deben ejecutarse las siguientes pruebas
desde la línea de comandos: <literal>php run-tests.php
ext/dba</literal>. Esto muestra si la combinación de controladores
funciona. Los más problemáticos son <literal>dbm</literal> y
<literal>ndbm</literal> que entran en conflicto con numerosas instalaciones.
Esto se debe a que en muchos sistemas, estas bibliotecas forman
parte de más de una biblioteca. La prueba de configuración impide
simplemente configurar descriptores cuya combinación es defectuosa
aunque funcionen correctamente por separado.
</para>
</warning>
<para>
<table>
<title>Gestores de DBA soportados</title>
<title>Gestores DBA soportados</title>
<tgroup cols="2">
<thead>
<row>
<entry>Gestor</entry>
<entry>Conmuntador de Configuración</entry>
<entry>Opción de configuración</entry>
</row>
</thead>
<tbody>
@@ -38,15 +42,15 @@
<entry><literal>dbm</literal></entry>
<entry>
<para>
Para habilitar el soporte para dbm añada
<option role="configure">--with-dbm[=DIR]</option>.
<note>
<para>
dbm es normalmente una envoltura que a menudo resulta en fallo.
Esto significa que debería usar dbm sólo si está seguro de que funciona
y que realmente necesita este formato.
</para>
</note>
Para activar el soporte de dbm, añada la opción
de compilación <option role="configure">--with-dbm[=DIR]</option>.
<note>
<para>
dbm es una sobrecarga que suele dar lugar a fallos.
Por tanto, solo debe utilizarse dbm si se está seguro de que
funciona y se necesita este formato.
</para>
</note>
</para>
</entry>
</row>
@@ -55,15 +59,15 @@
<entry><literal>ndbm</literal></entry>
<entry>
<para>
Para habilitar el soporte para ndbm añada
<option role="configure">--with-ndbm[=DIR]</option>.
<note>
<para>
ndbm es normalmente una envoltura que a menudo resulta en fallo.
Esto significa que debería usar ndbm sólo si está seguro de que funciona
y que realmente necesita este formato.
</para>
</note>
Para activar el soporte de ndbm, añada la opción
de compilación <option role="configure">--with-ndbm[=DIR]</option>.
<note>
<para>
ndbm es una sobrecarga que suele dar lugar a fallos.
Por tanto, solo debe utilizarse ndbm si se está seguro de que
funciona y se necesita este formato.
</para>
</note>
</para>
</entry>
</row>
@@ -71,8 +75,8 @@
<row>
<entry><literal>gdbm</literal></entry>
<entry>
Para habilitar el soporte para gdbm añada
<option role="configure">--with-gdbm[=DIR]</option>.
Para activar el soporte de gdbm, añada la opción
de compilación <option role="configure">--with-gdbm[=DIR]</option>.
</entry>
</row>
@@ -80,13 +84,13 @@
<entry><literal>db2</literal></entry>
<entry>
<para>
Para habilitar el soporte para Oracle Berkeley DB 2 añada
<option role="configure">--with-db2[=DIR]</option>.
<note>
<para>
db2 entra en conflicto con db3 y db4.
</para>
</note>
Para activar el soporte de Oracle Berkeley DB 2, añada la opción
de compilación <option role="configure">--with-db2[=DIR]</option>.
<note>
<para>
db2 entra en conflicto con db3 y db4.
</para>
</note>
</para>
</entry>
</row>
@@ -95,13 +99,13 @@
<entry><literal>db3</literal></entry>
<entry>
<para>
Para habilitar el soporte para Oracle Berkeley DB 3 añada
<option role="configure">--with-db3[=DIR]</option>.
<note>
<para>
db3 entra en conflicto con db2 y db4.
</para>
</note>
Para activar el soporte de Oracle Berkeley DB 3, añada la opción
de compilación <option role="configure">--with-db3[=DIR]</option>.
<note>
<para>
db3 entra en conflicto con db2 y db4.
</para>
</note>
</para>
</entry>
</row>
@@ -110,26 +114,22 @@
<entry><literal>db4</literal></entry>
<entry>
<para>
Para habilitar el soporte para Oracle Berkeley DB 4 o 5 añada
<option role="configure">--with-db4[=DIR]</option>.
<note>
<para>
db4 entra en conflicto con db3 y db3.
</para>
</note>
<note>
<para>
La opción db4 se añadió en PHP 4.3.2. En versiones anteriores de PHP se necesita usar
<option role="configure">--with-db3=DIR</option>, siendo DIR la
ruta a la biblioteca db4. No es posible usar versiones de db de
4.1 en adelante con PHP anterior a la versión 4.3.0. También, las bibliotecas db con
versiones 4.1 hasta 4.1.24 no se pueden usar en ninguna versión de PHP.
</para>
<para>
Se añadión el soporte para BDB 5 en PHP 5.3.3.
</para>
</note>
</para>
Para activar el soporte de Oracle Berkeley DB 4, añada la opción
de compilación <option role="configure">--with-db4[=DIR]</option>.
<note>
<para>
db4 entra en conflicto con db2 y db3.
</para>
</note>
<note>
<para>
Las bibliotecas db con versiones comprendidas entre 4.1 y 4.1.24 no pueden utilizarse con ninguna versión de PHP.
</para>
<para>
El soporte DB5 se añadió en PHP 5.3.3.
</para>
</note>
</para>
</entry>
</row>
@@ -137,15 +137,14 @@
<entry><literal>cdb</literal></entry>
<entry>
<para>
Para habilitar el soporte para cdb añada
<option role="configure">--with-cdb[=DIR]</option>.
<note>
<para>
Desde PHP 4.3.0 se puede omitir DIR para usar la biblioteca cdb incluida
que añade el gestor cdb_make, el cual permite la creación de ficheros cdb
y el acceso a ficheros cdb en la red usando flujos de PHP.
</para>
</note>
Para activar el soporte de cdb, añada la opción
de compilación <option role="configure">--with-cdb[=DIR]</option>.
<note>
<para>
Puede omitirse el uso de DIR, para aprovechar la biblioteca cdb proporcionada con PHP, que añade un gestor cdb_make, permite la creación de fichero
cdb y permite el acceso a los ficheros cbd a través de la red con los flujos de PHP.
</para>
</note>
</para>
</entry>
</row>
@@ -154,16 +153,18 @@
<entry><literal>flatfile</literal></entry>
<entry>
<para>
Para habilitar el soporte para flatfile añada
<option role="configure">--with-flatfile</option>.
<note>
<para>
Esto se añadio en PHP 4.3.0 para añadir compatibilidad con la extensión
<literal>dbm</literal> obsoleta. Use este gestor solamente
cuando no pueda instalar una de las bibliotecas requeridas por otros
gestores y cuando no pueda usar el gestor cdb interno.
</para>
</note>
Para activar el soporte de ficheros, añada la opción
de compilación
<option role="configure">--enable-flatfile</option>.
Anteriormente a PHP 5.2.1 debía utilizarse la opción
<option role="configure">--with-flatfile</option> en su lugar.
<note>
<para>
Esto se añadió para asegurar la compatibilidad con la extensión
<literal>dbm</literal> que está obsoleta.
Úsese este gestor solo cuando no pueda instalarse ningún otro gestor y no pueda utilizarse el gestor cdb integrado.
</para>
</note>
</para>
</entry>
</row>
@@ -172,14 +173,17 @@
<entry><literal>inifile</literal></entry>
<entry>
<para>
Para habilitar el soporte para <literal>inifile</literal> añada
<option role="configure">--with-inifile</option>.
<note>
<para>
Esto se añadió en PHP 5.0.0 y permite leer y establecer ficheros
<filename>.ini</filename> estilo microsoft (como el fichero &php.ini;).
</para>
</note>
Para activar el soporte de <literal>inifile</literal>, añada la opción
de compilación <option role="configure">--enable-inifile</option>.
Anteriormente a PHP 5.2.1 debía utilizarse la opción
<option role="configure">--with-inifile</option> en su lugar.
<note>
<para>
Esta opción se añadió para permitir leer y escribir en
ficheros de inicialización de tipo Microsoft
(<filename>.ini</filename>), como el &php.ini; por ejemplo.
</para>
</note>
</para>
</entry>
</row>
@@ -188,17 +192,51 @@
<entry><literal>qdbm</literal></entry>
<entry>
<para>
Para habilitar el soporte para qdbm añada
<option role="configure">--with-qdbm[=DIR]</option>.
Para activar el soporte de qdbm, añada la opción de compilación
<option role="configure">--with-qdbm[=DIR]</option>.
<note>
<para>
qdbm entra en conflicto con dbm y gdbm.
</para>
</note>
<note>
<para>
La biblioteca qdbm puede descargarse desde
<link xlink:href="&url.qdbm;"/>.
</para>
</note>
</para>
</entry>
</row>
<row>
<entry><literal>tcadb</literal></entry>
<entry>
<para>
Para activar el soporte de Tokyo Cabinet, añada la opción de compilación
<option role="configure">--with-tcadb[=DIR]</option>.
<note>
<para>
qdbm entra en conflicto con dbm y gdbm.
La biblioteca Tokyo Cabinet puede ser
descargada desde <link xlink:href="&url.tcadb;"/>.
</para>
</note>
</para>
</entry>
</row>
<row>
<entry><literal>lmdb</literal></entry>
<entry>
<para>
Para activar el soporte de Lightning Memory-Mapped Database añada
la opción de configuración
<option role="configure">--with-lmdb[=DIR]</option>.
<note>
<para>
Esto se añadió en PHP 5.0.0. La biblioteca qdbm puede ser cargada desde
<link xlink:href="&url.qdbm;"/>.
Esto se añadió en PHP 7.2.0. La biblioteca
Lightning Memory-Mapped Database puede descargarse desde
<link xlink:href="&url.lmdb;"/>.
</para>
</note>
</para>
@@ -208,14 +246,6 @@
</tbody>
</tgroup>
</table>
<note>
<para>
Hasta PHP 4.3.0 se puede añadir el gestor db2 y db3 pero sólo uno
de ellos se puede usar internamente. Esto significa que no se pueden tener ambos formatos
de fichero. Desde PHP 5.0.0 existe una comprobación de configuración que evita
tales configuraciones erróneas.
</para>
</note>
</para>
</section>

33
reference/dba/constants.xml
View File

@@ -1,12 +1,38 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: seros Status: ready -->
<!-- EN-Revision: bf457cd76a2f4745333e96ee4066308455ad2e12 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<appendix xml:id="dba.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.constants;
&no.constants;
&extension.constants;
<variablelist>
<varlistentry xml:id="constant.dba-lmdb-use-sub-dir">
<term>
<constant>DBA_LMDB_USE_SUB_DIR</constant>
(<type>int</type>)
</term>
<listitem>
<para>
Flag del controlador LMDB para permitir la creación de un subdirectorio para los ficheros de base de datos.
Disponible a partir de PHP 8.2.0.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.dba-lmdb-no-sub-dir">
<term>
<constant>DBA_LMDB_NO_SUB_DIR</constant>
(<type>int</type>)
</term>
<listitem>
<para>
Flag del controlador LMDB para prohibir la creación de un subdirectorio para los ficheros de base de datos.
Disponible a partir de PHP 8.2.0.
</para>
</listitem>
</varlistentry>
</variablelist>
</appendix>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -27,4 +53,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

50
reference/dba/examples.xml
View File

@@ -1,14 +1,15 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: seros Status: ready -->
<!-- EN-Revision: ea63eee345d123174f7d87e19df92880e0fdb02f Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes Maintainer: PhilDaiguille -->
<chapter xml:id="dba.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.examples;
<section xml:id="dba.example">
<title>Uso básico</title>
<title>Utilización</title>
<para>
<example>
<title>Ejemplo de DBA</title>
<title>Ejemplo con DBA</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -16,11 +17,11 @@
$id = dba_open("/tmp/test.db", "n", "db2");
if (!$id) {
echo "Falló dba_open\n";
echo "dba_open ha fallado\n";
exit;
}
dba_replace("key", "¡Este es un ejemplo!", $id);
dba_replace("key", "¡Esto es un ejemplo!", $id);
if (dba_exists("key", $id)) {
echo dba_fetch("key", $id);
@@ -34,37 +35,39 @@ dba_close($id);
</example>
</para>
<para>
DBA es seguro a nivel binario y no tiene límites arbitrarios.
Sin embargo, hereda todos los límites establecidos por la implementación
de la base de datos subyacente.
DBA gestiona datos binarios y no tiene límites arbitrarios.
Sin embargo, hereda todas las limitaciones definidas por
la implementación de la base de datos accedida.
</para>
<para>
Todas las bases de datos basadas en ficheros deben proporcionar una manera de establecer el modo
de fichero de una nueva base de datos creada, si es posible. El
modo de fichero se pasa comúnmente como el cuarto argumento a
<function>dba_open</function> o <function>dba_popen</function>.
Todas las bases de datos basadas en ficheros deben
proporcionar una forma de definir el modo de fichero de las nuevas
bases creadas. Este modo se pasa generalmente como cuarto argumento
de las funciones <function>dba_open</function> o
<function>dba_popen</function>.
</para>
<para>
Se puede acceder a todas las entradas de una base de datos de forma lineal usando las
funciones <function>dba_firstkey</function> y <function>dba_nextkey</function>.
No se puede cambiar la base de datos mientras se la atraviesa.
</para>
Se puede acceder a todas las entradas de la base de datos de
forma lineal, utilizando las funciones <function>dba_firstkey</function>
y <function>dba_nextkey</function>. No se puede modificar la
base de datos mientras se está leyendo.
</para>
<para>
<example>
<title>Atravesar una base de datos</title>
<title>Lectura de una base de datos</title>
<programlisting role="php">
<![CDATA[
<?php
// ...abrir la base de datos...
// ...apertura de la base de datos...
$clave = dba_firstkey($id);
$key = dba_firstkey($id);
while ($clave != false) {
if (true) { // recuerde la clave para realizar alguna acción posterior
$handle_later[] = $clave;
while ($key !== false) {
if (true) { // se retiene la clave para realizar otras acciones más tarde
$handle_later[] = $key;
}
$clave = dba_nextkey($id);
$key = dba_nextkey($id);
}
foreach ($handle_later as $val) {
@@ -99,4 +102,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

39
reference/dba/functions/dba-close.xml
View File

@@ -1,21 +1,23 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: lboshell Status: ready -->
<!-- EN-Revision: cc62b5ecf4831ef6cf888c925c2ad167410da811 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes Maintainer: PhilDaiguille -->
<refentry xml:id="function.dba-close" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>dba_close</refname>
<refpurpose>Cerrar una base de datos DBA</refpurpose>
<refpurpose>Cierra una base DBA</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>void</type><methodname>dba_close</methodname>
<methodparam><type>resource</type><parameter>handle</parameter></methodparam>
<methodparam><type>Dba\Connection</type><parameter>dba</parameter></methodparam>
</methodsynopsis>
<para>
<function>dba_close</function> cierra la base de datos establecida
y libera todos los recursos del gestor de base de datos
especificado.
<function>dba_close</function> cierra la conexión establecida con
la base de datos y libera todos los recursos del
<parameter>handle</parameter>.
</para>
</refsect1>
<refsect1 role="parameters">
@@ -23,23 +25,41 @@
<para>
<variablelist>
<varlistentry>
<term><parameter>handle</parameter></term>
<term><parameter>dba</parameter></term>
<listitem>
<para>
El gestor de base de datos, devuelto por <function>dba_open</function> o
<function>dba_popen</function>.
&dba.parameter.dba;
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.void;
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&dba.changelog.dba-object;
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -50,7 +70,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

43
reference/dba/functions/dba-delete.xml
View File

@@ -1,22 +1,28 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: lboshell Status: ready -->
<!-- EN-Revision: cc62b5ecf4831ef6cf888c925c2ad167410da811 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes Maintainer: PhilDaiguille -->
<refentry xml:id="function.dba-delete" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>dba_delete</refname>
<refpurpose>Elimina una entrada DBA especificada por clave</refpurpose>
<refpurpose>Elimina una línea en una base DBA</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>dba_delete</methodname>
<methodparam><type>string</type><parameter>key</parameter></methodparam>
<methodparam><type>resource</type><parameter>handle</parameter></methodparam>
<methodparam><type class="union"><type>string</type><type>array</type></type><parameter>key</parameter></methodparam>
<methodparam><type>Dba\Connection</type><parameter>dba</parameter></methodparam>
</methodsynopsis>
<para>
<function>dba_delete</function> elimina la entrada especificada de la base de datos.
<function>dba_delete</function> elimina la entrada
especificada por la clave <parameter>key</parameter>,
en la base identificada por <parameter>handle</parameter>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
@@ -25,28 +31,46 @@
<term><parameter>key</parameter></term>
<listitem>
<para>
La clave de la entrada que está siendo eliminada.
La clave de la entrada a eliminar.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>gestor</parameter></term>
<term><parameter>dba</parameter></term>
<listitem>
<para>
El gestor de base de datos, devuelto por <function>dba_open</function> o
<function>dba_popen</function>.
&dba.parameter.dba;
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&dba.changelog.dba-object;
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -59,7 +83,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

45
reference/dba/functions/dba-exists.xml
View File

@@ -1,23 +1,27 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: lboshell Status: ready -->
<!-- EN-Revision: cc62b5ecf4831ef6cf888c925c2ad167410da811 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes Maintainer: PhilDaiguille -->
<refentry xml:id="function.dba-exists" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>dba_exists</refname>
<refpurpose>Verificar si la clave existe</refpurpose>
<refpurpose>Verifica si una clave DBA existe</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>dba_exists</methodname>
<methodparam><type>string</type><parameter>key</parameter></methodparam>
<methodparam><type>resource</type><parameter>handle</parameter></methodparam>
<methodparam><type class="union"><type>string</type><type>array</type></type><parameter>key</parameter></methodparam>
<methodparam><type>Dba\Connection</type><parameter>dba</parameter></methodparam>
</methodsynopsis>
<para>
<function>dba_exists</function> verifica si la
<parameter>key</parameter> especificada existe en la base de datos.
<function>dba_exists</function> verifica si la clave
<parameter>key</parameter> existe en la base identificada
por <parameter>handle</parameter>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
@@ -26,28 +30,46 @@
<term><parameter>key</parameter></term>
<listitem>
<para>
La clave usada para el chequeo.
La clave a verificar.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>gestor</parameter></term>
<term><parameter>dba</parameter></term>
<listitem>
<para>
El gestor de base de datos, devuelto por <function>dba_open</function> o
<function>dba_popen</function>.
&dba.parameter.dba;
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve &true; si la clave existe, &false; de lo contrario.
Retorna &true; si la clave existe, &false; en caso contrario.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&dba.changelog.dba-object;
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -60,7 +82,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

124
reference/dba/functions/dba-fetch.xml
View File

@@ -1,30 +1,38 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: dd95f273f8588d1096e489819b1a73246bb9d8e3 Maintainer: yago Status: ready -->
<!-- EN-Revision: 44428b04b7b046593e9ab33874eddd1fea7dfab1 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes Maintainer: PhilDaiguille -->
<refentry xml:id="function.dba-fetch" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>dba_fetch</refname>
<refpurpose>Recuperar datos especificados por clave</refpurpose>
<refpurpose>Lee los datos asociados a una clave DBA</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>dba_fetch</methodname>
<methodparam><type>string</type><parameter>key</parameter></methodparam>
<methodparam><type>resource</type><parameter>handle</parameter></methodparam>
<type class="union"><type>string</type><type>false</type></type><methodname>dba_fetch</methodname>
<methodparam><type class="union"><type>string</type><type>array</type></type><parameter>key</parameter></methodparam>
<methodparam><type>Dba\Connection</type><parameter>dba</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>skip</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<simpara>
Firma sobrecargada obsoleta a partir de 8.3.0:
</simpara>
<methodsynopsis>
<type>string</type><methodname>dba_fetch</methodname>
<methodparam><type class="union"><type>string</type><type>array</type></type><parameter>key</parameter></methodparam>
<methodparam><type>int</type><parameter>skip</parameter></methodparam>
<methodparam><type>resource</type><parameter>dba</parameter></methodparam>
</methodsynopsis>
<methodsynopsis>
<type>string</type><methodname>dba_fetch</methodname>
<methodparam><type>string</type><parameter>key</parameter></methodparam>
<methodparam><type>int</type><parameter>skip</parameter></methodparam>
<methodparam><type>resource</type><parameter>handle</parameter></methodparam>
</methodsynopsis>
<para>
<function>dba_fetch</function> recupera los datos especificados por
<parameter>key</parameter> desde la base de datos indicada con
<parameter>handle</parameter>.
<function>dba_fetch</function> lee los datos especificados
por la clave <parameter>key</parameter> en la base identificada
por <parameter>dba</parameter>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
@@ -33,71 +41,78 @@
<term><parameter>key</parameter></term>
<listitem>
<para>
La clave que apunta a los datos.
La clave correspondiente a los datos.
</para>
<note>
<para>
Cuando se trabaja con archivos ini, esta función acepta
arrays como claves, en donde el índice 0 es el grupo y el índice 1 es el nombre del valor. Vea:
<function>dba_key_split</function>.
Al trabajar con ficheros .ini, esta función acepta
arrays como claves donde el índice 0 es el grupo y el índice 1 es el nombre
del valor. Ver la función <function>dba_key_split</function>.
</para>
</note>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>dba</parameter></term>
<listitem>
<para>
&dba.parameter.dba;
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>skip</parameter></term>
<listitem>
<para>
El número de parejas clave-valor a ignorar cuando se usan bases de datos cdb.
Este valor es ignorado por todas las otras bases de datos que no soportan múltiples claves
con el mismo nombre.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>gestor</parameter></term>
<listitem>
<para>
El gestor de base de datos, devuelto por <function>dba_open</function> o
<function>dba_popen</function>.
El número de pares clave-valor a ignorar al utilizar bases de datos cdb.
Este valor es ignorado para todas las demás bases de datos que no admiten
claves múltiples con el mismo nombre.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve la cadena asociada si la pareja clave/datos es encontrada,
&false; de lo contrario.
Devuelve la cadena asociada si se encuentra el par clave/valor, &false; en caso contrario.
</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>4.3.0</entry>
<entry>
El parámetro <parameter>skip</parameter> se encuentra
disponible para ofrecer soporte a la capacidad de gdb de
claves múltiples con el mismo nombre.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&dba.changelog.dba-object;
<row>
<entry>8.3.0</entry>
<entry>
La llamada a <function>dba_fetch</function> con <parameter>dba</parameter> como
tercer argumento es ahora obsoleta.
</entry>
</row>
<row>
<entry>8.2.0</entry>
<entry>
El argumento opcional "skip" de la función <function>dba_fetch</function> ahora se coloca al final,
conforme a la semántica PHP lado-usuario. La firma sobrecargada previamente
sigue siendo aceptada pero desaconsejada.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -111,7 +126,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

50
reference/dba/functions/dba-firstkey.xml
View File

@@ -1,58 +1,78 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: yago Status: ready -->
<!-- EN-Revision: cc62b5ecf4831ef6cf888c925c2ad167410da811 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes Maintainer: PhilDaiguille -->
<refentry xml:id="function.dba-firstkey" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>dba_firstkey</refname>
<refpurpose>Recuperar la primera clave</refpurpose>
<refpurpose>Lee la primera clave DBA</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>dba_firstkey</methodname>
<methodparam><type>resource</type><parameter>handle</parameter></methodparam>
<type class="union"><type>string</type><type>false</type></type><methodname>dba_firstkey</methodname>
<methodparam><type>Dba\Connection</type><parameter>dba</parameter></methodparam>
</methodsynopsis>
<para>
<function>dba_firstkey</function> devuelve la primera clave de la
base de datos y reestablece el apuntador de clave interno. Esto
permite una búsqueda lineal a través de la base de
datos completa.
<function>dba_firstkey</function> devuelve la primera clave
de la base de datos especificada por <parameter>handle</parameter>
y coloca el puntero interno de clave. Esto permitirá recorrer la base.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>handle</parameter></term>
<term><parameter>dba</parameter></term>
<listitem>
<para>
El gestor de base de datos, devuelto por
<function>dba_open</function> o <function>dba_popen</function>.
&dba.parameter.dba;
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve la clave en caso de tener éxito&return.falseforfailure;.
Devuelve la clave en caso de éxito&return.falseforfailure;.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&dba.changelog.dba-object;
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>dba_nextkey</function></member>
<member><function>dba_key_split</function></member>
<member>Ejemplo 2 en los <link linkend="dba.examples">ejemplos de DBA</link></member>
<member>Ejemplo 2 en los <link linkend="dba.examples">ejemplos DBA</link></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -72,4 +92,4 @@ End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
-->

54
reference/dba/functions/dba-insert.xml
View File

@@ -1,25 +1,30 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: yago Status: ready -->
<!-- EN-Revision: cc62b5ecf4831ef6cf888c925c2ad167410da811 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes Maintainer: PhilDaiguille -->
<refentry xml:id="function.dba-insert" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>dba_insert</refname>
<refpurpose>Insertar entrada</refpurpose>
<refpurpose>Inserta una entrada DBA</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>dba_insert</methodname>
<methodparam><type>string</type><parameter>key</parameter></methodparam>
<methodparam><type class="union"><type>string</type><type>array</type></type><parameter>key</parameter></methodparam>
<methodparam><type>string</type><parameter>value</parameter></methodparam>
<methodparam><type>resource</type><parameter>handle</parameter></methodparam>
<methodparam><type>Dba\Connection</type><parameter>dba</parameter></methodparam>
</methodsynopsis>
<para>
<function>dba_insert</function> inserta la entrada descrita con
<parameter>clave</parameter> y <parameter>valor</parameter> en la
base de datos.
<function>dba_insert</function> inserta la entrada descrita
por la clave <parameter>key</parameter> y el valor
<parameter>value</parameter> en la base especificada
por <parameter>handle</parameter>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
@@ -28,9 +33,9 @@
<term><parameter>key</parameter></term>
<listitem>
<para>
La clave de la entrada a ser insertada. Si esta clave ya existe
en la base de datos, esta función fallará. Use <function>dba_replace</function>
si necesita reemplazar una clave existente.
La clave de la entrada a insertar. Si esta clave ya existe en la base de datos,
esta función fallará. Utilice la función <function>dba_replace</function>
si se debe reemplazar una clave existente.
</para>
</listitem>
</varlistentry>
@@ -38,28 +43,46 @@
<term><parameter>value</parameter></term>
<listitem>
<para>
El valor a ser insertado.
El valor a insertar.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>handle</parameter></term>
<term><parameter>dba</parameter></term>
<listitem>
<para>
El gestor de base de datos, devuelto por <function>dba_open</function> o
<function>dba_popen</function>.
&dba.parameter.dba;
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&dba.changelog.dba-object;
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -72,7 +95,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -92,4 +114,4 @@ End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
-->

53
reference/dba/functions/dba-key-split.xml
View File

@@ -1,24 +1,29 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: yago Status: ready -->
<!-- EN-Revision: d34561113baaf49e9d0539c46511242941ea5a7b Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes Maintainer: PhilDaiguille -->
<refentry xml:id="function.dba-key-split" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>dba_key_split</refname>
<refpurpose>
Separa una clave en representación de cadena en representación de array
Transforma una representación de clave DBA por cadena en una
representación por array
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>mixed</type><methodname>dba_key_split</methodname>
<methodparam><type>mixed</type><parameter>key</parameter></methodparam>
<type class="union"><type>array</type><type>false</type></type><methodname>dba_key_split</methodname>
<methodparam><type class="union"><type>string</type><type>false</type><type>null</type></type><parameter>key</parameter></methodparam>
</methodsynopsis>
<para>
<function>dba_key_split</function> separa una clave (representación tipo cadena)
en una representación tipo array.
<function>dba_key_split</function> transforma una representación de
clave DBA por cadena en una representación por array.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
@@ -27,24 +32,49 @@
<term><parameter>key</parameter></term>
<listitem>
<para>
La clave en representación de cadena.
La clave en forma de string.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve un array de la forma <literal>array(0 =&gt; grupo, 1
=&gt; nombre_valor)</literal>. Esta función devolverá
&false; si <parameter>clave</parameter> es &null; o &false;.
Devuelve un array en la forma <literal>array(0 =&gt; group, 1 =&gt;
nom_valeur)</literal>. Esta función devuelve &false; si
<parameter>key</parameter> es &null; o &false;.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
Pasar &null; o &false; a <parameter>key</parameter>
está ahora deprecado.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<para>
<simplelist>
<member><function>dba_firstkey</function></member>
<member><function>dba_nextkey</function></member>
@@ -53,7 +83,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

19
reference/dba/functions/dba-list.xml
View File

@@ -1,10 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: yago Status: ready -->
<!-- EN-Revision: cbac1ecf71d754707d69bdc344c4031c157eaa54 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes Maintainer: PhilDaiguille -->
<refentry xml:id="function.dba-list" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>dba_list</refname>
<refpurpose>Listar todos los archivos de base de datos abiertos</refpurpose>
<refpurpose>Lista todos los ficheros de bases de datos DBA abiertos</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
@@ -13,17 +13,24 @@
<void/>
</methodsynopsis>
<para>
<function>dba_list</function> lista todos los archivos de bases de datos abiertos.
<function>dba_list</function> lista todos los ficheros de bases de datos
DBA abiertos.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Un array asociativo, en la forma <literal>id_recurso =&gt; nombre_archivo</literal>.
Un array asociativo, bajo la forma
<literal>idressource =&gt; nomfichier</literal>.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

43
reference/dba/functions/dba-nextkey.xml
View File

@@ -1,20 +1,23 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: yago Status: ready -->
<!-- EN-Revision: cc62b5ecf4831ef6cf888c925c2ad167410da811 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes Maintainer: PhilDaiguille -->
<refentry xml:id="function.dba-nextkey" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>dba_nextkey</refname>
<refpurpose>Recuperar la siguiente clave</refpurpose>
<refpurpose>Lee la clave DBA siguiente</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>dba_nextkey</methodname>
<methodparam><type>resource</type><parameter>handle</parameter></methodparam>
<type class="union"><type>string</type><type>false</type></type><methodname>dba_nextkey</methodname>
<methodparam><type>Dba\Connection</type><parameter>dba</parameter></methodparam>
</methodsynopsis>
<para>
<function>dba_nextkey</function> devuelve la siguiente clave de la
base de datos y avanza el apuntador de clave interno.
<function>dba_nextkey</function> devuelve la clave siguiente,
en la base identificada por <parameter>handle</parameter> y
incrementa el puntero de clave.
</para>
</refsect1>
<refsect1 role="parameters">
@@ -22,11 +25,10 @@
<para>
<variablelist>
<varlistentry>
<term><parameter>handle</parameter></term>
<term><parameter>dba</parameter></term>
<listitem>
<para>
El gestor de base de datos, devuelto por <function>dba_open</function>
o <function>dba_popen</function>.
&dba.parameter.dba;
</para>
</listitem>
</varlistentry>
@@ -36,21 +38,38 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve la clave si tiene éxito&return.falseforfailure;.
Devuelve la clave en caso de éxito&return.falseforfailure;.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&dba.changelog.dba-object;
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>dba_firstkey</function></member>
<member><function>dba_key_split</function></member>
<member>Ejemplo 2 en los <link linkend="dba.examples">ejemplos de DBA</link></member>
<member>Ejemplo 2 en los <link linkend="dba.examples">ejemplos DBA</link></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

266
reference/dba/functions/dba-open.xml
View File

@@ -1,24 +1,28 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 8b5940cadeb4f1c8492f4a7f70743a2be807cf39 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<!-- EN-Revision: 44428b04b7b046593e9ab33874eddd1fea7dfab1 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no Maintainer: PhilDaiguille -->
<refentry xml:id="function.dba-open" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>dba_open</refname>
<refpurpose>Abrir una base de datos</refpurpose>
<refpurpose>Abre una base de datos DBA</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>resource</type><methodname>dba_open</methodname>
<type class="union"><type>Dba\Connection</type><type>false</type></type><methodname>dba_open</methodname>
<methodparam><type>string</type><parameter>path</parameter></methodparam>
<methodparam><type>string</type><parameter>mode</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>handler</parameter></methodparam>
<methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam>
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>handler</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>permission</parameter><initializer>0644</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>map_size</parameter><initializer>0</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>flags</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<function>dba_open</function> establece una instancia de una base de datos para
<parameter>path</parameter> con <parameter>mode</parameter> usando
<function>dba_open</function> establece una conexión a
la base identificada por <parameter>path</parameter> con el
modo <parameter>mode</parameter> y el identificador
<parameter>handler</parameter>.
</para>
</refsect1>
@@ -30,7 +34,7 @@
<term><parameter>path</parameter></term>
<listitem>
<para>
Comúnmente una ruta normal de su sistema de ficheros.
Ruta en el sistema de archivos.
</para>
</listitem>
</varlistentry>
@@ -38,36 +42,34 @@
<term><parameter>mode</parameter></term>
<listitem>
<para>
Es <literal>r</literal> para acceso de lectura, <literal>w</literal> para
acceso de lectura/escritura de una base de datos existente, <literal>c</literal>
para acceso de lectura/escritura y creación de una base de datos si no existe actualmente,
y <literal>n</literal> para crear, truncar y acceso de lectura/escritura.
La base de datos se crea en el modo BTree, los demás modos (como Hash o Queue)
no están soportados.
Puede ser <literal>r</literal> para solo lectura, <literal>w</literal> para
lectura/escritura, <literal>c</literal> para lectura/escritura y creación si la base no existe,
y <literal>n</literal> para creación, sobrescritura y acceso en lectura/escritura.
La base de datos se crea en modo BTree; los otros modos (como Hash o Queue) no son soportados.
</para>
<para>
Además se puede establecer el método de bloqueo de la base de datos con el siguiente carácter.
Use <literal>l</literal> para bloquear la base de datos con un fichero <filename>.lck</filename>
o <literal>d</literal> para bloquear el fichero de la base de datos mismo. Es
importante que todas sus aplicaciones hagan esto de manera consistente.
Además, se puede elegir el método de bloqueo de la base con el
carácter siguiente. Utilice <literal>l</literal> para bloquear la base con un
fichero <filename>.lck</filename>, o <literal>d</literal> para bloquear
la base misma. Es importante que las aplicaciones utilicen estas
opciones de manera coherente.
</para>
<para>
Si quiere probar el acceso y no quiere esperar para el bloqueo
puede añadir <literal>t</literal> como tercer carácter. Cuando está absolutamente
seguro de que no se requiere el bloqueo de la base de datos, puede usar
<literal>-</literal> en lugar de <literal>l</literal> o
<literal>d</literal>. Cuando no se usar <literal>d</literal>,
<literal>l</literal> o <literal>-</literal>, dba bloqueará
el archivo de la base de datos como si lo estuviera con <literal>d</literal>.
Si se desea probar la posibilidad de acceso sin esperar la disponibilidad del bloqueo,
se puede añadir la letra <literal>t</literal> como tercer carácter. Cuando se está absolutamente seguro
de que la base no requiere bloqueo, se puede utilizar el guión <literal>-</literal>
en lugar de <literal>l</literal> o <literal>d</literal>.
Cuando no se utiliza ni <literal>d</literal>, ni <literal>l</literal> ni
<literal>-</literal>, dba bloqueará en modo <literal>d</literal>.
</para>
<note>
<para>
Sólo puede haber un escritor para el archivo de la base de datos. Cuando se usa dba
en un servidor web y más de una solicitud requiere operaciones de escritura, sólo pueden
hacerlo una tras otra. Tampoco está permitido la lectura durante la escritura.
La extensión dba usa bloqueos para impedirlo. Véase la siguiente tabla:
Solo puede haber un tipo de escritura en la base. Cuando se utiliza dba en un servidor web,
y varias peticiones HTTP realizan escrituras, estas solo pueden realizarse una tras otra. De igual
manera, la lectura durante la escritura no es posible. La extensión dba utiliza un bloqueo para evitar
estos problemas. A continuación se muestra la tabla de bloqueo:
<table>
<title>Bloqueo de DBA</title>
<title>Bloqueo DBA</title>
<tgroup cols="9">
<thead>
<row>
@@ -84,7 +86,7 @@
</thead>
<tbody>
<row>
<entry>sin abrir</entry>
<entry>no abierta</entry>
<entry>ok</entry>
<entry>ok</entry>
<entry>ok</entry>
@@ -98,54 +100,57 @@
<entry><parameter>mode</parameter> = "rl"</entry>
<entry>ok</entry>
<entry>ok</entry>
<entry>wait</entry>
<entry>false</entry>
<entry>illegal</entry>
<entry>illegal</entry>
<entry>illegal</entry>
<entry>illegal</entry>
<entry>esperando</entry>
<entry>&false;</entry>
<entry>ilegal</entry>
<entry>ilegal</entry>
<entry>ilegal</entry>
<entry>ilegal</entry>
</row>
<row>
<entry><parameter>mode</parameter> = "wl"</entry>
<entry>wait</entry>
<entry>false</entry>
<entry>wait</entry>
<entry>false</entry>
<entry>illegal</entry>
<entry>illegal</entry>
<entry>illegal</entry>
<entry>illegal</entry>
<entry>esperando</entry>
<entry>&false;</entry>
<entry>esperando</entry>
<entry>&false;</entry>
<entry>ilegal</entry>
<entry>ilegal</entry>
<entry>ilegal</entry>
<entry>ilegal</entry>
</row>
<row>
<entry><parameter>mode</parameter> = "rd"</entry>
<entry>illegal</entry>
<entry>illegal</entry>
<entry>illegal</entry>
<entry>illegal</entry>
<entry>ilegal</entry>
<entry>ilegal</entry>
<entry>ilegal</entry>
<entry>ilegal</entry>
<entry>ok</entry>
<entry>ok</entry>
<entry>wait</entry>
<entry>false</entry>
<entry>esperando</entry>
<entry>&false;</entry>
</row>
<row>
<entry><parameter>mode</parameter> = "wd"</entry>
<entry>illegal</entry>
<entry>illegal</entry>
<entry>illegal</entry>
<entry>illegal</entry>
<entry>wait</entry>
<entry>false</entry>
<entry>wait</entry>
<entry>false</entry>
<entry>ilegal</entry>
<entry>ilegal</entry>
<entry>ilegal</entry>
<entry>ilegal</entry>
<entry>esperando</entry>
<entry>&false;</entry>
<entry>esperando</entry>
<entry>&false;</entry>
</row>
</tbody>
</tgroup>
</table>
<simplelist>
<member>ok: la segunda llamada tendrá éxito.</member>
<member>wait: la sedunda llamada esperará hasta que se llame a <function>dba_close</function> la primera vez.</member>
<member>false: la segunda llamada devuelve false.</member>
<member>illegal: no se pueden mezclar los modificadores <literal>"l"</literal> y <literal>"d"</literal> con el parámetro <parameter>mode</parameter>.</member>
<member>ok: La segunda llamada tiene éxito.</member>
<member>esperando: La segunda llamada espera a que <function>dba_close</function>
sea llamada por el primer script.</member>
<member>false: La segunda llamada devuelve &false;.</member>
<member>ilegal: No se deben mezclar las opciones
<literal>"l"</literal> y <literal>"d"</literal> para el parámetro
<parameter>mode</parameter>.</member>
</simplelist>
</para>
</note>
@@ -155,49 +160,123 @@
<term><parameter>handler</parameter></term>
<listitem>
<para>
El nombre del <link linkend="dba.requirements">gestor</link> que
será usado para acceder a <parameter>path</parameter>. Se le pasan
todos los parámetros opcionales dados a <function>dba_open</function> y
puede actuar en su nombre.
El nombre del <link linkend="dba.requirements">gestor</link>
que debe ser utilizado para acceder a <parameter>path</parameter>.
Se pasa a todos los parámetros opcionales dados a
<function>dba_open</function> y puede actuar en su nombre.
Si el parámetro <parameter>handler</parameter> es &null;,
entonces se invoca el gestor por defecto.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>permission</parameter></term>
<listitem>
<para>
Parámetro opcional de tipo &integer; que se pasa al controlador. Tiene el mismo significado que
el parámetro <parameter>permissions</parameter> de la función <function>chmod</function>,
y tiene un valor por omisión de <literal>0644</literal>.
</para>
<para>
Los controladores <literal>db1</literal>, <literal>db2</literal>,
<literal>db3</literal>, <literal>db4</literal>, <literal>dbm</literal>,
<literal>gdbm</literal>,
Los controladores <literal>ndbm</literal> y <literal>lmdb</literal> soportan el
parámetro <parameter>permission</parameter>.
</para>
<para>
El controlador <literal>lmdb</literal> soporta dos parámetros adicionales.
El primero permite definir el <literal>$filemode</literal>
(ver descripción anterior), y el segundo permite definir la
<literal>$mapsize</literal>, cuyo valor debería ser un múltiplo del tamaño de página del sistema operativo,
o cero para utilizar la mapsize por defecto.
El parámetro <literal>$mapsize</literal> es soportado a partir de
PHP 7.3.14 y 7.4.2, respectivamente.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>map_size</parameter></term>
<listitem>
<para>
Parámetro opcional de tipo &integer; que se pasa al controlador. Su valor debe ser un múltiplo del
tamaño de página del sistema operativo, o cero para utilizar el tamaño de mappage por defecto.
</para>
<para>
Solo el controlador <literal>lmdb</literal> acepta el parámetro <parameter>map_size</parameter>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>flags</parameter></term>
<listitem>
<para>
Bandera a pasar a los controladores de base de datos. Si es &null;, se proporcionarán las banderas por defecto.
Actualmente, solo el controlador LMDB soporta las siguientes banderas:
<constant>DBA_LMDB_USE_SUB_DIR</constant> y
<constant>DBA_LMDB_NO_SUB_DIR</constant>.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<para>
&false; es devuelto y se emite un error de nivel <constant>E_WARNING</constant> cuando
el parámetro <parameter>handler</parameter> es &null;, pero no hay ningún gestor por defecto disponible.
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve un gestor positivo en caso de éxito &return.falseforfailure;.
Devuelve una instancia <classname>Dba\Connection</classname> en caso de éxito&return.falseforfailure;.
</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>4.3.0</entry>
<entry>
Es posible abrir ficheros de bases de datos sobre conexiones de red. Sin embargo,
en el caso en que se use una conexión de socket (como con http o ftp) la
conexión se bloqueará en lugar del recurso en sí. Esto es importante
para saber que en tales casos el bloqueo es ignorado simplemente en el recurso
y se tienen que encontrar otras soluciones.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
Ahora devuelve una instancia de <classname>Dba\Connection</classname>;
anteriormente se devolvía un &resource;.
</entry>
</row>
<row>
<entry>8.2.0</entry>
<entry>
Se añade el parámetro <parameter>flags</parameter>.
</entry>
</row>
<row>
<entry>8.2.0</entry>
<entry>
El parámetro <parameter>handler</parameter> ahora es nullable.
</entry>
</row>
<row>
<entry>7.3.14, 7.4.2</entry>
<entry>
El controlador <literal>lmdb</literal> ahora soporta un parámetro
adicional <parameter>map_size</parameter>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -208,7 +287,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

40
reference/dba/functions/dba-optimize.xml
View File

@@ -1,43 +1,66 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: yago Status: ready -->
<!-- EN-Revision: cc62b5ecf4831ef6cf888c925c2ad167410da811 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes Maintainer: PhilDaiguille -->
<refentry xml:id="function.dba-optimize" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>dba_optimize</refname>
<refpurpose>Optimizar base de datos</refpurpose>
<refpurpose>Optimiza una base DBA</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>dba_optimize</methodname>
<methodparam><type>resource</type><parameter>handle</parameter></methodparam>
<methodparam><type>Dba\Connection</type><parameter>dba</parameter></methodparam>
</methodsynopsis>
<para>
<function>dba_optimize</function> optimiza la base de datos interna.
<function>dba_optimize</function> optimiza la base de datos
identificada por <parameter>handle</parameter>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>handle</parameter></term>
<term><parameter>dba</parameter></term>
<listitem>
<para>
El gestor de base de datos, devuelto por <function>dba_open</function> o
<function>dba_popen</function>.
&dba.parameter.dba;
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&dba.changelog.dba-object;
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -47,7 +70,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -67,4 +89,4 @@ End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
-->

136
reference/dba/functions/dba-popen.xml
View File

@@ -1,26 +1,33 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: yago Status: ready -->
<!-- EN-Revision: 44428b04b7b046593e9ab33874eddd1fea7dfab1 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes Maintainer: PhilDaiguille -->
<refentry xml:id="function.dba-popen" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>dba_popen</refname>
<refpurpose>Abrir una base de datos de forma persistente</refpurpose>
<refpurpose>Establece una conexión persistente a una base de datos DBA</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>resource</type><methodname>dba_popen</methodname>
<type class="union"><type>Dba\Connection</type><type>false</type></type><methodname>dba_popen</methodname>
<methodparam><type>string</type><parameter>path</parameter></methodparam>
<methodparam><type>string</type><parameter>mode</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>handler</parameter></methodparam>
<methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam>
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>handler</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>permission</parameter><initializer>0644</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>map_size</parameter><initializer>0</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>flags</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<function>dba_popen</function> establece una instancia de base de
datos persistente para el archivo en <parameter>path</parameter> con el <parameter>mode</parameter> indicado,
usando <parameter>handler</parameter>.
<function>dba_popen</function> establece una conexión persistente
a la base identificada por <parameter>path</parameter>
con el modo <parameter>mode</parameter>, utilizando el identificador
<parameter>handler</parameter>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
@@ -29,18 +36,17 @@
<term><parameter>path</parameter></term>
<listitem>
<para>
Usualmente una ruta normal en su sistema de archivos.
</para>
Ruta en el sistema de ficheros.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>mode</parameter></term>
<listitem>
<para>
Es <literal>r</literal> para acceso de lectura, <literal>w</literal>
para acceso de lectura/escritura a una base de datos existente, <literal>c</literal> para acceso de
lectura/escritura y creación de base de datos si no existe actualmente,
y <literal>n</literal> para crear, truncar y tener acceso de lectura/escritura.
Puede ser <literal>r</literal> para solo lectura, <literal>w</literal> para
lectura/escritura, <literal>c</literal> para lectura/escritura y creación si la base no existe,
y <literal>n</literal> para creación, sobrescritura y acceso en lectura/escritura.
</para>
</listitem>
</varlistentry>
@@ -48,22 +54,112 @@
<term><parameter>handler</parameter></term>
<listitem>
<para>
El nombre del <link linkend="dba.requirements">gestor</link>
que será usado para acceder a <parameter>path</parameter>. A él se le pasan todos los
parámetros opcionales dados a <function>dba_popen</function>
y puede actuar sobre ellos.
El nombre del
<link linkend="dba.requirements">gestor</link> que debe ser
utilizado para acceder a <parameter>path</parameter>. El gestor recibe todos los argumentos adicionales
pasados a la función <function>dba_popen</function>. Si el argumento <parameter>handler</parameter> es &null;,
entonces se invoca el gestor por defecto.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>permission</parameter></term>
<listitem>
<para>
Argumento opcional de tipo entero (&integer;) que se pasa al controlador. Tiene el mismo significado
que el argumento <parameter>permissions</parameter> de la función <function>chmod</function>,
y su valor por omisión es <literal>0644</literal>.
</para>
<para>
Los controladores <literal>db1</literal>, <literal>db2</literal>,
<literal>db3</literal>, <literal>db4</literal>, <literal>dbm</literal>,
<literal>gdbm</literal>,
<literal>ndbm</literal> y <literal>lmdb</literal> admiten el argumento
<parameter>permission</parameter>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>map_size</parameter></term>
<listitem>
<para>
Argumento opcional de tipo &integer; que se pasa al controlador. Su valor debe ser un múltiplo de la
tamaño de página del sistema operativo, o cero para utilizar el tamaño de mapa por omisión.
</para>
<para>
El controlador <literal>lmdb</literal> acepta el argumento <parameter>map_size</parameter>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>flags</parameter></term>
<listitem>
<para>
Permite pasar banderas a los controladores de base de datos. Actualmente, solo el controlador LMDB con
las banderas <constant>DBA_LMDB_USE_SUB_DIR</constant> y <constant>DBA_LMDB_NO_SUB_DIR</constant> es soportado.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve un gestor positivo en caso de éxito, o &return.falseforfailure;.
Devuelve una instancia de <classname>Dba\Connection</classname> en caso de éxito&return.falseforfailure;.
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<para>
El valor &false; es devuelto y un error de nivel <constant>E_WARNING</constant> es emitido cuando
el argumento <parameter>handler</parameter> es &null;, pero no hay ningún gestor por defecto disponible.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
Ahora devuelve una instancia de <classname>Dba\Connection</classname>;
anteriormente se devolvía un &resource;.
</entry>
</row>
<row>
<entry>8.2.0</entry>
<entry>
Se añadió el argumento <parameter>flags</parameter>.
</entry>
</row>
<row>
<entry>8.2.0</entry>
<entry>
El argumento <parameter>handler</parameter> ahora es nullable.
</entry>
</row>
<row>
<entry>7.3.14, 7.4.2</entry>
<entry>
El controlador <literal>lmdb</literal> ahora soporta un argumento
adicional <parameter>map_size</parameter>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -94,4 +190,4 @@ End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
-->

47
reference/dba/functions/dba-replace.xml
View File

@@ -1,25 +1,29 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: yago Status: ready -->
<!-- EN-Revision: cc62b5ecf4831ef6cf888c925c2ad167410da811 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes Maintainer: PhilDaiguille -->
<refentry xml:id="function.dba-replace" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>dba_replace</refname>
<refpurpose>Reemplazar o insertar una entrada</refpurpose>
<refpurpose>Reemplaza o inserta una línea DBA</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>dba_replace</methodname>
<methodparam><type>string</type><parameter>key</parameter></methodparam>
<methodparam><type class="union"><type>string</type><type>array</type></type><parameter>key</parameter></methodparam>
<methodparam><type>string</type><parameter>value</parameter></methodparam>
<methodparam><type>resource</type><parameter>handle</parameter></methodparam>
<methodparam><type>Dba\Connection</type><parameter>dba</parameter></methodparam>
</methodsynopsis>
<para>
<function>dba_replace</function> reemplaza o inserta la entrada
descrita con <parameter>key</parameter> y <parameter>value</parameter> en la
base de datos especificada por <parameter>handle</parameter>.
<function>dba_replace</function> reemplaza o inserta una entrada,
para la clave <parameter>key</parameter> y con el valor
<parameter>value</parameter> en la base identificada por
<parameter>dba</parameter>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
@@ -28,7 +32,7 @@
<term><parameter>key</parameter></term>
<listitem>
<para>
La clave de la entrada a ser reemplazada.
La clave de la entrada a reemplazar.
</para>
</listitem>
</varlistentry>
@@ -36,28 +40,46 @@
<term><parameter>value</parameter></term>
<listitem>
<para>
El valor a ser reemplazado.
El valor utilizado para el reemplazo.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>handle</parameter></term>
<term><parameter>dba</parameter></term>
<listitem>
<para>
El gestor de base de datos, devuelto por <function>dba_open</function>
o <function>dba_popen</function>.
&dba.parameter.dba;
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&dba.changelog.dba-object;
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -70,7 +92,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

40
reference/dba/functions/dba-sync.xml
View File

@@ -1,44 +1,67 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: lboshell Status: ready -->
<!-- EN-Revision: cc62b5ecf4831ef6cf888c925c2ad167410da811 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes Maintainer: PhilDaiguille -->
<refentry xml:id="function.dba-sync" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>dba_sync</refname>
<refpurpose>Sincronizar base de datos</refpurpose>
<refpurpose>Sincroniza una base de datos DBA</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>dba_sync</methodname>
<methodparam><type>resource</type><parameter>handle</parameter></methodparam>
<methodparam><type>Dba\Connection</type><parameter>dba</parameter></methodparam>
</methodsynopsis>
<para>
<function>dba_sync</function> sincroniza la base de datos. Esto
probablemente desencadenará una escritura en disco, si es soportado.
<function>dba_sync</function> sincroniza la base de datos
especificada por <parameter>handle</parameter>. Si es admisible,
esto probablemente iniciará una operación de reescritura física del fichero.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>handle</parameter></term>
<term><parameter>dba</parameter></term>
<listitem>
<para>
El gestor de base de datos, devuelto por <function>dba_open</function>
o <function>dba_popen</function>.
&dba.parameter.dba;
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&dba.changelog.dba-object;
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -48,7 +71,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

124
reference/dba/setup.xml
View File

@@ -1,7 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: a0ae28d3bc85f927c22649ebd9a590b921534b7d Maintainer: seros Status: ready -->
<!-- EN-Revision: 8b2eba9e48eb1037f11aef36820db6b5b07fa08c Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<!-- CREDITS: DAnnebicque -->
<chapter xml:id="dba.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.setup;
@@ -10,13 +11,12 @@
<section xml:id="dba.requirements">
&reftitle.required;
<para>
El comportamiento de varios aspectos depende de la implementación de la
base de datos subyacente. Funciones tales como <function>dba_optimize</function>
y <function>dba_sync</function> harán que se prometa para una
base de datos y no harán nada para otras. Tiene que descargar e instalar
los gestores de dba soportados.
El comportamiento de ciertos aspectos depende de la implementación de la
base de datos subyacente. Las funciones como
<function>dba_optimize</function> y <function>dba_sync</function>
funcionan como se espera para una base de datos, mientras que pueden no hacer nada en otras. Deben descargarse e instalarse los gestores DBA soportados.
<table>
<title>Lista de los gestores de DBA</title>
<title>Lista de gestores DBA</title>
<tgroup cols="2">
<thead>
<row>
@@ -28,105 +28,105 @@
<row>
<entry><literal>dbm</literal></entry>
<entry>
Dbm es el tipo más antiguo (original) de las bases de datos estilo
Berkeley DB. Se debería evitar si es posible. No se tiene soporte para
la compatibilidad de funciones contruidas dentrode DB2 y gdbm, ya que
sólo son compatibles con el nivel de código fuente, pero no pueden
manejar el formato original de dbm.
DBM es la más antigua (la original) de las bases de datos
de estilo Berkeley DB. Debería evitarse su uso
si es posible. No se proporciona soporte para la compatibilidad de las funciones internas a DB2 y gdbm, ya que solo son compatibles a nivel de código fuente, pero no pueden manejar el formato original DBM.
</entry>
</row>
<row>
<entry><literal>ndbm</literal></entry>
<entry>
Ndbm es un tipo más reciente y flexible que dbm. Todavía tiene
la mayoría de los límites arbitrarios de dbm (aunque está
obsoleto).
Ndbm es un nuevo tipo y más flexible que dbm. Sin embargo,
presenta limitaciones arbitrarias de dbm
(y por lo tanto, está obsoleto).
</entry>
</row>
<row>
<entry><literal>gdbm</literal></entry>
<entry>
Gdbm es el <link xlink:href="&url.gdbm;">GNU database
manager</link>.
Gdbm es un <link xlink:href="&url.gdbm;">gestor de
bases de datos GNU</link>.
</entry>
</row>
<row>
<entry><literal>db2</literal></entry>
<entry>
DB2 es para <link xlink:href="&url.sleepycat;">Oracle Berkeley
DB 2</link>. Está descrito como "un conjunto de herramientas programático que
proporciona soporte para bases de datos internas de alto rendimiento para
aplicaciones autónomas y de cliente/servidor".
<link xlink:href="&url.sleepycat;">Oracle Berkeley
DB 2</link>. Se describe como "un toolkit que proporciona
soporte de alto rendimiento para bases de datos,
tanto del lado cliente como del lado servidor."
</entry>
</row>
<row>
<entry><literal>db3</literal></entry>
<entry>
DB3 es para <link xlink:href="&url.sleepycat;">Oracle Berkeley DB
3</link>.
<link xlink:href="&url.sleepycat;">Oracle Berkeley DB
3</link>.
</entry>
</row>
<row>
<entry><literal>db4</literal></entry>
<entry>
DB4 es para <link xlink:href="&url.sleepycat;">Oracle Berkeley DB
4 o 5</link>. Se puede
usar con BDB 5 desde PHP 5.3.3.
<link xlink:href="&url.sleepycat;">Oracle Berkeley DB
4 o 5</link>. Esta opción puede
utilizarse con BDB 5 a partir de PHP 5.3.3.
</entry>
</row>
<row>
<entry><literal>cdb</literal></entry>
<entry>
Cdb es "un paquete rápido, fiable, ligero para crear y
leer bases de datos constantes." Es del autor de qmail y
se puede encontrar en <link xlink:href="&url.cdb;">&url.cdb;</link>. Ya que
es constante, solo se soportan las operaciones de lectura.
Se soporta la escritura (no la actualización) a través de la biblioteca interna de cdb.
Cdb es un paquete rápido, ligero y fiable para crear y leer
bases de datos constantes. Fue creado por el autor
de qmail y puede encontrarse en
<link xlink:href="&url.cdb;">&url.cdb;</link>. Dado que es "constante",
solo se soportarán las operaciones de lectura.
También se soporta la escritura (y no la actualización)
mediante la biblioteca interna cdb.
</entry>
</row>
<row>
<entry><literal>cdb_make</literal></entry>
<entry>
Se soporta la creación (no la actualización) de ficheros cdb
cuando se usa la biblioteca interna cdb.
Se soporta la escritura (y no la actualización)
de archivos cdb cuando se utiliza la biblioteca cdb.
</entry>
</row>
<row>
<entry><literal>flatfile</literal></entry>
<entry>
Está disponible únicamente para la compatibilidad con la extensión
obsoleta <literal>dbm</literal> y debería de evitarse.
Sin embargo, se puede usar para los ficheros creados con este formato. Esto
ocurre cuando configure no puede encontrar una biblioteca externa.
Esto está disponible por razones de compatibilidad con
la extensión obsoleta <literal>dbm</literal>. Sin embargo, puede
utilizarse cuando los archivos han sido creados en este formato.
Ocurre cuando la configuración no ha logrado encontrar una
biblioteca externa.
</entry>
</row>
<row>
<entry><literal>inifile</literal></entry>
<entry>
Está disponible para ser capaz de modificar ficheros php.ini
desde dentro de scripts de PHP. Cuando se trabaja con ficheros ini se pueden pasar arrays
de la forma array(0=>grupo,1=>nombre_valor) o cadenas de la forma
"[grupo]nombre_valor" donde grupo es opcional. Ya que las funciones
<function>dba_firstkey</function> y <function>dba_nextkey</function>
devuelve una cadenas que representan la clave, existe una nueva función,
<function>dba_key_split</function>, la cual permite
convertir las claves de cadena en claves de array sin ocasionar &false;.
Esto está disponible para permitir la modificación de los
archivos php.ini desde scripts PHP. Al utilizar archivos ini, pueden pasarse arrays de la forma
(0=>grupo,1=>nombre_valor) o strings de la forma
"[grupo]nombre_valor" donde el grupo es opcional. Dado que las
funciones <function>dba_firstkey</function> y <function>dba_nextkey</function>
devuelven un string representando la clave, existe una nueva función, <function>dba_key_split</function>,
que permite convertir las claves en arrays sin pérdida.
</entry>
</row>
<row>
<entry><literal>qdbm</literal></entry>
<entry>
La biblioteca qdbm se puede cargar desde
La biblioteca qdbm puede descargarse desde
<link xlink:href="&url.qdbm;"/>.
</entry>
</row>
@@ -134,16 +134,16 @@
<row>
<entry><literal>tcadb</literal></entry>
<entry>
La biblioteca Tokyo Cabinet se puede
descargar desde <link xlink:href="&url.tcadb;"/>.
La biblioteca Tokyo Cabinet puede ser
descargada desde <link xlink:href="&url.tcadb;"/>.
</entry>
</row>
<row>
<entry><literal>lmdb</literal></entry>
<entry>
Está disponible desde PHP 7.2.0. La bilioteca de la base de datos The Lightning Memory-Mapped
puede ser descargada desde <link xlink:href="&url.lmdb;"/>.
Disponible a partir de PHP 7.2.0. La biblioteca Lightning
Memory-Mapped Database puede ser descargada desde
<link xlink:href="&url.lmdb;"/>.
</entry>
</row>
@@ -152,11 +152,12 @@
</table>
</para>
<para>
Cuando se invoca a las funciones <function>dba_open</function> o
<function>dba_popen</function>, se debe proporcionar uno de los
nombres de gestores como argumento. La lista real de gestores
disponibles se muestra invocando a
<function>phpinfo</function> o <function>dba_handlers</function>.
Al llamar a la función <function>dba_open</function> o
la función <function>dba_popen</function>, debe proporcionarse uno de los
nombres de gestor como argumento. La lista
de gestores disponibles puede mostrarse utilizando
la función <function>phpinfo</function> o la función
<function>dba_handlers</function>.
</para>
</section>
<!-- }}} -->
@@ -171,7 +172,7 @@
&extension.runtime;
<para>
<table>
<title>DBA &ConfigureOptions;</title>
<title>&ConfigureOptions; DBA</title>
<tgroup cols="4">
<thead>
<row>
@@ -206,9 +207,10 @@
</term>
<listitem>
<para>
El nombre del gestor predeterminado
El nombre del gestor por defecto
</para>
</listitem>
</varlistentry>
</variablelist>
@@ -220,9 +222,8 @@
<section xml:id="dba.resources">
&reftitle.resources;
<para>
Las funciones <function>dba_open</function> y
<function>dba_popen</function> devuelven un gestor al fichero de
base de datos especificado que se va a acceder, el cual es usado por las demás llamadas a funciones dba.
A partir de PHP 8.4.0, la mayoría de las funciones DBA operan sobre o devuelven recursos (por ejemplo, <function>dba_open</function>
devuelve un identificador de enlace DBA positivo requerido por la mayoría de las funciones DBA).
</para>
</section>
<!-- }}} -->
@@ -249,4 +250,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

32
reference/dio/book.xml
View File

@@ -1,32 +1,29 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b824e2b1086e94a1077bd071964547283616030a Maintainer: chuso Status: ready -->
<!-- Reviewed: no Maintainer: andresdzphp -->
<!-- EN-Revision: 68c2c871505aadf983f16113c5b077b335ce8d76 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<book xml:id="book.dio" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<?phpdoc extension-membership="pecl" ?>
<title>Direct IO</title>
<!-- {{{ preface -->
<preface xml:id="intro.dio">
&reftitle.intro;
<para>
PHP incorpora soporte para funciones de entrada/salida directa tal como
se describe en el estándar Posix (Sección 6) para realizar funciones de E/S a
un nivel más bajo bajo que los flujos de E/S de las funciones en C
(<function>fopen</function>, <function>fread</function>,..). Sólo
debe considerarse usar las funciones DIO cuando sea necesario tener
control directo sobre un dispositivo. En cualquier otro caso, las funciónes
estándar del <link linkend="book.filesystem">sistema de ficheros</link> son
más que suficiente.
PHP soporta las funciones Direct IO, tal como se describe en
el estándar Posix (Sección 6) para realizar funciones
I/O de bajo nivel en comparación con las funciones
C-Language stream I/O (<function>fopen</function>,
<function>fread</function>,..). El uso de las funciones
DIO debe considerarse únicamente cuando se requiere un control directo
de un dispositivo. En todos los demás casos,
las funciones estándar del <link linkend="book.filesystem">sistema
de archivos</link> son más adecuadas.
</para>
<note>
<para>
&pecl.moved-ver;5.1.0.
</para>
</note>
</preface>
<!-- }}} -->
&reference.dio.setup;
&reference.dio.constants;
&reference.dio.reference;
@@ -53,4 +50,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

16
reference/dio/configure.xml
View File

@@ -1,18 +1,16 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: chuso Status: ready -->
<!-- EN-Revision: 307e7d78baacfcd228eef8f384e96659b67d9adb Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<section xml:id="dio.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.install;
<para>
&pecl.moved;
&pecl.moved;
</para>
<para>
&pecl.info;
<link xlink:href="&url.pecl.package;dio">&url.pecl.package;dio</link>.
</para>
<para>
&pecl.windows.download;
</para>
&pecl.info;
<link xlink:href="&url.pecl.package;dio">&url.pecl.package;dio</link>.
</para>
</section>
<!-- Keep this comment at the end of the file

76
reference/dio/constants.xml
View File

@@ -1,6 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 14af302c9c0e561fa6f9cdd956268758ba9a89c5 Maintainer: chuso Status: ready -->
<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<appendix xml:id="dio.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
&extension.constants;
@@ -8,7 +10,7 @@
<varlistentry xml:id="constant.f-dupfd">
<term>
<constant>F_DUPFD</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -17,7 +19,7 @@
<varlistentry xml:id="constant.f-getfd">
<term>
<constant>F_GETFD</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -26,7 +28,7 @@
<varlistentry xml:id="constant.f-getfl">
<term>
<constant>F_GETFL</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -35,7 +37,7 @@
<varlistentry xml:id="constant.f-getlk">
<term>
<constant>F_GETLK</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -44,7 +46,7 @@
<varlistentry xml:id="constant.f-getown">
<term>
<constant>F_GETOWN</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -53,7 +55,7 @@
<varlistentry xml:id="constant.f-rdlck">
<term>
<constant>F_RDLCK</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -62,7 +64,7 @@
<varlistentry xml:id="constant.f-setfl">
<term>
<constant>F_SETFL</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -71,7 +73,7 @@
<varlistentry xml:id="constant.f-setlk">
<term>
<constant>F_SETLK</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -80,7 +82,7 @@
<varlistentry xml:id="constant.f-setlkw">
<term>
<constant>F_SETLKW</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -89,7 +91,7 @@
<varlistentry xml:id="constant.f-setown">
<term>
<constant>F_SETOWN</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -98,7 +100,7 @@
<varlistentry xml:id="constant.f-unlck">
<term>
<constant>F_UNLCK</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -107,7 +109,7 @@
<varlistentry xml:id="constant.f-wrlck">
<term>
<constant>F_WRLCK</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -116,7 +118,7 @@
<varlistentry xml:id="constant.o-append">
<term>
<constant>O_APPEND</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -125,7 +127,7 @@
<varlistentry xml:id="constant.o-async">
<term>
<constant>O_ASYNC</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -134,7 +136,7 @@
<varlistentry xml:id="constant.o-creat">
<term>
<constant>O_CREAT</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -143,7 +145,7 @@
<varlistentry xml:id="constant.o-excl">
<term>
<constant>O_EXCL</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -152,7 +154,7 @@
<varlistentry xml:id="constant.o-ndelay">
<term>
<constant>O_NDELAY</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -161,7 +163,7 @@
<varlistentry xml:id="constant.o-noctty">
<term>
<constant>O_NOCTTY</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -170,7 +172,7 @@
<varlistentry xml:id="constant.o-nonblock">
<term>
<constant>O_NONBLOCK</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -179,7 +181,7 @@
<varlistentry xml:id="constant.o-rdonly">
<term>
<constant>O_RDONLY</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -188,7 +190,7 @@
<varlistentry xml:id="constant.o-rdwr">
<term>
<constant>O_RDWR</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -197,7 +199,7 @@
<varlistentry xml:id="constant.o-sync">
<term>
<constant>O_SYNC</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -206,7 +208,7 @@
<varlistentry xml:id="constant.o-trunc">
<term>
<constant>O_TRUNC</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -215,7 +217,7 @@
<varlistentry xml:id="constant.o-wronly">
<term>
<constant>O_WRONLY</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -224,7 +226,7 @@
<varlistentry xml:id="constant.s-irgrp">
<term>
<constant>S_IRGRP</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -233,7 +235,7 @@
<varlistentry xml:id="constant.s-iroth">
<term>
<constant>S_IROTH</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -242,7 +244,7 @@
<varlistentry xml:id="constant.s-irusr">
<term>
<constant>S_IRUSR</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -251,7 +253,7 @@
<varlistentry xml:id="constant.s-irwxg">
<term>
<constant>S_IRWXG</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -260,7 +262,7 @@
<varlistentry xml:id="constant.s-irwxo">
<term>
<constant>S_IRWXO</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -269,7 +271,7 @@
<varlistentry xml:id="constant.s-irwxu">
<term>
<constant>S_IRWXU</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -278,7 +280,7 @@
<varlistentry xml:id="constant.s-iwgrp">
<term>
<constant>S_IWGRP</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -287,7 +289,7 @@
<varlistentry xml:id="constant.s-iwoth">
<term>
<constant>S_IWOTH</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -296,7 +298,7 @@
<varlistentry xml:id="constant.s-iwusr">
<term>
<constant>S_IWUSR</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -305,7 +307,7 @@
<varlistentry xml:id="constant.s-ixgrp">
<term>
<constant>S_IXGRP</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -314,7 +316,7 @@
<varlistentry xml:id="constant.s-ixoth">
<term>
<constant>S_IXOTH</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>
@@ -323,7 +325,7 @@
<varlistentry xml:id="constant.s-ixusr">
<term>
<constant>S_IXUSR</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<para></para>

27
reference/dio/setup.xml
View File

@@ -1,34 +1,22 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: chuso Status: ready -->
<!-- EN-Revision: 765b2d6eec7dfbaeed900b32aa91a1360d73df42 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<chapter xml:id="dio.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.setup;
<!-- {{{ Requirements -->
<section xml:id="dio.requirements">
&reftitle.required;
&no.requirement;
</section>
<!-- }}} -->
<!-- {{{ Installation -->
<!-- {{{ Configuración -->
&reference.dio.configure;
<!-- }}} -->
<!-- {{{ Configuration -->
<section xml:id="dio.configuration">
&reftitle.runtime;
&no.config;
</section>
<!-- }}} -->
<!-- {{{ Resources -->
<!-- {{{ Recursos -->
<section xml:id="dio.resources">
&reftitle.resources;
<para>
Esta extensión define un tipo de recurso:
un descriptor de fichero devuelto por <function>dio_open</function>.
Un tipo de recurso es definido por esta extensión:
un puntero de fichero, retornado por la función
<function>dio_open</function>.
</para>
</section>
<!-- }}} -->
@@ -55,4 +43,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

41
reference/dir/directory/close.xml
View File

@@ -1,28 +1,43 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 57177f415976f0c37afacfdaac08269fc568d672 Maintainer: seros Status: ready -->
<!-- EN-Revision: f6eea41e714ef49d05da10318d4a1c32f12911a2 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="directory.close" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>Directory::close</refname>
<refpurpose>Cierra un gestor de directorio</refpurpose>
<refpurpose>Cierra el manejador de directorio</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<methodsynopsis role="Directory">
<modifier>public</modifier> <type>void</type><methodname>Directory::close</methodname>
<methodparam choice="opt"><type>resource</type><parameter>dir_handle</parameter></methodparam>
<void/>
</methodsynopsis>
<para>
Al igual que <function>closedir</function>, solo que el valor predeterminado
de <parameter>dir_handle</parameter> es <varname>$this->handle</varname>.
</para>
</refsect1>
</refentry>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
No se acepta ningún argumento. Anteriormente, un manejador de directorio podía ser pasado como argumento.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

39
reference/dir/directory/read.xml
View File

@@ -1,28 +1,43 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 57177f415976f0c37afacfdaac08269fc568d672 Maintainer: juanframaureira Status: ready -->
<!-- EN-Revision: f6eea41e714ef49d05da10318d4a1c32f12911a2 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="directory.read" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>Directory::read</refname>
<refpurpose>Lee una entrada desde el controlador de directorio</refpurpose>
<refpurpose>Lee una entrada desde el manejador de directorio</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <type>string</type><methodname>Directory::read</methodname>
<methodparam choice="opt"><type>resource</type><parameter>dir_handle</parameter></methodparam>
<methodsynopsis role="Directory">
<modifier>public</modifier> <type class="union"><type>string</type><type>false</type></type><methodname>Directory::read</methodname>
<void/>
</methodsynopsis>
<para>
Igual a <function>readdir</function>,<parameter>
dir_handle</parameter> por defecto <varname>$this->handle</varname>.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
No se acepta ningún argumento. Anteriormente, un manejador de directorio podía ser pasado como argumento.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

37
reference/dir/directory/rewind.xml
View File

@@ -1,28 +1,43 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 57177f415976f0c37afacfdaac08269fc568d672 Maintainer: juanframaureira Status: ready -->
<!-- EN-Revision: f6eea41e714ef49d05da10318d4a1c32f12911a2 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="directory.rewind" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>Directory::rewind</refname>
<refpurpose>Rebobina el manejador de directorio</refpurpose>
<refpurpose>Reinicia el manejador de directorio</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<methodsynopsis role="Directory">
<modifier>public</modifier> <type>void</type><methodname>Directory::rewind</methodname>
<methodparam choice="opt"><type>resource</type><parameter>dir_handle</parameter></methodparam>
<void/>
</methodsynopsis>
<para>
Igual a <function>rewinddir</function>, <parameter>
dir_handle</parameter> por defecto <varname>$this->handle</varname>.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
No se acepta ningún argumento. Anteriormente, un manejador de directorio podía ser pasado como argumento.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

40
reference/dir/functions/chroot.xml
View File

@@ -1,14 +1,13 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 297028 -->
<!-- EN-Revision: dae442b0eca44ab535d19fc3880945911421fced Maintainer: agarzon Status: ready -->
<!-- $Revision$ -->
<!-- EN-Revision: 625dc345dba34bd0e8f97b6fac4272a5e8359428 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<!-- splitted from ./en/functions/dir.xml, last change in rev 1.11 -->
<refentry xml:id="function.chroot" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>chroot</refname>
<refpurpose>Cambia el directorio raíz</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
@@ -16,17 +15,20 @@
<methodparam><type>string</type><parameter>directory</parameter></methodparam>
</methodsynopsis>
<para>
Cambia el directorio raíz del proceso actual a
<parameter>directorio</parameter>, y cambia el directorio de trabajo
actual a "/".
<function>chroot</function> cambia la raíz del script en curso,
y la reemplaza por <parameter>directory</parameter>, luego cambia el directorio
de trabajo actual a "/".
</para>
<para>
Esta función sólo se encuentra disponible a sistemas GNU y BSD, y
se encuentra usando un entorno CLI, CGI o SAPI embebido.
Asimismo, esta función requiere privilegios de administrador (root).
Esta función solo está disponible en sistemas GNU y BSD y cuando se utiliza
la SAPI CLI, CGI o Embed. Además, esta función requiere privilegios de administrador.
</para>
<para>
Llamar a esta función no modifica los valores de las constantes mágicas
<literal>__DIR__</literal> y <literal>__FILE__</literal>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
@@ -35,30 +37,29 @@
<term><parameter>directory</parameter></term>
<listitem>
<para>
Directorio al que cambiar el raíz
El directorio al cual cambiar la raíz.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo de <function>chroot</function></title>
<example><title>Ejemplo con <function>chroot</function></title>
<programlisting role="php">
<![CDATA[
<?php
chroot("/ruta/al/chroot/");
chroot("/path/to/your/chroot/");
echo getcwd();
?>
]]>
@@ -72,10 +73,11 @@ echo getcwd();
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
&note.no-windows;
&note.no-zts;
</refsect1>
</refentry>

41
reference/dir/functions/closedir.xml
View File

@@ -1,57 +1,61 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 297028 -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: tkzexe Status: ready -->
<!-- EN-Revision: b0b19b66183b28cebc1ffbcf1e2b8763f9d9c7b3 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<!-- splitted from ./en/functions/dir.xml, last change in rev 1.2 -->
<refentry xml:id="function.closedir" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>closedir</refname>
<refpurpose>Cierra un gestor de directorio</refpurpose>
<refpurpose>Cierra el puntero al directorio</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>void</type><methodname>closedir</methodname>
<methodparam choice="opt"><type>resource</type><parameter>dir_handle</parameter></methodparam>
<methodparam choice="opt"><type class="union"><type>resource</type><type>null</type></type><parameter>dir_handle</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
Cierra la secuencia de directorio indicada por
<parameter>gestor_dir</parameter>. La secuencia debe haber sido abierta previamente por
<function>closedir</function> cierra el puntero al directorio
<parameter>dir_handle</parameter>. El directorio debe haber sido abierto previamente con
<function>opendir</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>gestor_dir</parameter></term>
<term><parameter>dir_handle</parameter></term>
<listitem>
<para>
El gestor de directorio tipo <type>resource</type>, previamente
abierto con <function>opendir</function>. Si el gestor de directorio no se especifica,
la última conexión abierta por <function>opendir</function>
es asumida.
La <type>recurso</type> de directorio abierta previamente con
<function>opendir</function>.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.void;
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>closedir</function> ejemplo</title>
<title>Ejemplo con <function>closedir</function></title>
<programlisting role="php">
<![CDATA[
<?php
$dir = "/etc/php5/";
// Abrir un directorio conocido, lee el directorio en una variable y lo cierra.
// Apertura de un directorio conocido, lectura del directorio y asignación a
// una variable, posteriormente cierre del directorio
if (is_dir($dir)) {
if ($dh = opendir($dir)) {
$directory = readdir($dh);
@@ -65,7 +69,6 @@ if (is_dir($dir)) {
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

42
reference/dir/functions/dir.xml
View File

@@ -1,8 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 53b6f116ed5f8649ca540c38dfe0ce30619d0dd9 Maintainer: aeoris Status: ready -->
<!-- EN-Revision: b0b19b66183b28cebc1ffbcf1e2b8763f9d9c7b3 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<!-- splitted from ./en/functions/dir.xml, last change in rev 1.2 -->
<refentry xml:id="function.dir" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>dir</refname>
@@ -18,8 +16,8 @@
</methodsynopsis>
<para>
Una forma pseudo orientada a objetos de leer un directorio. El
directorio proporcionado en <parameter>directory</parameter> es abierto.
Un mecanismo pseudo-objeto permite la lectura de un directorio.
El argumento <parameter>directory</parameter> es abierto.
</para>
</refsect1>
@@ -30,14 +28,14 @@
<term><parameter>directory</parameter></term>
<listitem>
<para>
Directorio a abrir
El directorio a abrir
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>context</parameter></term>
<listitem>
&note.context-support;
&note.context-support;
</listitem>
</varlistentry>
</variablelist>
@@ -46,7 +44,8 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve una instancia de la clase <classname>Directory</classname>, o &false; en caso de error.
Devuelve una instancia de la clase <classname>Directory</classname>
en caso de éxito, o &false; en caso de error.
</para>
</refsect1>
@@ -76,22 +75,21 @@
&reftitle.examples;
<para>
<example>
<title>Ejemplo de <function>dir</function></title>
<title>Ejemplo con <function>dir</function></title>
<para>
Tenga en cuenta la forma en que se comprueba el valor de retorno de <function>Directory::read</function>
en el siguiente ejemplo. Es necesario verificar explicitamente
si el valor de retorno es identico (tanto en valor como en
tipo - ver <link linkend="language.operators.comparison">
Operadores de comparación</link> para más información) a &false;, ya que
de lo contrario, cualquier directorio cuyo nombre evaluase a &false;
finalizaría el bucle.
Observe cómo se verifica el valor de retorno de <function>Directory::read</function>
en el siguiente ejemplo. Se comprueba si el valor es
idéntico (igual y del mismo tipo que -- véase <link
linkend="language.operators.comparison">operadores de comparación</link>
para más detalles) &false; de lo contrario, cualquier entrada en el nombre se evaluaría
a &false; causaría la interrupción del ciclo.
</para>
<programlisting role="php">
<![CDATA[
<?php
$d = dir("/etc/php5");
echo "Handle: " . $d->handle . "\n";
echo "Path: " . $d->path . "\n";
echo "Manejador : " . $d->handle . "\n";
echo "Ruta : " . $d->path . "\n";
while (false !== ($entry = $d->read())) {
echo $entry."\n";
}
@@ -102,8 +100,8 @@ $d->close();
&example.outputs.similar;
<screen>
<![CDATA[
Handle: Resource id #2
Path: /etc/php5
Manejador : Resource id #2
Ruta : /etc/php5
.
..
apache
@@ -119,8 +117,8 @@ cli
&reftitle.notes;
<note>
<para>
El orden en el que los archivos de un directorio son devueltos por el método de lectura
depende del sistema.
El orden en el que las entradas del directorio son devueltas con el
método read depende del sistema.
</para>
</note>
</refsect1>

65
reference/dir/functions/getcwd.xml
View File

@@ -1,56 +1,61 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 297028 -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: tkzexe Status: ready -->
<!-- EN-Revision: 62126c55f1c6ed444043e7272c4f9e233818a44b Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<!-- splitted from ./en/functions/dir.xml, last change in rev 1.7 -->
<refentry xml:id="function.getcwd" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>getcwd</refname>
<refpurpose>Obtiene el directorio actual en donde se esta trabajando</refpurpose>
<refpurpose>Devuelve el directorio de trabajo actual</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>getcwd</methodname>
<type class="union"><type>string</type><type>false</type></type><methodname>getcwd</methodname>
<void/>
</methodsynopsis>
<para>
Obtiene el directorio actual.
Devuelve el directorio de trabajo actual.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve el directorio actual de trabajo en caso de éxito, o &false; si ocurre un error.
</para>
Devuelve el directorio de trabajo actual en caso de éxito o &false; en caso
de fallo.
</para>
<para>
En algunas variantes de Unix, <function>getcwd</function> devolverá
&false; si alguno de los directorios padre no tiene definido el modo de lectura o búsqueda,
incluso si el directorio actual lo tiene. Vea <function>chmod</function> para más información sobre los modos y permisos.
En algunas versiones de Unix, <function>getcwd</function>
puede devolver &false; si todos los directorios padres no tienen
el modo escritura o el modo búsqueda definido, incluso si el directorio
actual los tiene. Ver la función <function>chmod</function> para más información
sobre los modos de permisos.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>getcwd</function> ejemplo</title>
<title>Ejemplo con <function>getcwd</function></title>
<programlisting role="php">
<![CDATA[
<?php
// directorio actual
echo getcwd() . "\n";
chdir('cvs');
// directorio actual
echo getcwd() . "\n";
?>
]]>
</programlisting>
@@ -64,7 +69,21 @@ echo getcwd() . "\n";
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<caution>
<para>
Si el intérprete PHP ha sido compilado con ZTS activado (Zend Thread Safety),
el directorio de trabajo actual, devuelto por la función
<function>getcwd</function> puede ser diferente del devuelto por
las interfaces del sistema. Las bibliotecas externas (llamadas a través
de <link linkend="book.ffi">FFI</link>), que dependen del directorio
de trabajo actual, se verán afectadas.
</para>
</caution>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -75,7 +94,7 @@ echo getcwd() . "\n";
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

139
reference/dir/functions/opendir.xml
View File

@@ -1,119 +1,109 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 297028 -->
<!-- EN-Revision: 53b6f116ed5f8649ca540c38dfe0ce30619d0dd9 Maintainer: tkzexe Status: ready -->
<!-- Reviewed: no Maintainer: andresdzphp -->
<!-- splitted from ./en/functions/dir.xml, last change in rev 1.2 -->
<!-- EN-Revision: b0b19b66183b28cebc1ffbcf1e2b8763f9d9c7b3 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.opendir" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>opendir</refname>
<refpurpose>Abre un gestor de directorio</refpurpose>
<refpurpose>
Abre un directorio y recupera un puntero sobre él
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>resource</type><methodname>opendir</methodname>
<methodparam><type>string</type><parameter>path</parameter></methodparam>
<methodparam choice="opt"><type>resource</type><parameter>context</parameter></methodparam>
<type class="union"><type>resource</type><type>false</type></type><methodname>opendir</methodname>
<methodparam><type>string</type><parameter>directory</parameter></methodparam>
<methodparam choice="opt"><type class="union"><type>resource</type><type>null</type></type><parameter>context</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
Abre un gestor de directorio para ser usado con llamadas posteriores como
<function>closedir</function>, <function>readdir</function>, y
<function>rewinddir</function>.
<function>opendir</function> devuelve un puntero sobre un directorio
que puede ser utilizado con las funciones
<function>closedir</function>, <function>readdir</function>
y <function>rewinddir</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>ruta</parameter></term>
<term><parameter>directory</parameter></term>
<listitem>
<para>
La ruta del directorio a ser abierta.
La ruta del directorio a abrir
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>contexto</parameter></term>
<term><parameter>context</parameter></term>
<listitem>
<para>
Para una descripción del parámetro <parameter>contexto</parameter>,
refiérase a <link linkend="ref.stream">la sección de secuencias </link> del manual.
</para>
Para la descripción del parámetro <parameter>context</parameter>,
consúltese la <link linkend="ref.stream">sección de flujos</link> del manual.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve un gestor de directorio tipo <type>resource</type> en caso de éxito, o
&false; si ocurre un error.
</para>
<para>
Si <parameter>ruta</parameter> no es un directorio válido o el directorio no puede ser abierto
debido a restricciones de permisos o errores del sistema de archivos,
<function>opendir</function> devuelve &false; y
genera un error de PHP de nivel <link linkend="errorfunc.constants">
E_WARNING</link>. Es posible suprimir la salida del error de
<function>opendir</function> anteponiendo
'<link linkend="language.operators.errorcontrol">@</link>' al nombre de la función.
Devuelve el &resource; de directorio en caso de éxito,
&return.falseforfailure;
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
&fs.emits.warning.on.failure;
<para>
Esto puede ocurrir si <parameter>directory</parameter> no es un directorio
válido, el directorio no puede ser abierto por problemas de permisos,
o debido a errores relacionados con el sistema de archivos.
</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>5.0.0</entry>
<entry>
<parameter>ruta</parameter> soporta dentro de la URL la envoltura <literal>ftp://</literal>.
</entry>
</row>
<row>
<entry>4.3.0</entry>
<entry>
<parameter>ruta</parameter> puede leer también cualquier URL que soporte el listado de
directorios, sin embargo solo la envoltura de URL <literal>file://</literal>
tiene este soporte en PHP 4 .
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
<parameter>context</parameter> ahora es nullable.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>opendir</function> ejemplo</title>
<title>Ejemplo con <function>opendir</function></title>
<programlisting role="php">
<![CDATA[
<?php
$dir = "/etc/php5/";
// Abre un directorio conocido, y procede a leer el contenido
$dir = "/tmp/php5";
// Abre un directorio conocido y lista todos los ficheros
if (is_dir($dir)) {
if ($dh = opendir($dir)) {
while (($file = readdir($dh)) !== false) {
echo "nombre archivo: $file : tipo archivo: " . filetype($dir . $file) . "\n";
echo "fichero : $file : tipo : " . filetype($dir . $file) . "\n";
}
closedir($dh);
}
@@ -124,17 +114,17 @@ if (is_dir($dir)) {
&example.outputs.similar;
<screen>
<![CDATA[
nombre archivo: . : tipo archivo: dir
nombre archivo: .. : tipo archivo: dir
nombre archivo: apache : tipo archivo: dir
nombre archivo: cgi : tipo archivo: dir
nombre archivo: cli : tipo archivo: dir
fichero : . : tipo : dir
fichero : .. : tipo : dir
fichero : apache : tipo : dir
fichero : cgi : tipo : dir
fichero : cli : tipo : dir
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -146,7 +136,6 @@ nombre archivo: cli : tipo archivo: dir
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

117
reference/dir/functions/readdir.xml
View File

@@ -1,86 +1,106 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 297028 -->
<!-- EN-Revision: 99a5cc447fc5ab7c3deeeb6f7462f9891bc86852 Maintainer: tkzexe Status: ready -->
<!-- EN-Revision: b0b19b66183b28cebc1ffbcf1e2b8763f9d9c7b3 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<!-- splitted from ./en/functions/dir.xml, last change in rev 1.2 -->
<refentry xml:id="function.readdir" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>readdir</refname>
<refpurpose>Lee una entrada desde un gestor de directorio</refpurpose>
<refpurpose>Lee una entrada del directorio</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>readdir</methodname>
<methodparam choice="opt"><type>resource</type><parameter>dir_handle</parameter></methodparam>
<type class="union"><type>string</type><type>false</type></type><methodname>readdir</methodname>
<methodparam choice="opt"><type class="union"><type>resource</type><type>null</type></type><parameter>dir_handle</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
Devuelve el nombre de la siguiente entrada del directorio. Las
entradas son devueltas en el orden en que fueron almacenadas por
el sistema de ficheros.
<function>readdir</function> devuelve el nombre de la próxima entrada
del directorio identificado por <parameter>dir_handle</parameter>.
Las entradas se devuelven en el orden en que están registradas
en el sistema de archivos.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>gestor_dir</parameter></term>
<term><parameter>dir_handle</parameter></term>
<listitem>
<para>
El gestor de directorio <type>resource</type> previamente abierto por <function>opendir</function>.
Si el gestor de directorio no se especifica, la ultima conexión abierta por <function>opendir</function>
es asumida.
El <type>recurso</type> de directorio abierto previamente con
<function>opendir</function>. Si el recurso de directorio
no está especificado, se utilizará el último recurso abierto con la función
<function>opendir</function>.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Retorna el nombre de la entrada en caso de éxito &return.falseforfailure;.
</para>
Devuelve el nombre de la entrada en caso de éxito,&return.falseforfailure;.
</para>
&return.falseproblem;
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
<parameter>dir_handle</parameter> ahora es nullable.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Listar todas las entradas de un directorio</title>
<title>Lista de todas las entradas de un directorio</title>
<para>
Por favor observe que la forma en que el valor de retorno de <function>readdir</function>
es chequeado en los siguientes ejemplos. Se está probando explícitamente si el valor de retorno es idéntico
(igual y del mismo tipo, vea los <link
linkend="language.operators.comparison">Operadores de Comparación</link>
para más información) a &false; ya que de otra forma,
cualquier entrada de directorio cuyo nombre evalúe a &false; detendrá
el ciclo (p.ej. un directorio llamado "0").
Observe cómo se verifica el valor de retorno de <function>dir</function>
en el siguiente ejemplo. Se comprueba si el valor es idéntico (igual y del mismo tipo -- véase <link
linkend="language.operators.comparison">operadores de comparación</link>
para más detalles) &false; de lo contrario, cualquier entrada en el nombre se evaluaría
como &false; causaría el fin del ciclo (ejemplo, un directorio llamado 0).
</para>
<programlisting role="php">
<![CDATA[
<?php
if ($gestor = opendir('/path/to/files')) {
echo "Gestor de directorio: $gestor\n";
if ($handle = opendir('/ruta/al/directorio')) {
echo "Controlador del directorio: $handle\n";
echo "Entradas:\n";
/* Esta es la forma correcta de iterar sobre el directorio. */
while (false !== ($entrada = readdir($gestor))) {
echo "$entrada\n";
/* Esta es la forma correcta de recorrer un directorio. */
while (false !== ($entry = readdir($handle))) {
echo "$entry\n";
}
/* Esta es la forma errónea de iterar sobre el directorio. */
while ($entrada = readdir($gestor)) {
echo "$entrada\n";
/* Esta es la FORMA INCORRECTA de recorrer un directorio. */
while ($entry = readdir($handle)) {
echo "$entry\n";
}
closedir($gestor);
closedir($handle);
}
?>
]]>
@@ -90,19 +110,19 @@ if ($gestor = opendir('/path/to/files')) {
<para>
<example>
<title>
Listar todas las entradas del directorio actual y descartar <literal>.</literal>
y <literal>..</literal>
Lista todas las entradas del directorio actual y elimina los
<literal>.</literal> y <literal>..</literal>
</title>
<programlisting role="php">
<![CDATA[
<?php
if ($gestor = opendir('.')) {
while (false !== ($entrada = readdir($gestor))) {
if ($entrada != "." && $entrada != "..") {
echo "$entrada\n";
if ($handle = opendir('.')) {
while (false !== ($entry = readdir($handle))) {
if ($entry != "." && $entry != "..") {
echo "$entry\n";
}
}
closedir($gestor);
closedir($handle);
}
?>
]]>
@@ -110,7 +130,7 @@ if ($gestor = opendir('.')) {
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -123,7 +143,6 @@ if ($gestor = opendir('.')) {
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

53
reference/dir/functions/rewinddir.xml
View File

@@ -1,53 +1,72 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 297028 -->
<!-- EN-Revision: e41806c30bf6975e452c0d4ce35ab0984c2fa68c Maintainer: tkzexe Status: ready -->
<!-- EN-Revision: b0b19b66183b28cebc1ffbcf1e2b8763f9d9c7b3 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<!-- splitted from ./en/functions/dir.xml, last change in rev 1.2 -->
<refentry xml:id="function.rewinddir" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>rewinddir</refname>
<refpurpose>Regresar el gestor de directorio</refpurpose>
<refpurpose>Retorna al primer elemento del directorio</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>void</type><methodname>rewinddir</methodname>
<methodparam choice="opt"><type>resource</type><parameter>dir_handle</parameter></methodparam>
<methodparam choice="opt"><type class="union"><type>resource</type><type>null</type></type><parameter>dir_handle</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
Restablece la secuencia de directorio indicada por
<parameter>gestor_dir</parameter> al comienzo del directorio.
<function>rewinddir</function> retorna al primer
elemento del directorio identificado por <parameter>dir_handle</parameter>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>gestor_dir</parameter></term>
<term><parameter>dir_handle</parameter></term>
<listitem>
<para>
El gestor de directorio tipo <type>resource</type> abierto previamente con <function>opendir</function>.
Si el gestor de directorio no se especifica, la ultima conexión abierta por <function>opendir</function>
es asumida.
El &resource; de directorio abierto previamente con
<function>opendir</function>. Si no se proporciona el recurso de directorio,
se utilizará el último recurso abierto con la función
<function>opendir</function>.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.nullorfalse;
&return.void;
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
<parameter>context</parameter> ahora es nulo.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

121
reference/dir/functions/scandir.xml
View File

@@ -1,28 +1,27 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 297028 -->
<!-- EN-Revision: 9e9c6ea115e3893ba17548ed8d3e0aa4a0ecc8a1 Maintainer: chuso Status: ready -->
<!-- Reviewed: yes Maintainer: seros -->
<!-- EN-Revision: 3f63f2b26300dd0c15d5635b8053e67448076146 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.scandir" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>scandir</refname>
<refpurpose>Enumera los ficheros y directorios ubicados en la ruta especificada</refpurpose>
<refpurpose>
Lista los ficheros y directorios en un directorio
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>array</type><methodname>scandir</methodname>
<type class="union"><type>array</type><type>false</type></type><methodname>scandir</methodname>
<methodparam><type>string</type><parameter>directory</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>sorting_order</parameter><initializer>SCANDIR_SORT_ASCENDING</initializer></methodparam>
<methodparam choice="opt"><type>resource</type><parameter>context</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>sorting_order</parameter><initializer><constant>SCANDIR_SORT_ASCENDING</constant></initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>resource</type><type>null</type></type><parameter>context</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
Devuelve un <type>array</type> con los ficheros y los directorios que se encuentran bajo
<parameter>directory</parameter>.
Devuelve un array de ficheros y directorios, provenientes de <parameter>directory</parameter>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
@@ -31,7 +30,7 @@
<term><parameter>directory</parameter></term>
<listitem>
<para>
El directorio que será examinado.
El directorio que será analizado.
</para>
</listitem>
</varlistentry>
@@ -39,11 +38,12 @@
<term><parameter>sorting_order</parameter></term>
<listitem>
<para>
Por omisión, se ordena alfabéticamente en sentido ascendente. Si se utiliza
el parámetro opcional <parameter>sorting_order</parameter> con el valor
<constant>SCANDIR_SORT_DESCENDING</constant>, entonces se ordenará alfabéticamente en
sentido descendente. Si se asigna
<constant>SCANDIR_SORT_NONE</constant> entonces el resultado no se ordena.
Por omisión, el orden es alfabético ascendente. Si el parámetro
opcional <parameter>sorting_order</parameter> es definido a
<constant>SCANDIR_SORT_DESCENDING</constant>, entonces el orden será
alfabético descendente. Si este parámetro es definido a
<constant>SCANDIR_SORT_NONE</constant>, entonces el resultado no será
ordenado.
</para>
</listitem>
</varlistentry>
@@ -51,68 +51,62 @@
<term><parameter>context</parameter></term>
<listitem>
<para>
Para una descripción del parámetro <parameter>context</parameter>,
consulte la <link linkend="ref.stream">sección de flujos</link>
Para una descripción del parámetro <parameter>context</parameter>,
consulte la <link linkend="ref.stream">sección flujo de datos</link>
del manual.
</para>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve un <type>array</type> con los nombres de los ficheros en caso de éxito, o &false; en
caso de error. Si <parameter>directory</parameter> no es un directorio, entonces
se devuelve &false;, y se genera un error de nivel
Devuelve un array de ficheros en caso de éxito o &false; en caso de
fallo. Si <parameter>directory</parameter> no es un directorio, entonces
se devuelve un valor booleano &false; y se genera un error de nivel
<constant>E_WARNING</constant>.
</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>5.4.0</entry>
<entry>
Se añadieron las <link linkend="dir.constants">constantes</link> de <parameter>sorting_order</parameter>.
En versiones anteriores, cualquir valor distinto de cero ocasionaba un ordenamiento descendente. Por lo tanto,
para todas las versiones de PHP, use <literal>0</literal> para el orden ascendente, y <literal>1</literal>
para el orden descendente. No existía una opción para el comportamiento de <constant>SCANDIR_SORT_NONE</constant>
antes de PHP 5.4.0.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
<parameter>context</parameter> ahora es nullable.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Un simple ejemplo de <function>scandir</function></title>
<title>Un simple ejemplo con <function>scandir</function></title>
<programlisting role="php">
<![CDATA[
<?php
$directorio = '/tmp';
$ficheros1 = scandir($directorio);
$ficheros2 = scandir($directorio, 1);
print_r($ficheros1);
print_r($ficheros2);
$dir = '/tmp';
$files1 = scandir($dir);
$files2 = scandir($dir, SCANDIR_SORT_DESCENDING);
print_r($files1);
print_r($files2);
?>
]]>
</programlisting>
@@ -140,12 +134,12 @@ Array
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
&tip.fopen-wrapper;
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -159,7 +153,6 @@ Array
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

90
reference/dom/book.xml
View File

@@ -1,17 +1,17 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 9b18516d6feb02d12056f8c7e88d0e83082e2e79 Maintainer: seros Status: ready -->
<!-- Reviewed: yes Maintainer: seros -->
<book xml:id="book.dom" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: c1f37a6c270aadbbb3da56a3973ffd62197adf2b Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<!-- CREDITS: DavidA -->
<book xml:id="book.dom" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="interactive">
<?phpdoc extension-membership="bundledexternal" ?>
<title>Modelo de Objetos de Documento</title>
<title>Modelo Objeto de un Documento</title>
<titleabbrev>DOM</titleabbrev>
<preface xml:id="intro.dom">
&reftitle.intro;
<para>
La extension DOM (siglas en inglés de Document Object Model)
permite manipular documentos XML mediante la API DOM con PHP.
La extensión DOM permite realizar operaciones sobre documentos XML y HTML
mediante la API DOM de PHP.
</para>
&dom.note.utf8;
</preface>
@@ -43,55 +43,37 @@
&reference.dom.domtext;
&reference.dom.domxpath;
<!-- FIXME:
<section xml:id="dom.class.domnamelist">
<title><classname>DOMNameList</classname></title>
<para>
</para>
<section xml:id="dom.class.domnamelist.methods">
&reftitle.methods;
<itemizedlist>
<listitem>
<para><xref linkend='function.dom-domnamelist-getname' /> - </para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domnamelist-getnamespaceuri' /> - </para>
</listitem>
</itemizedlist>
</section>
<section xml:id="dom.class.domnamelist.properties">
&reftitle.properties;
<table>
<title/>
<tgroup cols="4">
<thead>
<row>
<entry>Name</entry>
<entry>Type</entry>
<entry>Read-only</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>length</entry>
<entry>int</entry>
<entry>yes</entry>
<entry>
The number of pairs (name and namespaceURI) in the list. The range
of valid child node indices is 0 to <literal>length - 1</literal>
inclusive.
</entry>
</row>
</tbody>
</tgroup>
</table>
</section>
</section>-->
&reference.dom.dom.dom-adjacentposition;
&reference.dom.dom.dom-attr;
&reference.dom.dom.dom-cdatasection;
&reference.dom.dom.dom-characterdata;
&reference.dom.dom.dom-childnode;
&reference.dom.dom.dom-comment;
&reference.dom.dom.dom-document;
&reference.dom.dom.dom-documentfragment;
&reference.dom.dom.dom-documenttype;
&reference.dom.dom.dom-dtdnamednodemap;
&reference.dom.dom.dom-element;
&reference.dom.dom.dom-entity;
&reference.dom.dom.dom-entityreference;
&reference.dom.dom.dom-htmlcollection;
&reference.dom.dom.dom-htmldocument;
&reference.dom.dom.dom-htmlelement;
&reference.dom.dom.dom-implementation;
&reference.dom.dom.dom-namednodemap;
&reference.dom.dom.dom-namespaceinfo;
&reference.dom.dom.dom-node;
&reference.dom.dom.dom-nodelist;
&reference.dom.dom.dom-notation;
&reference.dom.dom.dom-parentnode;
&reference.dom.dom.dom-processinginstruction;
&reference.dom.dom.dom-text;
&reference.dom.dom.dom-tokenlist;
&reference.dom.dom.dom-xmldocument;
&reference.dom.dom.dom-xpath;
<reference xml:id="ref.dom" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>&Functions; de DOM</title>
<title>DOM &Functions;</title>
&reference.dom.entities.functions;
</reference>

678
reference/dom/constants.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 37280533a76693adac626a37ffc8daa2276400ce Maintainer: sabathorn Status: ready -->
<!-- Reviewed: no -->
<!-- EN-Revision: a8b6f4dd3a23875b066d4e47ea4a4977a63e0655 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<chapter xml:id="dom.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
&extension.constants;
@@ -9,9 +9,9 @@
<tgroup cols="3">
<thead>
<row>
<entry>Constante</entry>
<entry>&Constants;</entry>
<entry>Valor</entry>
<entry>Descripción</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
@@ -21,401 +21,447 @@
(<type>int</type>)
</entry>
<entry>1</entry>
<entry>Nodo es un <classname>DOMElement</classname></entry>
<entry>El nodo es un <classname>DOMElement</classname> / <classname>Dom\Element</classname></entry>
</row>
<row xml:id="constant.xml-attribute-node">
<entry>
<constant>XML_ATTRIBUTE_NODE</constant>
(<type>int</type>)
</entry>
<entry>2</entry>
<entry>Nodo es un <classname>DOMAttr</classname></entry>
</row>
<row xml:id="constant.xml-text-node">
<entry>
<constant>XML_TEXT_NODE</constant>
(<type>int</type>)
</entry>
<entry>3</entry>
<entry>Nodo es un <classname>DOMText</classname></entry>
</row>
<row xml:id="constant.xml-cdata-section-node">
<entry>
<constant>XML_CDATA_SECTION_NODE</constant>
(<type>int</type>)
</entry>
<entry>4</entry>
<entry>Nodo es un <classname>DOMCharacterData</classname></entry>
</row>
<row xml:id="constant.xml-entity-ref-node">
<entry>
<constant>XML_ENTITY_REF_NODE</constant>
(<type>int</type>)
</entry>
<entry>5</entry>
<entry>Nodo es un <classname>DOMEntityReference</classname></entry>
</row>
<row xml:id="constant.xml-entity-node">
<entry>
<constant>XML_ENTITY_NODE</constant>
(<type>int</type>)
</entry>
<entry>6</entry>
<entry>Nodo es un <classname>DOMEntity</classname></entry>
</row>
<row xml:id="constant.xml-pi-node">
<entry>
<constant>XML_PI_NODE</constant>
(<type>int</type>)
</entry>
<entry>7</entry>
<entry>Nodo es un <classname>DOMProcessingInstruction</classname></entry>
</row>
<row xml:id="constant.xml-comment-node">
<entry>
<constant>XML_COMMENT_NODE</constant>
(<type>int</type>)
</entry>
<entry>8</entry>
<entry>Nodo es un <classname>DOMComment</classname></entry>
</row>
<row xml:id="constant.xml-document-node">
<entry>
<constant>XML_DOCUMENT_NODE</constant>
(<type>int</type>)
</entry>
<entry>9</entry>
<entry>Nodo es un <classname>DOMDocument</classname></entry>
</row>
<row xml:id="constant.xml-document-type-node">
<entry>
<constant>XML_DOCUMENT_TYPE_NODE</constant>
(<type>int</type>)
</entry>
<entry>10</entry>
<entry>Nodo es un <classname>DOMDocumentType</classname></entry>
</row>
<row xml:id="constant.xml-document-frag-node">
<entry>
<constant>XML_DOCUMENT_FRAG_NODE</constant>
(<type>int</type>)
</entry>
<entry>11</entry>
<entry>Nodo es un <classname>DOMDocumentFragment</classname></entry>
</row>
<row xml:id="constant.xml-notation-node">
<entry>
<constant>XML_NOTATION_NODE</constant>
(<type>int</type>)
</entry>
<entry>12</entry>
<entry>Nodo es un <classname>DOMNotation</classname></entry>
</row>
<row xml:id="constant.xml-html-document-node">
<entry>
<constant>XML_HTML_DOCUMENT_NODE</constant>
(<type>int</type>)
</entry>
<entry>13</entry>
<entry/>
</row>
<row xml:id="constant.xml-dtd-node">
<entry>
<constant>XML_DTD_NODE</constant>
(<type>int</type>)
</entry>
<entry>14</entry>
<entry/>
</row>
<row xml:id="constant.xml-element-decl-node">
<entry>
<constant>XML_ELEMENT_DECL_NODE</constant>
(<type>int</type>)
</entry>
<entry>15</entry>
<entry/>
</row>
<row xml:id="constant.xml-attribute-decl-node">
<entry>
<constant>XML_ATTRIBUTE_DECL_NODE</constant>
(<type>int</type>)
</entry>
<entry>16</entry>
<entry/>
</row>
<row xml:id="constant.xml-entity-decl-node">
<entry>
<constant>XML_ENTITY_DECL_NODE</constant>
(<type>int</type>)
</entry>
<entry>17</entry>
<entry/>
</row>
<row xml:id="constant.xml-namespace-decl-node">
<entry>
<constant>XML_NAMESPACE_DECL_NODE</constant>
(<type>int</type>)
</entry>
<entry>18</entry>
<entry/>
</row>
<row xml:id="constant.xml-attribute-cdata">
<entry>
<constant>XML_ATTRIBUTE_CDATA</constant>
(<type>int</type>)
</entry>
<entry>1</entry>
<entry/>
</row>
<row xml:id="constant.xml-attribute-id">
<entry>
<constant>XML_ATTRIBUTE_ID</constant>
(<type>int</type>)
</entry>
<entry>2</entry>
<entry/>
</row>
<row xml:id="constant.xml-attribute-idref">
<entry>
<constant>XML_ATTRIBUTE_IDREF</constant>
(<type>int</type>)
</entry>
<entry>3</entry>
<entry/>
</row>
<row xml:id="constant.xml-attribute-idrefs">
<entry>
<constant>XML_ATTRIBUTE_IDREFS</constant>
(<type>int</type>)
</entry>
<entry>4</entry>
<entry/>
</row>
<row xml:id="constant.xml-attribute-entity">
<entry>
<constant>XML_ATTRIBUTE_ENTITY</constant>
(<type>int</type>)
</entry>
<entry>5</entry>
<entry/>
</row>
<row xml:id="constant.xml-attribute-nmtoken">
<entry>
<constant>XML_ATTRIBUTE_NMTOKEN</constant>
(<type>int</type>)
</entry>
<entry>7</entry>
<entry/>
</row>
<row xml:id="constant.xml-attribute-nmtokens">
<entry>
<constant>XML_ATTRIBUTE_NMTOKENS</constant>
(<type>int</type>)
</entry>
<entry>8</entry>
<entry/>
</row>
<row xml:id="constant.xml-attribute-enumeration">
<entry>
<constant>XML_ATTRIBUTE_ENUMERATION</constant>
(<type>int</type>)
</entry>
<entry>9</entry>
<entry/>
</row>
<row xml:id="constant.xml-attribute-notation">
<entry>
<constant>XML_ATTRIBUTE_NOTATION</constant>
(<type>int</type>)
</entry>
<entry>10</entry>
<entry/>
</row>
</tbody>
</tgroup>
</table>
<table>
<title>DOMException constantes</title>
<tgroup cols="3">
<thead>
<row>
<entry>Constante</entry>
<entry>Valor</entry>
<entry>Descripción</entry>
</row>
</thead>
<tbody>
<row xml:id="constant.dom-php-err">
<entry>
<constant>DOM_PHP_ERR</constant>
(<type>int</type>)
</entry>
<entry>0</entry>
<entry>
El código de Error no forma parte de la especificación DOM. Significado para errores PHP.
</entry>
</row>
<row xml:id="constant.dom-index-size-err">
<entry>
<constant>DOM_INDEX_SIZE_ERR</constant>
(<type>int</type>)
</entry>
<entry>1</entry>
<entry>
Si el índice o el tamaño es negativo, o mayor que el valor permitido.
</entry>
</row>
<row xml:id="constant.domstring-size-err">
<entry>
<constant>DOMSTRING_SIZE_ERR</constant>
(<type>int</type>)
</entry>
<entry>2</entry>
<entry>
Si el rango especificado de texto no cabe en un
<classname>DOMString</classname>.
</entry>
<entry>El nodo es un <classname>DOMAttr</classname> / <classname>Dom\Attr</classname></entry>
</row>
<row xml:id="constant.dom-hierarchy-request-err">
<row xml:id="constant.xml-text-node">
<entry>
<constant>DOM_HIERARCHY_REQUEST_ERR</constant>
<constant>XML_TEXT_NODE</constant>
(<type>int</type>)
</entry>
<entry>3</entry>
<entry>Si un nodo es insertado en un lugar al que no pertenece</entry>
<entry>El nodo es un <classname>DOMText</classname> / <classname>Dom\Text</classname></entry>
</row>
<row xml:id="constant.dom-wrong-document-err">
<row xml:id="constant.xml-cdata-section-node">
<entry>
<constant>DOM_WRONG_DOCUMENT_ERR</constant>
<constant>XML_CDATA_SECTION_NODE</constant>
(<type>int</type>)
</entry>
<entry>4</entry>
<entry>
Si un nodo es usado en un documento diferente al que lo creó.
</entry>
<entry>El nodo es un <classname>DOMCharacterData</classname> / <classname>Dom\CharacterData</classname></entry>
</row>
<row xml:id="constant.dom-invalid-character-err">
<row xml:id="constant.xml-entity-ref-node">
<entry>
<constant>DOM_INVALID_CHARACTER_ERR</constant>
<constant>XML_ENTITY_REF_NODE</constant>
(<type>int</type>)
</entry>
<entry>5</entry>
<entry>
Si un carácter ilegal o inválido es especificado, como en un nombre.
</entry>
<entry>El nodo es un <classname>DOMEntityReference</classname> / <classname>Dom\EntityReference</classname></entry>
</row>
<row xml:id="constant.dom-no-data-allowed-err">
<row xml:id="constant.xml-entity-node">
<entry>
<constant>DOM_NO_DATA_ALLOWED_ERR</constant>
<constant>XML_ENTITY_NODE</constant>
(<type>int</type>)
</entry>
<entry>6</entry>
<entry>
Si la data es especificada para un nodo que no la soporta.
</entry>
<entry>El nodo es un <classname>DOMEntity</classname> / <classname>Dom\Entity</classname></entry>
</row>
<row xml:id="constant.dom-no-modification-allowed-err">
<row xml:id="constant.xml-pi-node">
<entry>
<constant>DOM_NO_MODIFICATION_ALLOWED_ERR</constant>
<constant>XML_PI_NODE</constant>
(<type>int</type>)
</entry>
<entry>7</entry>
<entry>
Si se intenta modificar un objeto donde las modificaciones no están permitidas.
</entry>
<entry>El nodo es un <classname>DOMProcessingInstruction</classname> / <classname>Dom\ProcessingInstruction</classname></entry>
</row>
<row xml:id="constant.dom-not-found-err">
<row xml:id="constant.xml-comment-node">
<entry>
<constant>DOM_NOT_FOUND_ERR</constant>
<constant>XML_COMMENT_NODE</constant>
(<type>int</type>)
</entry>
<entry>8</entry>
<entry>
Si se intenta referenciar un nodo en un contexto en el que no existe.
</entry>
<entry>El nodo es un <classname>DOMComment</classname> / <classname>Dom\Comment</classname></entry>
</row>
<row xml:id="constant.dom-not-supported-err">
<row xml:id="constant.xml-document-node">
<entry>
<constant>DOM_NOT_SUPPORTED_ERR</constant>
<constant>XML_DOCUMENT_NODE</constant>
(<type>int</type>)
</entry>
<entry>9</entry>
<entry>
Si la implementación no soporta el tipo de objeto u operación solicitado.
</entry>
<entry>El nodo es un <classname>DOMDocument</classname> / <classname>Dom\Document</classname></entry>
</row>
<row xml:id="constant.dom-inuse-attribute-err">
<row xml:id="constant.xml-document-type-node">
<entry>
<constant>DOM_INUSE_ATTRIBUTE_ERR</constant>
<constant>XML_DOCUMENT_TYPE_NODE</constant>
(<type>int</type>)
</entry>
<entry>10</entry>
<entry>
Si se intenta agregar un atributo que esta siendo usado en otro lugar.
</entry>
<entry>El nodo es un <classname>DOMDocumentType</classname> / <classname>Dom\DocumentType</classname></entry>
</row>
<row xml:id="constant.dom-invalid-state-err">
<row xml:id="constant.xml-document-frag-node">
<entry>
<constant>DOM_INVALID_STATE_ERR</constant>
<constant>XML_DOCUMENT_FRAG_NODE</constant>
(<type>int</type>)
</entry>
<entry>11</entry>
<entry>
Si se intenta utilizar un objeto que no es o ha dejado de ser usable.
</entry>
<entry>El nodo es un <classname>DOMDocumentFragment</classname> / <classname>Dom\DocumentFragment</classname></entry>
</row>
<row xml:id="constant.dom-syntax-err">
<row xml:id="constant.xml-notation-node">
<entry>
<constant>DOM_SYNTAX_ERR</constant>
<constant>XML_NOTATION_NODE</constant>
(<type>int</type>)
</entry>
<entry>12</entry>
<entry>Si una cadena ilegal o inválida es especificada.</entry>
<entry>El nodo es un <classname>DOMNotation</classname> / <classname>Dom\Notation</classname></entry>
</row>
<row xml:id="constant.dom-invalid-modification-err">
<row xml:id="constant.xml-html-document-node">
<entry>
<constant>DOM_INVALID_MODIFICATION_ERR</constant>
<constant>XML_HTML_DOCUMENT_NODE</constant>
(<type>int</type>)
</entry>
<entry>13</entry>
<entry>Si se intenta modificar el tipo de dato del objeto subyacente.</entry>
<entry/>
</row>
<row xml:id="constant.dom-namespace-err">
<row xml:id="constant.xml-dtd-node">
<entry>
<constant>DOM_NAMESPACE_ERR</constant>
<constant>XML_DTD_NODE</constant>
(<type>int</type>)
</entry>
<entry>14</entry>
<entry>
Si se intenta crear o modificar un objeto de una manera que es incorrecta
con respecto a su espacio de nombre (namespace).
</entry>
<entry/>
</row>
<row xml:id="constant.dom-invalid-access-err">
<row xml:id="constant.xml-element-decl-node">
<entry>
<constant>DOM_INVALID_ACCESS_ERR</constant>
<constant>XML_ELEMENT_DECL_NODE</constant>
(<type>int</type>)
</entry>
<entry>15</entry>
<entry>
Si un parámetro u operación no es soportado por el objeto subyacente.
</entry>
<entry/>
</row>
<row xml:id="constant.dom-validation-err">
<row xml:id="constant.xml-attribute-decl-node">
<entry>
<constant>DOM_VALIDATION_ERR</constant>
<constant>XML_ATTRIBUTE_DECL_NODE</constant>
(<type>int</type>)
</entry>
<entry>16</entry>
<entry/>
</row>
<row xml:id="constant.xml-entity-decl-node">
<entry>
Si la llamada a un método como insertBefore o removeChild invalidará el Nodo
con respecto a la "validez parcial", esta excepción sera lanzada y la operación
no se realizará.
<constant>XML_ENTITY_DECL_NODE</constant>
(<type>int</type>)
</entry>
<entry>17</entry>
<entry/>
</row>
<row xml:id="constant.xml-namespace-decl-node">
<entry>
<constant>XML_NAMESPACE_DECL_NODE</constant>
(<type>int</type>)
</entry>
<entry>18</entry>
<entry/>
</row>
<row xml:id="constant.xml-attribute-cdata">
<entry>
<constant>XML_ATTRIBUTE_CDATA</constant>
(<type>int</type>)
</entry>
<entry>1</entry>
<entry/>
</row>
<row xml:id="constant.xml-attribute-id">
<entry>
<constant>XML_ATTRIBUTE_ID</constant>
(<type>int</type>)
</entry>
<entry>2</entry>
<entry/>
</row>
<row xml:id="constant.xml-attribute-idref">
<entry>
<constant>XML_ATTRIBUTE_IDREF</constant>
(<type>int</type>)
</entry>
<entry>3</entry>
<entry/>
</row>
<row xml:id="constant.xml-attribute-idrefs">
<entry>
<constant>XML_ATTRIBUTE_IDREFS</constant>
(<type>int</type>)
</entry>
<entry>4</entry>
<entry/>
</row>
<row xml:id="constant.xml-attribute-entity">
<entry>
<constant>XML_ATTRIBUTE_ENTITY</constant>
(<type>int</type>)
</entry>
<entry>5</entry>
<entry/>
</row>
<row xml:id="constant.xml-attribute-nmtoken">
<entry>
<constant>XML_ATTRIBUTE_NMTOKEN</constant>
(<type>int</type>)
</entry>
<entry>7</entry>
<entry/>
</row>
<row xml:id="constant.xml-attribute-nmtokens">
<entry>
<constant>XML_ATTRIBUTE_NMTOKENS</constant>
(<type>int</type>)
</entry>
<entry>8</entry>
<entry/>
</row>
<row xml:id="constant.xml-attribute-enumeration">
<entry>
<constant>XML_ATTRIBUTE_ENUMERATION</constant>
(<type>int</type>)
</entry>
<entry>9</entry>
<entry/>
</row>
<row xml:id="constant.xml-attribute-notation">
<entry>
<constant>XML_ATTRIBUTE_NOTATION</constant>
(<type>int</type>)
</entry>
<entry>10</entry>
<entry/>
</row>
<row xml:id="constant.xml-local-namespace">
<entry>
<constant>XML_LOCAL_NAMESPACE</constant>
(<type>int</type>)
</entry>
<entry></entry>
<entry>Un nodo de declaración de espacio de nombres.</entry>
</row>
</tbody>
</tgroup>
</table>
<table>
<title>Constantes HTML</title>
<tgroup cols="3">
<thead>
<row>
<entry>&Constants;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row xml:id="constant.dom-html-no-default-ns">
<entry>
<constant>Dom\HTML_NO_DEFAULT_NS</constant>
(<type>int</type>)
</entry>
<entry>
<simpara>
Esto desactiva la definición del espacio de nombres de los elementos durante el análisis
al utilizar <classname>Dom\HTMLDocument</classname>.
Esto existe para la compatibilidad ascendente con
<classname>DOMDocument</classname>.
</simpara>
<caution>
<simpara>
Algunos métodos DOM dependen de la definición del espacio de nombres
<acronym>HTML</acronym>.
Al utilizar esta opción del analizador, el comportamiento de estos métodos puede ser
influenciado.
</simpara>
</caution>
</entry>
</row>
</tbody>
</tgroup>
</table>
<table>
<title>Constantes <classname>DOMException</classname> / <classname>Dom\Exception</classname></title>
<tgroup cols="3">
<thead>
<row>
<entry>&Constants;</entry>
<entry>Valor</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row xml:id="constant.dom-php-err">
<entry>
<constant>DOM_PHP_ERR</constant>
(<type>int</type>)
</entry>
<entry>0</entry>
<entry>
Código de error que no forma parte de la especificación DOM. Destinado a errores PHP.
Deprecado a partir de PHP 8.4.0 ya que ya no se utiliza.
Antes de PHP 8.4.0, se utilizaba de manera inconsistente para indicar
situaciones de falta de memoria.
</entry>
</row>
<row xml:id="constant.dom-index-size-err">
<entry>
<constant>DOM_INDEX_SIZE_ERR</constant> / <constant>Dom\INDEX_SIZE_ERR</constant>
(<type>int</type>)
</entry>
<entry>1</entry>
<entry>
Si el índice o el tamaño es negativo, o superior al valor permitido.
</entry>
</row>
<row xml:id="constant.domstring-size-err">
<entry>
<constant>DOMSTRING_SIZE_ERR</constant> / <constant>Dom\STRING_SIZE_ERR</constant>
(<type>int</type>)
</entry>
<entry>2</entry>
<entry>
Si el rango de texto especificado no cabe en una
<type>string</type>.
</entry>
</row>
<row xml:id="constant.dom-hierarchy-request-err">
<entry>
<constant>DOM_HIERARCHY_REQUEST_ERR</constant> / <constant>Dom\HIERARCHY_REQUEST_ERR</constant>
(<type>int</type>)
</entry>
<entry>3</entry>
<entry>Si un nodo es insertado en un lugar donde no tiene cabida</entry>
</row>
<row xml:id="constant.dom-wrong-document-err">
<entry>
<constant>DOM_WRONG_DOCUMENT_ERR</constant> / <constant>Dom\WRONG_DOCUMENT_ERR</constant>
(<type>int</type>)
</entry>
<entry>4</entry>
<entry>
Si un nodo es utilizado en un documento diferente al que lo creó.
</entry>
</row>
<row xml:id="constant.dom-invalid-character-err">
<entry>
<constant>DOM_INVALID_CHARACTER_ERR</constant> / <constant>Dom\INVALID_CHARACTER_ERR</constant>
(<type>int</type>)
</entry>
<entry>5</entry>
<entry>
Si se especifica un carácter inválido o ilegal, como en un nombre.
</entry>
</row>
<row xml:id="constant.dom-no-data-allowed-err">
<entry>
<constant>DOM_NO_DATA_ALLOWED_ERR</constant> / <constant>Dom\NO_DATA_ALLOWED_ERR</constant>
(<type>int</type>)
</entry>
<entry>6</entry>
<entry>
Si se especifican datos para un nodo que no soporta datos.
</entry>
</row>
<row xml:id="constant.dom-no-modification-allowed-err">
<entry>
<constant>DOM_NO_MODIFICATION_ALLOWED_ERR</constant> / <constant>Dom\NO_MODIFICATION_ALLOWED_ERR</constant>
(<type>int</type>)
</entry>
<entry>7</entry>
<entry>
Si se intenta modificar un objeto cuando las modificaciones no están permitidas.
</entry>
</row>
<row xml:id="constant.dom-not-found-err">
<entry>
<constant>DOM_NOT_FOUND_ERR</constant> / <constant>Dom\NOT_FOUND_ERR</constant>
(<type>int</type>)
</entry>
<entry>8</entry>
<entry>
Si se intenta referenciar un nodo en un contexto donde no existe.
</entry>
</row>
<row xml:id="constant.dom-not-supported-err">
<entry>
<constant>DOM_NOT_SUPPORTED_ERR</constant> / <constant>Dom\NOT_SUPPORTED_ERR</constant>
(<type>int</type>)
</entry>
<entry>9</entry>
<entry>
Si la implementación no soporta el tipo de objeto o la operación solicitada.
</entry>
</row>
<row xml:id="constant.dom-inuse-attribute-err">
<entry>
<constant>DOM_INUSE_ATTRIBUTE_ERR</constant> / <constant>Dom\INUSE_ATTRIBUTE_ERR</constant>
(<type>int</type>)
</entry>
<entry>10</entry>
<entry>
Si se intenta añadir un atributo que ya está siendo utilizado en otro lugar.
</entry>
</row>
<row xml:id="constant.dom-invalid-state-err">
<entry>
<constant>DOM_INVALID_STATE_ERR</constant> / <constant>Dom\INVALID_STATE_ERR</constant>
(<type>int</type>)
</entry>
<entry>11</entry>
<entry>
Si se intenta utilizar un objeto que no es, o ya no es, utilizable.
</entry>
</row>
<row xml:id="constant.dom-syntax-err">
<entry>
<constant>DOM_SYNTAX_ERR</constant> / <constant>Dom\SYNTAX_ERR</constant>
(<type>int</type>)
</entry>
<entry>12</entry>
<entry>Si se especifica una cadena de caracteres inválida o ilegal.</entry>
</row>
<row xml:id="constant.dom-invalid-modification-err">
<entry>
<constant>DOM_INVALID_MODIFICATION_ERR</constant> / <constant>Dom\INVALID_MODIFICATION_ERR</constant>
(<type>int</type>)
</entry>
<entry>13</entry>
<entry>Si se intenta modificar el tipo del objeto subyacente.</entry>
</row>
<row xml:id="constant.dom-namespace-err">
<entry>
<constant>DOM_NAMESPACE_ERR</constant> / <constant>Dom\NAMESPACE_ERR</constant>
(<type>int</type>)
</entry>
<entry>14</entry>
<entry>
Si se intenta crear o modificar un objeto de manera incorrecta
con respecto a los espacios de nombres.
</entry>
</row>
<row xml:id="constant.dom-invalid-access-err">
<entry>
<constant>DOM_INVALID_ACCESS_ERR</constant> / <constant>Dom\INVALID_ACCESS_ERR</constant>
(<type>int</type>)
</entry>
<entry>15</entry>
<entry>
Si un parámetro o una operación no es soportada por el objeto subyacente.
</entry>
</row>
<row xml:id="constant.dom-validation-err">
<entry>
<constant>DOM_VALIDATION_ERR</constant> / <constant>Dom\VALIDATION_ERR</constant>
(<type>int</type>)
</entry>
<entry>16</entry>
<entry>
Si una llamada a un método como insertBefore o removeChild haría que el nodo
fuera inválido con respecto a la "valididad parcial", se lanzaría esta excepción y
la operación no se realizaría.
</entry>
</row>
</tbody>
</tgroup>
</table>
</chapter>
<!-- Keep this comment at the end of the file
Local variables:

23
reference/dom/domattr/construct.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4f5e2b22575131fa5e9c3004b1c874e1acb06573 Maintainer: chuso Status: ready -->
<!-- Reviewed: no -->
<!-- EN-Revision: d6f54016d62904cfd8200604aadd5e3f0d9bad97 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="domattr.construct" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>DOMAttr::__construct</refname>
@@ -14,11 +14,10 @@
<methodparam choice="opt"><type>string</type><parameter>value</parameter><initializer>""</initializer></methodparam>
</constructorsynopsis>
<para>
Crea un nuevo objeto DOMAttr. Este objeto es de sólo lectura.
Puede ser anexado a un documento, pero no se le podrán anexar
nodos adicionales a este hasta que sea asociado con un documento.
Para crear un nodo modificable utilice
<xref linkend="domdocument.createattribute"/>.
Crea un nuevo objeto <classname>DOMAttr</classname>.
Este objeto es de solo lectura. Puede ser añadido a un documento, pero los
nodos adicionales no pueden ser añadidos a este nodo mientras este nodo esté asociado a un documento. Para crear un nodo accesible en escritura,
utilice <xref linkend="domdocument.createattribute"/>.
</para>
</refsect1>
<refsect1 role="parameters">
@@ -29,7 +28,7 @@
<term><parameter>name</parameter></term>
<listitem>
<para>
El nombre de etiqueta del atributo.
El nombre del atributo.
</para>
</listitem>
</varlistentry>
@@ -37,7 +36,7 @@
<term><parameter>value</parameter></term>
<listitem>
<para>
El valor de atributo.
El valor del atributo.
</para>
</listitem>
</varlistentry>
@@ -53,7 +52,7 @@
<![CDATA[
<?php
$dom = new DOMDocument('1.0', 'iso-8859-1');
$dom = new DOMDocument('1.0', 'utf-8');
$element = $dom->appendChild(new DOMElement('root'));
$attr = $element->setAttributeNode(new DOMAttr('attr', 'attrvalue'));
echo $dom->saveXML();
@@ -64,8 +63,8 @@ echo $dom->saveXML();
&example.outputs;
<screen>
<![CDATA[
<?xml version="1.0" encoding="utf-8"?>
<root attr="attrvalue" />
<?xml version="1.0" encoding="iso-8859-1"?>
<root attr="attrvalue"/>
]]>
</screen>
</example>

31
reference/dom/domattr/isid.xml
View File

@@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4f5e2b22575131fa5e9c3004b1c874e1acb06573 Maintainer: jpberdejo Status: ready -->
<!-- Reviewed: no Maintainer: andresdzphp -->
<!-- EN-Revision: c1f37a6c270aadbbb3da56a3973ffd62197adf2b Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="domattr.isid" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>DOMAttr::isId</refname>
<refpurpose>
Verifica si un atributo es un ID definido.
Verifica si el atributo es un identificador definido
</refpurpose>
</refnamediv>
<refsect1 role="description">
@@ -15,13 +15,14 @@
<void/>
</methodsynopsis>
<para>
Esta función verifica si el atributo es un ID definido.
Esta función verifica si el atributo es un identificador definido.
</para>
<para>
De acuerdo al estándar DOM esto requiere una DTD que defina que el atributo ID
sea de tipo ID. Necesitará validar su documento con
De acuerdo con el estándar DOM, esto requiere un DTD que defina
el atributo ID que sea del tipo ID. Se debe validar el documento con la función
<xref linkend="domdocument.validate"/>
o <literal>DOMDocument::validateOnParse</literal> antes de utilizar esta función.
o la propiedad <property>DOMDocument::$validateOnParse</property> antes de utilizar
esta función.
</para>
</refsect1>
@@ -32,26 +33,26 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
<simpara>
Devuelve &true; si este atributo es un ID definido, &false; en caso contrario.
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo de DOMAttr::isId()</title>
<title>Ejemplo con DOMAttr::isId()</title>
<programlisting role="php">
<![CDATA[
<?php
$doc = new DomDocument;
$doc = new DOMDocument;
// Necesitaremos validar nuestro documento antes de referir el id
// Debemos validar nuestro documento antes de referirnos al ID
$doc->validateOnParse = true;
$doc->Load('book.xml');
$doc->load('examples/book-docbook.xml');
// Devolvemos el atributo llamado id del elemento chapter
// Obtenemos el atributo nombrado id del elemento chapter
$attr = $doc->getElementsByTagName('chapter')->item(0)->getAttributeNode('id');
var_dump($attr->isId()); // bool(true)

23
reference/dom/domcdatasection.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 2327968bca8962f3dad7600bef93341e06da7655 Maintainer: seros Status: ready -->
<!-- Reviewed: yes Maintainer: seros -->
<!-- EN-Revision: d1fe8bbfd49e95750eaa17d6b6c5d18279041068 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<reference xml:id="class.domcdatasection" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>La clase DOMCdataSection</title>
@@ -8,21 +8,21 @@
<partintro>
<!-- {{{ DOMCdataSection intro -->
<!-- {{{ DOMCdataSection intro -->
<section xml:id="domcdatasection.intro">
&reftitle.intro;
<para>
<classname>DOMCdataSection</classname> hereda de
<classname>DOMText</classname> para la representación textural
de constructores CData.
La clase <classname>DOMCdataSection</classname> hereda de la clase
<classname>DOMText</classname> para la
representación textual de la construcción del bloque CData.
</para>
</section>
<!-- }}} -->
<!-- }}} -->
<section xml:id="domcdatasection.synopsis">
&reftitle.classsynopsis;
<!-- {{{ Synopsis -->
<!-- {{{ Synopsis -->
<classsynopsis class="class">
<ooclass>
<classname>DOMCdataSection</classname>
@@ -33,6 +33,11 @@
<classname>DOMText</classname>
</ooclass>
<classsynopsisinfo role="comment">&InheritedConstants;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.domnode')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Constants;']]))">
<xi:fallback/>
</xi:include>
<classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.domtext')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Properties;']]))">
<xi:fallback/>
@@ -60,7 +65,7 @@
<xi:fallback/>
</xi:include>
</classsynopsis>
<!-- }}} -->
<!-- }}} -->
</section>
</partintro>

32
reference/dom/domcharacterdata/appenddata.xml
View File

@@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f781803449007bb0e3a96c693e0eee067f7eb466 Maintainer: andresdzphp Status: ready -->
<!-- Reviewed: no Maintainer: andresdzphp -->
<!-- EN-Revision: ccc76b5d82356cedd12227e1d65774df1669b26e Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="domcharacterdata.appenddata" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>DOMCharacterData::appendData</refname>
<refpurpose>
Añade el string de caracteres al final de los datos de carácter del nodo.
Añade la cadena al final de los datos en el nodo
</refpurpose>
</refnamediv>
<refsect1 role="description">
@@ -15,7 +15,8 @@
<methodparam><type>string</type><parameter>data</parameter></methodparam>
</methodsynopsis>
<para>
Añade el string <parameter>data</parameter> hasta el final de los datos de carácter del nodo.
Añade la cadena <parameter>data</parameter> al final de los datos en el
nodo.
</para>
</refsect1>
<refsect1 role="parameters">
@@ -26,7 +27,7 @@
<term><parameter>data</parameter></term>
<listitem>
<para>
El string de caracteres a añadir.
La cadena a añadir.
</para>
</listitem>
</varlistentry>
@@ -39,6 +40,27 @@
&return.true.always;
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.3.0</entry>
<entry>
Esta función ahora tiene un tipo de retorno tentativo de <type>true</type>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>

22
reference/dom/domcharacterdata/deletedata.xml
View File

@@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: d8660905005f1a63f440ff2c6b217e7e32dd759c Maintainer: sabathorn Status: ready -->
<!-- Reviewed: no Maintainer: andresdzphp -->
<!-- EN-Revision: 8c0d111851c38647956dc6a4527746787dd606eb Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="domcharacterdata.deletedata" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>DOMCharacterData::deleteData</refname>
<refpurpose>
Eliminar una serie de caracteres del nodo
Elimina un rango de caracteres de los datos de carácter
</refpurpose>
</refnamediv>
<refsect1 role="description">
@@ -16,7 +16,7 @@
<methodparam><type>int</type><parameter>count</parameter></methodparam>
</methodsynopsis>
<para>
Elimina <parameter>count</parameter> caracteres comenzando desde la posición
Borra <parameter>count</parameter> caracteres a partir de la posición
<parameter>offset</parameter>.
</para>
</refsect1>
@@ -28,7 +28,7 @@
<term><parameter>offset</parameter></term>
<listitem>
<para>
El índice desde el cual se comenzará a remover.
La posición a partir de la cual se debe comenzar a borrar.
</para>
</listitem>
</varlistentry>
@@ -36,9 +36,10 @@
<term><parameter>count</parameter></term>
<listitem>
<para>
La cantidad de caracteres a eliminar. Si la suma de
<parameter>offset</parameter> y <parameter>count</parameter> excede
la longitud, entonces todos los caracteres al final de la data son eliminados.
El número de caracteres a borrar. Si la suma de
<parameter>offset</parameter> y <parameter>count</parameter>
excede la longitud total de la cadena, entonces todos los caracteres hasta el
final de la cadena serán borrados.
</para>
</listitem>
</varlistentry>
@@ -59,8 +60,9 @@
<term><constant>DOM_INDEX_SIZE_ERR</constant></term>
<listitem>
<para>
Lanzada si <parameter>offset</parameter> es negativo o mayor que el número de unidades de 16-bit en la data,
o si <parameter>count</parameter> es negativo.
Se lanza si <parameter>offset</parameter> es negativo o mayor
que el número de puntos de código UTF-8 en los datos o si
<parameter>count</parameter> es negativo.
</para>
</listitem>
</varlistentry>

17
reference/dom/domcharacterdata/insertdata.xml
View File

@@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 798284682a5781d1ead287867b582760ae5a0919 Maintainer: sabathorn Status: ready -->
<!-- Reviewed: no Maintainer: andresdzphp -->
<!-- EN-Revision: c8372e094b51efd41dcb26064524b28173527deb Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="domcharacterdata.insertdata" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>DOMCharacterData::insertData</refname>
<refpurpose>
Inserta un string en la posición de 16-bit especificada
Inserta una cadena en el desplazamiento de punto de código UTF-8 especificado
</refpurpose>
</refnamediv>
<refsect1 role="description">
@@ -16,7 +16,8 @@
<methodparam><type>string</type><parameter>data</parameter></methodparam>
</methodsynopsis>
<para>
Inserta el string <parameter>data</parameter> en la posición <parameter>offset</parameter>.
Inserta la cadena <parameter>data</parameter> en la posición
<parameter>offset</parameter>.
</para>
</refsect1>
<refsect1 role="parameters">
@@ -27,7 +28,7 @@
<term><parameter>offset</parameter></term>
<listitem>
<para>
La posición en la cual se insertará.
La posición de la inserción.
</para>
</listitem>
</varlistentry>
@@ -35,7 +36,7 @@
<term><parameter>data</parameter></term>
<listitem>
<para>
El string a insertar.
La cadena a insertar.
</para>
</listitem>
</varlistentry>
@@ -56,8 +57,8 @@
<term><constant>DOM_INDEX_SIZE_ERR</constant></term>
<listitem>
<para>
Lanzado si <parameter>offset</parameter> es negativo o mayor que
el número de unidades de 16-bit en la data.
Se lanza si <parameter>offset</parameter> es negativo o mayor que
el número de puntos de código UTF-8 en los datos.
</para>
</listitem>
</varlistentry>

26
reference/dom/domcharacterdata/replacedata.xml
View File

@@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b5cc9867e6c0d3197e6aca552373abbad4720bda Maintainer: sabathorn Status: ready -->
<!-- Reviewed: no Maintainer: andresdzphp -->
<!-- EN-Revision: 8c0d111851c38647956dc6a4527746787dd606eb Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="domcharacterdata.replacedata" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>DOMCharacterData::replaceData</refname>
<refpurpose>
Reemplaza un substring dentro de un nodo DOMCharacterData
Reemplaza una subcadena en los datos de carácter
</refpurpose>
</refnamediv>
<refsect1 role="description">
@@ -17,8 +17,8 @@
<methodparam><type>string</type><parameter>data</parameter></methodparam>
</methodsynopsis>
<para>
Reemplaza <parameter>count</parameter> caracteres comenzando en la posicion
<parameter>offset</parameter> con <parameter>data</parameter>.
Reemplaza <parameter>count</parameter> caracteres a partir de la posición
<parameter>offset</parameter> con los datos <parameter>data</parameter>.
</para>
</refsect1>
<refsect1 role="parameters">
@@ -29,7 +29,7 @@
<term><parameter>offset</parameter></term>
<listitem>
<para>
La posición inicial a partir de la cual se iniciara el reemplazo.
La posición a partir de la cual se inicia el reemplazo.
</para>
</listitem>
</varlistentry>
@@ -37,9 +37,10 @@
<term><parameter>count</parameter></term>
<listitem>
<para>
El número de carácteres a reemplazar. Si la suma de
<parameter>offset</parameter> y <parameter>count</parameter> excede
la longitud, entonces todos los carácteres al final de la data son reemplazados.
El número de caracteres a reemplazar. Si la suma de
<parameter>offset</parameter> y <parameter>count</parameter>
excede la longitud total de la cadena, entonces todos los caracteres
hasta el final de los datos serán reemplazados.
</para>
</listitem>
</varlistentry>
@@ -47,7 +48,7 @@
<term><parameter>data</parameter></term>
<listitem>
<para>
El string con el cual el rango debe ser reemplazado.
La cadena utilizada para reemplazar los caracteres seleccionados.
</para>
</listitem>
</varlistentry>
@@ -68,8 +69,9 @@
<term><constant>DOM_INDEX_SIZE_ERR</constant></term>
<listitem>
<para>
Lanzado si <parameter>offset</parameter> es negativo o mayor que el
número de unidades de 16-bit en la data, o si <parameter>count</parameter> es negativo.
Lanzado si <parameter>offset</parameter> es negativo o mayor que
el número de unidades de puntos de código UTF-8 en los datos o si <parameter>count</parameter>
es negativo.
</para>
</listitem>
</varlistentry>

23
reference/dom/domcharacterdata/substringdata.xml
View File

@@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4f5e2b22575131fa5e9c3004b1c874e1acb06573 Maintainer: sabathorn Status: ready -->
<!-- Reviewed: no Maintainer: andresdzphp -->
<!-- EN-Revision: 8c0d111851c38647956dc6a4527746787dd606eb Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="domcharacterdata.substringdata" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>DOMCharacterData::substringData</refname>
<refpurpose>
Extrae una serie de datos del nodo
Extrae un rango de datos de los datos de carácter
</refpurpose>
</refnamediv>
<refsect1 role="description">
@@ -16,7 +16,7 @@
<methodparam><type>int</type><parameter>count</parameter></methodparam>
</methodsynopsis>
<para>
Devuelve el substring especificado.
Devuelve la sub-cadena especificada.
</para>
</refsect1>
<refsect1 role="parameters">
@@ -27,7 +27,7 @@
<term><parameter>offset</parameter></term>
<listitem>
<para>
Posición de inicio del substring a extraer.
La posición del inicio de la cadena a extraer.
</para>
</listitem>
</varlistentry>
@@ -35,7 +35,7 @@
<term><parameter>count</parameter></term>
<listitem>
<para>
El número de carácteres a extraer.
El número de caracteres a extraer.
</para>
</listitem>
</varlistentry>
@@ -45,9 +45,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
El substring especificado. Si la suma de <parameter>offset</parameter>
y <parameter>count</parameter> excede la longitud, entonces todas las unidades de 16-bit
hasta el final de la cadena son devueltas.
La sub-cadena especificada. Si la suma de <parameter>offset</parameter>
y <parameter>count</parameter> excede la longitud total de la cadena, entonces
todas las unidades de puntos de código UTF-8 hasta el final de los datos serán devueltas.
</para>
</refsect1>
<refsect1 role="errors">
@@ -58,8 +58,9 @@
<term><constant>DOM_INDEX_SIZE_ERR</constant></term>
<listitem>
<para>
Lanzado si <parameter>offset</parameter> es negativo o mayor que el
numero de unidades de 16-bit en la data, o si <parameter>count</parameter> es negativo.
Lanzado si <parameter>offset</parameter> es negativo o mayor que
el número de unidades de puntos de código UTF-8 en los datos o si
<parameter>count</parameter> es negativo.
</para>
</listitem>
</varlistentry>

23
reference/dom/domcomment.xml
View File

@@ -1,26 +1,26 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: sabathorn Status: ready -->
<!-- Reviewed: no Maintainer: andresdzphp -->
<!-- EN-Revision: d75a54118772b34c7a538962ac5f994900c99690 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<reference xml:id="class.domcomment" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>La clase DOMComment</title>
<title>&class.theclass; <classname>DOMComment</classname></title>
<titleabbrev>DOMComment</titleabbrev>
<partintro>
<!-- {{{ DOMComment intro -->
<!-- {{{ DOMComment intro -->
<section xml:id="domcomment.intro">
&reftitle.intro;
<para>
Representa nodos comentario, caracteres delimitados por <code>&lt;!--</code>
Representa un nodo de comentario, delimitado por <code>&lt;!--</code>
y <code>--&gt;</code>.
</para>
</section>
<!-- }}} -->
<!-- }}} -->
<section xml:id="domcomment.synopsis">
&reftitle.classsynopsis;
<!-- {{{ Synopsis -->
<!-- {{{ Synopsis -->
<classsynopsis class="class">
<ooclass>
<classname>DOMComment</classname>
@@ -31,6 +31,11 @@
<classname>DOMCharacterData</classname>
</ooclass>
<classsynopsisinfo role="comment">&InheritedConstants;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.domnode')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Constants;']]))">
<xi:fallback/>
</xi:include>
<classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.domcharacterdata')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Properties;']]))">
<xi:fallback/>
@@ -52,7 +57,7 @@
<xi:fallback/>
</xi:include>
</classsynopsis>
<!-- }}} -->
<!-- }}} -->
</section>
@@ -60,7 +65,7 @@
&reftitle.seealso;
<para>
<simplelist>
<member><link xlink:href="&url.spec.dom3.comment;">Especificación W3C de Comment</link></member>
<member><link xlink:href="&url.spec.dom3.comment;">especificación W3C de Comment</link></member>
</simplelist>
</para>
</section>

50
reference/dom/domdocument/createattributens.xml
View File

@@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4f5e2b22575131fa5e9c3004b1c874e1acb06573 Maintainer: sabathorn Status: ready -->
<!-- Reviewed: no Maintainer: andresdzphp -->
<!-- EN-Revision: c1349f9574ed77c268c6312a07466f06d59e5078 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="domdocument.createattributens" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>DOMDocument::createAttributeNS</refname>
<refpurpose>
Crea un nuevo nodo atributo con un namespace asociado.
Crea un nuevo atributo con un espacio de nombres asociado
</refpurpose>
</refnamediv>
<refsect1 role="description">
@@ -28,7 +28,7 @@
<term><parameter>namespace</parameter></term>
<listitem>
<para>
El URI del namespace.
El URI del espacio de nombres.
</para>
</listitem>
</varlistentry>
@@ -36,7 +36,8 @@
<term><parameter>qualifiedName</parameter></term>
<listitem>
<para>
El nombre de etiqueta y prefijo del atributo, como <literal>prefix:tagname</literal>.
El nombre de la etiqueta y el prefijo del atributo, en este formato:
<literal>prefijo:nombreEtiqueta</literal>.
</para>
</listitem>
</varlistentry>
@@ -46,7 +47,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
El nuevo <classname>DOMAttr</classname> o &false; si ha ocurrido un error.
El nuevo <classname>DOMAttr</classname> o &false; si ocurre un error.
</para>
</refsect1>
<refsect1 role="errors">
@@ -57,7 +58,7 @@
<term><constant>DOM_INVALID_CHARACTER_ERR</constant></term>
<listitem>
<para>
Lanzado si<parameter>qualifiedName</parameter> contiene un carácter inválido.
Lanzado si <parameter>qualifiedName</parameter> contiene un carácter inválido.
</para>
</listitem>
</varlistentry>
@@ -65,8 +66,8 @@
<term><constant>DOM_NAMESPACE_ERR</constant></term>
<listitem>
<para>
Lanzado si <parameter>qualifiedName</parameter> es un nombre calificado mal formado
, o si <parameter>qualifiedName</parameter> tiene un prefijo y
Lanzado si <parameter>qualifiedName</parameter> es un nombre cualificado mal formado
o si <parameter>qualifiedName</parameter> tiene un sufijo y
<parameter>namespace</parameter> es &null;.
</para>
</listitem>
@@ -74,6 +75,37 @@
</variablelist>
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.3.0</entry>
<entry>
Llamar a este método sin especificar un prefijo elegirá ahora un prefijo en lugar de asumir el espacio de nombres por defecto.
Anteriormente, esto creaba un atributo sin prefijo y aplicaba incorrectamente el espacio de nombres al elemento propietario
ya que los espacios de nombres por defecto no se aplican a los atributos.
</entry>
</row>
<row>
<entry>8.3.0</entry>
<entry>
Llamar a este método utilizando un prefijo ya declarado en el elemento propietario con un URI de espacio de nombres diferente
cambiará ahora el nuevo prefijo para evitar conflictos de espacio de nombres. Esto alinea el comportamiento con la especificación del DOM.
Anteriormente, esto lanzaba una <classname>DOMException</classname> con el código <constant>DOM_NAMESPACE_ERR</constant>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>

38
reference/dom/domdocument/createcomment.xml
View File

@@ -1,7 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 656d1610af1a960d87c8b7056e54d0d4c75fb123 Maintainer: sabathorn Status: ready -->
<!-- Reviewed: no Maintainer: andresdzphp -->
<!-- EN-Revision: 4f5e2b22575131fa5e9c3004b1c874e1acb06573 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="domdocument.createcomment" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>DOMDocument::createComment</refname>
@@ -9,13 +8,14 @@
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<methodsynopsis role="DOMDocument">
<modifier>public</modifier> <type>DOMComment</type><methodname>DOMDocument::createComment</methodname>
<methodparam><type>string</type><parameter>data</parameter></methodparam>
</methodsynopsis>
<para>
Esta función crea una nueva instancia de la clase
<classname>DOMComment</classname>. &dom.node.inserted;
<classname>DOMComment</classname>.
&dom.node.inserted;
</para>
</refsect1>
<refsect1 role="parameters">
@@ -33,12 +33,37 @@
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
El nuevo <classname>DOMComment</classname> o &false; si ha ocurrido un error.
El nuevo <classname>DOMComment</classname>.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.1.0</entry>
<entry>
En caso de error, una <classname>DomException</classname> es lanzada ahora.
Anteriormente, &false; era devuelto.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -57,7 +82,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

78
reference/dom/domdocument/createdocumentfragment.xml
View File

@@ -1,7 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 656d1610af1a960d87c8b7056e54d0d4c75fb123 Maintainer: sabathorn Status: ready -->
<!-- Reviewed: no Maintainer: andresdzphp -->
<!-- EN-Revision: 4f5e2b22575131fa5e9c3004b1c874e1acb06573 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="domdocument.createdocumentfragment" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>DOMDocument::createDocumentFragment</refname>
@@ -9,39 +8,70 @@
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<methodsynopsis role="DOMDocument">
<modifier>public</modifier> <type>DOMDocumentFragment</type><methodname>DOMDocument::createDocumentFragment</methodname>
<void/>
</methodsynopsis>
<para>
Esta función crea una nueva instancia de la clase
<classname>DOMDocumentFragment</classname>. &dom.node.inserted;
Esta función crea una nueva instancia de la clase
<classname>DOMDocumentFragment</classname>.
&dom.node.inserted;
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
El nuevo <classname>DOMDocumentFragment</classname> o &false; si ha ocurrido un error.
El nuevo <classname>DOMDocumentFragment</classname>.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.1.0</entry>
<entry>
En caso de error, una <classname>DomException</classname> es lanzada ahora.
Anteriormente, &false; era devuelto.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><methodname>DOMNode::appendChild</methodname></member>
<member><methodname>DOMDocument::createAttribute</methodname></member>
<member><methodname>DOMDocument::createAttributeNS</methodname></member>
<member><methodname>DOMDocument::createCDATASection</methodname></member>
<member><methodname>DOMDocument::createComment</methodname></member>
<member><methodname>DOMDocument::createElement</methodname></member>
<member><methodname>DOMDocument::createElementNS</methodname></member>
<member><methodname>DOMDocument::createEntityReference</methodname></member>
<member><methodname>DOMDocument::createProcessingInstruction</methodname></member>
<member><methodname>DOMDocument::createTextNode</methodname></member>
</simplelist>
</para>
</refsect1> <refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><methodname>DOMNode::appendChild</methodname></member>
<member><methodname>DOMDocument::createAttribute</methodname></member>
<member><methodname>DOMDocument::createAttributeNS</methodname></member>
<member><methodname>DOMDocument::createCDATASection</methodname></member>
<member><methodname>DOMDocument::createComment</methodname></member>
<member><methodname>DOMDocument::createElement</methodname></member>
<member><methodname>DOMDocument::createElementNS</methodname></member>
<member><methodname>DOMDocument::createEntityReference</methodname></member>
<member><methodname>DOMDocument::createProcessingInstruction</methodname></member>
<member><methodname>DOMDocument::createTextNode</methodname></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

42
reference/dom/domdocument/createtextnode.xml
View File

@@ -1,7 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 656d1610af1a960d87c8b7056e54d0d4c75fb123 Maintainer: sabathorn Status: ready -->
<!-- Reviewed: no Maintainer: andresdzphp -->
<!-- EN-Revision: 4f5e2b22575131fa5e9c3004b1c874e1acb06573 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="domdocument.createtextnode" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>DOMDocument::createTextNode</refname>
@@ -9,13 +8,14 @@
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<methodsynopsis role="DOMDocument">
<modifier>public</modifier> <type>DOMText</type><methodname>DOMDocument::createTextNode</methodname>
<methodparam><type>string</type><parameter>content</parameter></methodparam>
<methodparam><type>string</type><parameter>data</parameter></methodparam>
</methodsynopsis>
<para>
Esta función crea una nueva instancia de la clase
<classname>DOMText</classname>. &dom.node.inserted;
<classname>DOMText</classname>.
&dom.node.inserted;
</para>
</refsect1>
<refsect1 role="parameters">
@@ -23,7 +23,7 @@
<para>
<variablelist>
<varlistentry>
<term><parameter>content</parameter></term>
<term><parameter>data</parameter></term>
<listitem>
<para>
El contenido del texto.
@@ -33,12 +33,37 @@
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
El nuevo <classname>DOMText</classname> o &false; si ha ocurrido un error.
Un nuevo <classname>DOMText</classname>.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.1.0</entry>
<entry>
En caso de error, una <classname>DomException</classname> es ahora lanzada.
Anteriormente, &false; era devuelto.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -57,7 +82,6 @@
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

36
reference/dom/domdocument/getelementbyid.xml
View File

@@ -1,10 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4f5e2b22575131fa5e9c3004b1c874e1acb06573 Maintainer: jpberdejo Status: ready -->
<!-- Reviewed: no Maintainer: andresdzphp -->
<!-- EN-Revision: c1f37a6c270aadbbb3da56a3973ffd62197adf2b Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="domdocument.getelementbyid" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>DOMDocument::getElementById</refname>
<refpurpose>Busca un elemento con cierto id</refpurpose>
<refpurpose>Busca un elemento con un cierto identificador</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
@@ -13,17 +13,18 @@
<methodparam><type>string</type><parameter>elementId</parameter></methodparam>
</methodsynopsis>
<para>
Esta función es similar a
<xref linkend="domdocument.getelementsbytagname"/>pero
busca un elemento con el id dado.
Esta función es similar a la función
<xref linkend="domdocument.getelementsbytagname"/>
pero busca un elemento con un identificador dado.
</para>
<para>
Para que esta función trabaje, necesitará asignar algunos atributos ID
Para que esta función funcione, es necesario definir los atributos ID
con <xref linkend="domelement.setidattribute"/>
o un DTD que defina un atributo de tipo ID.
En el último caso necesitará validar el documento con
o definir una DTD que defina un atributo que debe ser de tipo ID.
En el último caso, es necesario validar el documento con
<xref linkend="domdocument.validate"/>
o <link linkend="domdocument.props.validateonparse">DOMDocument::$validateOnParse</link> antes de utilizar esta función.
o <link linkend="domdocument.props.validateonparse">DOMDocument::$validateOnParse</link>
antes de utilizar esta función.
</para>
</refsect1>
<refsect1 role="parameters">
@@ -34,7 +35,7 @@
<term><parameter>elementId</parameter></term>
<listitem>
<para>
El valor de id único para un elemento.
El valor del identificador único para un elemento.
</para>
</listitem>
</varlistentry>
@@ -44,13 +45,14 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve el <classname>DOMElement</classname> o &null; si el elemento no ha sido encontrado.
Devuelve un <classname>DOMElement</classname> o &null; si el elemento
no es encontrado.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Ejemplo de DOMDocument::getElementById()</title>
<title>Ejemplo con DOMDocument::getElementById()</title>
&dom.book.example;
<programlisting role="php">
<![CDATA[
@@ -58,11 +60,11 @@
$doc = new DomDocument;
// Necesitamos validar nuestro documento antes de referirnos al id
// Es necesario validar el documento antes de referirse al ID
$doc->validateOnParse = true;
$doc->Load('book.xml');
$doc->load('examples/book.xml');
echo "The element whose id is 'php-basics' is: " . $doc->getElementById('php-basics')->tagName . "\n";
echo "El elemento cuyo ID es 'php-basics' es: " . $doc->getElementById('php-basics')->tagName . "\n";
?>
]]>
@@ -70,7 +72,7 @@ echo "The element whose id is 'php-basics' is: " . $doc->getElementById('php-bas
&example.outputs;
<screen>
<![CDATA[
The element whose id is 'php-basics' is: book
El elemento cuyo ID es 'php-basics' es: chapter
]]>
</screen>
</example>

54
reference/dom/domdocument/getelementsbytagnamens.xml
View File

@@ -1,23 +1,23 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 656d1610af1a960d87c8b7056e54d0d4c75fb123 Maintainer: sabathorn Status: ready -->
<!-- EN-Revision: 842bbe35c608b95d04ba5c0e0f5eeb4bd4dcd799 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="domdocument.getelementsbytagnamens" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>DOMDocument::getElementsByTagNameNS</refname>
<refpurpose>
Busca todos los elementos con el nombre de etiqueta dado en el espacio de nombre especificado.
Búsqueda de todos los elementos con un nombre de etiqueta dado en un espacio de nombres especificado
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<methodsynopsis role="DOMDocument">
<modifier>public</modifier> <type>DOMNodeList</type><methodname>DOMDocument::getElementsByTagNameNS</methodname>
<methodparam><type>string</type><parameter>namespaceURI</parameter></methodparam>
<methodparam><type class="union"><type>string</type><type>null</type></type><parameter>namespace</parameter></methodparam>
<methodparam><type>string</type><parameter>localName</parameter></methodparam>
</methodsynopsis>
<para>
Devuelve un <classname>DOMNodeList</classname> de todos los elementos con el nombre local dado
y el URI del espacio de nombre.
Devuelve un <classname>DOMNodeList</classname> de todos los elementos
con un nombre local dado y una URI de espacio de nombres.
</para>
</refsect1>
<refsect1 role="parameters">
@@ -25,11 +25,12 @@
<para>
<variablelist>
<varlistentry>
<term><parameter>namespaceURI</parameter></term>
<term><parameter>namespace</parameter></term>
<listitem>
<para>
El URI del espacio de nombre de los elementos en los que se buscara.
El valor especial <literal>*</literal> coincide con todos los espacios de nombre.
La URI del espacio de nombres de los elementos a buscar.
El valor especial <literal>"*"</literal> representa todos los espacios de nombres.
Pasar &null; representa el espacio de nombres vacío.
</para>
</listitem>
</varlistentry>
@@ -37,8 +38,8 @@
<term><parameter>localName</parameter></term>
<listitem>
<para>
El nombre local de los elementos buscados.
El valor especial <literal>*</literal> coincide con todos los nombres locales.
El nombre local de los elementos a buscar.
El valor especial <literal>"*"</literal> representa todos los nombres locales.
</para>
</listitem>
</varlistentry>
@@ -48,14 +49,38 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Un nuevo objeto <classname>DOMNodeList</classname> que contiene todos los elementos coincidentes.
Un nuevo objeto <classname>DOMNodeList</classname> que contiene
todos los elementos encontrados.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.3</entry>
<entry>
<parameter>namespace</parameter> ahora es nullable.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Obtener todos los elementos XInclude </title>
<title>Recuperación de todos los elementos XInclude</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -106,7 +131,6 @@ local name: fallback, prefix: xi
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

73
reference/dom/domdocument/loadxml.xml
View File

@@ -1,22 +1,22 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 656d1610af1a960d87c8b7056e54d0d4c75fb123 Maintainer: agarzon Status: ready -->
<!-- EN-Revision: 765749a26b620538117fff4425fafb3ed5834b54 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="domdocument.loadxml" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>DOMDocument::loadXML</refname>
<refpurpose>
Cargar XML desde una cadena
Carga de XML desde una cadena de caracteres
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <type>mixed</type><methodname>DOMDocument::loadXML</methodname>
<methodsynopsis role="DOMDocument">
<modifier>public</modifier> <type>bool</type><methodname>DOMDocument::loadXML</methodname>
<methodparam><type>string</type><parameter>source</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>options</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<para>
Carga un documento XML desde una cadena.
Carga un documento XML desde una cadena de caracteres.
</para>
</refsect1>
<refsect1 role="parameters">
@@ -27,7 +27,7 @@
<term><parameter>source</parameter></term>
<listitem>
<para>
La cadena que contiene el XML.
La cadena de caracteres que contiene el XML.
</para>
</listitem>
</varlistentry>
@@ -35,35 +35,62 @@
<term><parameter>options</parameter></term>
<listitem>
<para>
<link linkend="language.operators.bitwise">Operador a nivel de bits <literal>OR</literal></link>
de las <link linkend="libxml.constants">constantes de opciones libxml</link>.
<link linkend="language.operators.bitwise">El operador <literal>OR</literal></link>
de las <link linkend="libxml.constants">constantes libxml</link>.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success; Si se llama estáticamente, devuelve un
<classname>DOMDocument</classname>&return.falseforfailure;.
&return.success;
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<para>
Si se pasa una cadena vacía a <parameter>source</parameter>,
se generará una advertencia. Esta advertencia no es generada por libxml
y no puede ser tratada usando funciones de manejo de errores de libxml.
Si se pasa una cadena vacía como argumento <parameter>source</parameter>,
se generará una advertencia. Esta advertencia no es generada
por libxml, y no puede ser gestionada utilizando las funciones de gestión
de errores de libxml.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.3.0</entry>
<entry>
Esta función tiene ahora un tipo de retorno <type>bool</type> provisional.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
La llamada estática a esta función levantará ahora una <classname>Error</classname>.
Anteriormente, se generaba un error <constant>E_DEPRECATED</constant>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Crear un Documento</title>
<title>Creación de un Documento</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -71,19 +98,6 @@ $doc = new DOMDocument();
$doc->loadXML('<root><node/></root>');
echo $doc->saveXML();
?>
]]>
</programlisting>
</example>
</para>
<para>
<example>
<title>Invocación estática de <literal>loadXML</literal></title>
<programlisting role="php">
<![CDATA[
<?php
$doc = DOMDocument::loadXML('<root><node/></root>');
echo $doc->saveXML();
?>
]]>
</programlisting>
</example>
@@ -100,7 +114,6 @@ echo $doc->saveXML();
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

205
reference/dom/domdocument/registernodeclass.xml
View File

@@ -1,114 +1,107 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 656d1610af1a960d87c8b7056e54d0d4c75fb123 Maintainer: seros Status: ready -->
<!-- EN-Revision: 0e2dfef689e3b40b8a826a0f64ba741863ee8c2a Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="domdocument.registernodeclass" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>DOMDocument::registerNodeClass</refname>
<refpurpose>Registra una clase extendida usada para crear tipos de nodos base</refpurpose>
<refpurpose>Registra la clase extendida utilizada para crear un tipo de nodo base</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <type>bool</type><methodname>DOMDocument::registerNodeClass</methodname>
<methodparam><type>string</type><parameter>baseclass</parameter></methodparam>
<methodparam><type>string</type><parameter>extendedclass</parameter></methodparam>
<methodsynopsis role="DOMDocument">
<modifier>public</modifier> <type>true</type><methodname>DOMDocument::registerNodeClass</methodname>
<methodparam><type>string</type><parameter>baseClass</parameter></methodparam>
<methodparam><type class="union"><type>string</type><type>null</type></type><parameter>extendedClass</parameter></methodparam>
</methodsynopsis>
<para>
Este método permite registrar su propia clase DOM extendida para usarla
después por la extensión DOM de PHP.
Este método permite registrar su propia clase DOM extendida para ser utilizada
posteriormente en la extensión DOM de PHP.
</para>
<para>
Este método no es parte del estándar DOM.
Este método no forma parte del estándar DOM.
</para>
<caution>
<simpara>
Los constructores de los objetos de las clases de nodos registrados no son llamados.
</simpara>
</caution>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>baseclass</parameter></term>
<term><parameter>baseClass</parameter></term>
<listitem>
<para>
La clase DOM que se quiere extender. Se puede encontrar una lista de estas
clases en el <link linkend="book.dom">capítulo introducción</link>.
La clase DOM que se desea extender. Puede encontrarse una lista
de estas clases en la <link linkend="book.dom">introducción del capítulo</link>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>extendedclass</parameter></term>
<term><parameter>extendedClass</parameter></term>
<listitem>
<para>
El nombre de la clase extendida. Si se proporciona &null;, cualquier clase
registrada previamente que extienda <parameter>baseclass</parameter>
será eliminada.
El nombre de su clase extendida. Si se proporciona el valor &null;, todas
las clases registradas previamente que extienden
<parameter>baseClass</parameter> serán eliminadas.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
&return.true.always;
</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>5.2.2</entry>
<entry>
Antes de 5.2.2, una <parameter>extendedclass</parameter> previamente registrada
teniá que ser desregistrada antes de poder registrar una nueva clase que extendiese
a la misma <parameter>baseclass</parameter>.
</entry>
</row>
<!--
<row>
<entry>...</entry>
<entry>
...
</entry>
</row>
-->
</tbody>
</tgroup>
</informaltable>
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
<methodname>DOMDocument::registerNodeClass</methodname>
ahora tiene un tipo de retorno provisional de tipo <type>true</type>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Añadir un nuevo método a DOMElement para facilitar su código</title>
<title>Añadir un nuevo método a DOMElement</title>
<programlisting role="php">
<![CDATA[
<?php
class myElement extends DOMElement {
function appendElement($name) {
function appendElement($name) {
return $this->appendChild(new myElement($name));
}
}
class myDocument extends DOMDocument {
function setRoot($name) {
function setRoot($name) {
return $this->appendChild(new myElement($name));
}
}
@@ -116,7 +109,7 @@ class myDocument extends DOMDocument {
$doc = new myDocument();
$doc->registerNodeClass('DOMElement', 'myElement');
// A partir de ahora, ¡ añadir un elemento a otro sólo cuesta una llamada al método !
// A partir de aquí, la adición de un elemento a otro se realiza en una sola llamada !
$root = $doc->setRoot('root');
$child = $root->appendElement('child');
$child->setAttribute('foo', 'bar');
@@ -137,7 +130,7 @@ echo $doc->saveXML();
</para>
<para>
<example>
<title>Recuperar elementos como clase personalizada</title>
<title>Recuperación de elementos en forma de clase personalizada</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -148,13 +141,13 @@ class myElement extends DOMElement {
}
$doc = new DOMDocument;
$doc->loadXML("<root><element><child>text in child</child></element></root>");
$doc->loadXML("<root><element><child>Texto en un hijo</child></element></root>");
$doc->registerNodeClass("DOMElement", "myElement");
$element = $doc->getElementsByTagName("child")->item(0);
var_dump(get_class($element));
// Y tomar ventaja del método __toString ...
// Y utilizamos las ventajas del método __toString..
echo $element;
?>
]]>
@@ -163,44 +156,55 @@ echo $element;
<screen role="xml">
<![CDATA[
string(9) "myElement"
text in child
Texto en un hijo
]]>
</screen>
</example>
</para>
<para>
<example>
<title>Recuperar un propio documento</title>
<title>Recuperación del propietario del documento</title>
<para>
Al instanciar un <classname>DOMDocument</classname> personalizado, la
propiedad <varname>ownerDocument</varname> se referirá a la clase
instanciada, lo que significa que no hay necesidad (y de hecho no es posible) de usar
<function>DOMDocument::registerNodeClass</function> con
<classname>DOMDocument</classname>
Al instanciar un <classname>DOMDocument</classname>
personalizado, la propiedad <varname>ownerDocument</varname> se refiere
a la clase instanciada. Sin embargo, si todas las referencias a esta clase
son eliminadas, será destruida y una nueva instancia de
<classname>DOMDocument</classname> será creada en su lugar. Por esta razón,
puede utilizarse el método <function>DOMDocument::registerNodeClass</function>
con <classname>DOMDocument</classname>
</para>
<programlisting role="php">
<![CDATA[
<?php
class myDOMDocument extends DOMDocument {
class MyDOMDocument extends DOMDocument {
}
class myOtherDOMDocument extends DOMDocument {
class MyOtherDOMDocument extends DOMDocument {
}
// Crear myDOMDocument con algo de XML
$doc = new myDOMDocument;
$doc->loadXML("<root><element><child>text in child</child></element></root>");
// Creación de un documento MyDOMDocument con algunos fragmentos XML
$doc = new MyDOMDocument;
$doc->loadXML("<root><element><child>texto en un hijo</child></element></root>");
$child = $doc->getElementsByTagName("child")->item(0);
// El actual propietario del nodo es myDOMDocument
// El propietario actual del nodo es MyDOMDocument
var_dump(get_class($child->ownerDocument));
// MyDOMDocument es destruido
unset($doc);
// Y una nueva instancia de DOMDocument es creada
var_dump(get_class($child->ownerDocument));
// Importar un nodo desde myDOMDocument
$newdoc = new myOtherDOMDocument;
// Importación de un nodo desde MyDOMDocument
$newdoc = new MyOtherDOMDocument;
$child = $newdoc->importNode($child);
// El propietario del nodo ha cambiado a myOtherDOMDocument
// Registra un DOMDocument personalizado
$newdoc->registerNodeClass("DOMDocument", "MyOtherDOMDocument");
var_dump(get_class($child->ownerDocument));
unset($doc);
// Un nuevo MyOtherDOMDocument es creado
var_dump(get_class($child->ownerDocument));
?>
]]>
@@ -208,16 +212,57 @@ var_dump(get_class($child->ownerDocument));
&example.outputs;
<screen role="xml">
<![CDATA[
string(13) "myDOMDocument"
string(18) "myOtherDOMDocument"
string(13) "MyDOMDocument"
string(11) "DOMDocument"
string(18) "MyOtherDOMDocument"
string(18) "MyOtherDOMDocument"
]]>
</screen>
</example>
</para>
<para>
<example xml:id="domdocument.registernodeclass.example.transient">
<title>Los objetos personalizados son efímeros</title>
<caution>
<simpara>
Los objetos de la clase de nodos registrada son efímeros, es decir, son
destruidos cuando ya no son referenciados desde el código PHP, y
recreados cuando son recuperados nuevamente. Esto implica que los valores
de propiedades personalizadas se perderán después de la recreación.
</simpara>
</caution>
<programlisting role="php">
<![CDATA[
<?php
class MyDOMElement extends DOMElement
{
public $myProp = 'default value';
}
$doc = new DOMDocument();
$doc->registerNodeClass('DOMElement', 'MyDOMElement');
$node = $doc->createElement('a');
$node->myProp = 'modified value';
$doc->appendChild($node);
echo $doc->childNodes[0]->myProp, PHP_EOL;
unset($node);
echo $doc->childNodes[0]->myProp, PHP_EOL;
?>]]>
</programlisting>
&example.outputs;
<screen role="xml">
<![CDATA[
modified value
default value
]]>
</screen>
</example>
</para>
</refsect1>
</refentry>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

57
reference/dom/domdocument/savexml.xml
View File

@@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4f5e2b22575131fa5e9c3004b1c874e1acb06573 Maintainer: seros Status: ready -->
<!-- Reviewed: no Maintainer: andresdzphp -->
<!-- EN-Revision: a8b6f4dd3a23875b066d4e47ea4a4977a63e0655 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="domdocument.savexml" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>DOMDocument::saveXML</refname>
<refpurpose>
Copia el arbol XML interno a un string
Guarda el árbol interno XML en una cadena de caracteres
</refpurpose>
</refnamediv>
<refsect1 role="description">
@@ -16,8 +16,9 @@
<methodparam choice="opt"><type>int</type><parameter>options</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<para>
Crea un documento XML desde la representación DOM. Esta función normalmente
se llama después de construir un nuevo documento desde cero, como en el ejemplo de abajo.
Crea un documento XML desde la representación DOM. Esta función es habitualmente
llamada después de la creación de un nuevo documento DOM, como en el ejemplo
que se muestra a continuación.
</para>
</refsect1>
@@ -29,17 +30,15 @@
<term><parameter>node</parameter></term>
<listitem>
<para>
Use este parámetro para imprimir sólo un nodo especifico sin la declaración XML
en vez del documento completo.
Utilice este argumento para mostrar únicamente un nodo específico sin declaración XML
en lugar de todo el documento.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>options</parameter></term>
<listitem>
<para>
Opciones Adicionales. Actualmente sólo está soportada <link linkend="libxml.constants">LIBXML_NOEMPTYTAG</link>.
</para>
&dom.parameters.serialize.options;
</listitem>
</varlistentry>
</variablelist>
@@ -49,7 +48,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve el XML, o &false; en caso de error.
Devuelve el XML o &false; si ocurre un error.
</para>
</refsect1>
<refsect1 role="errors">
@@ -60,7 +59,7 @@
<term><constant>DOM_WRONG_DOCUMENT_ERR</constant></term>
<listitem>
<para>
Lanzado si <parameter>node</parameter> es de otro documento.
Lanzado si <parameter>node</parameter> proviene de otro documento.
</para>
</listitem>
</varlistentry>
@@ -68,17 +67,39 @@
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.3.0</entry>
<entry>
<link linkend="libxml.constants">LIBXML_NOXMLDECL</link> es ahora soportado.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Guardar un árbol DOM en un string</title>
<title>Guardar el árbol DOM en una cadena de caracteres</title>
<programlisting role="php">
<![CDATA[
<?php
$doc = new DOMDocument('1.0');
// queremos una impresión buena
// queremos un formato de salida bonito
$doc->formatOutput = true;
$root = $doc->createElement('book');
@@ -90,10 +111,10 @@ $title = $root->appendChild($title);
$text = $doc->createTextNode('Este es el título');
$text = $title->appendChild($text);
echo "Guardando todo el documento:\n";
echo "Obtención de todo el documento :\n";
echo $doc->saveXML() . "\n";
echo "Guardando sólo la parte del título:\n";
echo "Obtención del título, únicamente :\n";
echo $doc->saveXML($title);
?>
@@ -102,13 +123,13 @@ echo $doc->saveXML($title);
&example.outputs;
<screen>
<![CDATA[
Guardando todo el documento:
Obtención de todo el documento :
<?xml version="1.0"?>
<book>
<title>Este es el título</title>
</book>
Guardando sólo la parte del título:
Obtención del título, únicamente :
<title>Este es el título</title>
]]>
</screen>

22
reference/dom/domdocument/validate.xml
View File

@@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4f5e2b22575131fa5e9c3004b1c874e1acb06573 Maintainer: seros Status: ready -->
<!-- Reviewed: no Maintainer: andresdzphp -->
<!-- EN-Revision: c1f37a6c270aadbbb3da56a3973ffd62197adf2b Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="domdocument.validate" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>DOMDocument::validate</refname>
<refpurpose>
Valida el documento basado en su DTD
Valida un documento basado en su DTD
</refpurpose>
</refnamediv>
<refsect1 role="description">
@@ -15,11 +15,11 @@
<void/>
</methodsynopsis>
<para>
Valida el documento basado en su DTD.
Valida un documento basado en su DTD.
</para>
<para>
También se puede usar la propiedad <literal>validateOnParse</literal> de
<classname>DOMDocument</classname> para realizar la validación de DTD.
Puede utilizarse la propiedad <literal>validateOnParse</literal> de la clase
<classname>DOMDocument</classname> para realizar una validación DTD.
</para>
</refsect1>
@@ -32,19 +32,19 @@
&reftitle.returnvalues;
<para>
&return.success;
Si el documento no tiene el DTD adjunto, este método devolverá &false;.
Si el documento no tiene ninguna DTD asociada, este método retornará &false;.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo de validación de DTD</title>
<title>Ejemplo de validación DTD</title>
<programlisting role="php">
<![CDATA[
<?php
$dom = new DOMDocument;
$dom->load('book.xml');
$dom->load('examples/book.xml');
if ($dom->validate()) {
echo "¡Este documento es válido!\n";
}
@@ -52,14 +52,14 @@ if ($dom->validate()) {
]]>
</programlisting>
<para>
También se puede validar un fichero XML mientras se carga:
Asimismo, puede validarse el fichero XML al cargarlo:
</para>
<programlisting role="php">
<![CDATA[
<?php
$dom = new DOMDocument;
$dom->validateOnParse = true;
$dom->load('book.xml');
$dom->load('examples/book.xml');
?>
]]>
</programlisting>

32
reference/dom/domdocument/xinclude.xml
View File

@@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: d2939d46110158f98ace5c20761c808b04c905d8 Maintainer: seros Status: ready -->
<!-- Reviewed: no Maintainer: andresdzphp -->
<!-- EN-Revision: c1f37a6c270aadbbb3da56a3973ffd62197adf2b Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="domdocument.xinclude" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>DOMDocument::xinclude</refname>
<refpurpose>
Sustituye XIncludes en un objeto DOMDocument
Reemplaza los XIncludes en un objeto DOMDocument
</refpurpose>
</refnamediv>
<refsect1 role="description">
@@ -15,12 +15,12 @@
<methodparam choice="opt"><type>int</type><parameter>options</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<para>
Este método sustituye <link xlink:href="&url.xinclude.spec;">XIncludes</link> en un objeto DOMDocument.
Este método reemplaza los <link xlink:href="&url.xinclude.spec;">XIncludes</link> en un objeto DOMDocument.
</para>
<note>
<para>
Debido a que libxml2 resuelve automáticamente entidades, este método producirá
resultados inesperados si el fichero XML incluido tiene un DTD adjunto.
Dado que la biblioteca libxml2 resuelve automáticamente las entidades, este método
puede producir resultados no esperados si el fichero XML incluido tiene una DTD adjunta.
</para>
</note>
</refsect1>
@@ -40,15 +40,15 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve el número de XIncludes del documento, -1 si falló algún proceso,
o &false; si no hubo sustituciones.
Devuelve el número de XIncludes del documento, -1 si ocurre un error
durante el proceso, o &false; si no hay sustitución.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo de DOMDocument::xinclude()</title>
<title>Ejemplo con DOMDocument::xinclude()</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -56,11 +56,11 @@
$xml = <<<EOD
<?xml version="1.0" ?>
<chapter xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Books of the other guy..</title>
<title>Los libros de otra persona</title>
<para>
<xi:include href="book.xml">
<xi:include href="examples/book.xml">
<xi:fallback>
<error>xinclude: book.xml not found</error>
<error>xinclude: book.xml no ha sido encontrado</error>
</xi:fallback>
</xi:include>
</para>
@@ -69,14 +69,14 @@ EOD;
$dom = new DOMDocument;
// vamos a tener una impresión buena
// Se desea un bonito formato de salida
$dom->preserveWhiteSpace = false;
$dom->formatOutput = true;
// cargar la cadena XML definida arriba
// carga del string XML definido anteriormente
$dom->loadXML($xml);
// sustituir xincludes
// reemplazo de los xincludes
$dom->xinclude();
echo $dom->saveXML();
@@ -89,7 +89,7 @@ echo $dom->saveXML();
<![CDATA[
<?xml version="1.0"?>
<chapter xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Books of the other guy..</title>
<title>Los libros de otra persona</title>
<para>
<row xml:base="/home/didou/book.xml">
<entry>The Grapes of Wrath</entry>

33
reference/dom/domdocumenttype.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<!-- EN-Revision: 63ea498c8479333b05441d8b00f03980ccdfd9d2 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<reference xml:id="class.domdocumenttype" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>La clase DOMDocumentType</title>
<titleabbrev>DOMDocumentType</titleabbrev>
@@ -12,7 +12,7 @@
&reftitle.intro;
<para>
Cada <classname>DOMDocument</classname> tiene un atributo <literal>doctype</literal>
cuyo valor es &null; o un objeto <classname>DOMDocumentType</classname>.
cuyo valor es o bien &null;, o bien un objeto <classname>DOMDocumentType</classname>.
</para>
</section>
<!-- }}} -->
@@ -31,6 +31,11 @@
<classname>DOMNode</classname>
</ooclass>
<classsynopsisinfo role="comment">&InheritedConstants;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.domnode')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Constants;']]))">
<xi:fallback/>
</xi:include>
<classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
<fieldsynopsis>
<modifier>public</modifier>
@@ -90,15 +95,15 @@
<varlistentry xml:id="domdocumenttype.props.publicid">
<term><varname>publicId</varname></term>
<listitem>
<para>El identificador público del subconjunto externo.</para>
<para>El identificador público del subset externo.</para>
</listitem>
</varlistentry>
<varlistentry xml:id="domdocumenttype.props.systemid">
<term><varname>systemId</varname></term>
<listitem>
<para>
El identificador de sistema del subconjunto externo. Puede ser o no una
URI absoluta.
El identificador de sistema del subset externo. Puede ser una
<acronym>URI</acronym> absoluta o no.
</para>
</listitem>
</varlistentry>
@@ -106,8 +111,8 @@
<term><varname>name</varname></term>
<listitem>
<para>
El nombre del DTD; es decir, el nombre que siguie inmediatemante a la
palabra clave <literal>DOCTYPE</literal>.
El nombre de la <acronym>DTD</acronym>; es decir, el nombre que sigue
inmediatamente a la palabra clave <literal>DOCTYPE</literal>.
</para>
</listitem>
</varlistentry>
@@ -115,8 +120,8 @@
<term><varname>entities</varname></term>
<listitem>
<para>
Un objeto <classname>DOMNamedNodeMap</classname> que contiene las entidades
generales, externas e internas, declaradas en el DTD.
Un <classname>DOMNamedNodeMap</classname> que contiene las entidades
generales, tanto externas como internas, declaradas en la <acronym>DTD</acronym>.
</para>
</listitem>
</varlistentry>
@@ -124,8 +129,8 @@
<term><varname>notations</varname></term>
<listitem>
<para>
Un objeto <classname>DOMNamedNodeMap</classname> que contiene las notaciones
declaradas en el DTD.
Un <classname>DOMNamedNodeMap</classname> que contiene las notaciones,
declaradas en la <acronym>DTD</acronym>.
</para>
</listitem>
</varlistentry>
@@ -133,8 +138,8 @@
<term><varname>internalSubset</varname></term>
<listitem>
<para>
El subconjunto interno como cadena, o &null; si no hay ninguno. No contiene
los corchetes delimitadores.
El subset interno, en forma de &string;, o &null; si no existe. Esta cadena
no contiene los corchetes delimitadores.
</para>
</listitem>
</varlistentry>

20
reference/dom/domelement/setattributenode.xml
View File

@@ -1,10 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 656d1610af1a960d87c8b7056e54d0d4c75fb123 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<!-- EN-Revision: b984d18e783b295fa78bd8a8a3e673311c5be65e Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="domelement.setattributenode" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>DOMElement::setAttributeNode</refname>
<refpurpose>Añade un nuevo nodo de atributo al elemento</refpurpose>
<refpurpose>Añade un nuevo atributo al elemento</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
@@ -13,7 +13,9 @@
<methodparam><type>DOMAttr</type><parameter>attr</parameter></methodparam>
</methodsynopsis>
<para>
Añade el nuevo nodo de atributo dado por <parameter>attr</parameter> al elemento.
Añade un nuevo atributo <parameter>attr</parameter> al elemento.
Si ya existe un atributo con el mismo nombre en el elemento, este atributo es reemplazado por
<parameter>attr</parameter>.
</para>
</refsect1>
<refsect1 role="parameters">
@@ -24,7 +26,7 @@
<term><parameter>attr</parameter></term>
<listitem>
<para>
El nodo de atributo.
El atributo.
</para>
</listitem>
</varlistentry>
@@ -34,7 +36,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve el nodo antiguo si el atributo ha sido reemplazado o &null;.
Devuelve el atributo antiguo si ha sido reemplazado o &null; si no había un atributo antiguo.
Si se produce un error <constant>DOM_WRONG_DOCUMENT_ERR</constant> y <varname
linkend="domdocument.props.stricterrorchecking">strictErrorChecking</varname> es &false;, entonces &false; es devuelto.
</para>
</refsect1>
<refsect1 role="errors">
@@ -42,10 +46,10 @@
<para>
<variablelist>
<varlistentry>
<term><constant>DOM_NO_MODIFICATION_ALLOWED_ERR</constant></term>
<term><constant>DOM_WRONG_DOCUMENT_ERR</constant></term>
<listitem>
<para>
Lanzado si el nodo es de sólo lectura.
Lanzado si <parameter>attr</parameter> pertenece a un documento diferente al del elemento.
</para>
</listitem>
</varlistentry>

20
reference/dom/domelement/setattributenodens.xml
View File

@@ -1,10 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 656d1610af1a960d87c8b7056e54d0d4c75fb123 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<!-- EN-Revision: b984d18e783b295fa78bd8a8a3e673311c5be65e Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="domelement.setattributenodens" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>DOMElement::setAttributeNodeNS</refname>
<refpurpose>Aña de un nuevo nodo de atributo al elemento</refpurpose>
<refpurpose>Añade un nuevo atributo al elemento</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
@@ -13,7 +13,9 @@
<methodparam><type>DOMAttr</type><parameter>attr</parameter></methodparam>
</methodsynopsis>
<para>
Añade el nuevo nodo atributo <parameter>attr</parameter> al elemento.
Añade un nuevo atributo <parameter>attr</parameter> al elemento, teniendo en cuenta el espacio de nombres (namespace):
Si ya existe un atributo con el mismo nombre en el elemento, este atributo es reemplazado por
<parameter>attr</parameter>.
</para>
</refsect1>
<refsect1 role="parameters">
@@ -24,7 +26,7 @@
<term><parameter>attr</parameter></term>
<listitem>
<para>
El nodo atributo.
El nombre del atributo.
</para>
</listitem>
</varlistentry>
@@ -34,7 +36,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve el antiguo nodo si el atributo ya sido reemplazado.
Devuelve el antiguo atributo si ha sido reemplazado o &null; si no había un atributo anterior.
Si se produce un error <constant>DOM_WRONG_DOCUMENT_ERR</constant> y <varname
linkend="domdocument.props.stricterrorchecking">strictErrorChecking</varname> es &false;, entonces se devuelve &false;.
</para>
</refsect1>
<refsect1 role="errors">
@@ -42,10 +46,10 @@
<para>
<variablelist>
<varlistentry>
<term><constant>DOM_NO_MODIFICATION_ALLOWED_ERR</constant></term>
<term><constant>DOM_WRONG_DOCUMENT_ERR</constant></term>
<listitem>
<para>
Lanzado si el nodo es de sólo lectura.
Se lanza si <parameter>attr</parameter> pertenece a un documento diferente al del elemento.
</para>
</listitem>
</varlistentry>

22
reference/dom/domelement/setidattributenode.xml
View File

@@ -1,10 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4f5e2b22575131fa5e9c3004b1c874e1acb06573 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<!-- EN-Revision: 6f103ee118aacbde15fc894eda6f3ce961548ceb Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="domelement.setidattributenode" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>DOMElement::setIdAttributeNode</refname>
<refpurpose>Declara el atributo especificado por su nodo como de tipo ID</refpurpose>
<refpurpose>Declara el atributo especificado por el nodo como de tipo ID</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
@@ -14,8 +14,8 @@
<methodparam><type>bool</type><parameter>isId</parameter></methodparam>
</methodsynopsis>
<para>
Declara el atributo especificado por <parameter>attr</parameter> como de
tipo ID.
Declara el atributo especificado por <parameter>attr</parameter>
como de tipo ID.
</para>
</refsect1>
<refsect1 role="parameters">
@@ -26,7 +26,7 @@
<term><parameter>attr</parameter></term>
<listitem>
<para>
El nodo atributo.
El atributo del nodo.
</para>
</listitem>
</varlistentry>
@@ -34,8 +34,8 @@
<term><parameter>isId</parameter></term>
<listitem>
<para>
Establecer a &true; si se quiere que <parameter>name</parameter> sea de tipo
ID, &false; si no.
Definir como &true; si se desea que <parameter>name</parameter>
sea de tipo ID, &false; en caso contrario.
</para>
</listitem>
</varlistentry>
@@ -58,15 +58,15 @@
<term><constant>DOM_NO_MODIFICATION_ALLOWED_ERR</constant></term>
<listitem>
<para>
Lanzado si el nodo es de sólo lectura.
Enviado si el nodo es de solo lectura.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>DOM_NOT_FOUND</constant></term>
<term><constant>DOM_NOT_FOUND_ERR</constant></term>
<listitem>
<para>
Lanzado si <parameter>name</parameter> no es un atributo de este elemento.
Enviado si <parameter>name</parameter> no es un atributo de este elemento.
</para>
</listitem>
</varlistentry>

71
reference/dom/domentity.xml
View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<!-- EN-Revision: d75a54118772b34c7a538962ac5f994900c99690 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<reference xml:id="class.domentity" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>La clase DOMEntity</title>
<title>La classe DOMEntity</title>
<titleabbrev>DOMEntity</titleabbrev>
<partintro>
@@ -11,7 +11,8 @@
<section xml:id="domentity.intro">
&reftitle.intro;
<para>
Esta interfaz representa una entidad conocida, analizada o sin analizar, de un documento XML.
Esta interfaz representa una entidad conocida, analizada o no, en un
documento XML.
</para>
</section>
<!-- }}} -->
@@ -30,6 +31,11 @@
<classname>DOMNode</classname>
</ooclass>
<classsynopsisinfo role="comment">&InheritedConstants;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.domnode')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Constants;']]))">
<xi:fallback/>
</xi:include>
<classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
<fieldsynopsis>
<modifier>public</modifier>
@@ -54,21 +60,18 @@
<modifier>readonly</modifier>
<type class="union"><type>string</type><type>null</type></type>
<varname linkend="domentity.props.actualencoding">actualEncoding</varname>
<initializer>null</initializer>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>readonly</modifier>
<type class="union"><type>string</type><type>null</type></type>
<varname linkend="domentity.props.encoding">encoding</varname>
<initializer>null</initializer>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>readonly</modifier>
<type class="union"><type>string</type><type>null</type></type>
<varname linkend="domentity.props.version">version</varname>
<initializer>null</initializer>
</fieldsynopsis>
<classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
@@ -93,8 +96,8 @@
<term><varname>publicId</varname></term>
<listitem>
<para>
El identificador público asociado con la entidad si se especifica, y
si no &null;.
El identificador público asociado con la entidad, si está especificado, y &null;
de lo contrario.
</para>
</listitem>
</varlistentry>
@@ -102,8 +105,8 @@
<term><varname>systemId</varname></term>
<listitem>
<para>
El identificador de sistema asociado con la entidad si se especifica, y
si no &null;. Puede ser o no una URI absoluta.
El identificador del sistema asociado con la entidad, si está especificado, y
&null; de lo contrario. Puede ser una URI absoluta o relativa.
</para>
</listitem>
</varlistentry>
@@ -111,8 +114,8 @@
<term><varname>notationName</varname></term>
<listitem>
<para>
Para entidades no analizadas, el nombre de la notación de la entidad. Para
entidades analizadas es &null;.
Para las entidades no analizadas, el nombre de la notación de la entidad.
Para las entidades analizadas, vale &null;.
</para>
</listitem>
</varlistentry>
@@ -120,10 +123,8 @@
<term><varname>actualEncoding</varname></term>
<listitem>
<para>
Un atributo que especifica la codificación usada para esta entidad en el
momento de analizar, cuando es una entidad analizada externa. Es
&null; si es una entidad de un subconjunto interno o si es
desconocida.
<emphasis>Deprecado a partir de PHP 8.4.0</emphasis>.
Esto siempre ha sido igual a &null;.
</para>
</listitem>
</varlistentry>
@@ -131,9 +132,8 @@
<term><varname>encoding</varname></term>
<listitem>
<para>
Un atributo que especifica, como parte de la declaración de texto, la
codificación de esta entirdad, cuando es una entidad analizada externa. Si no,
es &null;.
<emphasis>Deprecado a partir de PHP 8.4.0</emphasis>.
Esto siempre ha sido igual a &null;.
</para>
</listitem>
</varlistentry>
@@ -141,9 +141,8 @@
<term><varname>version</varname></term>
<listitem>
<para>
Un atributo que especifica, como parte de la declaración de texto, el
número de versión de esta entidad, cuando es una entidad analizada
externa. Si no, es &null;.
<emphasis>Deprecado a partir de PHP 8.4.0</emphasis>.
Esto siempre ha sido igual a &null;.
</para>
</listitem>
</varlistentry>
@@ -151,6 +150,31 @@
</section>
<!-- }}} -->
<section role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
<varname>actualEncoding</varname>,
<varname>encoding</varname>, y
<varname>version</varname> ahora están oficialmente depreciados porque siempre han sido
iguales a &null;.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</section>
<!-- {{{ See also -->
<!--
<section role="seealso">
@@ -166,7 +190,6 @@
</partintro>
</reference>
<!-- Keep this comment at the end of the file
Local variables:

63
reference/dom/domentityreference.xml
View File

@@ -1,35 +1,16 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<!--
Remove me once you perform substitutions
domentityreference
DOMEntityReference
domnode
DOMNode
dom
-->
<!-- EN-Revision: d75a54118772b34c7a538962ac5f994900c99690 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<reference xml:id="class.domentityreference" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>La clase DOMEntityReference</title>
<title>&class.theclass; <classname>DOMEntityReference</classname></title>
<titleabbrev>DOMEntityReference</titleabbrev>
<partintro>
<!-- {{{ DOMEntityReference intro -->
<!--
<section xml:id="domentityreference.intro">
&reftitle.intro;
<para>
</para>
</section>
-->
<!-- }}} -->
<section xml:id="domentityreference.synopsis">
&reftitle.classsynopsis;
<!-- {{{ Synopsis -->
<!-- {{{ Synopsis -->
<classsynopsis class="class">
<ooclass>
<classname>DOMEntityReference</classname>
@@ -40,6 +21,11 @@ Remove me once you perform substitutions
<classname>DOMNode</classname>
</ooclass>
<classsynopsisinfo role="comment">&InheritedConstants;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.domnode')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Constants;']]))">
<xi:fallback/>
</xi:include>
<classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.domnode')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Properties;']]))">
<xi:fallback/>
@@ -55,39 +41,10 @@ Remove me once you perform substitutions
<xi:fallback/>
</xi:include>
</classsynopsis>
<!-- }}} -->
<!-- }}} -->
</section>
<!-- {{{ DOMEntityReference properties -->
<!--
<section xml:id="domentityreference.props">
&reftitle.properties;
<variablelist>
<varlistentry xml:id="domentityreference.props.name">
<term><varname>name</varname></term>
<listitem>
<para>Prop description</para>
</listitem>
</varlistentry>
</variablelist>
</section>
-->
<!-- }}} -->
<!-- {{{ See also -->
<!--
<section role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><link xlink:href="&url.spec.dom3.;">W3C specification for</link></member>
</simplelist>
</para>
</section>
-->
<!-- }}} -->
</partintro>
&reference.dom.entities.domentityreference;

49
reference/dom/domexception.xml
View File

@@ -1,37 +1,31 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: seros Status: ready -->
<!-- EN-Revision: d6928bea11be0e97b9d72588d44eb3c96f863b64 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<!--
FIXME: Remove me once you perform substitutions
domexception
DOMException
exception
Exception
dom
-->
<reference xml:id="class.domexception" role="exception" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>La clase DOMException</title>
<title>&class.theclass; DOMException / Dom\Exception</title>
<titleabbrev>DOMException</titleabbrev>
<partintro>
<!-- {{{ DOMException intro -->
<!-- {{{ DOMException intro -->
<section xml:id="domexception.intro">
&reftitle.intro;
<simpara>
Las operaciones DOM lanzan excepciones en circunstancias particulares, es decir, cuando no es posible ejecutar una operación por razones lógicas.
</simpara>
<simpara>
Esta clase se aliasa bajo el nombre <classname>Dom\Exception</classname> en el espacio de nombres Dom.
</simpara>
<para>
Las operaciones DOM lanzan excepciones bajo circunstancias particulares, esto es,
cuando es imposible de realizar una operación por razones lógicas.
</para>
<para>
Véase también <xref linkend="language.exceptions"/>.
Ver también <xref linkend="language.exceptions"/>.
</para>
</section>
<!-- }}} -->
<!-- }}} -->
<section xml:id="domexception.synopsis">
&reftitle.classsynopsis;
<!-- {{{ Synopsis -->
<!-- {{{ Synopsis -->
<classsynopsis class="class">
<ooexception>
<modifier>final</modifier>
@@ -63,11 +57,11 @@ FIXME: Remove me once you perform substitutions
<xi:fallback/>
</xi:include>
</classsynopsis>
<!-- }}} -->
<!-- }}} -->
</section>
<!-- {{{ DOMException properties -->
<!-- {{{ DOMException properties -->
<section xml:id="domexception.props">
&reftitle.properties;
<variablelist>
@@ -79,21 +73,6 @@ FIXME: Remove me once you perform substitutions
</varlistentry>
</variablelist>
</section>
<!-- }}} -->
<!-- {{{ See also -->
<!--
<section role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><link xlink:href="&url.spec.dom3.;">W3C specification for</link></member>
</simplelist>
</para>
</section>
-->
<!-- }}} -->
</partintro>
</reference>

Some files were not shown because too many files have changed in this diff Show More