Pantek Library
Hosting Provided By
CybrHost
High Speed Hosting
Applications: MySQL > doc > refman > 6.0 > endate-and-time-functions.html (Request Expert MySQL Support)
Skip navigation links

Additional languages
    MySQL 6.0 Reference Manual :: 11 Functions and Operators :: 11.6 Date and Time Functions

    11.6. Date and Time Functions

    This section describes the functions that can be used to manipulate temporal values. See Section 10.3, “Date and Time Types”, for a description of the range of values each date and time type has and the valid formats in which values may be specified.

    NameDescription
    ADDDATE()(v4.1.1)Add dates
    ADDTIME()(v4.1.1)Add time
    CONVERT_TZ()(v4.1.3)Convert from one timezone to another
    CURDATE()Return the current date
    CURRENT_DATE(), CURRENT_DATESynonyms for CURDATE()
    CURRENT_TIME(), CURRENT_TIMESynonyms for CURTIME()
    CURRENT_TIMESTAMP(), CURRENT_TIMESTAMPSynonyms for NOW()
    CURTIME()Return the current time
    DATE_ADD()Add two dates
    DATE_FORMAT()Format date as specified
    DATE_SUB()Subtract two dates
    DATE()(v4.1.1)Extract the date part of a date or datetime expression
    DATEDIFF()(v4.1.1)Subtract two dates
    DAY()(v4.1.1)Synonym for DAYOFMONTH()
    DAYNAME()(v4.1.21)Return the name of the weekday
    DAYOFMONTH()Return the day of the month (1-31)
    DAYOFWEEK()Return the weekday index of the argument
    DAYOFYEAR()Return the day of the year (1-366)
    EXTRACTExtract part of a date
    FROM_DAYS()Convert a day number to a date
    FROM_UNIXTIME()Format UNIX timestamp as a date
    GET_FORMAT()(v4.1.1)Return a date format string
    HOUR()Extract the hour
    LAST_DAY(v4.1.1)Return the last day of the month for the argument
    LOCALTIME(), LOCALTIMESynonym for NOW()
    LOCALTIMESTAMP, LOCALTIMESTAMP()(v4.0.6)Synonym for NOW()
    MAKEDATE()(v4.1.1)Create a date from the year and day of year
    MAKETIME(v4.1.1)MAKETIME()
    MICROSECOND()(v4.1.1)Return the microseconds from argument
    MINUTE()Return the minute from the argument
    MONTH()Return the month from the date passed
    MONTHNAME()(v4.1.21)Return the name of the month
    NOW()Return the current date and time
    PERIOD_ADD()Add a period to a year-month
    PERIOD_DIFF()Return the number of months between periods
    QUARTER()Return the quarter from a date argument
    SEC_TO_TIME()Converts seconds to 'HH:MM:SS' format
    SECOND()Return the second (0-59)
    STR_TO_DATE()(v4.1.1)Convert a string to a date
    SUBDATE()When invoked with three arguments a synonym for DATE_SUB()
    SUBTIME()(v4.1.1)Subtract times
    SYSDATE()Return the time at which the function executes
    TIME_FORMAT()Format as time
    TIME_TO_SEC()Return the argument converted to seconds
    TIME()(v4.1.1)Extract the time portion of the expression passed
    TIMEDIFF()(v4.1.1)Subtract time
    TIMESTAMP()(v4.1.1)With a single argument, this function returns the date or datetime expression. With two arguments, the sum of the arguments
    TIMESTAMPADD()(v5.0.0)Add an interval to a datetime expression
    TIMESTAMPDIFF()(v5.0.0)Subtract an interval from a datetime expression
    TO_DAYS()Return the date argument converted to days
    UNIX_TIMESTAMP()Return a UNIX timestamp
    UTC_DATE()(v4.1.1)Return the current UTC date
    UTC_TIME()(v4.1.1)Return the current UTC time
    UTC_TIMESTAMP()(v4.1.1)Return the current UTC date and time
    WEEK()Return the week number
    WEEKDAY()Return the weekday index
    WEEKOFYEAR()(v4.1.1)Return the calendar week of the date (1-53)
    YEAR()Return the year
    YEARWEEK()Return the year and week

    Here is an example that uses date functions. The following query selects all rows with a date_col value from within the last 30 days: 

    mysql> 
SELECT something FROM tbl_name
    -> 
