<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.13 $ -->
 <reference id="ref.calendar">
  <title>カレンダー関数</title>
  <titleabbrev>カレンダー</titleabbrev>
  
  <partintro>
   <para>
    カレンダー関数は、PHPソースコードのサブディレクトリ"dl"または"ext"
    にあるカレンダー拡張をコンパイルした場合にのみ利用可能です。使用法
    については、READMEファイルを参照下さい。
   </para>
   <para>
    カレンダー関数は、異なったカレンダーフォーマット間の変換を
    簡単に行う関数の集まりです。標準としているのは、ユリウス積算日です。
    ユリウス積算日は、殆どの人が数える必要がある日よりも早い日
    (ほぼ紀元前4000年)から数え始めます。カレンダーシステム間の変換を行
    うには、ユリウス積算日に変換した後に選択したカレンダーシステムに変
    換しなければなりません。
    ユリウス積算日はユリウス暦とは全く違います!
    カレンダーシステムに関する情報を知りたい場合は、
    <ulink url="&url.calendar;">&url.calendar;</ulink>を参照下さい。
    本説明にはこのページからの引用が含まれています。
   </para>
  </partintro>
  
  <refentry id="function.jdtogregorian">
   <refnamediv>
    <refname>JDToGregorian</refname>
    <refpurpose>ユリウス積算日をグレゴリウス日に変換する</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>string</type><methodname>jdtogregorian</methodname>
      <methodparam><type>int</type><parameter>julianday</parameter></methodparam>
     </methodsynopsis>
    <para>
     ユリウス積算日を "月/日/年" の形式でグレゴリウス日を含む
     文字列に変換します。
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.gregoriantojd">
   <refnamediv>
    <refname>GregorianToJD</refname> 
    <refpurpose>
     グレゴリウス日をユリウス積算日に変換する
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>int</type><methodname>gregoriantojd</methodname>
      <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>
     有効なグレゴリウス暦の範囲は紀元前4714年から紀元後9999年です。
    </para>
    <para>
     このソフトウェアは日付けを全て紀元前4714年に逆昇ることが
     出来ますが、この様な使い方は特に意味があるわけではありません。
     グレゴリウス暦は1582年10月15日(ユリウス暦では
     1582年10月5日)まで制定されていませんでした。
     この暦は、いくつかの国でもっと後まで受け入れられませんでした。
     例えば、イギリスは1752 年、ロシア(USSR)は1918 年、ギリシャは1923年に
     移行しました。  ほとんどのヨーロッパの国々では、グレゴリウス暦の前は
     ユリウス暦を使用していました。
     <example>
      <title>カレンダー関数</title>
      <programlisting role="php">
