<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.31 $ -->
 <reference id="ref.datetime">
  <title>日付・時刻関数</title>
  <titleabbrev>日付/時刻</titleabbrev>

  <refentry id="function.checkdate">
   <refnamediv>
    <refname>checkdate</refname>
    <refpurpose>グレグリオ歴の日付/時刻の妥当性を確認します</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>int</type><methodname>checkdate</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>
     指定された日付が有効であれば&true;を返し、そうでなければ&false;
     を返します。引数で指定された日付の妥当性をチェックします。日付が
     以下のようになっていれば妥当であると判断されます。
     <itemizedlist>
      <listitem>
       <simpara>
        年が1から32767の間であること。
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        月が1から12の間であること。
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        <parameter>day</parameter>が指定された月
        (<parameter>month</parameter>)の日数以内に収まること。うるう年
        (<parameter>year</parameter>)も考慮の対象となります。
       </simpara>
      </listitem>
     </itemizedlist>
    </para>
    <para>
     <function>mktime</function>及び<function>strtotime</function>も参
     照下さい。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.date">
   <refnamediv>
    <refname>date</refname>
    <refpurpose>ローカルの日付/時刻を書式化する</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>string</type><methodname>date</methodname>
      <methodparam><type>string</type><parameter>format</parameter></methodparam>
       <methodparam><type>int</type><parameter>
         <replaceable><optional>timestamp</optional></replaceable>
        </parameter></methodparam>
     </methodsynopsis>
    <para>
     指定された引数 <parameter>timestamp</parameter> を、与えられた
     フォーマット文字列によりフォーマットし、日付文字列を返します。
     タイムスタンプが与えられない場合は、現在のローカル時刻が使われま
     す。
     <note>
      <para>
       有効なタイムスタンプの範囲は通常       Fri, 13 Dec 1901
       20:45:54 GMTからTue, 19 Jan 2038 03:14:07 GMTまでです。
       (これらの日付は、32ビット符号付き整数の最小および最大値に対応し
       ます。)
      </para>
      <para>
       日付の文字列表現からタイムスタンプを生成するには、
       <function>strtotime</function>を使用できる可能性があります。加
       えて、いくつかのデータベースは、(MySQLのUNIX_TIMESTAMP関数のよ
       うな)日付フォーマットからタイムスタンプに変換する関数を有してい
       ます。
      </para>
     </note>
    </para>
    <para>
     フォーマット文字列では、以下の文字が認識されます。
     <itemizedlist>
      <listitem>
       <simpara>
	a - "am" または "pm"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	A - "AM" または "PM"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	d - 日。2桁の数字 (先頭にゼロが付く場合も)。すなわち、"01"から
	"31"まで
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	D - 曜日。3 文字のテキスト形式。すなわち "Fri"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	F - 月。テキスト形式。長い形式。すなわち "January"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	h - 時。数字。12 時間単位。すなわち"01"から"12"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	H - 時。数字。24 時間単位。すなわち"00"から"23"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	g - 時。12時間単位。先頭にゼロを付けない。すなわち"1"から"12"。
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	G - 時。24時間単位。先頭にゼロを付けない。すなわち"0"から"23"。
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	i - 分。数字。すなわち"00"から"59"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	j - 日。数字。先頭にゼロを付けない。すなわち"1"から"31"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	l ('L'の小文字) - 曜日。テキスト形式。長い形式。すなわち "Friday"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	L - 閏年であるかどうかを表す論理値。すなわち、"0"または"1"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	m - 月。すなわち"01"から"12"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	n - 月。先頭にゼロを付けない。すなわち"1"から"12"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	M - 月。3 文字のテキスト形式。すなわち "Jan"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        r - RFC 822 フォーマットされた日付。すなわち "Thu, 21 Dec 2000
        16:01:07 +0200"
	(PHP 4.0.4で追加)
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	s - 秒。すなわち"00"から"59"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	S - 英語形式の序数を表すサフィックス。2 文字。すなわち "th" や "nd"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	t - 指定した月の日数。すなわち、"28"から"31"。
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        T - このマシーンのタイムゾーンの設定。例えば、"MDT"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	U - Unix 時(1970年1月1日)からの秒数
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	w - 曜日。数値。すなわち、"0"(日曜)から"6"(土曜日)まで
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        W - ISO-8601 月曜日に始まる年単位の週番号 (PHP 4.1.0で追加)
        (Saturday)
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	Y - 年。4 桁の数字。すなわち"1999"。
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	y - 年。2 桁の数字。すなわち"99"。
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	z - 年間の通算日。数字。。すなわち"0"から"365"。
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	Z - タイムゾーンのオフセット秒数。(すなわち、"-43200"から
	"43200")UTCの西側のタイムゾーン用のオフセットは常に負です。そ
	して、UTCの東側のオフセットは常に正です。
       </simpara>
      </listitem>
     </itemizedlist>
     フォーマット文字列中の認識されない文字は、そのまま表示されます。
     <function>gmdate</function>で使用した場合、"Z"フォーマットは常に"0"を
     返します。
     <example>
      <title><function>date</function> の例</title>
      <programlisting role="php">