WHERE DATE_SUB(CURDATE(),INTERVAL 30 DAY) <= date_col;

    Note that the query also selects rows with dates that lie in the future.

    Functions that expect date values usually accept datetime values and ignore the time part. Functions that expect time values usually accept datetime values and ignore the date part.

    Functions that return the current date or time each are evaluated only once per query at the start of query execution. This means that multiple references to a function such as NOW() within a single query always produce the same result (for our purposes a single query also includes a call to a stored routine or trigger and all sub-routines called by that routine/trigger). This principle also applies to CURDATE(), CURTIME(), UTC_DATE(), UTC_TIME(), UTC_TIMESTAMP(), and to any of their synonyms.

    Do you need help?X

    The CURRENT_TIMESTAMP(), CURRENT_TIME(), CURRENT_DATE(), and FROM_UNIXTIME() functions return values in the connection's current time zone, which is available as the value of the time_zone system variable. In addition, UNIX_TIMESTAMP() assumes that its argument is a datetime value in the current time zone. See Section 9.7, “MySQL Server Time Zone Support”.

    Some date functions can be used with “zero” dates or incomplete dates such as '2001-11-00', whereas others cannot. Functions that extract parts of dates typically work with incomplete dates. For example: 

    mysql> 
SELECT DAYOFMONTH('2001-11-00'), MONTH('2005-00-00');
        -> 0, 0

    Other functions expect complete dates and return NULL for incomplete dates. These include functions that perform date arithmetic or that map parts of dates to names. For example: 

    mysql> 
SELECT DATE_ADD('2006-05-00',INTERVAL 1 DAY);
        -> NULL
mysql> 
SELECT DAYNAME('2006-05-00');
        -> NULL

    • ADDDATE(date,INTERVAL expr unit), ADDDATE(expr,days)

      When invoked with the INTERVAL form of the second argument, ADDDATE() is a synonym for DATE_ADD(). The related function SUBDATE() is a synonym for DATE_SUB(). For information on the INTERVAL unit argument, see the discussion for DATE_ADD(). 

      mysql> 
SELECT DATE_ADD('1998-01-02', INTERVAL 31 DAY);
        -> '1998-02-02'
mysql> 
SELECT ADDDATE('1998-01-02', INTERVAL 31 DAY);
        -> '1998-02-02'

      When invoked with the days form of the second argument, MySQL treats it as an integer number of days to be added to expr. 

      mysql> 
SELECT ADDDATE('1998-01-02', 31);
        -> '1998-02-02'

    • ADDTIME(expr1,expr2)

      ADDTIME() adds expr2 to expr1 and returns the result. expr1 is a time or datetime expression, and expr2 is a time expression.

      Do you need more help?X
      mysql> 
SELECT ADDTIME('2007-12-31 23:59:59.999999',
    ->                
'1 1:1:1.000002');
        -> '2008-01-02 01:01:01.000001'
mysql> 
SELECT ADDTIME('01:00:00.999999', '02:00:00.999998');
        -> '03:00:01.999997'

    • CONVERT_TZ(dt,from_tz,to_tz)

      CONVERT_TZ() converts a datetime value dt from the time zone given by from_tz to the time zone given by to_tz and returns the resulting value. Time zones are specified as described in Section 9.7, “MySQL Server Time Zone Support”. This function returns NULL if the arguments are invalid.

      If the value falls out of the supported range of the TIMESTAMP type when converted from from_tz to UTC, no conversion occurs. The TIMESTAMP range is described in Section 10.1.2, “Overview of Date and Time Types”. 

      mysql> 
SELECT CONVERT_TZ('2004-01-01 12:00:00','GMT','MET');
        -> '2004-01-01 13:00:00'
mysql> 
SELECT CONVERT_TZ('2004-01-01 12:00:00','+00:00','+10:00');
        -> '2004-01-01 22:00:00'

      Note

      To use named time zones such as 'MET' or 'Europe/Moscow', the time zone tables must be properly set up. See Section 9.7, “MySQL Server Time Zone Support”, for instructions.

    • CURDATE()

      Returns the current date as a value in 'YYYY-MM-DD' or YYYYMMDD format, depending on whether the function is used in a string or numeric context. 

      mysql> 
SELECT CURDATE();
        -> '2008-06-13'
