date
(PHP 4, PHP 5, PHP 7, PHP 8)
date — Форматує тимчасову мітку Unix
Опис
date(string $format, ?int $timestamp = null): string
Повертає рядок, відформатований відповідно до зазначеного у параметрі formatшаблоном. Используется метка времени, заданная параметромtimestamp (мітка часу Unix), або поточний системний час, якщо параметр timestampне задан. Таким образом, параметрtimestamp є необов'язковим і за умовчанням дорівнює значенню, що повертається функцією time()
Увага
Мітки часу Unix не обробляють часові пояси. Використовуйте клас DateTimeImmutable та його метод форматування DateTimeInterface::format()для форматирования информации о дате/времени с привязкой к часовому поясу.
Список параметрів
format
Прийнятий формат DateTimeInterface::format()
Зауваження: Функцияdate() завжди генеруватиме
000000як мікросекунд, оскільки вона приймає параметр int, тоді як DateTime::format() підтримує мікросекунди, якщо DateTime був створений із мікросекундами.
timestamp
Необов'язковий параметр timestamp — це ціла (int) мітка часу, за умовчанням рівна поточному місцевому часу, якщо параметр timestamp не вказано або дорівнює **null**Говоря по другому, значение по умолчанию равно результату функцииtime()
Значення, що повертаються
Повертає відформатований рядок із датою.
Помилки
Кожен виклик до функцій дати/часу при неправильних налаштуваннях часового поясу згенерує помилку рівня E_WARNING, якщо часовий пояс неправильний. Дивіться також date_default_timezone_set()
список змін
| Версия | Опис |
|---|---|
| 8.0.0 | timestamp тепер допускає значення null. |
Приклади
Приклад #1 Приклад використання функції date()
Щоб заборонити розпізнавання символу як форматуючого, слід екранувати його за допомогою зворотного слішу. Якщо екранований символ також є послідовністю, що форматує, то слід екранувати його повторно.
Приклад #2 Екранування символів у функції date()
Для виведення минулих та майбутніх дат зручно використовувати функції **date()**иmktime()
**Приклад #3 Приклад спільного використання функцій **date()иmktime()
Зауваження :
Цей спосіб більш надійний, ніж просте віднімання та додавання секунд до мітки часу, оскільки дозволяє при необхідності гнучко здійснити перехід на літній/зимовий час.
Ще кілька прикладів використання функції date(). Важливо, що слід екранувати всі символи, які потрібно залишити без змін. Це справедливо і для тих символів, які в поточній версії PHP не розпізнаються як форматуючі, оскільки це може бути введено в наступних версіях. Для екранування керуючих послідовностей (наприклад, \n) слід використовувати одинарні лапки.
Приклад #4 Форматирование с использованиемdate()****
Для форматування дат іншими мовами замість функції date() можна використовувати метод IntlDateFormatter::format()
Примітки
Зауваження :
Для отримання мітки часу з строкового представлення дати можна скористатися функцією strtotime(). Крім того, деякі бази даних мають власні функції для перетворення внутрішнього подання дати на мітку часу (наприклад, функція MySQL » UNIX_TIMESTAMP
Підказка
Временную метку начала запроса можно получить из поля$_SERVER['REQUEST_TIME']
Дивіться також
- DateTimeImmutable::__construct() - Повертає новий об'єкт DateTimeImmutable
- DateTimeInterface::format() - Повертає дату, відформатовану згідно з переданим форматом
- gmdate() - Форматує дату/час за Грінвічем
- idate() - Перетворює локальний час/дату на ціле число
- getdate() - Повертає інформацію про дату/час
- getlastmod() - Отримує час останньої модифікації сторінки
- mktime() - Повертає позначку часу Unix для заданої дати
- IntlDateFormatter::format() - Форматує значення дати/часу у вигляді рядка
- time() - Повертає поточну мітку системного часу Unix
- Обумовлені константи дати та часу