Fixing wrong commit

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@141967 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Fernando Correa da Conceição 2003-10-07 03:49:01 +00:00
parent a37ab2f355
commit 2975fe3874
21 changed files with 291 additions and 303 deletions

View file

@ -1,9 +1,9 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.2 $ -->
<!-- $Revision: 1.3 $ -->
<section id="calendar.installation">
&reftitle.install;
<para>
Para estas funções funcionarem, você precisa compilar o PHP com
To get these functions to work, you have to compile PHP with
<option role="configure">--enable-calendar</option>.
</para>
&windows.builtin;
@ -27,4 +27,4 @@ End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
-->

View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.5 $ -->
<!-- $Revision: 1.6 $ -->
<section id="calendar.constants">
&reftitle.constants;
&extension.constants;
@ -7,7 +7,7 @@
<varlistentry>
<term>
<constant>CAL_GREGORIAN</constant>
(<type>inteiro</type>)
(<type>integer</type>)
</term>
<listitem>
<simpara>
@ -18,7 +18,7 @@
<varlistentry>
<term>
<constant>CAL_JULIAN</constant>
(<type>inteiro</type>)
(<type>integer</type>)
</term>
<listitem>
<simpara>
@ -29,7 +29,7 @@
<varlistentry>
<term>
<constant>CAL_JEWISH</constant>
(<type>inteiro</type>)
(<type>integer</type>)
</term>
<listitem>
<simpara>
@ -40,7 +40,7 @@
<varlistentry>
<term>
<constant>CAL_FRENCH</constant>
(<type>inteiro</type>)
(<type>integer</type>)
</term>
<listitem>
<simpara>
@ -51,7 +51,7 @@
<varlistentry>
<term>
<constant>CAL_NUM_CALS</constant>
(<type>inteiro</type>)
(<type>integer</type>)
</term>
<listitem>
<simpara>
@ -62,7 +62,7 @@
<varlistentry>
<term>
<constant>CAL_DOW_DAYNO</constant>
(<type>inteiro</type>)
(<type>integer</type>)
</term>
<listitem>
<simpara>
@ -73,7 +73,7 @@
<varlistentry>
<term>
<constant>CAL_DOW_SHORT</constant>
(<type>inteiro</type>)
(<type>integer</type>)
</term>
<listitem>
<simpara>
@ -84,7 +84,7 @@
<varlistentry>
<term>
<constant>CAL_DOW_LONG</constant>
(<type>inteiro</type>)
(<type>integer</type>)
</term>
<listitem>
<simpara>
@ -95,7 +95,7 @@
<varlistentry>
<term>
<constant>CAL_MONTH_GREGORIAN_SHORT</constant>
(<type>inteiro</type>)
(<type>integer</type>)
</term>
<listitem>
<simpara>
@ -106,7 +106,7 @@
<varlistentry>
<term>
<constant>CAL_MONTH_GREGORIAN_LONG</constant>
(<type>inteiro</type>)
(<type>integer</type>)
</term>
<listitem>
<simpara>
@ -117,7 +117,7 @@
<varlistentry>
<term>
<constant>CAL_MONTH_JULIAN_SHORT</constant>
(<type>inteiro</type>)
(<type>integer</type>)
</term>
<listitem>
<simpara>
@ -128,7 +128,7 @@
<varlistentry>
<term>
<constant>CAL_MONTH_JULIAN_LONG</constant>
(<type>inteiro</type>)
(<type>integer</type>)
</term>
<listitem>
<simpara>
@ -139,7 +139,7 @@
<varlistentry>
<term>
<constant>CAL_MONTH_JEWISH</constant>
(<type>inteiro</type>)
(<type>integer</type>)
</term>
<listitem>
<simpara>
@ -150,7 +150,7 @@
<varlistentry>
<term>
<constant>CAL_MONTH_FRENCH</constant>
(<type>inteiro</type>)
(<type>integer</type>)
</term>
<listitem>
<simpara>
@ -160,13 +160,13 @@
</varlistentry>
</variablelist>
<para>
As constantes abaixo estão disponíveis à partir da versão 4.3.0 do <literal>PHP</literal> :
The following constants are available since <literal>PHP</literal> 4.3.0 :
</para>
<variablelist>
<varlistentry>
<term>
<constant>CAL_EASTER_DEFAULT</constant>
(<type>inteiro</type>)
(<type>integer</type>)
</term>
<listitem>
<simpara>
@ -177,7 +177,7 @@
<varlistentry>
<term>
<constant>CAL_EASTER_ROMAN</constant>
(<type>inteiro</type>)
(<type>integer</type>)
</term>
<listitem>
<simpara>
@ -188,7 +188,7 @@
<varlistentry>
<term>
<constant>CAL_EASTER_ALWAYS_GREGORIAN</constant>
(<type>inteiro</type>)
(<type>integer</type>)
</term>
<listitem>
<simpara>
@ -199,7 +199,7 @@
<varlistentry>
<term>
<constant>CAL_EASTER_ALWAYS_JULIAN</constant>
(<type>inteiro</type>)
(<type>integer</type>)
</term>
<listitem>
<simpara>
@ -209,13 +209,13 @@
</varlistentry>
</variablelist>
<para>
As constantes abaixo estão disponíveis à partir da versão 5.0.0 do <literal>PHP</literal> :
The following constants are available since <literal>PHP</literal> 5.0.0 :
</para>
<variablelist>
<varlistentry>
<term>
<constant>CAL_JEWISH_ADD_ALAFIM_GERESH</constant>
(<type>inteiro</type>)
(<type>integer</type>)
</term>
<listitem>
<simpara>
@ -226,7 +226,7 @@
<varlistentry>
<term>
<constant>CAL_JEWISH_ADD_ALAFIM</constant>
(<type>inteiro</type>)
(<type>integer</type>)
</term>
<listitem>
<simpara>
@ -237,7 +237,7 @@
<varlistentry>
<term>
<constant>CAL_JEWISH_ADD_GERESHAYIM</constant>
(<type>inteiro</type>)
(<type>integer</type>)
</term>
<listitem>
<simpara>