mysql> 
SELECT CURDATE() + 0;
        -> 20080613

    • CURRENT_DATE, CURRENT_DATE()

      CURRENT_DATE and CURRENT_DATE() are synonyms for CURDATE().

      Can we help you?X

    • CURTIME()

      Returns the current time as a value in 'HH:MM:SS' or HHMMSS.uuuuuu format, depending on whether the function is used in a string or numeric context. The value is expressed in the current time zone. 

      mysql> 
SELECT CURTIME();
        -> '23:50:26'
mysql> 
SELECT CURTIME() + 0;
        -> 235026.000000

    • CURRENT_TIME, CURRENT_TIME()

      CURRENT_TIME and CURRENT_TIME() are synonyms for CURTIME().

    • CURRENT_TIMESTAMP, CURRENT_TIMESTAMP()

      CURRENT_TIMESTAMP and CURRENT_TIMESTAMP() are synonyms for NOW().

    • DATE(expr)

      Extracts the date part of the date or datetime expression expr.

      Can't find what you're looking for?X
      mysql> 
SELECT DATE('2003-12-31 01:02:03');
        -> '2003-12-31'

    • DATEDIFF(expr1,expr2)

      DATEDIFF() returns expr1 – expr2 expressed as a value in days from one date to the other. expr1 and expr2 are date or date-and-time expressions. Only the date parts of the values are used in the calculation. 

      mysql> 
SELECT DATEDIFF('2007-12-31 23:59:59','2007-12-30');
        -> 1
mysql> 
SELECT DATEDIFF('2010-11-30 23:59:59','2010-12-31');
        -> -31

    • DATE_ADD(date,INTERVAL expr unit), DATE_SUB(date,INTERVAL expr unit)

      These functions perform date arithmetic. The date argument specifies the starting date or datetime value. expr is an expression specifying the interval value to be added or subtracted from the starting date. expr is a string; it may start with a “-” for negative intervals. unit is a keyword indicating the units in which the expression should be interpreted.

      The INTERVAL keyword and the unit specifier are not case sensitive.

      The following table shows the expected form of the expr argument for each unit value.

      unit ValueExpected expr Format
      MICROSECONDMICROSECONDS
      SECONDSECONDS
      MINUTEMINUTES
      HOURHOURS
      DAYDAYS
      WEEKWEEKS
      MONTHMONTHS
      QUARTERQUARTERS
      YEARYEARS
      SECOND_MICROSECOND'SECONDS.MICROSECONDS'
      MINUTE_MICROSECOND'MINUTES.MICROSECONDS'
      MINUTE_SECOND'MINUTES:SECONDS'
      HOUR_MICROSECOND'HOURS.MICROSECONDS'
      HOUR_SECOND'HOURS:MINUTES:SECONDS'
      HOUR_MINUTE'HOURS:MINUTES'
      DAY_MICROSECOND'DAYS.MICROSECONDS'
      DAY_SECOND'DAYS HOURS:MINUTES:SECONDS'
      DAY_MINUTE'DAYS HOURS:MINUTES'
      DAY_HOUR'DAYS HOURS'
      YEAR_MONTH'YEARS-MONTHS'

      The return value depends on the arguments:

      To ensure that the result is DATETIME, you can use CAST() to convert the first argument to DATETIME.

      MySQL allows any punctuation delimiter in the expr format. Those shown in the table are the suggested delimiters. If the date argument is a DATE value and your calculations involve only YEAR, MONTH, and DAY parts (that is, no time parts), the result is a DATE value. Otherwise, the result is a DATETIME value.

      Date arithmetic also can be performed using INTERVAL together with the + or - operator: 

      date + INTERVAL 
expr 
unitdate - INTERVAL 
expr 
unit

      INTERVAL expr unit is allowed on either side of the + operator if the expression on the other side is a date or datetime value. For the - operator, INTERVAL expr unit is allowed only on the right side, because it makes no sense to subtract a date or datetime value from an interval. 

      mysql> 
SELECT '2008-12-31 23:59:59' + INTERVAL 1 SECOND;
        -> '2009-01-01 00:00:00'
mysql> 
SELECT INTERVAL 1 DAY + '2008-12-31';
        -> '2009-01-01'
mysql> 
SELECT '2005-01-01' - INTERVAL 1 SECOND;
        -> '2004-12-31 23:59:59'
