Python标准库之——time模块

布满荆棘的人生 2022-11-30 01:19 202阅读 0赞

> 前言：继上一篇[学完Python，我决定熬夜整理这篇总结…][Python]，本篇总结一下Python中常用的time标准库用法，通过Demo程序来加深理解

### 目录 ###

*  time模块
 *   *  Demo实例
     *  常用参数
     *  struct\_time结构
     *  format字符串

# time模块 #

time模块提供了各种时间相关的函数。  
关于time模块的详细介绍见官方文档：[time — 时间的访问和转换][time _]（参考）

## Demo实例 ##

先写个小的Demo程序展示一下time模块的相关用法，之后再做解释

'''
    @Author Caso_卡索
    @Date 2020-8-23 15:12
    @Func 使用 time 模块显示当前时间
    '''
    import time
    
    functions = {
        
        0:"gmtime(0)返回epoch时间开始的点的struct_time",
        1:"time()返回当前时间戳",
        2:"localime()返回struct_time类型的当地时间",
        3:"mktime()返回一个浮点数时间戳",
        4:"asctime()返回格式化后的时间字符串",
        5:"ctime()返回格式化后的时间字符串",
        6:"strftime()返回指定格式化后的时间字符串",
        7:"strptime()返回指定格式化解析后的struct_time"
    }
    
    def showcurtime():
        print('%-38s%s'%(functions[0], time.gmtime(0)))
        curtime = time.time()
        print('%-40s%s'%(functions[1], curtime))
        localtime = time.localtime(curtime)
        print('%-38s%s'%(functions[2], localtime))
        print('%-37s%s'%(functions[3], time.mktime(localtime)))
        print('%-35s%s'%(functions[4], time.asctime(localtime)))
        print('%-35s%s'%(functions[5], time.ctime(curtime)))
        formatstr = "%Y-%m-%d %H:%M:%S"
        formattime = time.strftime(formatstr, localtime)
        print('%-33s%s'%(functions[6], formattime))
        print('%-36s%s'%(functions[7], time.strptime(formattime, formatstr)))
    
    if __name__ == '__main__':
        showcurtime()

![time][]

## 常用参数 ##

其中的序号对应于Demo程序中的functions字典序号

