MySQL функция YEARWEEK

В этом учебном пособии вы узнаете, как использовать MySQL функцию YEARWEEK с синтаксисом и примерами.

Описание

MySQL функция YEARWEEK возвращает год и неделю для значения даты.

Синтаксис

Синтаксис MySQL функции YEARWEEK:

YEARWEEK( date_value, [ mode ] )

Параметры или аргументы

date_value - дата или значение даты/времени, из которой извлекаются год и неделя.

mode - необязательный. Он используется для указания дня недели. Это может быть один из следующих значений:

mode Пояснение Возвращает
0 Первый день недели - воскресенье 0-53
1 Первый день недели - понедельник, а первая неделя - более 3 дней. 0-53
2 Первый день недели - воскресенье 1-53
3 Первый день недели - понедельник, а первая неделя - более 3 дней. 1-53
4 Первый день недели - воскресенье, а первая неделя - более 3 дней. 0-53
5 Первый день недели - понедельник. 0-53
6 Первый день недели - воскресенье, а первая неделя - более 3 дней. 1-53
7 Первый день недели - понедельник. 1-53

Примечание

  • Функция YEARWEEK возвращает значение года, а также значение недели (от 0 до 53 или от 1 до 53) в зависимости от указанного режима.
  • Функция YEARWEEK может возвращать значение года, отличное от года, отображаемого в значении date_value, из-за указанного режима. Это должно произойти только в первую неделю года и последнюю неделю года.
  • Если вы используете MySQL 4.0.14+, а режим не указан, функция YEARWEEK будет использовать значение в системной переменной default_week_format в качестве режима.
  • Если вы используете версию MySQL, которая старше 4.0.14, а mode не указан, функция YEARWEEK будет использовать 0 в качестве mode.
  • См. также функции EXTRACT, YEAR, QUARTER, MONTH, DAY, HOUR, MINUTE, SECOND и MICROSECOND.

Применение

Функция YEARWEEK может использоваться в следующих версиях MySQL:
MySQL 5.7, MySQL 5.6, MySQL 5.5, MySQL 5.1, MySQL 5.0, MySQL 4.1, MySQL 4.0, MySQL 3.23.8

Пример

Рассмотрим примеры функции MySQL YEARWEEK, чтобы понять, как использовать функцию YEARWEEK в MySQL.
Например:
(Примечание. Ваши результаты могут отличаться от приведенных ниже примеров в зависимости от того, как установлена системная переменная default_week_format.)

В следующем примере YEARWEEK будет отображаться год и неделя для текущей системной даты (текущая системная дата возвращается функцией CURDATE).