SQLite - 日期时间函数 - STRFTIME
在 SQLite 中,strftime 函数是一个非常强大且灵活的日期和时间格式化函数,它可以根据指定的格式字符串将日期和时间值转换为特定格式的字符串,同时也能从日期和时间值中提取特定的信息。以下是对其使用方法的详细解释及示例。
基本语法
strftime(format, timestamp_value [, modifier1, modifier2, ...])
- format:这是必需的参数,是一个格式字符串,用于指定输出的日期和时间格式。格式字符串中可以包含各种格式化指令,这些指令以 % 开头,用于表示不同的日期和时间部分。
- timestamp_value:同样是必需的参数,可以是一个日期时间字符串,也可以是一个符合 SQLite 日期时间格式的表达式,或者是 'now' 表示当前日期和时间。
- modifier1, modifier2, ...:可选参数,是一系列的修饰符,用于对日期和时间进行调整,如 '+N days' 表示在原日期基础上加上 N 天,'-N months' 表示减去 N 个月等。
常见的格式化指令
格式化指令 | 描述 |
%Y | 四位数的年份(例如:2024) |
%m | 两位数的月份(01 - 12) |
%d | 两位数的日期(01 - 31) |
%H | 24 小时制的小时数(00 - 23) |
%M | 分钟数(00 - 59) |
%S | 秒数(00 - 59) |
%w | 星期几,0 表示星期日,1 - 6 分别表示星期一到星期六 |
%j | 一年中的第几天(001 - 366) |
%s | Unix 时间戳,即从 1970 年 1 月 1 日 00:00:00 UTC 开始到指定时间所经过的秒数 |
使用示例
1. 格式化当前日期和时间
-- 获取当前日期和时间,并格式化为 'YYYY-MM-DD HH:MM:SS' 的形式
SELECT strftime('%Y-%m-%d %H:%M:%S', 'now');
-- 获取当前日期,并格式化为 'Month Day, Year' 的形式
SELECT strftime('%m %d, %Y', 'now');
2. 格式化指定日期和时间
-- 将指定的日期时间字符串格式化为 'Day/Month/Year' 的形式
SELECT strftime('%d/%m/%Y', '2024-10-15 14:30:00');
-- 从表中获取日期时间列,并格式化为 'Year-Month' 的形式
CREATE TABLE events (
event_id INTEGER PRIMARY KEY,
event_datetime TEXT
);
INSERT INTO events (event_datetime) VALUES ('2025-03-20 09:45:00');
SELECT
event_id,
strftime('%Y-%m', event_datetime) AS formatted_date
FROM
events;
3. 结合修饰符进行日期和时间的调整与格式化
-- 在当前日期基础上加上 5 天,并格式化为 'YYYY-MM-DD' 的形式
SELECT strftime('%Y-%m-%d', 'now', '+5 days');
-- 在指定日期基础上减去 1 个月,并格式化为 'Month Day, Year' 的形式
SELECT strftime('%m %d, %Y', '2024-10-15', '-1 months');
4. 提取日期和时间的特定信息
-- 提取指定日期是一年中的第几天
SELECT strftime('%j', '2024-10-15');
-- 从表中获取日期时间列,并提取其对应的星期几
SELECT
event_id,
strftime('%w', event_datetime) AS day_of_week
FROM
events;
5. 将日期时间转换为 Unix 时间戳
-- 将指定的日期时间转换为 Unix 时间戳
SELECT strftime('%s', '2024-10-15 14:30:00');
-- 从表中获取日期时间列,并转换为 Unix 时间戳
SELECT
event_id,
strftime('%s', event_datetime) AS unix_timestamp
FROM
events;
注意事项
- 日期时间格式:输入的 timestamp_value 应符合 SQLite 的日期时间格式,常见的是 YYYY-MM-DD HH:MM:SS,否则可能会导致结果不准确。
- 时区问题:strftime 函数默认使用 UTC 时区。如果需要处理本地时间,可以结合 'localtime' 修饰符,例如 SELECT strftime('%Y-%m-%d %H:%M:%S', 'now', 'localtime');。
- 修饰符顺序:当使用多个修饰符时,修饰符的顺序会影响最终的结果,因为 SQLite 会按照修饰符出现的顺序依次对日期和时间进行调整。