<table> 
 <thead> 
  <tr> 
   <th align="center">序号</th> 
   <th align="left">常用参数</th> 
   <th align="left">功能</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="center">0</td> 
   <td align="left">time.gmtime(0)</td> 
   <td align="left">将以自 epoch 开始的秒数表示的时间转换为 UTC 的 struct_time ，其中 dst 标志始终为零</td> 
  </tr> 
  <tr> 
   <td align="center">1</td> 
   <td align="left">time.time()</td> 
   <td align="left">返回以浮点数表示的从 epoch 开始的秒数的时间值</td> 
  </tr> 
  <tr> 
   <td align="center">2</td> 
   <td align="left">time.localtime([secs]</td> 
   <td align="left">与 gmtime() 相似但转换为当地时间</td> 
  </tr> 
  <tr> 
   <td align="center">3</td> 
   <td align="left">time.mktime(t)</td> 
   <td align="left">这是 localtime() 的反函数，它返回一个浮点数，以便与 time() 兼容</td> 
  </tr> 
  <tr> 
   <td align="center">4</td> 
   <td align="left">time.asctime([t])</td> 
   <td align="left">转换由 gmtime() 或 localtime() 所返回的表示时间的元组或 struct_time 为以下形式的字符串: ‘Sun Jun 20 23:21:05 1993’。</td> 
  </tr> 
  <tr> 
   <td align="center">5</td> 
   <td align="left">time.ctime([secs])</td> 
   <td align="left">转换以距离初始纪元的秒数表示的时间为以下形式的字符串: ‘Sun Jun 20 23:21:05 1993’ 代表本地时间。</td> 
  </tr> 
  <tr> 
   <td align="center">6</td> 
   <td align="left">time.strptime(string[, format])</td> 
   <td align="left">根据格式解析表示时间的字符串。 返回值为一个被 gmtime() 或 localtime() 返回的 struct_time</td> 
  </tr> 
  <tr> 
   <td align="center">7</td> 
   <td align="left">time.strftime(format[, t])</td> 
   <td align="left">转换一个元组或 struct_time 表示的由 gmtime() 或 localtime() 返回的时间到由 format 参数指定的字符串</td> 
  </tr> 
 </tbody> 
</table>

该表中，epoch表示时间开始的点，并且取决于平台。对于Unix， epoch 是1970年1月1日00:00:00（UTC）。

## struct\_time结构 ##

time.struct\_time是一个带有named tuple接口的对象：可以通过索引和属性名访问值。

<table> 
 <thead> 
  <tr> 
   <th align="left">索引</th> 
   <th align="left">属性</th> 
   <th align="left">值</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">0</td> 
   <td align="left">tm_year</td> 
   <td align="left">例如，1993</td> 
  </tr> 
  <tr> 
   <td align="left">1</td> 
   <td align="left">tm_mon</td> 
   <td align="left">range [1, 12]</td> 
  </tr> 
  <tr> 
   <td align="left">2</td> 
   <td align="left">tm_mday</td> 
   <td align="left">range [1, 31]</td> 
  </tr> 
  <tr> 
   <td align="left">3</td> 
   <td align="left">tm_hour</td> 
   <td align="left">range [0, 23]</td> 
  </tr> 
  <tr> 
   <td align="left">4</td> 
   <td align="left">tm_min</td> 
   <td align="left">range [0, 59]</td> 
  </tr> 
  <tr> 
   <td align="left">5</td> 
   <td align="left">tm_sec</td> 
   <td align="left">range [0, 61]</td> 
  </tr> 
  <tr> 
   <td align="left">6</td> 
   <td align="left">tm_wday</td> 
   <td align="left">range [0, 6] ，周一为 0</td> 
  </tr> 
  <tr> 
   <td align="left">7</td> 
   <td align="left">tm_yday</td> 
   <td align="left">range [1, 366]</td> 
  </tr> 
  <tr> 
   <td align="left">8</td> 
   <td align="left">tm_isdst</td> 
   <td align="left">0, 1 或 -1</td> 
  </tr> 
  <tr> 
   <td align="left">N/A</td> 
   <td align="left">tm_zone</td> 
   <td align="left">时区名称的缩写</td> 
  </tr> 
  <tr> 
   <td align="left">N/A</td> 
   <td align="left">tm_gmtoff</td> 
   <td align="left">以秒为单位的UTC以东偏离</td> 
  </tr> 
 </tbody> 
</table>

对于属性tm\_isdst在调用 mktime() 时， tm\_isdst 可以在夏令时生效时设置为1，而在夏令时不生效时设置为0。 值-1表示这是未知的，并且通常会导致填写正确的状态。

## format字符串 ##

format 必须是一个字符串。如果 t（struct\_time）中的任何字段超出允许范围，则引发 ValueError（操作或函数接收到的值不适合）  
以下是一些可以嵌入 format 字符串中的指令：

<table> 
 <thead> 
  <tr> 
   <th align="left">指令</th> 
   <th align="left">含义</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">%d</td> 
   <td align="left">十进制数 [01,31] 表示的月中日</td> 
  </tr> 
  <tr> 
   <td align="left">%H</td> 
   <td align="left">十进制数 [00,23] 表示的小时（24小时制）</td> 
  </tr> 
  <tr> 
   <td align="left">%I</td> 
   <td align="left">十进制数 [01,12] 表示的小时（12小时制）</td> 
  </tr> 
  <tr> 
   <td align="left">%j</td> 
   <td align="left">十进制数 [001,366] 表示的年中日</td> 
  </tr> 
  <tr> 
   <td align="left">%m</td> 
   <td align="left">十进制数 [01,12] 表示的月</td> 
  </tr> 
  <tr> 
   <td align="left">%M</td> 
   <td align="left">十进制数 [00,59] 表示的分钟</td> 
  </tr> 
  <tr> 
   <td align="left"><font>%S</font></td> 
   <td align="left">十进制数 [00,61] 表示的秒</td> 
  </tr> 
  <tr> 
   <td align="left"><font>%U</font></td> 
   <td align="left">十进制数 [00,53] 表示的一年中的周数（星期日作为一周的第一天），在第一个星期日之前的新年中的所有日子都被认为是在第0周</td> 
  </tr> 
  <tr> 
   <td align="left">%w</td> 
   <td align="left">十进制数 [0(星期日),6] 表示的周中日</td> 
  </tr> 
  <tr> 
   <td align="left"><font>%W</font></td> 
   <td align="left">十进制数 [00,53] 表示的一年中的周数（星期一作为一周的第一天）作为。在第一个星期一之前的新年中的所有日子被认为是在第0周</td> 
  </tr> 
  <tr> 
   <td align="left">%y</td> 
   <td align="left">十进制数 [00,99] 表示的没有世纪的年份</td> 
  </tr> 
  <tr> 
   <td align="left">%Y</td> 
   <td align="left">十进制数表示的带世纪的年份</td> 
  </tr> 
  <tr> 
   <td align="left">%a</td> 
   <td align="left">本地化的缩写星期中每日的名称</td> 
  </tr> 
  <tr> 
   <td align="left">%A</td> 
   <td align="left">本地化的星期中每日的完整名称</td> 
  </tr> 
  <tr> 
   <td align="left">%b</td> 
   <td align="left">本地化的月缩写名称</td> 
  </tr> 
  <tr> 
   <td align="left">%B</td> 
   <td align="left">本地化的月完整名称</td> 
  </tr> 
  <tr> 
   <td align="left">%c</td> 
   <td align="left">本地化的适当日期和时间表示</td> 
  </tr> 
  <tr> 
   <td align="left"><font>%p</font></td> 
   <td align="left">本地化的 AM 或 PM</td> 
  </tr> 
  <tr> 
   <td align="left">%x</td> 
   <td align="left">本地化的适当日期表示</td> 
  </tr> 
  <tr> 
   <td align="left">%X</td> 
   <td align="left">本地化的适当时间表示</td> 
  </tr> 
  <tr> 
   <td align="left">%z</td> 
   <td align="left">时区偏移以格式 +HHMM 或 -HHMM 形式的 UTC/GMT 的正或负时差指示，其中H表示十进制小时数字，M表示小数分钟数字 [-23:59, +23:59]</td> 
  </tr> 
  <tr> 
   <td align="left">%Z</td> 
   <td align="left">时区名称（如果不存在时区，则不包含字符）</td> 
  </tr> 
  <tr> 
   <td align="left">%%</td> 
   <td align="left">字面的 ‘%’ 字符</td> 
  </tr> 
 </tbody> 
</table>

注释：

1.  当与 strptime() 函数一起使用时，如果使用 %I 指令来解析小时， %p 指令只影响输出小时字段。
2.  范围真的是 0 到 61 ；值 60 在表示 leap seconds 的时间戳中有效，并且由于历史原因支持值 61 。
3.  当与 strptime() 函数一起使用时， %U 和 %W 仅用于指定星期几和年份的计算。

--------------------

> 作者： Caso\_卡索  
> 博客: https://blog.csdn.net/xiaoma\_2018  
> 一个独立、不甘于现状的程序员，喜欢的朋友点赞支持一下，在此感谢，Python专栏后续持续更新…

[Python]: https://blog.csdn.net/xiaoma_2018/article/details/107799229
[time _]: https://docs.python.org/zh-cn/3/library/time.html
[time]: /images/20221124/ba1eed5de8a144dab0f1df5956a39ae1.png