<![CDATA[
<?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>
     ユリウス積算日をユリウス暦に変換する
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>string</type><methodname>jdtojulian</methodname>
      <methodparam><type>int</type><parameter>julianday </parameter></methodparam>
     </methodsynopsis>
    <para>
     ユリウス積算日を "月/日/年" の形式でユリウス暦を含む文字列に変換します。
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.juliantojd">
   <refnamediv>
    <refname>JulianToJD</refname> 
    <refpurpose>
     ユリウス暦をユリウス積算日に変換する
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>int</type><methodname>juliantojd</methodname>
      <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>
     ユリウス暦は紀元前4713年から紀元後9999年の範囲で使えます。
    </para>
    <para>
     このソフトウェアは日付けを全て紀元前 4713 年に逆昇って扱うことが
     出来ますが,この様な使い方はあまり意味があるわけではありません。
     このカレンダーは紀元前 46 年に作られました、しかし細部は紀元後
     8年になるまで、おそらくは4世紀になるまで安定しませんでした。
     また、年の始まりを一つの文化のものから別の文化のものに変更すること、
     つまり、Januaryを最初の月とすることは全く受け入れられませんでした。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.jdtojewish">
   <refnamediv>
    <refname>JDToJewish</refname>
    <refpurpose>
     ユリウス積算日をユダヤ暦に変換する
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>string</type><methodname>jdtojewish</methodname>
      <methodparam><type>int</type><parameter>julianday</parameter></methodparam>
     </methodsynopsis>
    <para>
     ユリウス積算日をユダヤ暦に変換します。
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.jewishtojd">
   <refnamediv>
    <refname>JewishToJD</refname> 
    <refpurpose> 
     ユダヤ暦の日付けをユリウス積算日に変換する
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>int</type><methodname>jewishtojd</methodname>
      <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>
     このソフトウェアでは1年(紀元前3761年)に遡って全ての日々を扱うこと
     が出来ますが、この様な使い方は特に意味があるわけではありません。
     ユダヤ暦は数千年に渡って使われていますが、当初は月の
     始まりが決められていませんでいた。新しい月は新月が最初に観測
     された日に始まりました。
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.jdtofrench">
   <refnamediv>
    <refname>JDToFrench</refname>
    <refpurpose>
     ユリウス積算日をフランス革命暦(共和暦)に変換する
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>string</type><methodname>jdtofrench</methodname>
      <methodparam><type>int</type><parameter>juliandaycount</parameter></methodparam>
     </methodsynopsis>
    <para>
     ユリウス積算日をフランス革命暦に変換します。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.frenchtojd">
   <refnamediv>
    <refname>FrenchToJD</refname>
    <refpurpose>
     フランス革命暦をユリウス積算日に変換する
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>int</type><methodname>frenchtojd</methodname>
      <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>
     日付けをフランス革命暦からユリウス積算日に変換します。
    </para>
    <para>
     これらのルーチンは、1から14年まで(グレゴリウス暦の1792年9月22日から
     1806年9月22日)日付けのみを変換します。
     この期間は、フランス革命暦が使用されていた期間を十分にカバーしています。
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.jdmonthname">
   <refnamediv>
    <refname>JDMonthName</refname>
    <refpurpose>月の名前を返す</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>string</type><methodname>jdmonthname</methodname>
      <methodparam><type>int</type><parameter>julianday</parameter></methodparam>
      <methodparam><type>int</type><parameter>mode</parameter></methodparam>
     </methodsynopsis>
    <para>
     月の名前を含んだ文字列を返します。
     <parameter>mode</parameter>はどの暦をユリウス積算日に変換するか、
     どんなタイプの月名を返すを関数に伝えます。
     <table>
      <title>暦モード</title>
      <tgroup cols="3">
       <thead>
	<row>
	 <entry>モード</entry>
	 <entry>意味</entry>
         <entry>値</entry>
	</row>
       </thead>
       <tbody>
	<row>
	 <entry>0</entry>
	 <entry>グレゴリウス暦 - 省略形</entry>
         <entry>Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec</entry>
	</row>
	<row>
	 <entry>1</entry>
	 <entry>グレゴリウス暦</entry>
         <entry>January, February, March, April, May, June, July, August, September, October, November, December</entry>
	</row>
	<row>
	 <entry>2</entry>
	 <entry>ユリウス暦 - 省略形</entry>
         <entry>Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec</entry>
	</row>
	<row>
	 <entry>3</entry>
	 <entry>ユリウス暦</entry>
         <entry>January, February, March, April, May, June, July, August, September, October, November, December</entry>
	</row>
	<row>
	 <entry>4</entry>
	 <entry>ユダヤ暦</entry>
         <entry>Tishri, Heshvan, Kislev, Tevet, Shevat, AdarI, AdarII, Nisan, Iyyar, Sivan, Tammuz, Av, Elul</entry>
	</row>
	<row>
	 <entry>5</entry>
	 <entry>フランス革命暦</entry>
         <entry>Vendemiaire, Brumaire, Frimaire, Nivose, Pluviose, Ventose, Germinal, Floreal, Prairial, Messidor, Thermidor, Fructidor, Extra</entry>
	</row>
       </tbody>
      </tgroup>
     </table>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.jddayofweek">
   <refnamediv>
    <refname>JDDayOfWeek</refname>
    <refpurpose>曜日を返す</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>mixed</type><methodname>jddayofweek</methodname>
      <methodparam><type>int</type><parameter>julianday</parameter></methodparam>
      <methodparam><type>int</type><parameter>mode</parameter></methodparam>
     </methodsynopsis>
    <para>
     曜日を返します。
     モードに依存した文字あるいは整数を返す事が出来ます。
     <table>
      <title>暦の曜日モード</title>
      <tgroup cols="2">
       <thead>
	<row>
	 <entry>モード</entry>
	 <entry>意味</entry>
	</row>
       </thead>
       <tbody>
	<row>
	 <entry>0</entry>
	 <entry>
	  整数で曜日番号 (0=sunday, 1=monday, 等)を返します。
	 </entry>
	</row>
	<row>
	 <entry>1</entry> 
	 <entry> 
	  曜日(英グレゴリウス)を含む文字列を返します。
	 </entry>
	</row>
	<row>
	 <entry>2</entry> 
	 <entry> 曜日の省略形(英グレゴリウス)を含む文字列を返します。
	 </entry>
	</row>
       </tbody>
      </tgroup>
     </table>
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.easter-date">
   <refnamediv>
    <refname>easter_date</refname>
    <refpurpose>
     指定した年における復活祭の真夜中のUNIX時を得る
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>int</type><methodname>easter_date</methodname>
      <methodparam><type>int</type><parameter>year</parameter></methodparam>
     </methodsynopsis>
    <para>
     指定した年yearにおける復活祭の真夜中のUNIX時を返します。
     yearが指定されない場合、現在の年が仮定されます。
    </para>
    <para>
     <emphasis>警告:</emphasis> この関数は、指定した年がUNIX時の
     範囲外(すなわち1970年以前か2037年以降)である場合に警告を
     生成します。
     <example>
      <title><function>easter_date</function>の例</title>
      <programlisting role="php">
<![CDATA[
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>
     復活祭の日付は、西暦325年の Nicaea 会議で春分の日の後の
     最初の満月の後の日曜日として定められました。
     満月とその次の日曜日の日付の計算を簡単にするために
     春分の日は常に3月21日になるとして計算されます。
     ここで用いるアルゴリズムは、532年頃、Dionysius Exiguus により
     導出されたものです。(1753年より前の年に関して)ユリウス暦の元では
     月の周期を追うために簡単な19年周期が用いられます。グレゴリウス暦
     (1753年以降。この暦は、ClaviusとLiliusにより考案され、
     教皇グレゴリウス13世により1582年10月に導入、イギリス及びその植民地に
     1752年9月に導入された。)
     のもとで、二つの補正係数が周期をより正確に作成するために追加されました。
    </para>
    <para>
     (このコードは、Simon Kershaw,
     &lt;webmaster@ely.anglican.org&gt;によるCプログラムに基づくものです。)
    </para>
    <para>
     1970年以前または2037年以降の復活祭の計算に関しては、
     <function>easter_days</function> を参照ください。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.easter-days">
   <refnamediv>
    <refname>easter_days</refname>
    <refpurpose>
     指定した年において3月21日以降、復活祭までの日数を得る
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>int</type><methodname>easter_days</methodname>
      <methodparam><type>int</type><parameter>year</parameter></methodparam>
     </methodsynopsis>
    <para>
     指定した年 year において3月21日以降復活祭までの日数を返します。
     year が指定されない場合、現在の年が仮定されます。
    </para>
    <para>
     この関数は、UNIX時の範囲外(すなわち1970年以前または2037年以降)の復活祭を
     計算するために<function>easter_date</function>の代わりにしようすることが
     できます。
     <example>
      <title><function>easter_days</function>の例</title>
      <programlisting role="php">
<![CDATA[
echo easter_days (1999);        /* 14, すなわち　4月4日   */
echo easter_days (1492);        /* 32, すなわち　4月22日  */
echo easter_days (1913);        /*  2, すなわち　3月23日  */
]]>
      </programlisting>
     </example>
    </para>
    <para>
     復活祭の日付は、西暦325年のNicaeaの会議で春分の人の日以降の
     最初の満月の後の日曜日として定義されました。
     満月とその次の日曜日の日付の計算を簡単にするために
     春分の日は常に3月21日になるとして計算されます。
     ここで用いるアルゴリズムは、532年頃、Dionysius Exiguus により
     導出されたものです。(1753年より前の年に関して)ユリウス暦の元では
     月の周期を追うために簡単な19年周期が用いられます。グレゴリウス暦
     (1753年以降。この暦は、Clavius と Lilius により考案され、
     教皇グレゴリウス13世により1582年10月に導入、イギリス及びその植民地に
     1752年9月に導入された。)
     のもとで、二つの補正係数が周期をより正確に作成するために追加されました。
    </para>
    <para>
     (このコードは、Simon Kershaw,
     &lt;webmaster@ely.anglican.org&gt;によるCプログラムに基づくものです。)
    </para>
    <para>
     <function>easter_date</function>も参照ください。
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.unixtojd">
   <refnamediv>
    <refname>unixtojd</refname>
    <refpurpose>UNIXタイムスタンプをユリウス歴に変換する</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>int</type><methodname>unixtojd</methodname>
      <methodparam><type>int</type><parameter>
	<replaceable><optional>timestamp</optional></replaceable>
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     UNIX歴(1970/1/1からの秒数)<parameter>timestamp</parameter>をユリウス歴
     に変換して返します。<parameter>timestamp</parameter>が指定されない場合は
     現在の日付が使用されます。
    </para>
    <para>
     <function>jdtounix</function>も参照下さい。
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.jdtounix"> 
   <refnamediv>
    <refname>jdtounix</refname>
    <refpurpose>ユリウス歴をUNIXタイムスタンプに変換する</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>int</type><methodname>jdtounix</methodname>
      <methodparam><type>int</type><parameter>jday</parameter></methodparam>
     </methodsynopsis>
    <para>
     この関数は、<parameter>jday</parameter>で指定したユリウス歴
     に対応するUNIXタイムスタンプを返します。
     <parameter>jday</parameter>がUNIX歴(グレゴリウス歴で1970年と2037年の間
     または2440588 &lt;= <parameter>jday</parameter> &lt;= 2465342)
     の範囲外の場合は&false;を返します。
    </para>
    <para>
     <function>unixtojd</function>も参照下さい。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.cal-days-in-month"> 
   <refnamediv>
    <refname>cal_days_in_month</refname>
    <refpurpose>
     指定した年とカレンダについて日数を返す
     calendar
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>int</type><methodname>cal_days_in_month</methodname>
      <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>
     この関数は、指定した<parameter>calendar</parameter>について
     <parameter>year</parameter>年<parameter>month</parameter>月の日数
     を返します。
    </para>
    <para>
     <function>jdtounix</function>も参照下さい。
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.cal-to-jd'>
   <refnamediv>
    <refname>cal_to_jd</refname>
    <refpurpose>
     サポートされるカレンダからユリウス積算日に変換する
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>int</type><methodname>cal_to_jd</methodname>
      <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>
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.cal-from-jd'>
   <refnamediv>
    <refname>cal_from_jd</refname>
    <refpurpose>
     ユリウス積算日からサポートされるカレンダに変換し、拡張情報を返す
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>array</type><methodname>cal_from_jd</methodname>
      <methodparam><type>int</type><parameter>jd</parameter></methodparam>
      <methodparam><type>int</type><parameter>calendar</parameter></methodparam>
     </methodsynopsis>
    <para>
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.cal-info'>
   <refnamediv>
    <refname>cal_info</refname>
    <refpurpose>特定のカレンダに関する情報を返す</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>array</type><methodname>cal_info</methodname>
      <methodparam><type>int</type><parameter>calendar</parameter></methodparam>
     </methodsynopsis>
    <para>
    </para>
   </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
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->