<![CDATA[
echo date ("l dS of F Y h:i:s A");
echo "July 1, 2000 is on a " . date ("l", mktime(0,0,0,7,1,2000));
]]>
     </programlisting>
     </example>
    </para>
    <para>
     前にバックスラッシュを付けてエスケープすることにより、フォーマッ
     ト文字列として認識される文字が展開されることを防止することができ
     ます。バックスラッシュ付きの文字は既に特別なシーケンスであり、バッ
     クスラッシュもエスケープすることが必要となる可能性があります。
     <example>
      <title><function>date</function>の文字をエスケープする</title>
      <programlisting role="php">
<![CDATA[
echo date("l \\t\h\e jS"); // 'Saturday the 8th'のように出力
]]>
      </programlisting>
     </example>
    </para>
    <para>
     <function>date</function> と <function>mktime</function> の
     両方を用いて未来または過去の日付を知ることができます。
     <example>
      <title>
       <function>date</function>と<function>mktime</function>の例
      </title>
      <programlisting role="php">
<![CDATA[
$tomorrow  = mktime (0,0,0,date("m")  ,date("d")+1,date("Y"));
$lastmonth = mktime (0,0,0,date("m")-1,date("d"),  date("Y"));
$nextyear  = mktime (0,0,0,date("m"),  date("d"),  date("Y")+1);
]]>
      </programlisting>
     </example>
     <note>
      <para>
       サマータイムがあるため日付や月の秒数を単純にタイムスタンプに可
       減算するよりもより信頼性があります。
      </para>
     </note>
    </para>
    <para>
     <function>date</function> フォーマットのいくつかの例を示します。
     現在の実装で特別な意味がある文字や今後のPHPのバージョンで意味が割
     り付けられるであろう文字については、望ましくない結果を避けるため
     にエスケープする必要があることに注意して下さい。エスケープをする
     際には、改行文字 \n のような文字を回避するためにシングルークオー
     トを使用して下さい。
     <example>
      <title>
       <function>date</function> によるフォーマット
      </title>
      <programlisting role="php">
<![CDATA[
/* 今日は、March 10th, 2001, 5:16:18 pm です。 */
$today = date("F j, Y, g:i a");                 // March 10, 2001, 5:16 pm
$today = date("m.d.y");                         // 03.10.01
$today = date("j, m, Y");                       // 10, 3, 2001
$today = date("Ymd");                           // 20010310
$today = date('h-i-s, j-m-y, it is w Day z ');  // 05-16-17, 10-03-01, 1631 1618 6 Fripm01
$today = date('\i\t \i\s \t\h\e jS \d\a\y.');   // It is the 10th day.
$today = date("D M j G:i:s T Y");               // Sat Mar 10 15:16:08 MST 2001
$today = date('H:m:s \m \i\s\ \m\o\n\t\h');     // 17:03:17 m is month
$today = date("H:i:s");                         // 17:16:17
]]>
      </programlisting>
     </example>
    </para>
    <para>
     他の言語で日付をフォーマットするためには、
     <function>setlocale</function> および <function>strftime</function>
     関数を使用する必要があります。
    </para>
    <para>
     <function>getlastmod</function>, <function>gmdate</function>,
     <function>mktime</function>, <function>strftime</function>,
     <function>time</function>も参照下さい。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.getdate">
   <refnamediv>
    <refname>getdate</refname>
    <refpurpose>日付/時刻情報の取得</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>array</type><methodname>getdate</methodname>
      <methodparam><type>int</type><parameter>       
	<replaceable><optional>timestamp</optional></replaceable>
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     <parameter>timestamp</parameter>に関する日付情報を有する連想配列を
     返します。timestampが指定されない場合は、現在のローカルな時間に関
     する情報を返します。日付情報は以下の配列要素として返されます。
     <itemizedlist>
      <listitem>
       <simpara>
	"seconds" - 秒
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"minutes" - 分
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"hours" - 時
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"mday" - 月単位の日付
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"wday" - 曜日、数字: 0が日曜、6が土曜日
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"mon" - 月、数字
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"year" - 年、数字
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"yday" - 年単位の日付、数字。たとえば "299"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"weekday" - 曜日(テキスト)。たとえば "Friday"
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"month" - 月(テキスト)。たとえば "January"
       </simpara>
      </listitem>
     </itemizedlist>
     <example>
      <title><function>getdate</function> の例</title>
     <programlisting role="php">