mysql> 
SELECT DATE_ADD('2000-12-31 23:59:59',
    -> 
                INTERVAL 1 SECOND);
        -> '2001-01-01 00:00:00'
mysql> 
SELECT DATE_ADD('2010-12-31 23:59:59',
    -> 
                INTERVAL 1 DAY);
        -> '2011-01-01 23:59:59'
mysql> 
SELECT DATE_ADD('2100-12-31 23:59:59',
    -> 
                INTERVAL '1:1' MINUTE_SECOND);
        -> '2101-01-01 00:01:00'
mysql> 
SELECT DATE_SUB('2005-01-01 00:00:00',
    -> 
                INTERVAL '1 1:1:1' DAY_SECOND);
        -> '2004-12-30 22:58:59'
mysql> 
SELECT DATE_ADD('1900-01-01 00:00:00',
    -> 
                INTERVAL '-1 10' DAY_HOUR);
        -> '1899-12-30 14:00:00'
mysql> 
SELECT DATE_SUB('1998-01-02', INTERVAL 31 DAY);
        -> '1997-12-02'
mysql> 
SELECT DATE_ADD('1992-12-31 23:59:59.000002',
    ->            
INTERVAL '1.999999' SECOND_MICROSECOND);
        -> '1993-01-01 00:00:01.000001'

      If you specify an interval value that is too short (does not include all the interval parts that would be expected from the unit keyword), MySQL assumes that you have left out the leftmost parts of the interval value. For example, if you specify a unit of DAY_SECOND, the value of expr is expected to have days, hours, minutes, and seconds parts. If you specify a value like '1:10', MySQL assumes that the days and hours parts are missing and the value represents minutes and seconds. In other words, '1:10' DAY_SECOND is interpreted in such a way that it is equivalent to '1:10' MINUTE_SECOND. This is analogous to the way that MySQL interprets TIME values as representing elapsed time rather than as a time of day.

      Because expr is treated as a string, be careful if you specify a non-string value with INTERVAL. For example, with an interval specifier of HOUR_MINUTE, 6/4 evaluates to 1.5000 and is treated as 1 hour, 5000 minutes: 

      mysql> 
SELECT 6/4;
        -> 1.5000
mysql> 
SELECT DATE_ADD('1999-01-01', INTERVAL 6/4 HOUR_MINUTE);
        -> '1999-01-04 12:20:00'

      To ensure interpretation of the interval value as you expect, a CAST() operation may be used. To treat 6/4 as 1 hour, 5 minutes, cast it to a DECIMAL value with a single fractional digit:

      Confused? Frustrated?X
      mysql> 
SELECT CAST(6/4 AS DECIMAL(3,1));
        -> 1.5
mysql> 
SELECT DATE_ADD('1970-01-01 12:00:00',
    -> 
                INTERVAL CAST(6/4 AS DECIMAL(3,1)) HOUR_MINUTE);
        -> '1970-01-01 13:05:00'

      If you add to or subtract from a date value something that contains a time part, the result is automatically converted to a datetime value: 

      mysql> 
SELECT DATE_ADD('1999-01-01', INTERVAL 1 DAY);
        -> '1999-01-02'
mysql> 
SELECT DATE_ADD('1999-01-01', INTERVAL 1 HOUR);
        -> '1999-01-01 01:00:00'

      If you add MONTH, YEAR_MONTH, or YEAR and the resulting date has a day that is larger than the maximum day for the new month, the day is adjusted to the maximum days in the new month: 

      mysql> 
SELECT DATE_ADD('1998-01-30', INTERVAL 1 MONTH);
        -> '1998-02-28'

      Date arithmetic operations require complete dates and do not work with incomplete dates such as '2006-07-00' or badly malformed dates: 

      mysql> 
SELECT DATE_ADD('2006-07-00', INTERVAL 1 DAY);
        -> NULL
