cvs: phpdoc /cs/functions calendar.xml

From: Date: Mon, 05 Feb 2001 12:40:48 +0000
Subject: cvs: phpdoc /cs/functions calendar.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969334168@lists.php.net to get a copy of this message
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"> &lt;?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, &lt;webmaster@ely.anglican.org&gt;) </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, &lt;webmaster@ely.anglican.org&gt;) </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 &lt;= <parameter>jday</parameter> &lt;= 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: -->
« previous php.doc (#969334168) next »