time 模块详解（时间获取和转换）

╰+攻爆jí腚メ 2022-04-12 04:28 352阅读 0赞

**time 模块 -- 时间获取和转换**  
  
time 模块提供各种时间相关的功能  
  
在 Python 中，与时间处理有关的模块包括：time，datetime 以及 calendar  
  
**必要说明：**

*  虽然这个模块总是可用，但并非所有的功能都适用于各个平台。
 *  该模块中定义的大部分函数是调用 C 平台上的同名函数实现，所以各个平台上实现可能略有不同。

**一些术语和约定的解释：**

*  时间戳（timestamp）的方式：通常来说，时间戳表示的是从 1970 年 1 月 1 日 00:00:00 开始按秒计算的偏移量（time.gmtime(0)）此模块中的函数无法处理 1970 纪元年以前的日期和时间或太遥远的未来（处理极限取决于 C 函数库，对于 32 位系统来说，是 2038 年）
 *  UTC（Coordinated Universal Time，世界协调时）也叫格林威治天文时间，是世界标准时间。在中国为 UTC+8
 *  DST（Daylight Saving Time）即夏令时的意思
 *  一些实时函数的计算精度可能低于它们建议的值或参数，例如在大部分 Unix 系统，时钟一秒钟“滴答”50~100 次

**时间元组（time.struct\_time）：**  
  
gmtime()，localtime() 和 strptime() 以时间元组（struct\_time）的形式返回。

<table> 
 <tbody> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;"><strong>索引值（Index）</strong></td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;"><strong>属性（Attribute）</strong></td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;"><strong>值（Values）</strong></td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">0</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">tm_year（年）</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">（例如：2015）</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">1</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">tm_mon（月）</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">1 ~ 12</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">2</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">tm_mday（日）</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">1 ~ 31</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">3</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">tm_hour（时）</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">0 ~ 23</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">4</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">tm_min（分）</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">0 ~ 59</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">5</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">tm_sec（秒）</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">0 ~ 61（见下方注1）</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">6</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">tm_wday（星期几）</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">0 ~ 6（0 表示星期一）</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">7</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">tm_yday（一年中的第几天）</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">1 ~ 366</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">8</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">tm_isdst（是否为夏令时）</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">0， 1， -1（-1 代表夏令时）</td> 
  </tr> 
 </tbody> 
</table>

*注1：范围真的是 0 ~ 61（你没有看错哦^\_^）；60 代表闰秒，61 是基于历史原因保留。*  
  
**time.altzone**  
  
返回格林威治西部的夏令时地区的偏移秒数；如果该地区在格林威治东部会返回负值（如西欧，包括英国）；对夏令时启用地区才能使用。  
  
**time.asctime(\[t\])**  
  
接受时间元组并返回一个可读的形式为"Tue Dec 11 18:07:14 2015"（2015年12月11日 周二 18时07分14秒）的 24 个字符的字符串。  
  
**time.clock()**  
  
用以浮点数计算的秒数返回当前的 CPU 时间。用来衡量不同程序的耗时，比 time.time() 更有用。  
  
*Python 3.3 以后不被推荐，由于该方法依赖操作系统，建议使用 perf\_counter() 或 process\_time() 代替（一个返回系统运行时间，一个返回进程运行时间，请按照实际需求选择）*  
  
**time.ctime(\[secs\]) **  
  
作用相当于 asctime(localtime(secs))，未给参数相当于 asctime()  
  
**time.gmtime(\[secs\])**  
  
接收时间辍（1970 纪元年后经过的浮点秒数）并返回格林威治天文时间下的时间元组 t（注：t.tm\_isdst 始终为 0）  
  
**time.daylight**  
  
如果夏令时被定义，则该值为非零。  
  
**time.localtime(\[secs\])**  
  
接收时间辍（1970 纪元年后经过的浮点秒数）并返回当地时间下的时间元组 t（t.tm\_isdst 可取 0 或 1，取决于当地当时是不是夏令时）  
  
**time.mktime(t)**  
  
接受时间元组并返回时间辍（1970纪元后经过的浮点秒数）  
  
**time.perf\_counter()**  
  
返回计时器的精准时间（系统的运行时间），包含整个系统的睡眠时间。由于返回值的基准点是未定义的，所以，只有连续调用的结果之间的差才是有效的。  
  
