Описание функции get_weekstartend()
Функция get_weekstartend() возвращает начальную и конечную дату недели для заданной даты. Это полезно для получения диапазона дат, который может быть использован в различных контекстах, например, для отчетов или календарей. Функция учитывает настройки первой недели и формата даты в WordPress.
Параметры
$date
Тип: string
Обязательный: Да
Описание: Дата, для которой нужно получить начало и конец недели
Возможные значения:
$first_day
Тип: int
Обязательный: Нет
Описание: Первый день недели (0 — воскресенье, 1 — понедельник и т.д.)
Возможные значения:
0: 0
1: 1
2: 2
3: 3
4: 4
5: 5
6: 6
Возвращаемое значение
Тип: array
Описание: Массив, содержащий начало и конец недели
Возможные значения:
• Массив с двумя элементами: ‘start’ и ‘end’
• false в случае ошибки
Примеры использования
Базовый пример получения недельного диапазона для заданной даты
$week_dates = get_weekstartend('2023-10-01');
// $week_dates = ['start' => '2023-09-30', 'end' => '2023-10-06']
Начало недели: 2023-09-30, Конец недели: 2023-10-06
Получение диапазона дат с понедельника как первого дня недели
$week_dates = get_weekstartend('2023-10-01', 1);
// $week_dates = ['start' => '2023-10-02', 'end' => '2023-10-08']
Начало недели: 2023-10-02, Конец недели: 2023-10-08
Безопасность
Валидация входных данных: Функция проверяет корректность переданной даты
Санитизация: Параметры автоматически очищаются
Рекомендации: При выводе дат используйте esc_html() для предотвращения XSS
— Связанные функции
Преобразует дату из GMT в локальное время
Форматирует дату с учетом локализации
— Примечания
– Ограничения
Функция может возвращать false при неверном формате даты
– Частые проблемы
- Неверный формат даты приводит к ошибке
- Некорректные значения first_day могут привести к неожиданным результатам