View file

@ -1,39 +1,39 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.4 $ -->
<!-- $Revision: 1.5 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.19 -->
<refentry id="function.cal-days-in-month">
<refnamediv>
<refname>cal_days_in_month</refname>
<refpurpose>Retorna o número de dias em um mês de um calendário e ano requisitado</refpurpose>
<refpurpose>Return the number of days in a month for a given year and calendar</refpurpose>
</refnamediv>
<refsect1>
<title>Descrição</title>
<title>Description</title>
<methodsynopsis>
<type>int</type><methodname>cal_days_in_month</methodname>
<methodparam><type>int</type><parameter>calendario</parameter></methodparam>
<methodparam><type>int</type><parameter>mês</parameter></methodparam>
<methodparam><type>int</type><parameter>ano</parameter></methodparam>
<methodparam><type>int</type><parameter>calendar</parameter></methodparam>
<methodparam><type>int</type><parameter>month</parameter></methodparam>
<methodparam><type>int</type><parameter>year</parameter></methodparam>
</methodsynopsis>
<para>
ESta função irá retornar o número de dias em um
<parameter>month</parameter> do <parameter>ano</parameter> para
o <parameter>calendário</parameter> especificado.
This function will return the number of days in the
<parameter>month</parameter> of <parameter>year</parameter> for
the specified <parameter>calendar</parameter>.
</para>
<para>
<example>
<title><function>cal_days_in_month</function> exemplo</title>
<title><function>cal_days_in_month</function> example</title>
<programlisting role="php">
<![CDATA[
<?php
$num = cal_days_in_month(CAL_GREGORIAN, 8, 2003); // 31
echo "Houve $num dias em Agosto de 2003";
echo "There was $num days in August 2003";
?>
]]>
</programlisting>
</example>
</para>
<para>
Veja também <function>jdtounix</function>.
See also <function>jdtounix</function>.
</para>
</refsect1>
</refentry>

View file

