cal_info()

date()

Введение

Функция date() — одна из наиболее часто используемых встроенных функций PHP для форматирования даты и времени. В этом руководстве рассматриваются её параметры, примеры использования и способы устранения распространённых проблем.

Обзор функции date() в PHP

Функция date() — это встроенная функция PHP, позволяющая форматировать дату и время различными способами. Она принимает два параметра: строку формата и метку времени. Строка формата определяет, как должны отображаться дата и время, а метка времени является необязательной и указывает форматируемый момент. Если метка времени не указана, используются текущие дата и время.

Параметры функции date()

Строка формата, используемая в функции date(), может содержать различные символы формата, которые заменяются соответствующими значениями при выводе даты и времени. Наиболее часто используемые символы формата:

• d: День месяца (от 01 до 31)
• m: Месяц (от 01 до 12)
• Y: Год (четыре цифры)
• H: Час в 24-часовом формате (от 00 до 23)
• i: Минуты (от 00 до 59)
• s: Секунды (от 00 до 59)
• l: Полное текстовое название дня недели (Sunday–Saturday)

Примечание: символы формата чувствительны к регистру. Например, d выводит день с ведущим нулём (01–31), тогда как D выводит сокращённое текстовое название дня (Mon–Sun). Аналогично, l (строчная L) даёт полное название дня, а L указывает, является ли год високосным (1 или 0).

Примеры использования

Рассмотрим несколько примеров использования функции date() для форматирования даты и времени:

echo date("Y/m/d"); // outputs: 2023/03/02

echo date("H:i:s"); // outputs: 14:35:22

echo date("Y-m-d H:i:s"); // outputs: 2023-03-02 14:35:22

Можно также передать необязательную метку времени вторым параметром для форматирования конкретного момента:

echo date("Y-m-d", 1677724800); // outputs: 2023-03-02 (UTC)

Примечание: метка времени 1677724800 соответствует определённому моменту в UTC. Отображаемая дата сместится, если часовой пояс сервера по умолчанию отличается от UTC.

Как видно, строку формата можно настраивать для вывода даты и времени в различных форматах.

Устранение распространённых проблем

При работе с функцией date() разработчики могут столкнуться с рядом типичных проблем. Наиболее распространённые из них и способы их решения:

• Нераспознанные символы формата: date() выводит любой нераспознанный символ формата буквально, не генерируя ошибку. Убедитесь, что используете допустимые символы формата из официальной документации PHP.
• Ограничения диапазона меток времени: на 32-битных системах метки времени за пределами диапазона 1970–2038 могут давать непредсказуемые результаты или переполнение целых чисел. Используйте класс DateTime для дат вне этого диапазона.
• Предупреждения о часовом поясе: в PHP 8.1+ вызов date() без настроенного часового пояса вызывает предупреждение об устаревании. Задайте часовой пояс в начале скрипта с помощью date_default_timezone_set('UTC'); (или вашего предпочтительного часового пояса).

Заключение

Функция date() в PHP — это мощный инструмент, позволяющий разработчикам форматировать дату и время различными способами. Благодаря настраиваемым параметрам и простоте использования она пользуется популярностью среди разработчиков по всему миру. Для более сложных операций с датой и временем рекомендуется использовать современный класс PHP DateTime, который предоставляет объектно-ориентированные методы и более удобную работу с часовыми поясами. Следуя рекомендациям, изложенным в этой статье, вы сможете избежать распространённых проблем и в полной мере использовать возможности этой универсальной функции.

Практика