archived-doc-es/reference/calendar/functions/easter-date.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 8b5940cadeb4f1c8492f4a7f70743a2be807cf39 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.easter-date" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>easter_date</refname>
  <refpurpose>Obtener la fecha Unix para la medianoche de Pascua de un año dado</refpurpose>
 </refnamediv>
 
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>int</type><methodname>easter_date</methodname>
   <methodparam choice="opt"><type>int</type><parameter>year</parameter><initializer>date("Y")</initializer></methodparam>
  </methodsynopsis>
  <para>
   Devuelve la fecha Unix correspondiente a la medianoche de Pascua del
   año dado.
  </para>
  <warning>
   <para>
    Esta función generará una advertencia si el año está fuera
    del rango de fechas Unix (esto es, antes de 1970 o después de 2037).
   </para>
  </warning>
  <para>
   La fecha del Domiongo de Pascua fue definida por el Concilio de Nicea en
   el año 325 D.C. como el domingo después de la primera luna llena que cae en
   o después del Equinocio de Primavera. El equinocio se asume que cae en
   el 21 de marzo, por lo que el cálculo se reduce a determinar la fecha
   de la luna llena y la fecha del siguiente domingo. El
   algoritmo que se usa aquí fue introducido alrededor del año 532 por
   Dionisio el Exiguo. Bajo el Calendario Juliano (para años anteriores a
   1753) se usa un simple ciclo de 19 años para rastrear las fases de la
   luna. Bajo el Calendario Gregoriano (para años posteriores a 1753 -
   concebido por Clavio y Lilio, e introducido por el papa Gregorio
   XIII en Octubre de 1582, e introducido en Gran Bretaña y sus colonias en
   Septiembre de 1752) se añadieron dos factores de corrección para hacer el
   ciclo más exacto.
  </para>
 </refsect1>
 
 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>year</parameter></term>
     <listitem>
      <para>
       El año como un número entre 1970 y 2037. Si se omite, el valor predeterminado  será el del
       año actual según la hora local.
      </para>
     </listitem>
    </varlistentry>  
   </variablelist>
  </para>
 </refsect1>
 
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   El Domingo de Pascua como fecha Unix.
  </para>
 </refsect1>
 
 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Ejemplo de <function>easter_date</function></title>
    <programlisting role="php">
<![CDATA[
<?php

echo date("M-d-Y", easter_date(1999));        // Apr-04-1999
echo date("M-d-Y", easter_date(2000));        // Apr-23-2000
echo date("M-d-Y", easter_date(2001));        // Apr-15-2001

?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>
 
 <refsect1 role="notes">
  &reftitle.notes;
  <note>
   <para>
    <function>easter_date</function> depende de las función de hora en C de su
    sistema en vez de usar las funciones de fecha y hora internas de PHP. Como
    consecuencia, <function>easter_date</function> utiliza la
    variable de entorno <literal>TZ</literal> para determinar la zona horaria en la
    que debería operar, en lugar de usar la
    <link linkend="ini.date.timezone">zona horaria predeterminada</link> de PHP, la cual
    podría resultar en un comportamiento inesperado al usar esta función junto
    con otras funciones de fecha de PHP.
   </para>
   <para>
    Como atajo, se puede usar <function>easter_days</function> con
    <classname>DateTime</classname> y <classname>DateInterval</classname> para
    calcular el inico de la Semana Santa en la zona horario de su PHP como sigue:
   </para>
   <informalexample>
    <programlisting role="php">
<![CDATA[
<?php
function get_easter_datetime($año) {
    $base = new DateTime("$año-03-21");
    $días = easter_days($año);

    return $base->add(new DateInterval("P{$días}D"));
}

foreach (range(2012, 2015) as $año) {
    printf("La Semana Santa del %d cae en %s\n",
           $año,
           get_easter_datetime($año)->format('F j'));
}
?>
]]>
    </programlisting>
    &example.outputs;
    <screen>
<![CDATA[
La Semana Santa del 2012 cae en April 8
La Semana Santa del 2013 cae en March 31
La Semana Santa del 2014 cae en April 20
La Semana Santa del 2015 cae en April 5
]]>
    </screen>
   </informalexample>
  </note>
 </refsect1>
 
 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member>
     <function>easter_days</function> para calcular la Pascua
     antes de 1970 o después de 2037
    </member>
   </simplelist>
  </para>
 </refsect1>
 
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->