Python 时间详解（time）

1 常用方法

1.1 获取时间戳：time()

• 从 "1970 年 1 月 1 日 00:00:00" UTC 到 当前时间 的 秒数
• 返回值：时间戳，如：1701354126.7494054

import time

timestamp = time.time()
print(f'当前时间戳是：{timestamp}')
# 1701748405.276349

1.2 获取时间元组 - 本地时间：localtime()

• 返回值：struct_time 对象（结构化对象）
• 如：time.struct_time(tm_year=2023, tm_mon=11, tm_mday=30, tm_hour=22, tm_min=25, tm_sec=32, tm_wday=3, tm_yday=334, tm_isdst=0)

import time

local_time = time.localtime()
print(f'获取时间元组-本地时间：{local_time}')

1.3 获取时间元组 - 世界时间：gmtime()

• gmtime() 函数与 localtime() 函数的作用类似，但将当前时间转换为 GMT 时间（世界标准时间）
• 两者的差异：本地时间 = 世界时间 + 8小时

import time

gmtime = time.gmtime()
print(f'获取时间元组-世界时间：{gmtime}')

2 格式转换

2.0 总结图示

2.1 时间戳 -> 时间元组：localtime()、gmtime()

import time

# 差异，以我本地举例。本地时间 = 世界时间 + 8 h
timestamp = time.time()

localtime = time.localtime(timestamp)  # timestamp 默认为当前时间
print(f'时间戳：{timestamp} => 时间元组-本地时间：{localtime}')

gmtime = time.gmtime(timestamp)  # timestamp 默认为当前时间
print(f'时间戳：{timestamp} => 时间元组-世界时间：{gmtime}')

2.2 时间元组 -> 时间戳：mktime()

import time

# 差异，以我本地举例。本地时间 = 世界时间 + 8 h
localtime = time.localtime()  # 默认为当前时间
gmtime = time.gmtime()  # 默认为当前时间

print(f'时间元组-本地时间：{localtime} => 时间戳：{time.mktime(localtime)}')
print(f'时间元组-世界时间：{gmtime} => 时间戳：{time.mktime(gmtime)}')

2.3 时间戳 -> 默认时间字符串：ctime()

import time

timestamp = time.time()
print(f'时间戳：{timestamp} => 时间字符串：{time.ctime(timestamp)}')
# 时间戳：1702286216.4072735 => 时间字符串：Mon Dec 11 17:16:56 2023

# 注：默认当前时间
print(time.ctime())

2.4 时间元组 -> 默认时间字符串：asctime()

import time

local_time = time.localtime()
print(f'时间元组：{local_time} => 时间字符串：{time.asctime(local_time)}')

# 注：默认当前时间
print(time.asctime())

2.5 时间元组 -> 自定义时间字符串：strftime()

import time

local_time = time.localtime()

format_time = time.strftime("%Y-%m-%d %H:%M:%S", local_time)
print(f"时间元组：{local_time} => 自定义时间字符串：{format_time}")
# 2023-12-05 11:31:05

# 若参数为空，默认当前时间
print(time.strftime("%Y-%m-%d %H:%M:%S"))
# 2023-12-05 11:31:05

2.6 自定义时间字符串 -> 时间元组：strptime()

import time

format_time_str = "2023-11-30 23:07:47"
struct_time = time.strptime(format_time_str, "%Y-%m-%d %H:%M:%S")

print(f"自定义时间字符串：{format_time_str} => 时间元组：{struct_time}")

3 扩展

3.1 时间元组：struct_time

• 返回值类型：struct_time 对象（时间元组）
• 如：time.struct_time(tm_year=2023, tm_mon=11, tm_mday=30, tm_hour=22, tm_min=25, tm_sec=32, tm_wday=3, tm_yday=334, tm_isdst=0)

import time

local_time = time.localtime()
print(f'当前本地时间是：{local_time}')

gmtime = time.gmtime()
print(f'当前世界标准时间(GMT)是：{gmtime}')

序号	属性	描述	取值
0	tm_year	年	四位数，如：2023
1	tm_mon	月	1 到 12
2	tm_mday	日	1 到 31
3	tm_hour	时	0 到 23
4	tm_min	分	0 到 59
5	tm_sec	秒	0 到 59
6	tm_wday	周	0 到 6（0 是周一）
7	tm_yday	天	1 到 366，一年中的第几天
8	tm_isdst	是否夏令时	1=是，0=否，-1=未知(默认)

3.2 自定义格式：%Y-%m-%d 等

格式符	含义
%Y	年（0000-9999）
%y	年（00-99）
%m	月（01 - 12）
%d	日（0-31）
%H	时（00-23）
%I	时（01-12）
%M	分（00-59）
%S	秒（00-59）
%a	星期的简称
%A	星期的全称
%b	月份的简称
%B	月份的全称
%c	日期和时间
%x	日期（不含时间）
%X	时间（不含日期）

import time

# 测试
print(time.strftime('%Y-%m-%d %H:%M:%S'))
print(time.strftime('%Y'))

3.3 睡眠：sleep()

import time

print("开始执行程序")
time.sleep(3)  # 睡眠 3 秒
print("3秒后，程序继续执行")