**time.process\_time() **  
  
返回当前进程执行 CPU 的时间总和，不包含睡眠时间。由于返回值的基准点是未定义的，所以，只有连续调用的结果之间的差才是有效的。  
  
**time.sleep(secs)**  
  
推迟调用线程的运行，secs 的单位是秒。  
  
**time.strftime(format\[, t\]) **  
  
把一个代表时间的元组或者 struct\_time（如由 time.localtime() 和 time.gmtime() 返回）转化为格式化的时间字符串。如果 t 未指定，将传入 time.localtime()。如果元组中任何一个元素越界，将会抛出 ValueError 异常。  
  
format 格式如下：

<table> 
 <tbody> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;"><strong>格式</strong></td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;"><strong>含义</strong></td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;"><strong>备注</strong></td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">%a</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">本地（locale）简化星期名称</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">&nbsp;</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">%A</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">本地完整星期名称</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">&nbsp;</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">%b</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">本地简化月份名称</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">&nbsp;</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">%B</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">本地完整月份名称</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">&nbsp;</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">%c</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">本地相应的日期和时间表示</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">&nbsp;</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">%d</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">一个月中的第几天（01 - 31）</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">&nbsp;</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">%H</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">一天中的第几个小时（24 小时制，00 - 23）</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">&nbsp;</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">%l</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">一天中的第几个小时（12 小时制，01 - 12）</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">&nbsp;</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">%j</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">一年中的第几天（001 - 366）</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">&nbsp;</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">%m</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">月份（01 - 12）</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">&nbsp;</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">%M</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">分钟数（00 - 59）</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">&nbsp;</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">%p</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">本地 am 或者 pm 的相应符</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;"><em>注1</em></td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">%S</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">秒（01 - 61）</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;"><em>注2</em></td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">%U</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">一年中的星期数（00 - 53 星期天是一个星期的开始）第一个星期天之前的所有天数都放在第 0 周</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;"><em>注3</em></td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">%w</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">一个星期中的第几天（0 - 6，0 是星期天）</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;"><em>注3</em></td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">%W</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">和 %U 基本相同，不同的是 %W 以星期一为一个星期的开始</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">&nbsp;</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">%x</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">本地相应日期</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">&nbsp;</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">%X</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">本地相应时间</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">&nbsp;</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">%y</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">去掉世纪的年份（00 - 99）</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">&nbsp;</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">%Y</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">完整的年份</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">&nbsp;</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">%z</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">用 +HHMM 或 -HHMM 表示距离格林威治的时区偏移（H 代表十进制的小时数，M 代表十进制的分钟数）</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">&nbsp;</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">%Z</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">时区的名字（如果不存在为空字符）</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">&nbsp;</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">%%</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">%号本身</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">&nbsp;</td> 
  </tr> 
 </tbody> 
</table>

*注1：“%p”只有与“%I”配合使用才有效果。*  
*注2：范围真的是 0 ~ 61（你没有看错哦^\_^）；60 代表闰秒，61 是基于历史原因保留。*  
*注3：当使用 strptime() 函数时，只有当在这年中的周数和天数被确定的时候 %U 和 %W 才会被计算。*  
  
举个例子：

# time模块示例
    >>> import time as t
    >>> t.strftime("a, %d %b %Y %H:%M:%S +0000", t.gmtime())
    'a, 24 Aug 2014 14:15:03 +0000'

**time.strptime(string\[, format\])**  
  
把一个格式化时间字符串转化为 struct\_time。实际上它和 strftime() 是逆操作。  
  
举个例子：

# time模块示例
    >>> import time as t
    >>> t.strptime("30 Nov 14", "%d %b %y")
    time.struct_time(tm_year=2014, tm_mon=11, tm_mday=30, tm_hour=0, tm_min=0, tm_sec=0, tm_wday=6, tm_yday=334, tm_isdst=-1)

**time.time()**  
  
返回当前时间的时间戳（1970 纪元年后经过的浮点秒数）  
  
**time.timezone**  
  
time.timezone 属性是当地时区（未启动夏令时）距离格林威治的偏移秒数（美洲 >0；大部分欧洲，亚洲，非洲 <= 0）  
  
**time.tzname**  
  
time.tzname 属性是包含两个字符串的元组：第一是当地非夏令时区的名称，第二个是当地的 DST 时区的名称。