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:
-->