<![CDATA[
$today = getdate(); 
$month = $today['month']; 
$mday = $today['mday']; 
$year = $today['year']; 
echo "$month $mday, $year";
]]>
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.gettimeofday">
   <refnamediv>
    <refname>gettimeofday</refname>
    <refpurpose>現在の時間を得る</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>array</type><methodname>gettimeofday</methodname>
      <void/>
     </methodsynopsis>
    <para>
     この関数は、gettimeofday(2) へのインターフェースです。この
     関数は、システムコールから返されたデータを有する連想配列を
     返します。
     <itemizedlist>
      <listitem>
       <simpara>
	"sec" - 秒
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"usec" - マイクロ秒
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"minuteswest" - グリニッジ基準の分
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"dsttime" - 夏時間補正の型
       </simpara>
      </listitem>
     </itemizedlist>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.gmdate">
   <refnamediv>
    <refname>gmdate</refname>
    <refpurpose>GMT/CUT の日付／時刻を書式化</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>string</type><methodname>gmdate</methodname>
      <methodparam><type>string</type><parameter>format</parameter></methodparam>
      <methodparam><type>int</type><parameter>
	<replaceable><optional>timestamp</optional></replaceable>
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>date</function> 関数と同じですが、返される時刻が
     グリニッジ標準時(GMT) であるところが異なります。たとえば
     フィンランド(GMT +0200)で実行されると、下の例の最初の行は
     "Jan 01 1998 00:00:00" と表示されますが、2 番目の行は
     "Dec 31 1997 22:00:00" と表示されます。
     <example>
      <title><function>gmdate</function>の例</title>
      <programlisting role="php">
<![CDATA[
echo date ("M d Y H:i:s", mktime (0,0,0,1,1,1998));
echo gmdate ("M d Y H:i:s", mktime (0,0,0,1,1,1998));
]]>
      </programlisting>
     </example>
    </para>
    <para>
     <function>date</function>,<function>mktime</function>, 
     <function>gmmktime</function>, <function>strftime</function>も参
     照下さい。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.gmmktime">
   <refnamediv>
    <refname>gmmktime</refname>
    <refpurpose>GMT日付によるUNIXタイムスタンプを取得する</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>int</type><methodname>gmmktime</methodname>
      <methodparam><type>int</type><parameter>hour</parameter></methodparam>
      <methodparam><type>int</type><parameter>minute</parameter></methodparam>
      <methodparam><type>int</type><parameter>second</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>
      <methodparam><type>int</type><parameter>
	<replaceable><optional>is_dst</optional></replaceable>
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     指定されるパラメータが GMT 日付を表すこと以外は
     <function>mktime</function> と同じです。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.gmstrftime">
   <refnamediv>
    <refname>gmstrftime</refname>
    <refpurpose>
     ロケールの設定に基づきGMT/CUT 時刻/日付をフォーマットする
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>string</type><methodname>gmstrftime</methodname>
      <methodparam><type>string</type><parameter>format</parameter></methodparam>
      <methodparam><type>int</type><parameter>
        <replaceable><optional>timestamp</optional></replaceable>
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     グリニッジ標準時を返すこと以外は、
     <function>strftime</function>と同じ動作をします。例えば、東部標準時
     (GMT -0500)で実行した場合、以下の最初の行は"Dec 31 1998 20:00:00"を
     出力し、二行目は"Jan 01 1999 01:00:00"を」出力します。
     <example>
      <title><function>gmstrftime</function> の例</title>
      <programlisting role="php">
