Skip to main content
Version: Latest-3.3

from_unixtime

Description​

Converts a UNIX timestamp into the required time format. The default format is yyyy-MM-dd HH:mm:ss. It also supports the formats in date_format.

Currently, string_format supports the following formats:

%Y: Year  e.g.: 2014, 1900
%m: Month   e.g.: 12, 09
%d: Day  e.g.: 11, 01
%H: Hour  e.g.: 23, 01, 12
%i: Minute  e.g.: 05, 11
%s: Second  e.g.: 59, 01

Other formats are invalid and NULL will be returned.

Syntax​

VARCHAR from_unixtime(BIGINT unix_timestamp[, VARCHAR string_format])

Parameters​

  • unix_timestamp: the UNIX timestamp you want to convert. It must be of the BIGINT type. If the specified timestamp is less than 0 or larger than 253402243199, NULL will be returned. That is, the range for timestamp is 1970-01-01 00:00:00 to 9999-12-30 11:59:59(varies because of timezone).

  • string_format: the required time format.

Return value​

Returns a DATETIME or DATE value of the VARCHAR type. If string_format specifies the DATE format, a DATE value of the VARCHAR type is returned.

If the timestamp exceeds the value range or if string_format is invalid, NULL will be returned.

Examples​

MySQL > select from_unixtime(1196440219);
+---------------------------+
| from_unixtime(1196440219) |
+---------------------------+
| 2007-12-01 00:30:19       |
+---------------------------+

MySQL > select from_unixtime(1196440219, 'yyyy-MM-dd HH:mm:ss');
+--------------------------------------------------+
| from_unixtime(1196440219, 'yyyy-MM-dd HH:mm:ss') |
+--------------------------------------------------+
| 2007-12-01 00:30:19                              |
+--------------------------------------------------+

MySQL > select from_unixtime(1196440219, '%Y-%m-%d');
+-----------------------------------------+
| from_unixtime(1196440219, '%Y-%m-%d')   |
+-----------------------------------------+
| 2007-12-01                              |
+-----------------------------------------+

MySQL > select from_unixtime(1196440219, '%Y-%m-%d %H:%i:%s');
+--------------------------------------------------+
| from_unixtime(1196440219, '%Y-%m-%d %H:%i:%s')   |
+--------------------------------------------------+
| 2007-12-01 00:30:19                              |
+--------------------------------------------------+

keyword​

FROM_UNIXTIME,FROM,UNIXTIME