Виктор Гольцман - MySQL 5.0. Библиотека программиста
Функция 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 минут.
• PERIOD_ADD(<Период в формате YYMM или YYYYMM>,<Количество месяцев>).
Функция PERIOD_ADD() возвращает результат добавления к указанному периоду указанное количество месяцев. Обратите внимание, что оба аргумента этой функции – числа и возвращаемый результат – также число. Например, PERIOD_ADD(200712,3) возвращает значение 200803, поскольку через три месяца после декабря 2007 г наступит март 2008 г.
• PERIOD_DIFF(<Период в формате YYMM или YYYYMM>,<Период в формате YYMM или YYYYMM>).
Функция PERIOD_DIFF() возвращает разность в месяцах между первым и вторым периодом. Обратите внимание, что оба аргумента этой функции – числа. Например, PERIOD_DIFF(200712,200803) возвращает значение – 3.
• TIMESTAMP('<Дата или дата время>','<Время>').
Функция TIMESTAMP() возвращает сумму своих аргументов в формате даты и времени. Например, функция TIMESTAMP('2007-12-12 12:30','15:50') добавляет 15 часов 50 минут к 12 часам 30 минутам 12 декабря 2007г. и возвращает результат 2007-12-13 04:20:00.
• TIMESTAMPADD(<Тип периода>,<Длина периода>,<Дата или дата и время>).
Функция TIMESTAMPADD() возвращает дату или дату и время сдвинутые относительно указанной даты на указанный период. Первым аргументом является тип периода:
DAY —число(номерднявмесяце;
WEEK —номернеделивгоду
MONTH —номермесяца
QUARTER —номерквартала
YEAR —номергода
HOUR —часы
MINUTE —минуты
SECOND —секунды
Вторым аргументом является целое число – длина периода, то есть количество единиц измерения, заданных первым параметром. Если длина периода меньше 0, дата, определяемая третьим параметром, будет сдвинута в прошлое.
Например, функция TIMESTAMPADD(HOUR,15,'2007-12-12 12:30:00') добавляет15 часов к 12 часам 30 минутам 12 декабря 2007г. и возвращает результат 2007-12-13 03:30:00.
• TIMESTAMPDIFF(<Тип периода>,<Дата или дата и время>,<Дата или дата и время>).
Функция TIMESTAMPDIFF() возвращает количество указанных периодов, прошедших между первым и вторым моментом. Первый аргумент может приниматьте же значения, что и первый аргумент функции TIMESTAMPADD(). Если вторая дата предшествует первой, результат будет отрицательным. Например, TIMESTAMPDIFF(WEEK, 2007-12-12 12:30:00, 2007-12-31)возвращает значение 2, и это означает, что 12 декабря и 31 декабря 2007 г. разделяют две недели.
В следующем подразделе мы рассмотрим функции, позволяющие переводить даты из одного формата в другой.
Функции преобразования форматов дат
Для преобразования дат из одного формата в другой вы можете использовать следующие основные функции:
• DATE_FORMAT('<Дата или дата и время>', '<Формат>').
Функция DATE_FORMAT() возвращает строку, содержащую дату, преобразованную к указанному формату. Формат может включать следующие основные параметры:
• %a – сокращенное наименование дня недели (Sun, Mon и т. д.). О том, как настроить вывод дат на русском языке («Пнд», «Втр» и т. д.), рассказывалось при описании функции DAYNAME().
• %b – сокращенное наименование месяца (Jan, Feb и т. д.). О том, как настроить вывод дат на русском языке (Янв, Фев и т. д.), говорилось при описании функции DAYNAME().
• %c – номер месяца (0-12).
• %D – число (номер дня в месяце) с английским суффиксом (0th, 1st, 2nd, и т. д.).
• %d – число месяца (00–31).
• %e – число месяца (0-31).
• %H – часы (00–23).
• %h, %I – часы (01–12).
• %i – минуты (0 0–5 9).
• %j – номер дня в году (0 01-3 6 6).
• %k – часы (0-23).
• %l – часы (1-12).
• %M – наименование месяца (January, February и т. д.). О том, как настроить вывод дат на русском языке (Января, Февраля и т. д.), говорилось при описании функции DAYNAME().
• %m – номер месяца (00–12).
• %p – AM (обозначение первой половины суток) или PM (обозначение второй половины суток).
• %r – время в 12-часовом формате (HH:MM:SS AM или PM).
• %S, %s – секунды (0 0–5 9).
• %T – время в 24-часовом формате (HH:MM:SS).
• %U – номер недели в году (0 0-53), первым днем недели считается воскресенье, первая неделя года – целиком находящаяся в этом году, для дней, предшествующих первой неделе, номер недели равен 0.
• %u – номер недели в году (0 0-53), первым днем недели считается понедельник, первая неделя года – та, более трех дней которой находится в этом году, для дней, предшествующих первой неделе, номер недели равен 0.
• %V – номер недели в году (01–53), первым днем недели считается воскресенье, первая неделя года – целиком находящаяся в этом году, для дней, предшествующих первой неделе, номер недели равен номеру последней недели в предыдущем году.
• %v – номер недели в году (01–53), первым днем недели считается понедельник, первая неделя года – та, более трех дней которой находится в этом году, для дней, предшествующих первой неделе, номер недели равен номеру последней недели в предыдущем году.
• %W – наименование дня недели (Sunday, Monday и т. д.). О том, как настроить вывод дат на русском языке (Понедельник, Вторник и т. д.), было сказано при описании функции DAYNAME().
• %w – номер дня недели (0 – воскресенье, 1 – понедельник и т. д.).
• %X – номер года, к которому относится текущая неделя (первым днем недели считается воскресенье, первая неделя года – целиком находящаяся в этом году, неделя, предшествующая первой неделе года, относится к предыдущему году), в формате YYYY.
• %x – номер года, к которому относится текущая неделя (первым днем недели считается понедельник, первая неделя года – та, более трех дней которой находится в этом году, неделя, предшествующая первой неделе года, относится к предыдущему году), в формате YYYY.
• %Y – номер года в формате YYYY.
• %y – номер года в формате YY.
• %% – знак процента.
Например, функция DATE_FORMAT('2007-12-12 12:30:00', %e %M %Y г. %k часов %i минут') возвращает значение 12 December 2007 г. 12 часов 30 минут или 12 Декабря 2007 г. 12 часов 30 минут, в зависимости от установленного языка вывода дат.
• TIME_FORMAT('<Время или дата и время>', '<Формат>').
Функция TIME_FORMAT() возвращает время, преобразованное к указанному формату. Формат может включать те из перечисленных выше параметров, которые предназначены для отображения часов, минут и секунд. Например, функция TIME_FORMAT('2007-12-12 12:30:00', '%k часов %i минут') возвращает значение 12 часов 30 минут.
• STR_TO_DATE('<Строка>', '<Формат>').
Функция STR_TO_DATE() получает в качестве аргумента строку, содержащую дату и/или время, и строку формата, и возвращает дату и/или время, полученные из строки в соответствии с указанным форматом. Функции STR_TO_DATE() и DATE_FORMAT() взаимно обратны: если дата была преобразована в строку некоторого формата с помощью функции DATE_FORMAT(), то с помощью функции STR_TO_DATE(), указав тот же формат, можно получить исходную дату, и наоборот. Например, STR_TO_DATE('12 December 2007 г. 12 часов 30 минут','%e %M %Y г. %k часов %i минут') = STR_TO_DATE(DATE_FORMAT('2007-12-12 12:30:00','%e %M %Y г. %k часов %i минут'), '%e %M %Y г. %k часов %i минут') = 2007-12-12 12:30:00. Однако названия месяцев и дней недели на русском языке функция STR_TO_DATE() обрабатывает некорректно.
• GET_FORMAT(<DATE, TIME или DATETIME>,<'EUR', 'ISO', 'JIS', 'USA' или 'INTERNAL'>).
Функция GET_FORMAT() возвращает строку формата даты и/или времени, которую затем можно использовать в функции DATE_FORMAT(). Первый аргумент функции указывает, какой формат нужно получить: формат даты, времени или даты и времени. Второй аргумент задает стандарт, которому соответствует возвращаемый формат. Например, функция GET_FORMAT(DATETIME,'EUR') возвращает значение %Y-%m-%d %H.%i.%s».
• MAKEDATE(<Номер года>,<Номер дня в году>).
Функция MAKEDATE() получает в качестве аргументов номер года и номер дня в году и возвращает дату, соответствующую этому году и дню. Например, функция MAKEDATE(2007,346) возвращает значение 2007-12-12.
• MAKETIME(<Часы>,<Минуты>,<Секунды>).
Функция MAKETIME() получает в качестве аргументов час, минуту и секунду и возвращает соответствующее время. Например, функция MAKETIME(12,30,0) возвращает значение 12:30:00.
• FROM_DAYS(<Количество дней>).
Функция FROM_DAYS() получает в качестве аргумента количество дней от Р. Х. и возвращает дату, соответствующую этому дню. Например, функция FROM_DAYS(733387) возвращает значение 2007-12-12.
• TO_DAYS(<Дата или дата и время>).
Функция TO_DAYS() получает в качестве аргумента дату или дату и время и возвращает количество дней от Р. Х., соответствующее этой дате. Например, функция TO_DAYS('2007-12-12 12:30:00') возвращает значение 733387.
• SEC_TO_TIME(<Количество секунд>).
Функция SEC_TO_TIME() получает в качестве аргумента количество секунд и возвращает соответствующее количество часов, минут и секунд в формате времени. Например, функция SEC_TO_TIME(45000) возвращает значение 12:30:00.
• TIME_TO_SEC(<Время или дата и время>).
Функция TIME_TO_SEC() получает в качестве аргумента время или дату и время и возвращает количество секунд, соответствующее времени (дата при этом игнорируется). Например, функция TIME_TO_SEC('2007-12-12 12:30:00') возвращает значение 45 000.
• FROM_UNIXTIME(<Unix-время>[,'<Формат>']).