<![CDATA[
setlocale ('LC_TIME', 'en_US');
echo strftime ("%b %d %Y %H:%M:%S", mktime (20,0,0,12,31,98))."\n";
echo gmstrftime ("%b %d %Y %H:%M:%S", mktime (20,0,0,12,31,98))."\n";
]]>
      </programlisting>
     </example>
    </para>
    <para>
     <function>strftime</function>も参照ください。
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.localtime">
   <refnamediv>
    <refname>localtime</refname>
    <refpurpose>ローカルタイムを得る</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>array</type><methodname>localtime</methodname>
      <methodparam><type>int</type><parameter>
        <replaceable><optional>timestamp</optional></replaceable>
       </parameter></methodparam>
      <methodparam><type>bool</type><parameter>
        <replaceable><optional>is_associative</optional></replaceable>
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>localtime</function>関数は同名のC言語の関数コールにより
     返される構造体と同じ内容の配列を返します。
     <function>localtime</function>の最初の引数はtimestampであり、
     省略された場合には現在の時間が使用されます。
     <function>localtime</function>の2番目の引数は
     <parameter>is_associative</parameter>であり、これが0に設定されるか
     指定が省略された場合には、配列は通常の数値を添字とした配列として
     返されます。その引数が1に設定された場合、
     <function>localtime</function>はC言語の関数localtimeのコール
     により返される構造体の全ての要素を有する連想配列を返します。
     この連想配列の各キーの名前は次のようになります。
     <itemizedlist>
      <listitem>
       <simpara>
	"tm_sec" - 秒
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"tm_min" - 分
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"tm_hour" - 時間
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"tm_mday" - 月単位の日付
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"tm_mon" - 月
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"tm_year" - 年、1900年からの年
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"tm_wday" - 週単位の日付
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"tm_yday" - 年単位の日付
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	"tm_isdst" - 夏時間が有効かどうか
       </simpara>
      </listitem>
     </itemizedlist>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.microtime">
   <refnamediv>
    <refname>microtime</refname>
    <refpurpose> 
     現在のUNIXタイムスタンプをマイクロ秒まで返す 
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>string</type><methodname>microtime</methodname>
      <void/>
     </methodsynopsis>
    <para>
     文字列 "msec sec" を返します。sec は現在時刻を Unix epoch
     (1970年1月1日 00:00:00)からの通算秒としたもので、msec は
     マイクロ秒の部分です。この関数は、システムコール gettimeofday() を
     サポートするオペレーティング・システム上でのみ使用可能です。
    </para>
    <para>
     文字列は、ともに秒単位で返されます。
     <example>
      <title><function>microtime</function> の例</title>
      <programlisting role="php">
<![CDATA[
function getmicrotime(){ 
    list($usec, $sec) = explode(" ",microtime()); 
    return ((float)$sec + (float)$usec); 
    } 

$time_start = getmicrotime();
    
for ($i=0; $i < 1000; $i++){
    // 何もしない。1000 回ループ
    }

$time_end = getmicrotime();
$time = $time_end - $time_start;

echo "$time 秒間何もしませんでした。";
]]>
      </programlisting>
     </example>
    </para>
    <para>
     <function>time</function>も参照下さい。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.mktime">
   <refnamediv>
    <refname>mktime</refname>
    <refpurpose>日付を UNIX のタイムスタンプとして取得する</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>int</type><methodname>mktime</methodname>
      <methodparam><type>int</type><parameter>hour</parameter></methodparam>
      <methodparam><type>int</type><parameter>minute</parameter></methodparam>
      <methodparam><type>int</type><parameter>second</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>
      <methodparam><type>int</type><parameter>
	<replaceable><optional>is_dst</optional></replaceable>
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     <emphasis>警告:</emphasis> 
     引数の順番が、通常の UNIX mktime() の引数の順番と
     異なっていることに注意して下さい。
     このことは、(以下に示すように)パラメータを右から左に
     省略出来るようにすることに役立っているわけではありません。
     これらの値をスクリプトで混用するというのは、ありがちなエラーです。
    </para>
    <para>
     与えられた引数に従って UNIX のタイムスタンプを返します。
     このタイムスタンプは、Unix epoch(1970年1月1日)から
     指定された時刻までの通算秒を表す長整数です。
    </para>
    <para>
     引数は右から順に省略することができます。省略された引数は、
     ローカルの日付と時刻に従って、現在の値にセットされます。
    </para>
    <para>
     <parameter>is_dst</parameter> はサマータイムの時に1にセットされ、
     そうでない時に0に、サマータイムであるかどうかが不明である場合に-1
     にセットされます。
    </para>
    <note>
     <para>
      <parameter>is_dst</parameter> は　3.0.10　で追加されました。
     </para>
    </note>
    <para>
     <function>mktime</function> は入力日付の有効性を確認しており、
     範囲外の入力を自動的に修正して計算してくれるので便利です。
     例えば、以下の各行はいずれも文字列 "Jan-01-1998"を出力します。
     <example>
      <title><function>mktime</function>の例</title>
      <programlisting role="php">