mysql> 
SELECT '2005-03-32' + INTERVAL 1 MONTH;
        -> NULL

    • DATE_FORMAT(date,format)

      Formats the date value according to the format string.

      The following specifiers may be used in the format string. The “%” character is required before format specifier characters.

      SpecifierDescription
      %aAbbreviated weekday name (Sun..Sat)
      %bAbbreviated month name (Jan..Dec)
      %cMonth, numeric (0..12)
      %DDay of the month with English suffix (0th, 1st, 2nd, 3rd, …)
      %dDay of the month, numeric (00..31)
      %eDay of the month, numeric (0..31)
      %fMicroseconds (000000..999999)
      %HHour (00..23)
      %hHour (01..12)
      %IHour (01..12)
      %iMinutes, numeric (00..59)
      %jDay of year (001..366)
      %kHour (0..23)
      %lHour (1..12)
      %MMonth name (January..December)
      %mMonth, numeric (00..12)
      %pAM or PM
      %rTime, 12-hour (hh:mm:ss followed by AM or PM)
      %SSeconds (00..59)
      %sSeconds (00..59)
      %TTime, 24-hour (hh:mm:ss)
      %UWeek (00..53), where Sunday is the first day of the week
      %uWeek (00..53), where Monday is the first day of the week
      %VWeek (01..53), where Sunday is the first day of the week; used with %X
      %vWeek (01..53), where Monday is the first day of the week; used with %x
      %WWeekday name (Sunday..Saturday)
      %wDay of the week (0=Sunday..6=Saturday)
      %XYear for the week where Sunday is the first day of the week, numeric, four digits; used with %V
      %xYear for the week, where Monday is the first day of the week, numeric, four digits; used with %v
      %YYear, numeric, four digits
      %yYear, numeric (two digits)
      %%A literal “%” character
      %xx, for any “x” not listed above

      Ranges for the month and day specifiers begin with zero due to the fact that MySQL allows the storing of incomplete dates such as '2004-00-00'.

      The language used for day and month names and abbreviations is controlled by the value of the lc_time_names system variable (Section 9.8, “MySQL Server Locale Support”).

      Call Pantek today for Open Source Technical Support at 1-877-546-8934 - 24/7/365X

      The DATE_FORMAT() returns a string with a character set and collation given by character_set_connection and collation_connection so that it can return month and weekday names containing non-ASCII characters. 

      mysql> 
SELECT DATE_FORMAT('2009-10-04 22:23:00', '%W %M %Y');
        -> 'Sunday October 2009'
mysql> 
SELECT DATE_FORMAT('2007-10-04 22:23:00', '%H:%i:%s');
        -> '22:23:00'
mysql> 
SELECT DATE_FORMAT('1900-10-04 22:23:00',
    -> 
                '%D %y %a %d %m %b %j');
        -> '4th 00 Thu 04 10 Oct 277'
mysql> 
SELECT DATE_FORMAT('1997-10-04 22:23:00',
    -> 
                '%H %k %I %r %T %S %w');
        -> '22 22 10 10:23:00 PM 22:23:00 00 6'
mysql> 
SELECT DATE_FORMAT('1999-01-01', '%X %V');
        -> '1998 52'
mysql> 
SELECT DATE_FORMAT('2006-06-00', '%d');
        -> '00'

    • DATE_SUB(date,INTERVAL expr unit)

      See the description for DATE_ADD().

    • DAY(date)

      DAY() is a synonym for DAYOFMONTH().

    • DAYNAME(date)

      Returns the name of the weekday for date. The language used for the name is controlled by the value of the lc_time_names system variable (Section 9.8, “MySQL Server Locale Support”). 

      mysql> 
SELECT DAYNAME('1998-02-05');
        -> 'Thursday'

    • DAYOFMONTH(date)

      Do you need help?X

      Returns the day of the month for date, in the range 1 to 31, or 0 for dates such as '0000-00-00' or '2008-00-00' that have a zero day part. 

      mysql> 
SELECT DAYOFMONTH('1998-02-03');
        -> 3

    • DAYOFWEEK(date)

      Returns the weekday index for date (1 = Sunday, 2 = Monday, …, 7 = Saturday). These index values correspond to the ODBC standard. 

      mysql> 
SELECT DAYOFWEEK('1998-02-03');
        -> 3

    • DAYOFYEAR(date)

      Returns the day of the year for date, in the range 1 to 366. 

      mysql> 
SELECT DAYOFYEAR('1998-02-03');
        -> 34

    • EXTRACT(unit FROM date)

      The EXTRACT() function uses the same kinds of unit specifiers as DATE_ADD() or DATE_SUB(), but extracts parts from the date rather than performing date arithmetic. 

      mysql> 
SELECT EXTRACT(YEAR FROM '1999-07-02');
       -> 1999