@ -1,41 +1,41 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.6 $ -->
<!-- $Revision: 1.7 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.19 -->
<refentry id='function.cal-from-jd'>
<refnamediv>
<refname>cal_from_jd</refname>
<refpurpose>Converte à partir do "Julian Day Count" para um outro calendário suportado</refpurpose>
<refpurpose>Converts from Julian Day Count to a supported calendar</refpurpose>
</refnamediv>
<refsect1>
<title>Descrição</title>
<title>Description</title>
<methodsynopsis>
<type>array</type><methodname>cal_from_jd</methodname>
<methodparam><type>int</type><parameter>jd</parameter></methodparam>
<methodparam><type>int</type><parameter>calendário</parameter></methodparam>
<methodparam><type>int</type><parameter>calendar</parameter></methodparam>
</methodsynopsis>
<para>
<function>cal_from_jd</function> converte do "Julian Day Count" (
<parameter>jd</parameter>) para uma data de um
<parameter>calendário</parameter> especificado. Os valores dos
<parameter>calendários</parameter> suportados são
<function>cal_from_jd</function> converts the julian day given in
<parameter>jd</parameter> into a date of the specified
<parameter>calendar</parameter>. Supported
<parameter>calendar</parameter> values are
<constant>CAL_GREGORIAN</constant>,
<constant>CAL_JULIAN</constant>,
<constant>CAL_JEWISH</constant> e
<constant>CAL_JEWISH</constant> and
<constant>CAL_FRENCH</constant>.
</para>
<para>
<example>
<title><function>cal_from_jd</function> exemplo</title>
<title><function>cal_from_jd</function> example</title>
<programlisting role="php">
<![CDATA[
<?php
$hoje = unixtojd(mktime(0, 0, 0, 8, 16, 2003));
print_r(cal_from_jd($hoje, CAL_GREGORIAN));
$today = unixtojd(mktime(0, 0, 0, 8, 16, 2003));
print_r(cal_from_jd($today, CAL_GREGORIAN));
?>
]]>
</programlisting>
<para>
Este código retorna:
This will output :
</para>
<screen>
<![CDATA[
@ -56,7 +56,7 @@ Array
</example>
</para>
<para>
Veja também <function>cal_to_jd</function>.
See also <function>cal_to_jd</function>.
</para>
</refsect1>
</refentry>

View file

@ -1,32 +1,32 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.7 $ -->
<!-- $Revision: 1.8 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.19 -->
<refentry id='function.cal-info'>
<refnamediv>
<refname>cal_info</refname>
<refpurpose>Retorna informações sobre um calendário em particular</refpurpose>
<refpurpose>Returns information about a particular calendar</refpurpose>
</refnamediv>
<refsect1>
<title>Descrição</title>
<title>Description</title>
<methodsynopsis>
<type>array</type><methodname>cal_info</methodname>
<methodparam choice='opt'><type>int</type><parameter>calendário</parameter></methodparam>
<methodparam choice='opt'><type>int</type><parameter>calendar</parameter></methodparam>
</methodsynopsis>
<para>
<function>cal_info</function> retorna as informações de um
<parameter>calendário</parameter> específico ou de todos os calendários
se nenhum <parameter>calendário</parameter> for especificado.
<function>cal_info</function> returns information on the
specified <parameter>calendar</parameter> or on all supported
calendars if no <parameter>calendar</parameter> is specified.
</para>
<para>
A informação do calendário especificado é retornada em um array contendo os
elementos <literal>calname</literal>, <literal>calsymbol</literal>,
<literal>month</literal>, <literal>abbrevmonth</literal> e
Calendar information is returned as an array containing the
elements <literal>calname</literal>, <literal>calsymbol</literal>,
<literal>month</literal>, <literal>abbrevmonth</literal> and
<literal>maxdaysinmonth</literal>.
</para>
<para>
Se nenhum <parameter>calendário</parameter> foi especificado as informações de
todos os calendários suportados são retornadas em um array. Esta funcionalidade
será suportada à partir do PHP 5.
If no <parameter>calendar</parameter> is specified information on all
supported calendars is returned as an array. This functionality
will be available beginning with PHP 5.
</para>
</refsect1>
</refentry>

View file

@ -1,31 +1,31 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.5 $ -->
<!-- $Revision: 1.6 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.19 -->
<refentry id='function.cal-to-jd'>
<refnamediv>
<refname>cal_to_jd</refname>
<refpurpose>Converte um calendário (suportado) para o calendário "Julian Day Count"</refpurpose>
<refpurpose>Converts from a supported calendar to Julian Day Count</refpurpose>
</refnamediv>
<refsect1>
<title>Descrião</title>
<title>Description</title>
<methodsynopsis>
<type>int</type><methodname>cal_to_jd</methodname>
<methodparam><type>int</type><parameter>calendário</parameter></methodparam>
<methodparam><type>int</type><parameter>mês</parameter></methodparam>
<methodparam><type>int</type><parameter>dia</parameter></methodparam>
<methodparam><type>int</type><parameter>ano</parameter></methodparam>
<methodparam><type>int</type><parameter>calendar</parameter></methodparam>
<methodparam><type>int</type><parameter>month</parameter></methodparam>
<methodparam><type>int</type><parameter>day</parameter></methodparam>
<methodparam><type>int</type><parameter>year</parameter></methodparam>
</methodsynopsis>
<para>
<function>cal_to_jd</function> calcula uma data em formato "Julian Day Count"
à partir de um <parameter>calendário</parameter> suportado especificado.
Os <parameter>calendários</parameter> suportados são:
<function>cal_to_jd</function> calculates the julian day count
for a date in the specified <parameter>calendar</parameter>.
Supported <parameter>calendar</parameter>s are
<constant>CAL_GREGORIAN</constant>,
<constant>CAL_JULIAN</constant>,
<constant>CAL_JEWISH</constant> e
<constant>CAL_JEWISH</constant> and
<constant>CAL_FRENCH</constant>.
</para>
<para>
Veja também <function>cal_to_jd</function>.
See also <function>cal_to_jd</function>.
</para>
</refsect1>
</refentry>

View file

@ -1,39 +1,34 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.5 $ -->
<!-- $Revision: 1.6 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.2 -->
<!--
A.D -> anno dommini (depois de cristo) D.C
B.C -> before christ (antes de cristo) A.C
-->
<refentry id="function.easter-date">
<refnamediv>
<refname>easter_date</refname>
<refpurpose>
Retorna a data do sistema UNIX correspondente à meia-noite da Páscoa do ano especificado.
Se nenhum ano tiver sido especificado, será assumido o ano atual.
Get UNIX timestamp for midnight on Easter of a given year
</refpurpose>
</refnamediv>
<refsect1>
<title>Descrição</title>
<title>Description</title>
<methodsynopsis>
<type>int</type><methodname>easter_date</methodname>
<methodparam choice="opt"><type>int</type><parameter>ano</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>year</parameter></methodparam>
</methodsynopsis>
<para>
Retorna a data do sistema UNIX correspondente à meia-noite da Páscoa do ano especificado.
Se nenhum ano tiver sido especificado, será assumido o ano atual.
Returns the UNIX timestamp corresponding to midnight on Easter of
the given year.
</para>
<para>
À partir da versão 4.3.0 <literal>PHP</literal>, e se omitido
o parâmetro <parameter>ano</parameter>, o padrão assumido é o ano
atual de acordo com a hora local.
Since <literal>PHP</literal> 4.3.0, the <parameter>year</parameter>
parameter is optional and defaults to the current year according to the
localtime if ommited.
</para>
<para>
<emphasis>Aviso</emphasis> Esta função irá gerar um aviso se
o ano está fora do padrão de datas do sistema UNIX (i.e. antes
de 1970 ou após 2037).
<emphasis>Warning:</emphasis> This function will generate
a warning if the year is outside of the range for UNIX
timestamps (i.e. before 1970 or after 2037).
<example>
<title><function>easter_date</function> exemplo</title>
<title><function>easter_date</function> example</title>
<programlisting role="php">
<![CDATA[
<?php
@ -48,25 +43,27 @@ echo date ("M-d-Y", easter_date(2001)); // Apr-15-2001
</example>
</para>
<para>
A data da Páscoa foi definida pelo Conselho de Nicaea em
DC325 como sendo o primeiro domingo após a primeira lua cheia
que cai no equinócio da primavera ou depois dele. O equinócio geralmente
cai perto do 21º de Março, logo, o cálculo resume-se à determinar a data
da lua cheia e a data do seguinte domingo. O algoritmo usado aqui foi
feito no ano 532 por Dionysius Exiguus. De acordo com o calendário "Julian" (para
anos anterioris à 1753) um simples ciclo de 19-anos é usado para seguir as
fases da lua. De acordo com o Calendário Gregoriano (para antes após 1753 -
planejado por Clavius e por Lilius, e feito por Pope Gregory XIII em Outubro
de 1582, e na Grã Bretanha e suas colônias em Setembro de 1752), duas correções
fatoriais foram adicionadas para fazer o ciclo mais exato.
The date of Easter Day was defined by the Council of Nicaea in
AD325 as the Sunday after the first full moon which falls on or
after the Spring Equinox. The Equinox is assumed to always fall
on 21st March, so the calculation reduces to determining the date
of the full moon and the date of the following Sunday. The
algorithm used here was introduced around the year 532 by
Dionysius Exiguus. Under the Julian Calendar (for years before
1753) a simple 19-year cycle is used to track the phases of the
Moon. Under the Gregorian Calendar (for years after 1753 -
devised by Clavius and Lilius, and introduced by Pope Gregory
XIII in October 1582, and into Britain and its then colonies in
September 1752) two correction factors are added to make the
cycle more accurate.
</para>
<para>
(O código é baseado em um programa feito em C por Simon Kershaw,
(The code is based on a C program by Simon Kershaw,
&lt;webmaster@ely.anglican.org&gt;)
</para>
<para>
Veja <function>easter_days</function> para calcular a Páscoa
antes de 1970 ou após 2037.
See <function>easter_days</function> for calculating Easter
before 1970 or after 2037.
</para>
</refsect1>
</refentry>

View file

@ -1,44 +1,46 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.5 $ -->
<!-- $Revision: 1.6 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.2 -->
<refentry id="function.easter-days">
<refnamediv>
<refname>easter_days</refname>
<refpurpose>
Obtém o número de dias entre 21 de Março e o dia da Páscoa em
determinado ano.
Get number of days after March 21 on which Easter falls for a
given year
</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>int</type><methodname>easter_days</methodname>
<methodparam choice="opt"><type>int</type><parameter>ano</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>método</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>year</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>method</parameter></methodparam>
</methodsynopsis>
<para>
Retorna o número de dias entre 21 de Março e o dia da Páscoa em
determinado ano. Se nenhum ano tiver sido especificado, será assumido
o ano atual.
Returns the number of days after March 21 on which Easter falls
for a given year. If no year is specified, the current year is
assumed.
</para>
<para>
À partir da versão 4.3.0 do <literal>PHP</literal>, o parâmetro <parameter>ano</parameter>
é opcional e se for omitido o padrão assumido é o ano atual de acrodo com o hora local.
Since <literal>PHP</literal> 4.3.0, the <parameter>year</parameter>
parameter is optional and defaults to the current year according to the
localtime if ommited.
</para>
<para>
O parâmetro <parameter>método</parameter> está disponível à partir da versão
4.3.0 do <literal>PHP</literal> e perimite calcular as datas da Páscoa baseadas no
calendário Gregoriano durante os anos 1582 - 1752 quando a constante
<constant>CAL_EASTER_ROMAN</constant> está ligada. Veja as
<link linkend="calendar.constants">constantes de calendário</link> para obter
outras constantes válidas.
The <parameter>method</parameter> parameter was also introduced in
<literal>PHP</literal> 4.3.0 and allows to calculate easter dates based
on the Gregorian calendar during the years 1582 - 1752 when set to
<constant>CAL_EASTER_ROMAN</constant>. See the <link
linkend="calendar.constants">calendar constants</link> for more valid
constants.
</para>
<para>
Ao invés de usar a função <function>easter_date</function>,
você pode usar esta função para calcular a Páscoa em anos que estão
fora da escala de datas do sistema UNIX (i.e. antes de 1970 ou após 2037).
<example>
<title><function>easter_days</function> exemplo</title>
This function can be used instead of
<function>easter_date</function> to calculate Easter for years
which fall outside the range of UNIX timestamps (i.e. before 1970
or after 2037).
<example>
<title><function>easter_days</function> example</title>
<programlisting role="php">
<![CDATA[
<?php
@ -53,24 +55,26 @@ echo easter_days (1913); // 2, i.e. March 23
</example>
</para>
<para>
A data da Páscoa foi definida pelo Conselho de Nicaea em
DC325 como sendo o primeiro domingo após a primeira lua cheia
que cai no equinócio da primavera ou depois dele. O equinócio geralmente
cai perto do 21º de Março, logo, o cálculo resume-se à determinar a data
da lua cheia e a data do seguinte domingo. O algoritmo usado aqui foi
feito no ano 532 por Dionysius Exiguus. De acordo com o calendário "Julian" (para
anos anterioris à 1753) um simples ciclo de 19-anos é usado para seguir as
fases da lua. De acordo com o Calendário Gregoriano (para antes após 1753 -
planejado por Clavius e por Lilius, e feito por Pope Gregory XIII em Outubro
de 1582, e na Grã Bretanha e suas colônias em Setembro de 1752), duas correções
fatoriais foram adicionadas para fazer o ciclo mais exato.
The date of Easter Day was defined by the Council of Nicaea in
AD325 as the Sunday after the first full moon which falls on or
after the Spring Equinox. The Equinox is assumed to always fall
on 21st March, so the calculation reduces to determining the date
of the full moon and the date of the following Sunday. The
algorithm used here was introduced around the year 532 by
Dionysius Exiguus. Under the Julian Calendar (for years before
1753) a simple 19-year cycle is used to track the phases of the
Moon. Under the Gregorian Calendar (for years after 1753 -
devised by Clavius and Lilius, and introduced by Pope Gregory
XIII in October 1582, and into Britain and its then colonies in
September 1752) two correction factors are added to make the
cycle more accurate.
</para>
<para>
(O código é baseado em um programa feito em C por Simon Kershaw,
(The code is based on a C program by Simon Kershaw,
&lt;webmaster@ely.anglican.org&gt;)
</para>
<para>
Veja também <function>easter_date</function>.
See also <function>easter_date</function>.
</para>
</refsect1>
</refentry>

View file

@ -1,31 +1,31 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- $Revision: 1.4 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 -->
<refentry id="function.frenchtojd">
<refnamediv>
<refname>FrenchToJD</refname>
<refpurpose>
Converte uma data do calendário Republicano da França para o calendário
"Julian Day Count".
Converts a date from the French Republican Calendar to a Julian
Day Count
</refpurpose>
</refnamediv>
<refsect1>
<title>Descrição</title>
<title>Description</title>
<methodsynopsis>
<type>int</type><methodname>frenchtojd</methodname>
<methodparam><type>int</type><parameter>mês</parameter></methodparam>
<methodparam><type>int</type><parameter>dia</parameter></methodparam>
<methodparam><type>int</type><parameter>ano</parameter></methodparam>
<methodparam><type>int</type><parameter>month</parameter></methodparam>
<methodparam><type>int</type><parameter>day</parameter></methodparam>
<methodparam><type>int</type><parameter>year</parameter></methodparam>
</methodsynopsis>
<para>
Converte uma data do calendário Republicano da França para o calendário
"Julian Day Count".
Converts a date from the French Republican Calendar to a Julian
Day Count.
</para>
<para>
Estas rotinas somente converte datas entre os anos de 1 até 14
(datas Gregorianas de 22 de Setembro de 1792 até 22 de Setembro
de 1806). "This more than covers the period when the calendar was in
use."
These routines only convert dates in years 1 through 14
(Gregorian dates 22 September 1792 through 22 September
1806). This more than covers the period when the calendar was in
use.
</para>
</refsect1>
</refentry>

View file

@ -1,37 +1,33 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- $Revision: 1.4 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 -->
<!--
A.D -> anno dommini (depois de cristo) D.C
B.C -> before christ (antes de cristo) A.C
-->
<refentry id="function.gregoriantojd">
<refnamediv>
<refname>GregorianToJD</refname>
<refpurpose>
Converte uma data do calendário Gregoriano para o calendário "Julian Day Count".
Converts a Gregorian date to Julian Day Count
</refpurpose>
</refnamediv>
<refsect1>
<title>Descrição</title>
<title>Description</title>
<methodsynopsis>
<type>int</type><methodname>gregoriantojd</methodname>
<methodparam><type>int</type><parameter>mês</parameter></methodparam>
<methodparam><type>int</type><parameter>dia</parameter></methodparam>
<methodparam><type>int</type><parameter>ano</parameter></methodparam>
<methodparam><type>int</type><parameter>month</parameter></methodparam>
<methodparam><type>int</type><parameter>day</parameter></methodparam>
<methodparam><type>int</type><parameter>year</parameter></methodparam>
</methodsynopsis>
<para>
Escala válida para o Calendário Gregoriano: 4714 A.C. to 9999 D.C.</para>
Valid Range for Gregorian Calendar 4714 B.C. to 9999 A.D.</para>
<para>
Entretanto esta função pode trabalhar com todas datas anteriores à,
porém usá-la desta maneira não tem muito sentido. O Calendário Gregoriano
não foi instituído até 15 de Outubro de 1582 (ou 5 de Outubro de 1582, no
calendário JDC ("Julian Day Count")). Alguns países aceitaram este calendário
um pouco mais tarde. Por exemplo, a Grã Bretanha converteu-se em 1752, a URSS
em 1918 e a Grécia em 1923. A maioria dos países Europeus usaram o calendário
"Julian" (JDC) antes do calendário Gregoriano.
Although this function can handle dates all the way back to 4714
B.C., such use may not be meaningful. The Gregorian calendar was
not instituted until October 15, 1582 (or October 5, 1582 in the
Julian calendar). Some countries did not accept it until much
later. For example, Britain converted in 1752, The USSR in 1918
and Greece in 1923. Most European countries used the Julian
calendar prior to the Gregorian.
<example>
<title>Funções do Calendário</title>
<title>Calendar functions</title>
<programlisting role="php">
<![CDATA[
<?php

View file

@ -1,49 +1,49 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- $Revision: 1.4 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 -->
<refentry id="function.jddayofweek">
<refnamediv>
<refname>JDDayOfWeek</refname>
<refpurpose>Retorna o dia da semana</refpurpose>
<refpurpose>Returns the day of the week</refpurpose>
</refnamediv>
<refsect1>
<title>Descrição</title>
<title>Description</title>
<methodsynopsis>
<type>mixed</type><methodname>jddayofweek</methodname>
<methodparam><type>int</type><parameter>julianday</parameter></methodparam>
<methodparam><type>int</type><parameter>modo</parameter></methodparam>
<methodparam><type>int</type><parameter>mode</parameter></methodparam>
</methodsynopsis>
<para>
Retorna o dia da semana. Pode retornar uma "string" ou um inteiro
dependendo do modo utilizado.
Returns the day of the week. Can return a string or an integer
depending on the mode.
<table>
<title>Calendários da semana (modos)</title>
<title>Calendar week modes</title>
<tgroup cols="2">
<thead>
<row>
<entry>Modo</entry>
<entry>Significado</entry>
<entry>Mode</entry>
<entry>Meaning</entry>
</row>
</thead>
<tbody>
<row>
<entry>0</entry>
<entry>
Retonra o dia da semana como sendo um número inteiro (0=domingo, 1=segunda, etc.)
Returns the day number as an int (0=sunday, 1=monday, etc)
</entry>
</row>
<row>
<entry>1</entry>
<entry>
Retorna uma string contendo o dia da semana
(inglês-gregoriano)
Returns string containing the day of week
(english-gregorian)
</entry>
</row>
<row>
<entry>2</entry>
<entry>
Retorna uma "string" contendo a abreviação do dia da semana
(inglês-gregoriano)
Returns a string containing the abbreviated day of week
(english-gregorian)
</entry>
</row>
</tbody>

View file

@ -1,62 +1,62 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- $Revision: 1.4 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 -->
<refentry id="function.jdmonthname">
<refnamediv>
<refname>JDMonthName</refname>
<refpurpose>REtorna o nome de um mês</refpurpose>
<refpurpose>Returns a month name</refpurpose>
</refnamediv>
<refsect1>
<title>Descrição</title>
<title>Description</title>
<methodsynopsis>
<type>string</type><methodname>jdmonthname</methodname>
<methodparam><type>int</type><parameter>julianday</parameter></methodparam>
<methodparam><type>int</type><parameter>modo</parameter></methodparam>
<methodparam><type>int</type><parameter>mode</parameter></methodparam>
</methodsynopsis>
<para>
Retorna uma "string" contendo o nome do mês.
O parâmetro <parameter>modo</parameter> diz à função
qual calendário será convertido para o formato "Julian Day Count",
e o tipo do nome do mês.
Returns a string containing a month name.
<parameter>mode</parameter> tells this function which calendar to
convert the Julian Day Count to, and what type of month names are
to be returned.
<table>
<title>Calendário (modos)</title>
<title>Calendar modes</title>
<tgroup cols="3">
<thead>
<row>
<entry>Modo</entry>
<entry>Significado</entry>
<entry>Valores</entry>
<entry>Mode</entry>
<entry>Meaning</entry>
<entry>Values</entry>
</row>
</thead>
<tbody>
<row>
<entry>0</entry>
<entry>Gregoriano - abreviado</entry>
<entry>Jan, Fev, Mar, Abr, Mai, Jun, Jul, Ago, Set, Out, Nov, Dez</entry>
<entry>Gregorian - abbreviated</entry>
<entry>Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec</entry>
</row>
<row>
<entry>1</entry>
<entry>Gregoriano</entry>
<entry>Janeiro, Fevereiro, Março, Abril, Maio, Junho, Julho, Agosto, Setembro, Outubro, Novembro, Dezembro</entry>
<entry>Gregorian</entry>
<entry>January, February, March, April, May, June, July, August, September, October, November, December</entry>
</row>
<row>
<entry>2</entry>
<entry>"Julian" - abreviado</entry>
<entry>Jan, Fev, Mar, Abr, Mai, Jun, Jul, Ago, Set, Out, Nov, Dez</entry>
<entry>Julian - abbreviated</entry>
<entry>Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec</entry>
</row>
<row>
<entry>3</entry>
<entry>"Julian"</entry>
<entry>Janeiro, Fevereiro, Março, Abril, Maio, Junho, Julho, Agosto, Setembro, Outubro, Novembro, Dezembro</entry>
<entry>Julian</entry>
<entry>January, February, March, April, May, June, July, August, September, October, November, December</entry>
</row>
<row>
<entry>4</entry>
<entry>Judeu</entry>
<entry>Jewish</entry>
<entry>Tishri, Heshvan, Kislev, Tevet, Shevat, AdarI, AdarII, Nisan, Iyyar, Sivan, Tammuz, Av, Elul</entry>
</row>
<row>
<entry>5</entry>
<entry>Republicano Francês</entry>
<entry>French Republican</entry>
<entry>Vendemiaire, Brumaire, Frimaire, Nivose, Pluviose, Ventose, Germinal, Floreal, Prairial, Messidor, Thermidor, Fructidor, Extra</entry>
</row>
</tbody>

View file

@ -1,21 +1,21 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- $Revision: 1.4 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 -->
<refentry id="function.jdtofrench">
<refnamediv>
<refname>JDToFrench</refname>
<refpurpose>
Converte do calendário "Julian Day Count" para o calendário Republicano Francês
Converts a Julian Day Count to the French Republican Calendar
</refpurpose>
</refnamediv>
<refsect1>
<title>Descrição</title>
<title>Description</title>
<methodsynopsis>
<type>string</type><methodname>jdtofrench</methodname>
<methodparam><type>int</type><parameter>juliandaycount</parameter></methodparam>
</methodsynopsis>
<para>
Converte do calendário "Julian Day Count" para o calendário Republicano Francês
Converts a Julian Day Count to the French Republican Calendar.
</para>
</refsect1>
</refentry>

View file

@ -1,20 +1,20 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- $Revision: 1.4 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 -->
<refentry id="function.jdtogregorian">
<refnamediv>
<refname>JDToGregorian</refname>
<refpurpose>Converte uma data no formato "Julian Day Count" para o formato Gregoriano</refpurpose>
<refpurpose>Converts Julian Day Count to Gregorian date</refpurpose>
</refnamediv>
<refsect1>
<title>Descrição</title>
<title>Description</title>
<methodsynopsis>
<type>string</type><methodname>jdtogregorian</methodname>
<methodparam><type>int</type><parameter>julianday</parameter></methodparam>
</methodsynopsis>
<para>
Converte "Julian Day Count" para uma "string" contendo a data em
formato Gregoriano "mês/dia/ano".
Converts Julian Day Count to a string containing the Gregorian
date in the format of "month/day/year".
</para>
</refsect1>
</refentry>

View file

@ -1,15 +1,15 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.5 $ -->
<!-- $Revision: 1.6 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 -->
<refentry id="function.jdtojewish">
<refnamediv>
<refname>jdtojewish</refname>
<refpurpose>
Convete uma data do calendário "Julian Day Count" para o calendário Judaico
Converts a julian day count to a jewish calendar date
</refpurpose>
</refnamediv>
<refsect1>
<title>Descrição</title>
<title>Description</title>
<methodsynopsis>
<type>string</type><methodname>jdtojewish</methodname>
<methodparam><type>int</type><parameter>juliandaycount</parameter></methodparam>
@ -17,23 +17,23 @@
<methodparam choice="opt"><type>int</type><parameter>fl</parameter></methodparam>
</methodsynopsis>
<para>
Convete uma data do calendário "Julian Day Count" para o calendário Judaico
Converts a Julian Day Count the the Jewish Calendar.
</para>
<para>
Os parâmetros <parameter>hebrew</parameter> e <parameter>fl</parameter>
são opcionais e estarão disponíveis na versão do PHP 5.0.0
The optional <parameter>hebrew</parameter> and <parameter>fl</parameter>
parameters became available in PHP 5.0.0
</para>
<para>
Se o parâmetro <parameter>hebrew</parameter> for &true;, o parâmetro
<parameter>fl</parameter> a "string" de saída de dados é
baseada no formato "hebrew". Os formatos disponíveis são:
If the the <parameter>hebrew</parameter> parameter is set to &true;, the
<parameter>fl</parameter> parameter is used for hebrew, string based,
output format. The available formats are:
<constant>CAL_JEWISH_ADD_ALAFIM_GERESH</constant>,
<constant>CAL_JEWISH_ADD_ALAFIM</constant>,
<constant>CAL_JEWISH_ADD_GERESHAYIM</constant>.
</para>
<para>
<example>
<title><function>jdtojewish</function> Exemplo</title>
<title><function>jdtojewish</function> Example</title>
<programlisting role="php">
<![CDATA[
<?php

View file

@ -1,22 +1,22 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- $Revision: 1.4 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 -->
<refentry id="function.jdtojulian">
<refnamediv>
<refname>JDToJulian</refname>
<refpurpose>
Converte uma data do calendário "Julian Day Count" para o calendário "Julian"
Converts a Julian Day Count to a Julian Calendar Date
</refpurpose>
</refnamediv>
<refsect1>
<title>Descrição</title>
<title>Description</title>
<methodsynopsis>
<type>string</type><methodname>jdtojulian</methodname>
<methodparam><type>int</type><parameter>julianday</parameter></methodparam>
</methodsynopsis>
<para>
Converte "Julian Day Count" para uma "string" contendo a data
do calendário "Julian" no formato "mês/dia/ano".
Converts Julian Day Count to a string containing the Julian
Calendar Date in the format of "month/day/year".
</para>
</refsect1>
</refentry>

View file

@ -1,27 +1,27 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.4 $ -->
<!-- $Revision: 1.5 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.3 -->
<refentry id="function.jdtounix">
<refnamediv>
<refname>jdtounix</refname>
<refpurpose>Converte do formato "Julain Day" para o formato de datas do sistema UNIX ("timestamp")</refpurpose>
<refpurpose>Convert Julian Day to UNIX timestamp</refpurpose>
</refnamediv>
<refsect1>
<title>Descrição</title>
<title>Description</title>
<methodsynopsis>
<type>int</type><methodname>jdtounix</methodname>
<methodparam><type>int</type><parameter>jday</parameter></methodparam>
</methodsynopsis>
<para>
Esta função irá retorna a data do sistema UNIX correspondente ao
"Julian Day" especificado no parâmetro <parameter>jday</parameter> ou &false;
se <parameter>jday</parameter> não está dentre a escala de datas UNIX
(Anos Gregorianos entre 1970 e 2037 ou 2440588 &lt;=
<parameter>jday</parameter> &lt;= 2465342). A hora retornada é a
hora local (e não a GMT).
This function will return a UNIX timestamp corresponding to the
Julian Day given in <parameter>jday</parameter> or &false; if
<parameter>jday</parameter> is not inside the UNIX epoch
(Gregorian years between 1970 and 2037 or 2440588 &lt;=
<parameter>jday</parameter> &lt;= 2465342 ). The time returned is
localtime (and not GMT).
</para>
<para>
Veja também <function>unixtojd</function>.
See also <function>unixtojd</function>.
</para>
</refsect1>
</refentry>

View file

@ -1,31 +1,27 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- $Revision: 1.4 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 -->
<!--
A.D -> anno dommini (depois de cristo) D.C
B.C -> before christ (antes de cristo) A.C
-->
<refentry id="function.jewishtojd">
<refnamediv>
<refname>JewishToJD</refname>
<refpurpose>
Converte uma data do calendário Judaico para o calendário "Julian Day Count".
Converts a date in the Jewish Calendar to Julian Day Count
</refpurpose>
</refnamediv>
<refsect1>
<title>Descrição</title>
<title>Description</title>
<methodsynopsis>
<type>int</type><methodname>jewishtojd</methodname>
<methodparam><type>int</type><parameter>mês</parameter></methodparam>
<methodparam><type>int</type><parameter>dia</parameter></methodparam>
<methodparam><type>int</type><parameter>ano</parameter></methodparam>
<methodparam><type>int</type><parameter>month</parameter></methodparam>
<methodparam><type>int</type><parameter>day</parameter></methodparam>
<methodparam><type>int</type><parameter>year</parameter></methodparam>
</methodsynopsis>
<para>
Entretanto esta função suporta datas anteriores ao ano 1 (3761 A.C.),
porém tal uso não faz sentido. O calendário Judaico vem sendo usado por
centenas de anos, porém os primeiros dias não tem uma fórmula que
determina qual é o começo do mês. Um novo mês começa quando uma lua nova
é vista.
Although this function can handle dates all the way back to the year 1
(3761 B.C.), such use may not be meaningful. The Jewish calendar has
been in use for several thousand years, but in the early days there was
no formula to determine the start of a month. A new month was started
when the new moon was first observed.
</para>
</refsect1>
</refentry>

View file

@ -1,41 +1,37 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.4 $ -->
<!-- $Revision: 1.5 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 -->
<!--
A.D -> anno dommini (depois de cristo) D.C
B.C -> before christ (antes de cristo) A.C
-->
<refentry id="function.juliantojd">
<refnamediv>
<refname>JulianToJD</refname>
<refpurpose>
Converte datas no formato "Julian" para o formato "Julian Day Count"
Converts a Julian Calendar date to Julian Day Count
</refpurpose>
</refnamediv>
<refsect1>
<title>Descrição</title>
<title>Description</title>
<methodsynopsis>
<type>int</type><methodname>juliantojd</methodname>
<methodparam><type>int</type><parameter>mês</parameter></methodparam>
<methodparam><type>int</type><parameter>dia</parameter></methodparam>
<methodparam><type>int</type><parameter>ano</parameter></methodparam>
<methodparam><type>int</type><parameter>month</parameter></methodparam>
<methodparam><type>int</type><parameter>day</parameter></methodparam>
<methodparam><type>int</type><parameter>year</parameter></methodparam>
</methodsynopsis>
<para>
O Calendário "Julian" vai de 4713 A.C. até 9999 D.C.
Valid Range for Julian Calendar 4713 B.C. to 9999 A.D.
</para>
<para>
Entretanto esta função trabalha com datas anteriores à 4713 A.C,
porém tal uso não faz muito sentido. O calendário foi criado em
46 A.C., mas os detalhes não foram padronizados até o ano 8 D.C.,
e talvez mais tarde no 4º século. Além disso, o começo do ano
variou de uma cultura para outra - nem todas aceitaram o Janeiro
como sendo o primeiro mês.
Although this function can handle dates all the way back to 4713
B.C., such use may not be meaningful. The calendar was created in
46 B.C., but the details did not stabilize until at least 8 A.D.,
and perhaps as late at the 4th century. Also, the beginning of a
year varied from one culture to another - not all accepted
January as the first month.
</para>
<caution>
<para>
Lembre-se, o sistema atual de calendário que é usado mundialmente é
o Gregoriano. A função <function>gregoriantojd</function> pode ser
usada para converter datas no formato Gregoriano para o formato "Julian Day Count".
Remember, the current calendar system being used worldwide is the
Gregorian calendar. <function>gregoriantojd</function> can be used to
convert such dates to their Julian Day count.
</para>
</caution>
</refsect1>

View file

@ -1,24 +1,24 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- $Revision: 1.4 $ -->
<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.3 -->
<refentry id="function.unixtojd">
<refnamediv>
<refname>unixtojd</refname>
<refpurpose>Converte datas do sistema UNIX para o "Julian Day"</refpurpose>
<refpurpose>Convert UNIX timestamp to Julian Day</refpurpose>
</refnamediv>
<refsect1>
<title>Descrição</title>
<title>Description</title>
<methodsynopsis>
<type>int</type><methodname>unixtojd</methodname>
<methodparam choice="opt"><type>int</type><parameter>timestamp</parameter></methodparam>
</methodsynopsis>
<para>
Retorna o "Julian Day" para um UNIX <parameter>timestamp</parameter>
(segundos desde 1.1.1970), ou para o dia atual se nenhum
<parameter>timestamp</parameter> for especificado.
Return the Julian Day for a UNIX <parameter>timestamp</parameter>
(seconds since 1.1.1970), or for the current day if no
<parameter>timestamp</parameter> is given.
</para>
<para>
Veja também <function>jdtounix</function>.
See also <function>jdtounix</function>.
</para>
</refsect1>
</refentry>

View file

@ -1,24 +1,23 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.6 $ -->
<!-- $Revision: 1.7 $ -->
<reference id="ref.calendar">
<title>Calendário, funções</title>
<titleabbrev>Calendário</titleabbrev>
<title>Calendar functions</title>
<titleabbrev>Calendar</titleabbrev>
<partintro>
<section id="calendar.intro">
&reftitle.intro;
<para>
A extensão de calendário contém uma série de funções para simplificar
a conversão de diferentes formatos de calendários. O calendário padrão
é baseado no formato "Julian Day Count". A contagem de dias do calendário
"Julian Day Count" começa em 1º de Janeiro de 4713 B.C. Para converter
um calendário para algum formato, você deve primeiro convertê-lo para o
formato "Julian Day Count", então converter para o sistema de calendário
de sua escolha. O formato de calendário "Julian Day Count" é muito diferente
do "Julian Calendar"! Para mais informações sobre o calendário "Julian Day Count",
visite <ulink url="&url.calendar.jd;">&url.calendar.jd;</ulink>. Para mais informações
sobre sistemas de calendários, visite: <ulink
url="&url.calendar;">&url.calendar;</ulink>. "Excerpts from this page are
included in these instructions, and are in quotes".
The calendar extension presents a series of functions to simplify
converting between different calendar formats. The intermediary or
standard it is based on is the Julian Day Count. The Julian Day Count is
a count of days starting from January 1st, 4713 B.C. To convert between
calendar systems, you must first convert to Julian Day Count, then to the
calendar system of your choice. Julian Day Count is very different from
the Julian Calendar! For more information on Julian Day Count, visit
<ulink url="&url.calendar.jd;">&url.calendar.jd;</ulink>. For more
information on calendar systems visit <ulink
url="&url.calendar;">&url.calendar;</ulink>. Excerpts from this page are
included in these instructions, and are in quotes.
</para>
</section>