<![CDATA[
echo date ("M-d-Y", mktime (0,0,0,12,32,1997));
echo date ("M-d-Y", mktime (0,0,0,13,1,1997));
echo date ("M-d-Y", mktime (0,0,0,1,1,1998));
echo date ("M-d-Y", mktime (0,0,0,1,1,98));
]]>
      </programlisting>
     </example>
     <parameter>year</parameter> は2桁または4桁の値を指定可能で、
     0-69の間の値は2000-2069に、70-99は1970-1999にマップされます。
     (今日最も一般的なtime_tが32ビットの符号付き整数であるシステムで、
     <parameter>year</parameter>として有効な範囲は1902から2037の間です)
    </para>
    <para>
     指定した月の最後の日は次の月の -1 番目の日ではなく、"0" 番目の日
     として表すことが可能です。以下の例はともに文字列"The last day in
     Feb 2000 is: 29" を出力します。
     <example>
      <title>次の月の最後の日</title>
      <programlisting role="php">
<![CDATA[
$lastday = mktime (0,0,0,3,0,2000);
echo strftime ("Last day in Feb 2000 is: %d", $lastday);
     
$lastday = mktime (0,0,0,4,-31,2000);
echo strftime ("Last day in Feb 2000 is: %d", $lastday);
]]>
      </programlisting>
     </example>
    </para>
    <simpara>
     year、month、dayをゼロとした日付は、不正と判定されます。
     (さもなくば、30.11.1999と見なされますが、意図した結果にはならない
     でしょう。)
    </simpara>
    <para>
     <function>date</function>, <function>time</function>も参照下さい。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strftime">
   <refnamediv>
    <refname>strftime</refname>
    <refpurpose>
     ローカルな設定に基づきローカルな日付・時間をフォーマットします
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>string</type><methodname>strftime</methodname>
      <methodparam><type>string</type><parameter>format</parameter></methodparam>
      <methodparam><type>int</type><parameter>
        <replaceable><optional>timestamp</optional></replaceable>
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     指定した <parameter>timestamp</parameter> または timestamp
     が指定されていない場合に現在のローカル時間を用いて指定した
     フォーマット文字列に基づき文字列をフォーマットして返します。
     月および曜日の名前およびその他の言語依存の文字列は、
     <function>setlocale</function> でセットされた現在のロケールに関係
     します。
    </para>
    <para>
     次の変換指定子は、フォーマット文字列として認識されます。
     <itemizedlist>
      <listitem>
       <simpara>
	%a - 現在のロケールに基づく短縮された曜日の名前
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%A - 現在のロケールに基づく完全な曜日の名前
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%b - 現在のロケールに基づく短縮された月の名前
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%B - 現在のロケールに基づく完全な月の名前
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%c - 現在のロケールに基づく適当な日付と時間の表現
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%C - 世紀(年を100で割り、整数に丸めたもの。00〜99)
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%d - 日付を10進数で。(01から31)
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%D - %m/%d/%yと同じ
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%e - 月単位の日付を10進数で表したもの。日付が1桁の場合は、前に
	空白を一つ付けます。(' 1'〜'31')
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%h - %bと同じ。
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%H - 時間を24時間表示の10進数で(00から23まで)
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%I - 時間を12時間表示の10進数で(01から12までの範囲)
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%j - 年間での日付を10進数で表現 (001から366)
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%m - 月を10進数で表現 (01から12)
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%M - 分を10進数で表現
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%n - 改行文字
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%p - 指定した時間により `am' または `pm' 、または
	現在のロケールに対応した文字列
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%r - a.m.およびp.m.表記で表した時間
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%R - 24時間表記で表した時間
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%S - 秒を10進数で表現
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%t - タブ文字
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%T - 現在の時間。%H:%M:%Sに等しい。
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%u - 10進数表記の曜日で1〜7の範囲。1が月曜日。
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%U - 年間で何番目の週であるかを 10 進数で表現。
	年間で最初の日曜を最初の週の最初の日として数えます。
       </simpara>
      </listitem>
      <listitem>
       <simpara> 
        %V - ISO 8601:1988で規定された現在の年の週番号の10進数表現で
	01から53までの範囲となります。1は最初の週でその週は現在の年に
	最低4日はあります。週は月曜日から始まります。
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%W - 現在の年で何番目の週であるかを10進数で表現。
	年間で最初の月曜を最初の週の最初の日として数えます。
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%w - 曜日を10進数で表現。日曜は0になります。
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%x - 時間を除いた日付を現在のロケールに基づき表現します。
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%X - 日付を除いた時間を現在のロケールに基づき表現します。
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%y - 世紀の部分を除いた年を10進数として表現。(00から99までの範囲)
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%Y - 世紀を含む年を 10進数で表現
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%Z - タイムゾーンまたはその名前または短縮形
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	%% - 文字リテラル`%' 
       </simpara>
      </listitem>
     </itemizedlist>
     <note>
      <para>
       (上記の)全ての変換指定子が使用するCライブラリでサポートされてい
       ない可能性があります。この場合、PHPの
       <function>strftime</function>で該当する変換指定子はサポートされ
       ません。
      </para>
     </note>
     <example>
      <title><function>strftime</function>の例</title>
      <programlisting role="php">
<![CDATA[
setlocale ("LC_TIME", "C");
print (strftime ("%A in Finnish is "));
setlocale ("LC_TIME", "fi_FI");
print (strftime ("%A, in French "));
setlocale ("LC_TIME", "fr_FR");
print (strftime ("%A and in German "));
setlocale ("LC_TIME", "de_DE");
print (strftime ("%A.\n"));
]]>
      </programlisting>
     </example>
     この例は、各ロケールがシステムにインストールされている場合に動作します。
    </para>
    <para>
     <function>setlocale</function>、<function>mktime</function>、
     <ulink url="&spec.strftime;">Open Groupによる
     <function>strftime</function>の定義</ulink>も参照下さい。
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.time">
   <refnamediv>
    <refname>time</refname>
    <refpurpose>現在の UNIX タイムスタンプを返す</refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>int</type><methodname>time</methodname>
      <void/>
     </methodsynopsis>
    <para>
     現在時刻をUnix epoch(1970年1月1日 00:00:00 GMT))からの通算秒
     として返します。
    </para>
    <para>
     <function>date</function>も参照下さい。
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strtotime">
   <refnamediv>
    <refname>strtotime</refname>
    <refpurpose>
     英文形式の日付をUNIXタイムスタンプに変換する
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>説明</title>
     <methodsynopsis>
      <type>int</type><methodname>strtotime</methodname>
      <methodparam><type>string</type><parameter>time</parameter></methodparam>
      <methodparam><type>int</type><parameter>
	<replaceable><optional>now</optional></replaceable>
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     この関数は英文形式の日付を含む文字列が指定されることを期待してお
     り、その形式からUNIXタイムスタンプへの変換を試みます。
     <example>
      <title><function>strtotime</function>の例</title>
      <programlisting role="php">
<![CDATA[
echo strtotime ("now"), "\n";
echo strtotime ("10 September 2000"), "\n";
echo strtotime ("+1 day"), "\n";
echo strtotime ("+1 week"), "\n";
echo strtotime ("+1 week 2 days 4 hours 2 seconds"), "\n";
echo strtotime ("next Thursday"), "\n";
echo strtotime ("last Monday"), "\n";
]]>
      </programlisting>
     </example>
    </para>
    <para>
     <example>
      <title>失敗のチェック</title>
      <programlisting role="php">
<![CDATA[
$str = 'Not Good';
if (($timestamp = strtotime($str)) === -1) {
    echo "The string ($str) is bogus";
} else {
    echo "$str == ". date('l dS of F Y h:i:s A',$timestamp);
}
]]>
      </programlisting>
     </example>
    </para>
    <note>
     <para>
      タイムスタンプの有効な範囲は、通常、Fri, 13 Dec 1901 20:45:54
      GMTからTue, 19 Jan 2038 03:14:07 GMTまでです。(これらは、32ビッ
      ト符号付整数の最大及び最小に一致します。)
     </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
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:
-->