Python datetime.date 类的 timetuple() 函数

datetime.date 类是 Python 标准库中的一个类，用于表示日期。timetuple() 是 date 类的一个成员函数，用于将日期转换为一个 time.struct_time 对象。

示例代码

下面是一个使用 timetuple() 函数的示例代码：

import datetime

# 创建一个日期对象
date_obj = datetime.date(2022, 1, 1)

# 将日期转换为 struct_time 对象
time_tuple = date_obj.timetuple()

# 打印 struct_time 对象的属性
print(time_tuple.tm_year)
print(time_tuple.tm_mon)
print(time_tuple.tm_mday)
print(time_tuple.tm_hour)
print(time_tuple.tm_min)
print(time_tuple.tm_sec)
print(time_tuple.tm_wday)
print(time_tuple.tm_yday)
print(time_tuple.tm_isdst)

返回值

timetuple() 函数返回一个 time.struct_time 对象，该对象包含了日期的各个时间属性。struct_time 对象是一个具名元组 (namedtuple)，其属性包括：

• tm_year：四位数的年份，如 2022
• tm_mon：月份，范围为 1 到 12
• tm_mday：月份中的一天，范围为 1 到 31
• tm_hour：小时，范围为 0 到 23
• tm_min：分钟，范围为 0 到 59
• tm_sec：秒数，范围为 0 到 61（60 和 61 用于闰秒）
• tm_wday：星期几，范围为 0（星期一）到 6（星期日）
• tm_yday：一年中的第几天，范围为 1 到 366
• tm_isdst：是否为夏令时，默认为 -1（表示未知），0 表示不是夏令时，1 表示是夏令时

注意事项

• timetuple() 函数仅适用于 datetime.date 类的对象，并非所有的日期对象都可以调用该函数。
• time.struct_time 对象是一个普通的元组，可以通过索引获取属性值，如 time_tuple[0] 获取年份。但由于该对象是具名元组，也可以通过属性名获取属性值，如 time_tuple.tm_year 获取年份。