date

説明

指定された引数 timestamp を、与えられた フォーマット文字列によりフォーマットし、日付文字列を返します。 タイムスタンプが与えられない場合は、現在のローカル時刻が使われます。 つまり timestamp はオプションであり そのデフォルト値は time() の値です。

パラメータ

返り値

日付を表す文字列を返します。 timestamp に数字以外が使用された場合は FALSE が返され、E_WARNING レベルのエラーが発生します。

エラー / 例外

すべての日付/時刻関数は、 有効なタイムゾーンが設定されていない場合に E_NOTICE を発生させます。また、システム設定のタイムゾーンあるいは環境変数 TZ を使用した場合には E_STRICT を発生させます。 date_default_timezone_set() も参照ください。

変更履歴

例

例 1. date() の例 <?php // 使用するデフォルトのタイムゾーンを指定します。PHP 5.1 以降で使用可能です。 date_default_timezone_set('UTC'); // 結果は、たとえば Monday のようになります。 echo date("l"); // 結果は、たとえば Monday 15th of August 2005 03:12:46 PM のようになります。 echo date('l dS \of F Y h:i:s A'); // 結果は July 1, 2000 is on a Saturday となります。 echo "July 1, 2000 is on a " . date("l", mktime(0, 0, 0, 7, 1, 2000)); /* 書式指定パラメータに、定数を使用します。 */ // 結果は、たとえば Mon, 15 Aug 2005 15:12:46 UTC のようになります。 echo date(DATE_RFC822); // 結果は、たとえば 2000-07-01T00:00:00+00:00 のようになります。 echo date(DATE_ATOM, mktime(0, 0, 0, 7, 1, 2000)); ?>

前にバックスラッシュを付けてエスケープすることにより、 フォーマット文字列として認識される文字が展開されることを防止することができます。 バックスラッシュ付きの文字は既に特別なシーケンスであり、 バックスラッシュもエスケープすることが必要となる可能性があります。

例 2. date() の文字をエスケープする <?php // Wednesday the 15th のように出力 echo date("l \\t\h\e jS"); ?>

date() と mktime() の両方を用いて、未来または過去の日付を知ることができます。

例 3. date() と mktime() の例 <?php $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); ?>

date() フォーマットのいくつかの例を示します。 現在の実装で特別な意味がある文字や今後の PHP のバージョンで意味が 割り付けられるであろう文字については、望ましくない結果を避けるために エスケープする必要があることに注意してください。エスケープを する際には、改行文字 \n のような文字を回避するために シングルクォートを使用してください。

例 4. date() のフォーマット指定 <?php // 今日は 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, n, 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 ?>

他の言語で日付をフォーマットするためには、date() のかわりに setlocale() および strftime() 関数を使用する必要があります。

注意

参考