美食网站开发目的,高端集团网站建设公司,网站上线具体流程,查看wordpress付费TOC
一、概述 time模块提供了各种与时间相关的函数。相关功能还可以参阅datetime 和 calendar模块。 尽管所有平台皆可引用此模块#xff0c;但模块内的函数并不是所有平台都可用。此模块中定义的大多数函数的实现都是调用其所在平台的C语言库的同名函数。因为这些函数的语义…TOC
一、概述 time模块提供了各种与时间相关的函数。相关功能还可以参阅datetime 和 calendar模块。 尽管所有平台皆可引用此模块但模块内的函数并不是所有平台都可用。此模块中定义的大多数函数的实现都是调用其所在平台的C语言库的同名函数。因为这些函数的语义可能因平台而异所以使用时最好查阅对应平台的相关文档。
二、术语
下面是一些名词术语的解释
2.1 UTC
协调世界时Coordinated Universal Time的缩写。它以前也被称为格林威治标准时间GMT。使用UTC而不是CUT作为缩写是英语与法语Temps Universel Coordonné之间妥协的结果不是什么低级错误。
2.2 DST
夏令时Daylight Saving Time的缩写在一年的某一段时间中将当地时间调整通常一小时。 夏令时的规则非常神奇由当地法律确定并且每年的起止时间都不同。C语言库中有一个表格记录了各地的夏令时规则实际上为了灵活性C语言库通常是从某个系统文件中读取这张表。从这个角度而言这张表是夏令时规则的唯一权威真理。
2.3 epoch
起始的时间点即 time.gmtime(0) 的返回值。 这在所有平台上都是 1970-01-01, 00:00:00 (UTC)。
2.4 纪元秒数
指自 epoch 纪元时间点以来经过的总秒数通常不包括[闰秒。 在所有符合 POSIX 标准的平台上闰秒都不会记录在总秒数中。
三、惯例
下面是一些惯例的说明
3.1 有限的过去有限的未来
此模块中只能处理有限的时间区间可能无法处理 epoch 之前或遥远未来的日期和时间。 “遥远未来”的分界点是由 C 库确定的对于 32 位系统它通常是在 2038 年。
3.2 两位数年份68大69小
函数 strptime()在接收到 %y 格式代码时可以解析使用 2 位数表示的年份。当解析 2 位数年份时函数会按照 POSIX 和 ISO C 标准进行年份转换数值 69–99 被映射为 1969–1999数值 0–68 被映射为 2000–2068。
3.3 Unix的老旧时钟
由于平台限制各种实时函数的精度可能低于其值或参数所要求或给定的精度。例如在大多数Unix系统上时钟频率仅为每秒50或100次。
另一方面time()和 sleep()的精度优于它们的 Unix 等价物时间表示为浮点数time() 返回可用的最准确时间并且 sleep()将接受带有非零小数部分的时间。
3.4 时间转换关系
时间值由gmtime()localtime() 和 strptime()返回并被asctime() mktime() 和 strftime()接受是一个 9 个整数的序列。gmtime() localtime() 和strptime()的返回值还提供各个字段的属性名称。具体字段属性请看struct_time章节。
使用以下函数在时间表示之间进行转换
从到使用自纪元以来的秒数UTC 的 struct_timegmtime()自纪元以来的秒数本地时间的 struct_timelocaltime()UTC 的 struct_time自纪元以来的秒数calendar.timegm()本地时间的 struct_time自纪元以来的秒数mktime()
四、函数
4.8 time.process_time()
以小数表示的秒为单位返回当前进程的系统和用户 CPU 时间的总计值。 它不包括睡眠状态所消耗的时间。 根据定义它只作用于进程范围。 返回值的参考点未被定义因此只有两次调用之间的差值才是有效的。
# 记录开始时间点
start_time time.process_time()
# 进行一些计算或操作
for i in range(1000000):pass
# 记录结束时间点
end_time time.process_time()
# 计算执行时间
elapsed_time end_time - start_time
print(f执行时间0.0561 秒)# 执行结果
执行时间0.03125 秒4.9 time.sleep(secs)
调用方线程暂停执行给定的秒数。 该参数可以为浮点数以指定一个更精确的休眠时间。如果休眠被信号打断并且信号处理句柄未引发异常休眠将基于重新计算的时延重新开始。暂停时间有可能比请求的要长出一段不确定的时间因为会受系统中的其他活动排期影响。在 Windows 上如果 secs 为零线程会将其时间片的剩余部分让渡给任何其他准备要运行的线程。 如果没有准备要运行的其他线程该函数将立即返回而线程将继续执行。如果 secs 为零则会使用 Sleep(0)。
time.sleep(5)
print(5 秒已过)# 执行结果
5 秒已过4.10 time.strftime(format[, t])
转换一个元组或struct_time 表示的由gmtime()或 localtime() 返回的时间到由 format 参数指定的字符串。如果未提供 t 则使用由 localtime() 返回的当前时间。 format 必须是一个字符串。如果 t 中的任何字段超出允许范围则引发ValueError 。
0是时间元组中任何位置的合法参数如果它通常是非法的则该值被强制改为正确的值。
以下指令可以嵌入 format 字符串中
指令含意备注%a本地化的缩写星期中每日的名称。%A本地化的星期中每日的完整名称。%b本地化的月缩写名称。%B本地化的月完整名称。%c本地化的适当日期和时间表示。%d十进制数 [01,31] 表示的月中日。%H十进制数 [00,23] 表示的小时24小时制。%I十进制数 [01,12] 表示的小时12小时制。%j十进制数 [001,366] 表示的年中日。%m十进制数 [01,12] 表示的月。%M十进制数 [00,59] 表示的分钟。%p本地化的 AM 或 PM 。(1)%S十进制数 [00,61] 表示的秒。(2)%U十进制数 [00,53] 表示的一年中的周数星期日作为一周的第一天。 在第一个星期日之前的新年中的所有日子都被认为是在第 0 周。(3)%w十进制数 [0(星期日),6] 表示的周中日。%W十进制数 [00,53] 表示的一年中的周数星期一作为一周的第一天。 在第一个星期一之前的新年中的所有日子被认为是在第 0 周。(3)%x本地化的适当日期表示。%X本地化的适当时间表示。%y十进制数 [00,99] 表示的没有世纪的年份。%Y十进制数表示的带世纪的年份。%z时区偏移以格式 HHMM 或 -HHMM 形式的 UTC/GMT 的正或负时差指示其中H表示十进制小时数字M表示小数分钟数字 [-23:59, 23:59] 。%Z时区名称如果不存在时区则不包含字符。已弃用。%%字面的 % 字符。
注释 当与strptime函数一起使用时如果使用 %I 指令来解析小时 %p 指令只影响输出小时字段。 范围真的是 0 到 61 值 60 在表示leap seconds的时间戳中有效并且由于历史原因支持值 61 。 当与strptime函数一起使用时 %U 和 %W 仅用于指定星期几和年份的计算。 # 获取当前时间
current_time time.time()
# 使用 strftime 格式化时间一
formatted_time time.strftime(%H:%M:%S, time.localtime(current_time))
print(当前时间格式化时间一, formatted_time)
# 使用 strftime 格式化时间二
formatted_time time.strftime(%Y-%m-%d %H:%M:%S, time.localtime(current_time))
print(当前时间格式化时间二, formatted_time)
# 使用 strftime 格式化短日期
formatted_date time.strftime(%d/%m/%Y, time.localtime(current_time))
print(当前时间格式化短日期, formatted_time)
# 使用 strftime 格式化长日期
formatted_date time.strftime(%A, %d %B %Y, time.localtime(current_time))
print(当前时间格式化长日期, formatted_time)
# 使用 strftime 格式化完整日期和时间
formatted_datetime time.strftime(%A, %d %B %Y, %H:%M:%S, time.localtime(current_time))
print(当前时间格式化完整日期和时间, formatted_time)# 执行结果
当前时间格式化时间一 12:16:42
当前时间格式化时间二 2024-02-24 12:16:42
当前时间格式化短日期 2024-02-24 12:16:42
当前时间格式化长日期 2024-02-24 12:16:42
当前时间格式化完整日期和时间 2024-02-24 12:16:424.11 time.strptime(string[, format])
根据格式解析表示时间的字符串。 返回值为一个被gmtime()或 localtime() 返回的struct_time 。
format 参数使用与strftime()相同的指令。 它默认为匹配ctime()所返回的格式 %a %b %d %H:%M:%S %Y 。 如果 string 不能根据 format 来解析或者解析后它有多余的数据则会引发ValueError。 当无法推断出更准确的值时用于填充任何缺失数据的默认值是 (1900, 1, 1, 0, 0, 0, 0, 1, -1) 。 string 和 format 都必须为字符串。
# 格式化字符串用于表示日期和时间
date_format %Y-%m-%d %H:%M:%S
# 要解析的日期和时间字符串
date_string 2023-09-25 14:30:45
# 使用 strptime 解析日期和时间字符串
parsed_time time.strptime(date_string, date_format)
# 输出解析后的时间元组
print(解析后的时间元组, parsed_time)# 执行结果
解析后的时间元组 time.struct_time(tm_year2023, tm_mon9, tm_mday25, tm_hour14, tm_min30, tm_sec45, tm_wday0, tm_yday268, tm_is夏令时-1)4.12 class time.struct_time
返回的时间值序列的类型为gmtime()、 localtime() 和strptime。它是一个带有named tuple 接口的对象可以通过索引和属性名访问值。 存在以下值
索引属性值0tm_year例如19931tm_monrange [1, 12]2tm_dayrange [1, 31]3tm_hourrange [0, 23]4tm_minrange [0, 59]5tm_secrange [0, 61]参见strftime()中的 注释 (2)6tm_wday取值范围 [0, 6]周一为 07tm_ydayrange [1, 366]8tm_is夏令时0, 1 或 -1如下所示N/Atm_zone时区名称的缩写N/Atm_gmtoff以秒为单位的UTC以东偏离
请注意与C结构不同月份值是 [1,12] 的范围而不是 [0,11] 。
在调用 mktime()时tm_is夏令时可以在夏令时生效时设置为1而在夏令时不生效时设置为0。 值-1表示这是未知的并且通常会导致填写正确的状态。
当一个长度不正确的元组被传递给期望struct_time 的函数或者具有错误类型的元素时会引发TypeError 。
# 获取当前时间
current_time time.localtime()
# 输出当前时间的 struct_time 对象
print(当前时间的 struct_time 对象, current_time)
# 访问 struct_time 对象的各个元素
print(年, current_time.tm_year)
print(月, current_time.tm_mon)
print(日, current_time.tm_mday)
print(小时, current_time.tm_hour)
print(分钟, current_time.tm_min)
print(秒, current_time.tm_sec)
print(一周中的第几天0 表示星期一, current_time.tm_wday)
print(一年中的第几天, current_time.tm_yday)
print(是否是夏令时, current_time.tm_is夏令时)# 执行结果
当前时间的 struct_time 对象 time.struct_time(tm_year2024, tm_mon2, tm_mday24, tm_hour12, tm_min27, tm_sec18, tm_wday5, tm_yday55, tm_is夏令时0)
年 2024
月 2
日 24
小时 12
分钟 27
秒 18
一周中的第几天0 表示星期一 5
一年中的第几天 55
是否是夏令时 04.13 time.time()
返回以浮点数表示的从epoch 开始的秒数形式的时间。 对leap seconds的处理取决于具体平台。 在 Windows 和大多数 Unix 系统中闰秒不会被计入从epoch 开始的秒数形式的时间中。 这通常被称为 Unix 时间。
请注意即使时间总是作为浮点数返回但并非所有系统都提供高于1秒的精度。虽然此函数通常返回非递减值但如果在两次调用之间设置了系统时钟则它可以返回比先前调用更低的值。
# 获取当前时间戳自1970年1月1日以来的秒数
current_timestamp time.time()
# 输出当前时间戳
print(当前时间戳, current_timestamp)
# 将当前时间戳转换为日期和时间字符串
formatted_time time.strftime(%Y-%m-%d %H:%M:%S, time.localtime(current_timestamp))
# 输出格式化后的日期和时间字符串
print(格式化后的日期和时间字符串, formatted_time)# 执行结果
当前时间戳 1708749105.776935
格式化后的日期和时间字符串 2024-02-24 12:31:45五、时区常量
5.1 time.altzone
本地夏令时时区的偏移量以UTC为单位的秒数如果已定义。如果当地夏令时时区在UTC以东如在西欧包括英国则是负数。 只有当 daylight 非零时才使用它。
# 获取当前时间戳自1970年1月1日以来的秒数
current_timestamp time.time()
print(当前时间戳, current_timestamp)
# 获取当前时区偏移量以秒为单位
timezone_offset time.altzone
print(当前时区偏移量以秒为单位, timezone_offset)
# 获取当前时区偏移量以小时为单位
timezone_offset_hours timezone_offset / 3600
print(当前时区偏移量以小时为单位, timezone_offset_hours)# 执行结果
当前时间戳 1708749985.8680549
当前时区偏移量以秒为单位 -32400
当前时区偏移量以小时为单位 -9.05.2 time.daylight
如果启用了夏令时则为非零。
# 获取当前是否启用了夏令时
is_夏令时_enabled time.daylight
print(当前是否启用了夏令时, is_夏令时_enabled)# 执行结果
当前是否启用了夏令时 05.3 time.timezone
本地非夏令时时区的偏移量UTC以西的秒数西欧大部分地区为负美国为正英国为零。
# 获取当前时区偏移量以分钟为单位
timezone_offset_minutes time.timezone
print(当前时区偏移量以分钟为单位, timezone_offset_minutes)
# 获取当前时区偏移量以小时为单位
timezone_offset_hours timezone_offset_minutes / 60
print(当前时区偏移量以小时为单位, timezone_offset_hours)# 执行结果
当前时区偏移量以分钟为单位 -28800
当前时区偏移量以小时为单位 -480.05.4 time.tzname
两个字符串的元组第一个是本地非夏令时时区的名称第二个是本地夏令时时区的名称。 如果未定义夏令时时区则不应使用第二个字符串。
# 获取当前时区的名称
tzname time.tzname
print(当前时区名称, tzname)
tzname1, tzname2 tzname[0].encode(latin-1).decode(gbk), tzname[1].encode(latin-1).decode(gbk)
print(当前时区名称({},{}).format(tzname1, tzname2))# 执行结果
当前时区名称 (Öйú±ê׼ʱ¼ä, ÖйúÏÄÁîʱ)
当前时区名称(中国标准时间,中国夏令时)六、相关模块
6.1 模块 datetime
更多面向对象的日期和时间接口以及多种处理日期和时间的类
6.2 模块locale
国际化服务模块。 区域的设置会影响strftime()和strptime中许多格式说明符的解析。
模块calendar
一般日历相关功能模块。这个模块的 timegm() 是函数gmtime()的反函数。 may the odds be ever in your favor ~