mysql> 
SELECT EXTRACT(YEAR_MONTH FROM '1999-07-02 01:02:03');
       -> 199907
mysql> 
SELECT EXTRACT(DAY_MINUTE FROM '1999-07-02 01:02:03');
       -> 20102
mysql> 
SELECT EXTRACT(MICROSECOND
    ->                
FROM '2003-01-02 10:30:00.000123');
        -> 123

    • FROM_DAYS(N)

      Do you need more help?X

      Given a day number N, returns a DATE value. 

      mysql> 
SELECT FROM_DAYS(730669);
        -> '2007-07-03'

      Can we help you?X

      Use FROM_DAYS() with caution on old dates. It is not intended for use with values that precede the advent of the Gregorian calendar (1582). See Section 11.7, “What Calendar Is Used By MySQL?”.

    • FROM_UNIXTIME(unix_timestamp), FROM_UNIXTIME(unix_timestamp,format)

      Returns a representation of the unix_timestamp argument as a value in 'YYYY-MM-DD HH:MM:SS' or YYYYMMDDHHMMSS.uuuuuu format, depending on whether the function is used in a string or numeric context. The value is expressed in the current time zone. unix_timestamp is an internal timestamp value such as is produced by the UNIX_TIMESTAMP() function.

      If format is given, the result is formatted according to the format string, which is used the same way as listed in the entry for the DATE_FORMAT() function. 

      mysql> 
SELECT FROM_UNIXTIME(1196440219);
        -> '2007-11-30 10:30:19'
mysql> 
SELECT FROM_UNIXTIME(1196440219) + 0;
        -> 20071130103019.000000
mysql> 
SELECT FROM_UNIXTIME(UNIX_TIMESTAMP(),
    ->                      
'%Y %D %M %h:%i:%s %x');
        -> '2007 30th November 10:30:59 2007'

      Note: If you use UNIX_TIMESTAMP() and FROM_UNIXTIME() to convert between TIMESTAMP values and Unix timestamp values, the conversion is lossy because the mapping is not one-to-one in both directions. For details, see the description of the UNIX_TIMESTAMP() function.

    • GET_FORMAT(DATE|TIME|DATETIME, 'EUR'|'USA'|'JIS'|'ISO'|'INTERNAL')

      Returns a format string. This function is useful in combination with the DATE_FORMAT() and the STR_TO_DATE() functions.

      Can't find what you're looking for?X

      The possible values for the first and second arguments result in several possible format strings (for the specifiers used, see the table in the DATE_FORMAT() function description). ISO format refers to ISO 9075, not ISO 8601.

      Function CallResult
      GET_FORMAT(DATE,'USA')'%m.%d.%Y'
      GET_FORMAT(DATE,'JIS')'%Y-%m-%d'
      GET_FORMAT(DATE,'ISO')'%Y-%m-%d'
      GET_FORMAT(DATE,'EUR')'%d.%m.%Y'
      GET_FORMAT(DATE,'INTERNAL')'%Y%m%d'
      GET_FORMAT(DATETIME,'USA')'%Y-%m-%d %H.%i.%s'
      GET_FORMAT(DATETIME,'JIS')'%Y-%m-%d %H:%i:%s'
      GET_FORMAT(DATETIME,'ISO')'%Y-%m-%d %H:%i:%s'
      GET_FORMAT(DATETIME,'EUR')'%Y-%m-%d %H.%i.%s'
      GET_FORMAT(DATETIME,'INTERNAL')'%Y%m%d%H%i%s'
      GET_FORMAT(TIME,'USA')'%h:%i:%s %p'
      GET_FORMAT(TIME,'JIS')'%H:%i:%s'
      GET_FORMAT(TIME,'ISO')'%H:%i:%s'
      GET_FORMAT(TIME,'EUR')'%H.%i.%s'
      GET_FORMAT(TIME,'INTERNAL')'%H%i%s'

      TIMESTAMP can also be used as the first argument to GET_FORMAT(), in which case the function returns the same values as for DATETIME. 

      mysql> 
SELECT DATE_FORMAT('2003-10-03',GET_FORMAT(DATE,'EUR'));
        -> '03.10.2003'
mysql> 
SELECT STR_TO_DATE('10.31.2003',GET_FORMAT(DATE,'USA'));
        -> '2003-10-31'

    • HOUR(time)

      Returns the hour for time. The range of the return value is 0 to 23 for time-of-day values. However, the range of TIME values actually is much larger, so HOUR can return values greater than 23. 

      mysql> 
