NAME
      SiMH::DateTime - 日付時刻データ操作

SYNOPSIS
      use SiMH::DateTime;

      $days = SiMH::DateTime::days_of_month($year,$month);
      $yday = SiMH::DateTime::day_of_year($year,$month,$day);
      $wday = SiMH::DateTime::day_of_week($year,$month,$day);
      ($year,$month,$day) = SiMH::DateTime::tomorrow($year,$month,$day);
      ($year,$month,$day) = SiMH::DateTime::yesterday($year,$month,$day);
      $dt14 = SiMH::DateTime::gmtime($time);
      $dt14 = SiMH::DateTime::localtime($time);
      $dt14 = SiMH::DateTime::adjust($dt14,$diff) or die;
      $httpdate = SiMH::DateTime::to_httpdate($dt14) or die;
      $dt14 = SiMH::DateTime::from_httpdate($httpdate) or die;

DESCRIPTION
      日付や時刻を操作するサブルーチンを提供する。

    days_of_month(《年》,《月》)
      指定された月の日数を求める。
      《年》には任意の値を指定できるが、現在の暦のルールを機械的に適用して
      いるだけなので、過去および未来において正しい値を返すとは限らない。
      《月》が不正な場合の動作は保証しない。

    day_of_year(《年》,《月》,《日》)
      指定された日の1/1からの通算日を求める。
      《年》には任意の値を指定できるが、現在の暦のルールを機械的に適用して
      いるだけなので、過去および未来において正しい値を返すとは限らない。
      《月》,《日》が不正な場合の動作は保証しない。

    day_of_week(《年》,《月》,《日》)
      指定された日の曜日番号（0:日, 1:月, … 6:土）を求める。
      《年》には任意の値を指定できるが、現在の暦のルールを機械的に適用して
      いるだけなので、過去および未来において正しい値を返すとは限らない。
      《月》,《日》が不正な場合の動作は保証しない。

    tomorrow(《年》,《月》,《日》)
      指定された日の翌日の日付を求め、年月日の3要素から成る配列として返す。
      《年》には任意の値を指定できるが、現在の暦のルールを機械的に適用して
      いるだけなので、過去および未来において正しい値を返すとは限らない。
      《月》,《日》が不正な場合の動作は保証しない。

    yesterday(《年》,《月》,《日》)
      指定された日の前日の日付を求め、年月日の3要素から成る配列として返す。
      《年》には任意の値を指定できるが、現在の暦のルールを機械的に適用して
      いるだけなので、過去および未来において正しい値を返すとは限らない。
      《月》,《日》が不正な場合の動作は保証しない。

    gmtime(《通算秒数》)
      いわゆる「エポック」からの秒数(time関数が返すデータ形式)を与えると、
      それに対応するGMTを "YYYYMMDDHHMMSS" の形式で返す。
      引数を指定しなかった場合には現在の時刻が使用される。

    localtime(《通算秒数》)
      いわゆる「エポック」からの秒数(time関数が返すデータ形式)を与えると、
      それに対応するローカルタイムを "YYYYMMDDHHMMSS" の形式で返す。
      引数を指定しなかった場合には現在の時刻が使用される。

    adjust(《日時文字列》,《時差》)
      指定された日時文字列（YYYYMMDDHHMMSS形式）に対して時差の調整を行う。
      《時差》 は +/- の符合と4桁の時分文字列（"±HHMM"）で指定する。
      不正な文字列が与えられた場合には、undef を返す。
      オーバーフローした場合の動作は保証しない。

    to_httpdate(《日時文字列》)
      指定された日時文字列（YYYYMMDDHHMMSS形式）を HTTP-date に変換する。
      タイムゾーンは入出力ともGMTだと仮定して時差の調節は行わない。
      不正な文字列が与えられた場合には、undef を返す。

    from_httpdate(《HTTP日付文字列》)
      指定された HTTP-date を日時文字列（YYYYMMDDHHMMSS形式）に変換する。
      タイムゾーンは入出力ともGMTだと仮定して時差の調節は行わない。
      不正な文字列が与えられた場合には、undef を返す。

SEE ALSO
      RFC 2616 - Hypertext Transfer Protocol - HTTP/1.1

COPYRIGHT
      Copyright 2003, HIRANO Kiyoshi <hirano-k@tokyo.email.ne.jp>.

      このソフトウェアのソースコードおよびバイナリー形式の利用、複製、
      再配布を、変更の有無に関わらず、以下の3つの条件の下で許可します。

      1. ソースコードの再配布においては、上記著作権表示および許諾条件の
         列挙を含めること。

      2. バイナリー形式の再配布においては、上記著作権表示および許諾条件
         の列挙を、配布物に附属した文書等に記載すること。

      3. このソフトウェアの提供に際して、HIRANO Kiyoshi は一切の保証を
         しません。 理由のいかんを問わず、このソフトウェアの利用、複製、
         再配布に伴い発生したいかなる損害も補償しません。