date

(PHP 3, PHP 4, PHP 5)

date -- Форматирует системную дату/время

Описание

string date ( string format [, int timestamp] )

Возвращает время, отформатированное в соответствии с аргументом format, используя метку времени, заданную аргументом timestamp или текущее системное время, если timestamp не задан. Другими словами, timestamp является необязательным и по умолчанию равен значению, возвращаемому функцией time().

Любые другие символы, встреченные в строке format, будут выведены в результирующую строку без изменений. Z всегда возвращает 0 при использовании gmdate().

Пример 1. Примеры использования функции date() <?php // вывод дня недели, например Wednesday echo date("l"); // вывод даты в формате: Wednesday 15th of January 2003 05:51:38 AM 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)); ?>

Избежать распознавания символа как форматирующего можно, если экранировать этот символ с помощью \ Если в сочетании с \ символ являееся специальным (например, \t), следует добавлять еще один \.

Пример 2. Экранирование символов в функции date() <?php // вывод: Wednesday the 15th echo date("l \\t\h\e jS"); ?>

Функции date() и mktime() для вывода прошедших и будущих дат.

Пример 3. date() и mktime() example <?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 ?>

Для форматирования дат на других языках используйте функции setlocale() и strftime().

См. также описание функций getlastmod(), gmdate(), mktime(), strftime() и time().