SELECT HOUR('10:05:03');
        -> 10
mysql> 
SELECT HOUR('272:59:59');
        -> 272

    • LAST_DAY(date)

      Takes a date or datetime value and returns the corresponding value for the last day of the month. Returns NULL if the argument is invalid. 

      mysql> 
SELECT LAST_DAY('2003-02-05');
        -> '2003-02-28'
mysql> 
SELECT LAST_DAY('2004-02-05');
        -> '2004-02-29'
mysql> 
SELECT LAST_DAY('2004-01-01 01:01:01');
        -> '2004-01-31'
mysql> 
SELECT LAST_DAY('2003-03-32');
        -> NULL

    • LOCALTIME, LOCALTIME()

      LOCALTIME and LOCALTIME() are synonyms for NOW().

      Don't know where to look next?X

    • LOCALTIMESTAMP, LOCALTIMESTAMP()

      LOCALTIMESTAMP and LOCALTIMESTAMP() are synonyms for NOW().

    • MAKEDATE(year,dayofyear)

      Returns a date, given year and day-of-year values. dayofyear must be greater than 0 or the result is NULL. 

      mysql> 
SELECT MAKEDATE(2001,31), MAKEDATE(2001,32);
        -> '2001-01-31', '2001-02-01'
mysql> 
SELECT MAKEDATE(2001,365), MAKEDATE(2004,365);
        -> '2001-12-31', '2004-12-30'
mysql> 
SELECT MAKEDATE(2001,0);
        -> NULL

    • MAKETIME(hour,minute,second)

      Returns a time value calculated from the hour, minute, and second arguments. 

      mysql> 
SELECT MAKETIME(12,15,30);
        -> '12:15:30'

    • MICROSECOND(expr)

      Returns the microseconds from the time or datetime expression expr as a number in the range from 0 to 999999.

      Confused? Frustrated?X
      mysql> 
SELECT MICROSECOND('12:00:00.123456');
        -> 123456
mysql> 
SELECT MICROSECOND('2009-12-31 23:59:59.000010');
        -> 10

    • MINUTE(time)

      Returns the minute for time, in the range 0 to 59. 

      mysql> 
SELECT MINUTE('98-02-03 10:05:03');
        -> 5

    • MONTH(date)

      Returns the month for date, in the range 1 to 12 for January to December, or 0 for dates such as '0000-00-00' or '2008-00-00' that have a zero month part. 

      mysql> 
SELECT MONTH('1998-02-03');
        -> 2

    • MONTHNAME(date)

      Returns the full name of the month for date. The language used for the name is controlled by the value of the lc_time_names system variable (Section 9.8, “MySQL Server Locale Support”). 

      mysql> 
SELECT MONTHNAME('1998-02-05');
        -> 'February'

    • NOW()

      Returns the current date and time as a value in 'YYYY-MM-DD HH:MM:SS' or YYYYMMDDHHMMSS.uuuuuu format, depending on whether the function is used in a string or numeric context. The value is expressed in the current time zone.

      Call Pantek today for Open Source Technical Support at 1-877-546-8934 - 24/7/365X
      mysql> 
SELECT NOW();
        -> '2007-12-15 23:50:26'
mysql> 
SELECT NOW() + 0;
        -> 20071215235026.000000

      NOW() returns a constant time that indicates the time at which the statement began to execute. (Within a stored routine or trigger, NOW() returns the time at which the routine or triggering statement began to execute.) This differs from the behavior for SYSDATE(), which returns the exact time at which it executes. 

      mysql> 
SELECT NOW(), SLEEP(2), NOW();
+---------------------+----------+---------------------+
| NOW()               | SLEEP(2) | NOW()               |
+---------------------+----------+---------------------+
| 2006-04-12 13:47:36 |        0 | 2006-04-12 13:47:36 |
+---------------------+----------+---------------------+

