MySQL FROM_UNIXTIME() 用法与实例

MySQL 中的 FROM_UNIXTIME() 函数可以将 Unix 时间戳转换为可读的日期时间格式，本文将介绍其用法和实例。

发布于

在 MySQL 数据库中，FROM_UNIXTIME() 是一个非常有用的日期时间函数，它能够将 Unix 时间戳转换为可读的日期时间格式。Unix 时间戳是指从 1970 年 1 月 1 日 00:00:00 UTC 到当前时间的秒数。这个函数在日常开发中特别实用，尤其是在处理那些以时间戳形式存储的日期数据时。

FROM_UNIXTIME 函数的基本用法

FROM_UNIXTIME() 函数最基本的语法形式如下：

FROM_UNIXTIME(unix_timestamp)

这个简单的调用会将 Unix 时间戳转换为 MySQL 的默认日期时间格式 YYYY-MM-DD HH:MM:SS。让我们看一个具体的例子：

SELECT FROM_UNIXTIME(1617184800);

执行结果将会是：

2021-03-31 10:00:00

需要注意的是，unix_timestamp 参数通常是一个整数，表示从 Unix 纪元开始的秒数。如果传入的是小数，函数会将其视为秒数和小数秒的组合。

指定输出格式的 FROM_UNIXTIME

MySQL 还允许我们指定输出格式，使用第二个可选参数来自定义日期时间的显示方式：

FROM_UNIXTIME(unix_timestamp, format)

这个 format 参数与 DATE_FORMAT() 函数使用的格式字符串相同。下面是一些常用的格式说明符：

  • %Y：四位数的年份
  • %m：两位数的月份（01-12）
  • %d：两位数的日期（01-31）
  • %H：24 小时制的小时（00-23）
  • %i：分钟（00-59）
  • %s：秒（00-59）

让我们看几个例子：

SELECT FROM_UNIXTIME(1617184800, '%Y年%m月%d日 %H时%i分%s秒');

执行结果：

2021年03月31日 10时00分00秒

SELECT FROM_UNIXTIME(1617184800, '%W, %M %D, %Y');

执行结果：

Wednesday, March 31st, 2021

处理毫秒级时间戳

虽然标准的 Unix 时间戳是秒级的，但有时我们可能会遇到毫秒级的时间戳（13 位数字）。对于这种情况，我们需要先将毫秒转换为秒：

SELECT FROM_UNIXTIME(1617184800123 / 1000);

或者更精确地保留毫秒信息：

SELECT FROM_UNIXTIME(1617184800.123);

执行结果：

2021-03-31 10:00:00.123

与时区相关的注意事项

FROM_UNIXTIME() 函数返回的结果是基于 MySQL 服务器时区设置的。这意味着相同的 Unix 时间戳在不同时区设置的服务器上可能会显示不同的本地时间。

例如，如果服务器时区设置为 UTC+8，那么：

SET time_zone = '+08:00';
SELECT FROM_UNIXTIME(1617184800);

结果可能是：

2021-03-31 18:00:00

而如果时区设置为 UTC：

SET time_zone = '+00:00';
SELECT FROM_UNIXTIME(1617184800);

结果则是：

2021-03-31 10:00:00

实际应用场景

FROM_UNIXTIME() 在实际开发中有许多应用场景。例如，当我们需要从日志表中查询特定日期范围内的记录时：

SELECT * FROM system_logs
WHERE log_time BETWEEN FROM_UNIXTIME(1617184800) AND FROM_UNIXTIME(1617271200);

或者在报表中格式化显示时间：

SELECT
    user_id,
    FROM_UNIXTIME(login_time, '%Y-%m-%d') AS login_date,
    COUNT(*) AS login_count
FROM user_logins
GROUP BY user_id, login_date;

与其他日期函数的结合使用

FROM_UNIXTIME() 可以与其他 MySQL 日期函数结合使用，实现更复杂的时间处理。例如，我们可以计算两个时间戳之间的天数差：

SELECT
    DATEDIFF(
        FROM_UNIXTIME(1617271200),
        FROM_UNIXTIME(1617184800)
    ) AS day_difference;

或者提取日期部分：

SELECT DATE(FROM_UNIXTIME(1617184800));

总结

FROM_UNIXTIME() 是 MySQL 中处理 Unix 时间戳的强大工具，它能够将数字时间戳转换为人类可读的日期时间格式。通过掌握它的基本用法、格式控制、时区影响以及与其他函数的组合使用，我们可以更高效地处理各种时间相关的数据操作。无论是简单的日期显示，还是复杂的报表生成，这个函数都能发挥重要作用。记住在实际使用时考虑服务器的时区设置，以确保时间显示的准确性。