Виктор Гольцман - MySQL 5.0. Библиотека программиста
Вы можете также задать параметр, определяющий правило нумерации недель.
• 0 – неделя считается начинающейся с воскресенья, первая неделя года – целиком находящаяся в этом году, для дней, предшествующих первой неделе, номер недели равен 0. Например, WEEK('2008-01-01',0) = 0.
• 1 – неделя считается начинающейся с понедельника, первая неделя года – та, более трех дней которой находится в этом году, для дней, предшествующих первой неделе, номер недели равен 0. Например, WEEK('2008-01-01',1) = 1.
• 2 – неделя считается начинающейся с воскресенья, первая неделя года – целиком находящаяся в этом году, для дней, предшествующих первой неделе, номер недели равен номеру последней недели в предыдущем году. Например, WEEK('2008-01-01',2) = 52.
• 3 – неделя считается начинающейся с понедельника, первая неделя года – та, более трех дней которой находится в этом году, для дней, предшествующих первой неделе, номер недели равен номеру последней недели в предыдущем году. Например, WEEK('2008-01-01',3) = 1.
• 4 – неделя считается начинающейся с воскресенья, первая неделя года – та, более трех дней которой находится в этом году, для дней, предшествующих первой неделе, номер недели равен 0. Например, WEEK('2008-01-01',4) = 1.
• 5 – неделя считается начинающейся с понедельника, первая неделя года – целиком находящаяся в этом году, для дней, предшествующих первой неделе, номер недели равен 0. Например, WEEK('2008-01-01',5) = 0.
• 6 – неделя считается начинающейся с воскресенья, первая неделя года – та, более трех дней которой находится в этом году, для дней, предшествующих первой неделе, номер недели равен номеру последней недели в предыдущем году. Например, WEEK('2008-01-01',6) = 1.
• 7 – неделя считается начинающейся с понедельника, первая неделя года – целиком находящаяся в этом году, для дней, предшествующих первой неделе, номер недели равен номеру последней недели в предыдущем году. Например, WEEK('2008-01-01',7) = 53.
• WEEKOFYEAR('<Дата или дата и время>').
Является синонимом WEEKOFYEAR(<Дата или дата и время>,3).
• MONTHNAME('<Дата или дата и время>').
Функция MONTHNAME() получает в качестве аргумента дату или дату и время и возвращает наименование месяца, которому принадлежит эта дата. Например, MONTHNAME('2007-12-12') возвращает значение December. О том, как настроить вывод дат на русском языке, рассказывалось при описании функции DAYNAME().
• MONTH('<Дата или дата и время>').
Функция MONTH() получает в качестве аргумента дату или дату и время и возвращает номер месяца, которому принадлежит эта дата. Например, MONTH('2007-12-12') возвращает значение 12.
• QUARTER('<Дата или дата и время>').
Функция QUARTER() получает в качестве аргумента дату или дату и время и возвращает номер квартала, которому принадлежит эта дата. Например, QUARTER('2007-12-12') возвращает значение 4.
• YEAR('<Дата или дата и время>').
Функция YEAR() получает в качестве аргумента дату или дату и время и возвращает номер года, которому принадлежит эта дата. Например, YEAR('2007-12–12') возвращает значение 2007.
• YEARWEEK('<Дата или дата и время>' [,Правило нумерации]).
Функция YEARWEEK() получает в качестве аргумента дату или дату и время и возвращает номер года и номер недели в году в формате YYYYWW. По умолчанию неделя считается начинающейся с воскресенья, и первой неделей считается та неделя, воскресенье которой принадлежит данному году, а дни, предшествующие первой неделе, считаются относящимися к последней неделе предыдущего года. Например, YEARWEEK('2007-12-31') = YEARWEEK('2008-01-01') = 200752, и это означает, что обе даты относятся к 52-й неделе 2007 г.
Вы можете также задать параметр, определяющий правило нумерации недель. Этот параметр аналогичен соответствующему параметру функции WEEK(), о которой мы рассказывали выше, однако для тех дат, для которых функция WEEK() возвращает значение 0, функция YEARWEEK() возвращает номер предыдущего года и номер последней недели предыдущего года. Например, WEEK('2008-01-01',5) = 200753.
• HOUR('<Время или дата и время>').
Функция HOUR() получает в качестве аргумента время или дату и время и выделяет из нее часы. Например, HOUR('12:30:00') возвращает значение 12.
• MINUТЕ('<Время или дата и время>').
Функция MINUTE() получает в качестве аргумента время или дату и время и выделяет из нее минуты. Например, MINUTE('12:30:00') возвращает значение 30.
• SECOND('<Время или дата и время>').
Функция SECOND() получает в качестве аргумента время или дату и время и выделяет из нее секунды. Например, SECOND('12:30:00') возвращает значение 0.
• EXTRACT('<Наименование периода>' FROM '<Дата и/или время>'). Функция EXTRACT() – наиболее общая из функций получения компонентов даты и времени. Первым ее аргументом является наименование компонента или диапазона компонентов, которые нужно выделить из даты:
• DAY – число (номер дня в месяце);
• WEEK – номер недели в году;
• MONTH – номер месяца;
• QUARTER – номер квартала;
• YEAR – номер года;
• HOUR – часы;
• MINUTE – минуты;
• SECOND – секунды;
• YEAR_MONTH – номер года и номер месяца;
• DAY_HOUR – число и часы;
• DAY_MINUTE – число, часы и минуты;
• DAY_SECOND – число, часы, минуты и секунды;
• HOUR_MINUTE – часы и минуты;
• HOUR_SECOND – часы, минуты и секунды;
• MINUTE_SECOND – минуты и секунды.
Вторым аргументом функции может быть дата и время, а также, в зависимости от извлекаемого компонента, либо дата, либо время.
Например, EXTRACT(WEEK FROM '2007-12-31') возвращает, как и WEEK('2007-12–31'), значение 52, а EXTRACT(DAY_MINUTE FROM '2007-12-31 12:30:00') возвращает значение 311230 (31 число, 12 часов и 30 минут).
В следующем подразделе я расскажу о функциях, позволяющих выполнять арифметические операции с датами.
Функции сложения и вычитания дат
Рассмотрим функции, которые вы можете использовать для выполнения арифметических операций.
• ADDDATE('<Дата или дата и время>',<Количество дней>) или ADDDATE('<Дата или дата и время>',<Временной интервал>). Функция возвращает дату или дату и время, сдвинутые относительно указанной даты на указанное количество дней или на указанный временной интервал. Для задания интервала можно использовать один из следующих основных форматов:
• INTERVAL '<Количество секунд>' SECOND
• INTERVAL '<Количество минут>' MINUTE
• INTERVAL '<Количество часов>' HOUR
• INTERVAL '<Количество дней>' DAY
• INTERVAL '<Количество недель>' WEEK
• INTERVAL '<Количество месяцев>' MONTH
• INTERVAL '<Количество кварталов>' QUARTER
• INTERVAL '<Количество лет>' YEAR
• INTERVAL '<Количество минут>:<Количество секунд>' MINUTE_SECOND
• INTERVAL '<Количество часов>:<Количество минут>:<Количество секунд>' HOUR_SECOND
• INTERVAL '<Количество часов>:<Количество минут>' HOUR_MINUTE
• INTERVAL '<Количество дней> <Количество часов>:<Количество минут>:<Количество секунд>' DAY SECOND
• INTERVAL '<Количество дней> <Количество часов>:<Количество минут>' DAY_MINUTE
• INTERVAL '<Количество дней> <Количество часов>' DAY_HOUR
• INTERVAL '<Количество лет>-<Количество месяцев>' YEAR MONTH
Например, функция ADDDATE('2007-12-12',28) добавляет 28 дней к 12 декабря 2007 г. и возвращает результат 2008-01-09, а функция ADDDATE('2007-12-12',INTERVAL '28 12:30' DAY_MINUTE) добавляет 28 дней, 12 часов и 30 минут к 12 декабря 2007 г. и возвращает результат 2008-01-09 12:30:00.
• DATE_ADD('<Дата или дата и время>','<Временной интервал>').
Синоним ADDDATE('<Дата или дата и время>','<Временной интервал>').
• ADDTIME(<Время или дата и время>,<Добавляемое время>).
Функция возвращает сумму своих аргументов. Например, функция ADDTIME ('2007-12-12 12:30:00','15:50:00') добавляет 15 часов 50 минут к 12 часам 30 минутам 12 декабря 2007 г. и возвращает результат 2007-12-13 04:20:00.
• SUBDATE('<Дата или дата и время>',<Количество дней>) или SUBDATE('<Дата или дата и время>','<Временной интервал>').
Функция SUBDATE() аналогична функции ADDDATE(), только указанное количество дней или указанный временной интервал не добавляются к дате, а вычитаются из нее, иными словами, дата сдвигается в прошлое, а не в будущее. Например, функция SUBDATE('2007-12-12',INTERVAL '28 12:30' DAY_MINUTE) вычитает 28 дней, 12 часов и 30 минут из 12 декабря 2007 г. и возвращает результат 2007-11-13 11:30:00.
• DATE_SUB('<Дата или дата и время>','<Временной интервал>')
Синоним SUBDATE('<Дата или дата и время>','<Временной интервал>').
• SUBTIME(<Время или дата и время>,<Вычитаемое время>).
Функция возвращает разность своих аргументов. Например, функция SUBTIME('2007-12-12 12:30:00','15:50:00') вычитает 15 часов 50 минут из 12 часов 30 минут 12 декабря 2007 г. и возвращает результат 2007-12-11 20:40:00.
• DATEDIFF('<Дата или дата и время>','<Дата или дата и время>').
Функция DATEDIFF() возвращает разность в днях между первой и второй датой (время при этом не учитывается). Если первая дата предшествует второй, результат будет отрицательным. Например, DATEDIFF('2007-12-12 12:30:00','2007-12-31') возвращает значение –19.
• TIMEDIFF('<Время или дата и время>','<Время или дата и время>').
Функция TIMEDIFF() возвращает разность своих аргументов в формате времени. Если первый момент предшествует второму, результат будет отрицательным. Например, функция TIMEDIFF('2007-12-12 12:30:00','2007-12-31 15:50:00') возвращает значение –459:20:00. Это означает, что 12 декабря 2007 г. 12 часов 30 минут отстоит в прошлое от 31 декабря 2007 г. 15 часов 50 минут на 459 часов 20 минут.