mysql> 
SELECT SYSDATE(), SLEEP(2), SYSDATE();
+---------------------+----------+---------------------+
| SYSDATE()           | SLEEP(2) | SYSDATE()           |
+---------------------+----------+---------------------+
| 2006-04-12 13:47:44 |        0 | 2006-04-12 13:47:46 |
+---------------------+----------+---------------------+

      In addition, the SET TIMESTAMP statement affects the value returned by NOW() but not by SYSDATE(). This means that timestamp settings in the binary log have no effect on invocations of SYSDATE().

      See the description for SYSDATE() for additional information about the differences between the two functions.

    • PERIOD_ADD(P,N)

      Adds N months to period P (in the format YYMM or YYYYMM). Returns a value in the format YYYYMM. Note that the period argument P is not a date value. 

      mysql> 
SELECT PERIOD_ADD(9801,2);
        -> 199803

    • PERIOD_DIFF(P1,P2)

      Returns the number of months between periods P1 and P2. P1 and P2 should be in the format YYMM or YYYYMM. Note that the period arguments P1 and P2 are not date values. 

      mysql> 
SELECT PERIOD_DIFF(9802,199703);
        -> 11

    • QUARTER(date)

      Do you need help?X

      Returns the quarter of the year for date, in the range 1 to 4. 

      mysql> 
SELECT QUARTER('98-04-01');
        -> 2

    • SECOND(time)

      Returns the second for time, in the range 0 to 59. 

      mysql> 
SELECT SECOND('10:05:03');
        -> 3

    • SEC_TO_TIME(seconds)

      Returns the seconds argument, converted to hours, minutes, and seconds, as a TIME value. The range of the result is constrained to that of the TIME data type. A warning occurs if the argument corresponds to a value outside that range. 

      mysql> 
SELECT SEC_TO_TIME(2378);
        -> '00:39:38'
mysql> 
SELECT SEC_TO_TIME(2378) + 0;
        -> 3938

    • STR_TO_DATE(str,format)

      This is the inverse of the DATE_FORMAT() function. It takes a string str and a format string format. STR_TO_DATE() returns a DATETIME value if the format string contains both date and time parts, or a DATE or TIME value if the string contains only date or time parts.

      The date, time, or datetime values contained in str should be given in the format indicated by format. For the specifiers that can be used in format, see the DATE_FORMAT() function description. If str contains an illegal date, time, or datetime value, STR_TO_DATE() returns NULL. An illegal value also produces a warning.

      Do you need more help?X

      Range checking on the parts of date values is as described in Section 10.3.1, “The DATETIME, DATE, and TIMESTAMP Types”. This means, for example, that “zero” dates or dates with part values of 0 are allowed unless the SQL mode is set to disallow such values. 

      mysql> 
SELECT STR_TO_DATE('00/00/0000', '%m/%d/%Y');
        -> '0000-00-00'
mysql> 
SELECT STR_TO_DATE('04/31/2004', '%m/%d/%Y');
        -> '2004-04-31'

      Note

      You cannot use format "%X%V" to convert a year-week string to a date because the combination of a year and week does not uniquely identify a year and month if the week crosses a month boundary. To convert a year-week to a date, then you should also specify the weekday: 

      mysql> 
SELECT STR_TO_DATE('200442 Monday', '%X%V %W');
        -> '2004-10-18'

    • SUBDATE(date,INTERVAL expr unit), SUBDATE(expr,days)

      When invoked with the INTERVAL form of the second argument, SUBDATE() is a synonym for DATE_SUB(). For information on the INTERVAL unit argument, see the discussion for DATE_ADD(). 

      mysql> 
SELECT DATE_SUB('2008-01-02', INTERVAL 31 DAY);
        -> '2007-12-02'
mysql> 
SELECT SUBDATE('2008-01-02', INTERVAL 31 DAY);
        -> '2007-12-02'

      The second form allows the use of an integer value for days. In such cases, it is interpreted as the number of days to be subtracted from the date or datetime expression expr. 

      mysql> 
SELECT SUBDATE('2008-01-02 12:00:00', 31);
        -> '2007-12-02 12:00:00'

    • SUBTIME(expr1,expr2)

      SUBTIME() returns expr1 – expr2 expressed as a value in the same format as expr1. expr1 is a time or datetime expression, and expr2 is a time expression. 

      mysql> 
SELECT SUBTIME('2007-12-31 23:59:59.999999','1 1:1:1.000002');
        -> '2007-12-30 22:58:58.999997'
mysql> 
SELECT SUBTIME('01:00:00.999999', '02:00:00.999998');
        -> '-00:59:59.999999'

    • SYSDATE()

      Can we help you?X