参考

Python datetime模块详解、示例
搞定Python时区的N种姿势
calendar – 日历相关

time 模块

在Python中，通常有这几种方式来表示时间：
1）时间戳
2）格式化的时间字符串
3）元组（struct_time）共九个元素。

UTC（Coordinated Universal Time，世界协调时）：即格林威治天文时间，世界标准时间，在中国为UTC+8。
DST（Daylight Saving Time：即夏令时。
时间戳（timestamp）：时间戳表示的是从1970年1月1日00:00:00开始按秒计算的偏移量。
元组（struct_time）：struct_time元组共有9个元素，返回struct_time的函数主要有gmtime()，localtime()，strptime()。
下面列出这种方式元组中的几个元素：

索引（Index）	属性（Attribute）	值（Values）
0	tm_year（年）	比如2011
1	tm_mon（月）	1 - 12
2	tm_mday（日）	1 - 31
3	tm_hour（时）	0 - 23
4	tm_min（分）	0 - 59
5	tm_sec（秒）	0 - 61
6	tm_wday（weekday）	0 - 6（0表示周日）
7	tm_yday（一年中的第几天）	1 - 366
8	tm_isdst（是否是夏令时）	默认为-1

常见接口

import time# 返回当前UTC时间的时间戳(从1970年1月1日00:00:00开始按秒计算的偏移量)
time.time()# 和localtime()类似，gmtime()是将一个时间戳转换为UTC-0时区的struct_time。
time.gmtime([secs])# 将一个时间戳转换为当前本地时区的struct_time。secs参数未提供，返回当前本地时区的当前时间struct_time
time.localtime([secs])# localtime()的反函数,将一个struct_time转化为时间戳。
# 参数是 struct_time 或者完整的9元组 ，注意参数是当前本地时区的struct_time，而不是UTC-0时区
time.mktime(t)# 把一个表示时间的struct_time或者完整的9元组转化为格式化的时间字符串。
# 如果t未指定，将传入time.localtime()
time.strftime(format[, t])# strftime()的逆操作, 把一个格式化时间字符串转化为struct_time
time.strptime(string[, format])# 把一个表示时间的struct_time或者完整的9元组表示为：'Sat Dec  9 23:16:45 2023'。这种形式
# 如果没有参数，将会将time.localtime()作为参数传入
time.asctime([t])# 把一个时间戳转化为time.asctime()的形式。
# 如果参数未给或者为None的时候，将会默认time.time()为参数
time.ctime([secs])# 线程推迟指定的时间运行，单位为秒。
time.sleep(secs)# 在UNIX系统上，clock()返回的是秒表示的时间戳
# 在WINDOWS中，第一次调用，返回的是进程运行的实际时间。而第二次之后的调用是自第一次调用以后到现在的运行时间。
time.clock()

示例

import time
print(f'time.time():{time.time()}')
print(f'time.gmtime():{time.gmtime()}')
print(f'time.localtime():{time.localtime()}')
print(f'time.strftime("%Y/%m/%d/ %H:%M:%S", time.localtime()):{time.strftime("%Y/%m/%d/ %H:%M:%S", time.localtime())}')
print(f'time.asctime:{time.asctime()}')# 结果
time.time():1702135670.389908
time.gmtime():time.struct_time(tm_year=2023, tm_mon=12, tm_mday=9, tm_hour=15, tm_min=27, tm_sec=50, tm_wday=5, tm_yday=343, tm_isdst=0)
time.localtime():time.struct_time(tm_year=2023, tm_mon=12, tm_mday=9, tm_hour=23, tm_min=27, tm_sec=50, tm_wday=5, tm_yday=343, tm_isdst=0)
time.strftime("%Y/%m/%d/ %H:%M:%S", time.localtime()):2023/12/09/ 23:27:50
time.asctime:Sat Dec  9 23:27:50 2023

datetime 模块

python datetime time 时间模块
搞定Python时区的N种姿势

datetime模块中包含如下类：

类名	功能说明
date	日期对象,常用的属性有year, month, day
time	时间对象
datetime	日期时间对象,常用的属性有hour, minute, second, microsecond
datetime_CAPI	日期时间对象C语言接口
timedelta	时间间隔，即两个时间点之间的长度
tzinfo	时区信息对象

datetime模块中包含的常量

datetime.MAXYEAR	# 返回能表示的最大年份9999
datetime.MINYEAR    # 返回能表示的最小年份1

常见接口

from datetime import datetime, timedelta, tzinfo# 获取当前utc-0时区的时间
datetime.utcnow()
# 由时间戳返回本地时间datetime
datetime.fromtimestamp
# 由时间戳返回utc时间datetime
datetime.utcfromtimestamp

calendar 模块

calendar – 日历相关
Python-标准库calendar的使用
提供日历功能

常见接口

