cynic Mon Feb 5 04:40:48 2001 EDT
Added files:
/phpdoc/cs/functions calendar.xml
Log:
should be completely translated
Index: phpdoc/cs/functions/calendar.xml
+++ phpdoc/cs/functions/calendar.xml
<reference id="ref.calendar">
<title>Kalend��ov� funkce</title>
<titleabbrev>Kalend��</titleabbrev>
<partintro>
<para>
Kalend��ov� funkce jsou p��stupn� pouze pokud m�te zkompilovanout calendar
extenzi um�st�nou v adres��i "dl" or "ext" ve zdrojov�m k�du PHP. P�ed jej�m
pou�it�m si pros�m p�e�t�te README soubor.
</para>
<para>
Calendar extenze p�edstavuje sadu funkc� ur�en�ch ke zjednodu�en� p�evod�
mezi r�zn�mi kalend��i. Prost�edn�kem nebo standardem, na kter�m je zalo�ena
je Julian Day Count. To je po�et dn� za��naj�c� daleko p�ed jak�mkoli datem
o kter� by se v�t�ina lid� zaj�mala (n�kde kolem 4000 p�. n. l.). Pokud
chcete p�ev�d�t mezi kalend��ov�mi syst�my, mus�te nejd��v p�ev�st na
Julian Day Count, potom na k��en� kalend��. Julian Day Count se velmi li��
od Juli�nsk�ho kaled��e! V�ce informac� o kalend��ov�ch syst�mech viz <ulink
url="&url.calendar;">&url.calendar;</ulink>. Tyto instrukce obsahuj� v��atky
z t�to str�nky (v uvozovk�ch).
</para>
</partintro>
<refentry id="function.jdtogregorian">
<refnamediv>
<refname>JDToGregorian</refname>
<refpurpose>P�ev�st Julian Day Count na Gregori�nsk� datum</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>jdtogregorian</function></funcdef>
<paramdef>int <parameter>julianday</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
P�ev�d� Julian Day Count na �et�zec obsahuj�c� Gregori�nsk� datum ve form�tu
"m�s�c/den/rok".
</para>
</refsect1>
</refentry>
<refentry id="function.gregoriantojd">
<refnamediv>
<refname>GregorianToJD</refname>
<refpurpose>P�ev�st Gregori�nsk� datum na Julian Day Count</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>gregoriantojd</function></funcdef>
<paramdef>int <parameter>month</parameter></paramdef>
<paramdef>int <parameter>day</parameter></paramdef>
<paramdef>int <parameter>year</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Platn� rozsah Gregori�nsk�ho kalend��e je 4714 p�. n. l. a� 9999 n. l.
</para>
<para>
Jakkoli tento software zvl�d� data a� do 4714 p�. n. l., takov� pou�it� asi
nem� smysl. Gregori�nsk� kalend�� byl zalo�en a� 15. ��jna 1582 (5. ��jna
1582 podle Juli�nsk�ho kalend��e). N�kter� zem� ho p�ijaly mnohem pozd�ji,
�ecko a� v r. 1923. V�t�ina evropsk�m st�t� p�ed Gregori�nsk�m kalend��em
pou��vala Juli�nsk�.
<example>
<title>Kalend��ov� funkce</title>
<programlisting role="php">
<?php
$jd = GregorianToJD (10,11,1970);
echo "$jd\n";
$gregorian = JDToGregorian ($jd);
echo "$gregorian\n";
?>
</programlisting>
</example>
</para>
</refsect1>
</refentry>
<refentry id="function.jdtojulian">
<refnamediv>
<refname>JDToJulian</refname>
<refpurpose>
P�ev�st Julian Day Count na Juli�nsk� datum
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>jdtojulian</function></funcdef>
<paramdef>int <parameter>julianday</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
P�ev�d� Julian Day Count na �et�zec obsahuj�c� Juli�nsk� datum ve form�tu
"m�s�c/den/rok".
</para>
</refsect1>
</refentry>
<refentry id="function.juliantojd">
<refnamediv>
<refname>JulianToJD</refname>
<refpurpose>
P�ev�st Juli�nsk� datum na Julian Day Count
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>juliantojd</function></funcdef>
<paramdef>int <parameter>month</parameter></paramdef>
<paramdef>int <parameter>day</parameter></paramdef>
<paramdef>int <parameter>year</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Platn� rozsah pro Juli�nsk� kalend�� je 4713 p�. n. l. a� 9999 n. l.
</para>
<para>
Jakkoli tento software zvl�d� data a� do 4713 p�. n. l., takov� pou�it� asi
nem� smysl. Tento kalend�� byl vytvo�en v roce 46 p�. n. l., ale detaily se
nestabilizovaly nejm�n� do 8 n. l., a mo�n� a� do konce 4. stolet�. Nav�c
za��tek roku se li�il od kultury ke kultu�e - ne v�echny p�ij�maly leden
jako prvn� m�s�c roku.
</para>
</refsect1>
</refentry>
<refentry id="function.jdtojewish">
<refnamediv>
<refname>JDToJewish</refname>
<refpurpose>
P�ev�st Julian Day Count na idovsk� kalend��
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>jdtojewish</function></funcdef>
<paramdef>int <parameter>julianday</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
P�ev�d� Julian Day Count na idovsk� kalend��.
</para>
</refsect1>
</refentry>
<refentry id="function.jewishtojd">
<refnamediv>
<refname>JewishToJD</refname>
<refpurpose>
P�ev�st datum podle idovsk�ho kalend��e na Julian Day Count
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>jewishtojd</function></funcdef>
<paramdef>int <parameter>month</parameter></paramdef>
<paramdef>int <parameter>day</parameter></paramdef>
<paramdef>int <parameter>year</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Platn� rozsah
Jakkoli tento software zvl�d� data a� do roku 1 (3761 p�. n. l.), takov�
pou�it� asi nem� smysl.
</para>
<para>
idovsk� kalend�� se pou��v� n�kolik tis�c let, ale zpo��tku neexistoval
vzorec na ur�en� za��tku m�s�ce. Nov� m�s�c za��nal, kdy� byl poprv� spat�en
nov� M�s�c.
</para>
</refsect1>
</refentry>
<refentry id="function.jdtofrench">
<refnamediv>
<refname>JDToFrench</refname>
<refpurpose>
P�ev�st Julian Day Count na Francouzsk� republik�nsk� kalend��
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>jdtofrench</function></funcdef>
<paramdef>int <parameter>juliandaycount</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
P�ev�d� Julian Day Count na Francouzsk� republik�nsk� kalend��.
</para>
</refsect1>
</refentry>
<refentry id="function.frenchtojd">
<refnamediv>
<refname>FrenchToJD</refname>
<refpurpose>
P�ev�st datum z Francouzsk�ho republik�nsk�ho kalend��e na Julian
Day Count
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>frenchtojd</function></funcdef>
<paramdef>int <parameter>month</parameter></paramdef>
<paramdef>int <parameter>day</parameter></paramdef>
<paramdef>int <parameter>year</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
P�ev�d� datum z Francouzsk�ho republik�nsk�ho kalend��e na Julian
Day Count.
</para>
<para>
Tyto rutiny konvertuj� pouze data v letech 1 a� 14 (Gregori�nsk� data
22. z��� 1792 a� 22. z��� 1806). To v�ce ne� dostate�n� pokr�v� obdob�, po
kter� se tento kalend�� pou��val.
</para>
</refsect1>
</refentry>
<refentry id="function.jdmonthname">
<refnamediv>
<refname>JDMonthName</refname>
<refpurpose>Vr�tit n�zev m�s�ce</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>jdmonthname</function></funcdef>
<paramdef>int <parameter>julianday</parameter></paramdef>
<paramdef>int <parameter>mode</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrac� �et�zec obsahuj�c� n�zev m�s�ce. <parameter>mode</parameter> ur�uje,
na kter� kalend�� se m� Julian Day Count konvertovat a jak� typ jm�na se
m� vr�tit.
<table>
<title>Kalend��ov� m�dy</title>
<tgroup cols="2">
<thead>
<row>
<entry>M�d</entry>
<entry>V�znam</entry>
</row>
</thead>
<tbody>
<row>
<entry>0</entry>
<entry>Gregori�nsk� - zkr�cen�</entry>
</row>
<row>
<entry>1</entry>
<entry>Gregori�nsk�</entry>
</row>
<row>
<entry>2</entry>
<entry>Juli�nsk� - zkr�cen�</entry>
</row>
<row>
<entry>3</entry>
<entry>Juli�nsk�</entry>
</row>
<row>
<entry>4</entry>
<entry> idovsk�</entry>
</row>
<row>
<entry>5</entry>
<entry>Francouzsk� republik�nsk�</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</refsect1>
</refentry>
<refentry id="function.jddayofweek">
<refnamediv>
<refname>JDDayOfWeek</refname>
<refpurpose>Vr�tit den v t�dnu</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>mixed <function>jddayofweek</function></funcdef>
<paramdef>int <parameter>julianday</parameter></paramdef>
<paramdef>int <parameter>mode</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrac� den v t�dnu. V z�vislosti na m�du vrac� �et�zec nebo integer.
<table>
<title>Kalend��ov� t�denn� m�dy</title>
<tgroup cols="2">
<thead>
<row>
<entry>M�d</entry>
<entry>V�znam</entry>
</row>
</thead>
<tbody>
<row>
<entry>0</entry>
<entry>
Vrac� ��slo dne jako integer (0=sunday, 1=monday, etc)
</entry>
</row>
<row>
<entry>1</entry>
<entry>
Vrac� �et�zec obsahuj�c� n�zev dne v t�dnu (anglick� gregori�nsk�)
</entry>
</row>
<row>
<entry>2</entry>
<entry>
Vrac� �et�zec obsahuj�c� zkr�cen� n�zev dne v t�dnu (anglick� gregori�nsk�)
</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</refsect1>
</refentry>
<refentry id="function.easter-date">
<refnamediv>
<refname>easter_date</refname>
<refpurpose>Zjistit UNIXov� timestamp Velikono�n� p�lnoci v dan�m roce
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>easter_date</function></funcdef>
<paramdef>int <parameter>year</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrac� UNIXov� timestamp odpov�daj�c� Velikono�n� p�lnoci v dan�m roce.
Default <parameter>year</parameter> je sou�asn� rok.
</para>
<para>
<emphasis>Varov�n�:</emphasis> Tato funkce vygeneruje varov�n�, pokud je
<parameter>year</parameter> mimo rozsah UNIXov�ch timestamp� (tj. p�ed 1970
nebo po 2037).
<example>
<title>Uk�zka <function>easter_date</function></title>
<programlisting role="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>
<para>
Datum Velikonoc bylo definov�no Nicaejsk�m koncilem v r. 325 n. l. jako
ned�le po prvn�m �pl�ku kter� p�ipad� na nebo po jarn� rovnodennosti.
Rovnodennost se v�dy p�edpokl�d� na 21. b�ezna, tak�e se v�po�et redukuje
na ur�en� data �pl�ku a data n�sleduj�c� ned�le. Zde pou�it� algoritmus
byl poprv� pou�it kolem roku 532 Dionysiem Exiguem. V Juli�nsk�m kalend��i
(pro l�ta p�ed 1753) se na sledov�n� f�z� M�s�ce pou��val jednoduch�
devaten�ctilet� cyklus. V Gregori�nsk�m kalend��i (pro l�ta po 1753 -
navr�en Claviem a Liliem a zaveden pape�em �eho�em XIII v ��jnu 1582, v
Brit�nii a jej�ch koloni�ch v z��� 1752) se p�id�vaj� dva faktory, kter�
tento cyklus zp�es�uj�.
</para>
<para>
(K�d je zalo�en na C programu od Simona Kershawa,
<[EMAIL PROTECTED]>)
</para>
<para>
V�po�et Velikonoc p�ed rokem 1970 nebo po roce 2037 viz
<function>easter_days</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.easter-days">
<refnamediv>
<refname>easter_days</refname>
<refpurpose>
Get number of days after March 21 on which Easter falls for a
given year
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>easter_days</function></funcdef>
<paramdef>int <parameter>year</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrac� po�et dn� od 21. b�ezna do Velikonoc v dan�m roce. Default
<parameter>year</parameter> je sou�asn� rok.
</para>
<para>
Tato funkce je vyu�iteln� m�sto <function>easter_date</function> na v�po�ty
Velikonoc pro roky kter� spadaj� mimo rozsah UNIXov�ch timestamp� (tj. p�ed
rokem 1970 a po roce 2037).
<example>
<title>Uk�zka <function>easter_date</function></title>
<programlisting role="php">
echo easter_days (1999); /* 14, i.e. April 4 */
echo easter_days (1492); /* 32, i.e. April 22 */
echo easter_days (1913); /* 2, i.e. March 23 */
</programlisting>
</example>
</para>
<para>
Datum Velikonoc bylo definov�no Nicaejsk�m koncilem v r. 325 n. l. jako
ned�le po prvn�m �pl�ku kter� p�ipad� na nebo po jarn� rovnodennosti.
Rovnodennost se v�dy p�edpokl�d� na 21. b�ezna, tak�e se v�po�et redukuje
na ur�en� data �pl�ku a data n�sleduj�c� ned�le. Zde pou�it� algoritmus
byl poprv� pou�it kolem roku 532 Dionysiem Exiguem. V Juli�nsk�m kalend��i
(pro l�ta p�ed 1753) se na sledov�n� f�z� M�s�ce pou��val jednoduch�
devaten�ctilet� cyklus. V Gregori�nsk�m kalend��i (pro l�ta po 1753 -
navr�en Claviem a Liliem a zaveden pape�em �eho�em XIII v ��jnu 1582, v
Brit�nii a jej�ch koloni�ch v z��� 1752) se p�id�vaj� dva faktory, kter�
tento cyklus zp�es�uj�.
</para>
<para>
(K�d je zalo�en na C programu od Simona Kershawa,
<[EMAIL PROTECTED]>)
</para>
<para>
Viz tak�: <function>easter_date</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.unixtojd">
<refnamediv>
<refname>unixtojd</refname>
<refpurpose>P�ev�st UNIXov� timestamp na Julian Day Count</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>unixtojd</function></funcdef>
<paramdef>int
<parameter><optional>timestamp</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrac� Julian Day Count pro UNIXov� <parameter>timestamp</parameter>
(sekundy od 1.1.1970), nebo pro aktu�ln� den, pokud nen� d�n
<parameter>timestamp</parameter>.
</para>
<para>
Viz tak�: <function>jdtounix</function>.
</para>
<note>
<para>
Tato funkce byla p�id�na v PHP 4 RC2.
</para>
</note>
</refsect1>
</refentry>
<refentry id="function.jdtounix">
<refnamediv>
<refname>jdtounix</refname>
<refpurpose>P�ev�st Julian Day Count na UNIXov� timestamp</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>jdtounix</function></funcdef>
<paramdef>int <parameter>jday</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>jdtounix</function> vrac� UNIXov� timestamp odpov�daj�c� Julian
Day Countu dan�mu v <parameter>jday</parameter> nebo <literal>false</literal>,
pokud je <parameter>jday</parameter> mimo UNIXovou epochu (Gregori�nsk�
roky mezi 1970 a 2037, nebo-li 2440588 <= <parameter>jday</parameter>
<= 2465342 )
</para>
<para>
Viz tak�: <function>jdtounix</function>.
</para>
<note>
<para>
Tato funkce byla p�id�na v PHP 4 RC2.
</para>
</note>
</refsect1>
</refentry>
</reference>
<!-- 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
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
