SQLite strftime 函数

2025年3月17日 | 阅读 3 分钟

SQLite strftime 函数是一个非常强大的函数，它可以帮助您获取日期和时间，以及执行日期计算。

语法

在这里，format 可以是以下任何一种

索引	格式	说明
1)	%Y	年份，4 位数字（0000 到 9999）
2)	%W	一年中的第几周（00 到 53）
3)	%w	星期几（0 到 6，其中 0 表示星期日）
4)	%m	一年中的第几月（01 到 12）
5)	%d	一个月中的第几天（00 到 31）
6)	%H	小时（00 到 24）
7)	%M	分钟（00 到 59）
8)	%S	秒 (00 到 59)
9)	%s	自 1970-01-01 以来的秒数
10)	%f	小数秒 (SS.SSS)
11)	%j	一年中的第几天（001 到 366）
12)	%J	Julian 日期，数值

其中，timestring 是一个日期值，可以是以下任何一种

索引	timestring	描述
1)	now	它是一个用于返回当前日期的文字。
2)	YYYY-MM-DD	它指定了格式为“YYYY-MM-DD”的日期值
3)	YYYY-MM-DD HH:MM	它指定了格式为“YYYY-MM-DD HH:MM”的日期值
4)	YYYY-MM-DD HH:MM:SS	它指定了格式为“YYYY-MM-DD HH:MM:SS”的日期值
5)	YYYY-MM-DD HH:MM:SS.SSS	它指定了格式为“YYYY-MM-DD HH:MM:SS.SSS”的日期值
6)	HH:MM	它指定了格式为“HH:MM”的日期值
7)	HH:MM:SS	它指定了格式为“HH:MM:SS”的日期值
8)	HH:MM:SS.SSS	它指定了格式为“HH:MM:SS.SSS”的日期值
9)	YYYY-MM-DDTHH:MM	它指定了格式为“YYYY-MM-DDTHH:MM”的日期值，其中 t 是分隔日期和时间部分的文字字符。
10)	YYYY-MM-DDTHH:MM:SS	它指定了格式为“YYYY-MM-DDTHH:MM:SS”的日期值，其中 t 是分隔日期和时间部分的文字字符
11)	YYYY-MM-DDTHH:MM:SS.SSS	它指定了格式为“YYYY-MM-DDTHH:MM:SS.SSS”的日期值，其中 t 是分隔日期和时间部分的文字字符
12)	DDDDDDDDDD	它指定了儒略日数字

modifier1, modifier2, ... modifier_n: 修饰符是可选的。它们与 timestring 一起使用以添加或减去时间、日期或年份。

索引	修饰符	描述
1)	[+-]NNN years	它用于指定添加到/从日期中减去的年数
2)	[+-]NNN months	它用于指定添加到/从日期中减去的月数
3)	[+-]NNN days	它用于指定添加到/从日期中减去的天数
4)	[+-]NNN hours	它用于指定添加到/从日期中减去的小时数
5)	[+-]NNN minutes	它用于指定添加到/从日期中减去的分钟数
6)	[+-]NNN seconds	它用于指定添加到/从日期中减去的秒数
7)	[+-]NNN.NNNN seconds	它用于指定添加到/从日期中减去的秒数（和秒的小数部分）
8)	start of year	它用于将日期移回到年初
9)	start of month	它用于将日期移回本月初
10)	start of day	它用于将日期移回当天开始
11)	weekday N	它用于将日期向前移动到下一个日期，其中工作日编号为 N（0=星期日，1=星期一，2=星期二，3=星期三，4=星期四，5=星期五，6=星期六）
12)	unixepoch	它与 DDDDDDDDDD 时间字符串一起使用，将日期解释为 UNIX 时间（即：自 1970-01-01 以来的秒数）
13)	localtime	它用于将日期调整为本地时间，假设 timestring 以 UTC 表示
14)	utc	它用于将日期调整为 utc，假设 timestring 以本地时间表示

示例 1：检索当前日期

SELECT strftime('%Y %m %d', 'now');
SELECT strftime('%Y-%m-%d %H:%M', 'now');

输出

示例 2：检索当月的第一天

SELECT strftime('%Y-%m-%d', '2017-04-14', 'start of month');
SELECT strftime('%Y-%m-%d', 'now', 'start of month');
SELECT strftime('%Y-%m-%d', '2017-03-07', '-6 days');
SELECT strftime('%Y-%m-%d', 'now', '-13 days');

输出

示例 2：检索当月的最后一天

SELECT strftime('%Y-%m-%d', '2017-03-07', 'start of month', '+1 month', '-1 day'); 
SELECT strftime('%Y-%m-%d', 'now', 'start of month', '+1 month', '-1 day');
SELECT strftime('%Y-%m-%d', '2017-03-07', '+24 days');
SELECT strftime('%Y-%m-%d', 'now', '+24 days');

输出

示例 3：增加/减少年份和天数

SELECT strftime('%Y-%m-%d', '2017-04-14', '+2 years');
SELECT strftime('%Y-%m-%d', 'now', '-2 years');
SELECT strftime('%Y-%m-%d', '2017-04-14', '+7 days');
SELECT strftime('%Y-%m-%d', 'now', '-10 days'); 

输出