import calendarif __name__ == "__main__":cc = calendar.Calendar(0)one_weekday = []for index, dt in enumerate(cc.itermonthdates(2023, 12)):if index != 0 and index % 7 == 0:print(''.join(one_weekday))one_weekday.clear()one_weekday.append(f'{dt} ')# 结果
2023-11-27 2023-11-28 2023-11-29 2023-11-30 2023-12-01 2023-12-02 2023-12-03
2023-12-04 2023-12-05 2023-12-06 2023-12-07 2023-12-08 2023-12-09 2023-12-10
2023-12-11 2023-12-12 2023-12-13 2023-12-14 2023-12-15 2023-12-16 2023-12-17
2023-12-18 2023-12-19 2023-12-20 2023-12-21 2023-12-22 2023-12-23 2023-12-24

示例

一些常见的时间转换函数封装

# -*- coding: utf-8 -*-
import time
from datetime import datetime, timezone, timedeltaTIME_FORMAT_STR = "%Y/%m/%d/ %H:%M:%S"
DAY_SECOND = 86400
HOUR_SECOND = 3600
MINUTE_SECOND = 60def datetime_to_str(datetime_obj: datetime, format_str=TIME_FORMAT_STR) -> str:return datetime_obj.strftime(format_str)def str_to_datetime(time_str: str, format_str=TIME_FORMAT_STR) -> datetime:return datetime.strptime(time_str, format_str)def datetime_to_timestamp(datetime_obj: datetime) -> float:return time.mktime(datetime_obj.timetuple())def timestamp_to_str(timestamp: float, format_str=TIME_FORMAT_STR) -> str:return time.strftime(format_str, time.localtime(timestamp))def str_to_timestamp(time_str: str, format_str=TIME_FORMAT_STR) -> float:"""time.gmtime([secs]): 将一个时间戳转换为UTC-0时区的struct_time。time.localtime([secs]): 将一个时间戳转换为当前时区的struct_time。secs参数未提供，则以当前时间为准time.mktime: localtime()的反函数,将一个struct_time转化为时间戳,注意参数是使用本地时区的_TimeTuple | struct_time，而不是UTC-0时区"""datetime_obj: datetime = str_to_datetime(time_str, format_str)return time.mktime(datetime_obj.timetuple())def get_local_date_str(timestamp: float) -> str:"""将一个时间戳转换为当前本地时区的日期字符串"""# 将一个时间戳转换为当前时区的struct_timetime_struct: time.struct_time = time.localtime(int(timestamp))ret: str = time.strftime(TIME_FORMAT_STR, time_struct)return retdef get_local_date_str_custom1(timestamp: float, HMS_FMT="%H:%M:%S") -> str:time_struct: time.struct_time = time.localtime(int(timestamp))input_day = int(timestamp) / DAY_SECONDcur_day = int(time.time()) / DAY_SECONDif input_day == cur_day:return time.strftime(HMS_FMT, time_struct)else:return time.strftime(TIME_FORMAT_STR, time_struct)def get_now_time_str(is_local: bool = True, timezone_num: int = 0) -> str:if is_local:# 当前本地时区datetime_obj: datetime = datetime.now()else:# utc-0 时区# utc_0_datetime: datetime = datetime.utcnow()# timezone_num=0: utc-0 时区; timezone_num=2: utc-2 时区datetime_obj: datetime = datetime.now(timezone(timedelta(hours=timezone_num)))return datetime_to_str(datetime_obj)def timestamp_to_utc_str(timestamp: float, format_str=TIME_FORMAT_STR) -> str:"""时间戳转utc-0时区的时间"""datetime_obj: datetime = datetime.utcfromtimestamp(timestamp)return datetime_obj.strftime(format_str)def timestamp_to_local_str(timestamp: float, format_str=TIME_FORMAT_STR) -> str:"""时间戳转当前本地时区的时间"""datetime_obj: datetime = datetime.fromtimestamp(timestamp)return datetime_obj.strftime(format_str)def get_local_offst() -> timedelta:"""获取当前时区相对UTC-0的偏移"""timestamp: float = time.time()local_datetime_obj: datetime = datetime.fromtimestamp(timestamp)utc0_datetime_obj: datetime = datetime.utcfromtimestamp(timestamp)offset: timedelta = local_datetime_obj - utc0_datetime_objreturn offsetdef seconds_to_left_str(input_seconds: float) -> str:"""秒数seconds转剩余倒计时:XX时XX分XX秒https://www.runoob.com/python/att-string-format.html"""hours = 0minutes = 0seconds = 0input_seconds = int(input_seconds)if input_seconds >= 0:hours = int(input_seconds / HOUR_SECOND)minutes = int(input_seconds % HOUR_SECOND / MINUTE_SECOND)seconds = int(input_seconds % MINUTE_SECOND)# 例如：(100, 1, 10) ==> 100时01分10秒; (0, 0, 0) ==> 0时00分00秒return "{:0>d}时{:0>2d}分{:0>2d}秒".format(hours, minutes, seconds)if __name__ == "__main__":print(f'utc-0 time_str: {timestamp_to_utc_str(time.time())}')print(f'utc-local time_str: {timestamp_to_local_str(time.time())}')print(f'utc-0 time_str: {get_now_time_str(False, 0)}')print(f'utc-local time_str: {get_now_time_str()}')print(f'utc-local time_str:{get_local_date_str(time.time())}')print(f'utc-local offset:{get_local_offst()}')input_seconds = 6000print(f'{input_seconds} seconds==>{seconds_to_left_str(input_seconds)}')