### 导航
- [索引](../genindex.xhtml "总目录")
- [模块](../py-modindex.xhtml "Python 模块索引") |
- [下一页](argparse.xhtml "argparse --- 命令行选项、参数和子命令解析器") |
- [上一页](io.xhtml "io --- 处理流的核心工具") |
- 
- [Python](https://www.python.org/) »
- zh\_CN 3.7.3 [文档](../index.xhtml) »
- [Python 标准库](index.xhtml) »
- [通用操作系统服务](allos.xhtml) »
- $('.inline-search').show(0); |
# [`time`](#module-time "time: Time access and conversions.") --- 时间的访问和转换
- - - - - -
该模块提供了各种时间相关的函数。相关功能还可以参阅 [`datetime`](datetime.xhtml#module-datetime "datetime: Basic date and time types.") 和 [`calendar`](calendar.xhtml#module-calendar "calendar: Functions for working with calendars, including some emulation of the Unix cal program.") 模块。
尽管此模块始终可用，但并非所有平台上都提供所有功能。 此模块中定义的大多数函数调用都具有相同名称的平台C库函数。 因为这些函数的语义因平台而异,所以使用时最好查阅平台相关文档。
下面是一些术语和惯例的解释.
- *epoch* 是时间开始的点，并且取决于平台。对于Unix， epoch 是1970年1月1日00:00:00（UTC）。要找出给定平台上的 epoch ，请查看 `time.gmtime(0)` 。
- 术语 *Unix 纪元秒数* 是指自国际标准时间 1970 年 1 月 1 日零时以来经过的总秒数，通常不包括 [闰秒](https://en.wikipedia.org/wiki/Leap_second) \[https://en.wikipedia.org/wiki/Leap\_second\]。 在所有符合 POSIX 标准的平台上，闰秒都会从总秒数中被扣除。
- 此模块中的功能可能无法处理纪元之前或将来的远期日期和时间。未来的截止点由C库决定；对于32位系统，它通常在2038年。
- **2000年（Y2K）问题** ：Python依赖于平台的C库，它通常没有2000年问题，因为所有日期和时间都在内部表示为自纪元以来的秒数。函数 [`strptime()`](#time.strptime "time.strptime") 在给出 `%y` 格式代码时可以解析2位数年份。当解析2位数年份时，它们将根据 POSIX 和 ISO C 标准进行转换：值 69--99 映射到 1969--1999，值 0--68 映射到2000--2068。
- UTC是协调世界时（以前称为格林威治标准时间，或GMT）。缩写UTC不是错误，而是英语和法语之间的妥协。
- DST是夏令时，在一年中的一部分时间（通常）调整时区一小时。 DST规则很神奇（由当地法律确定），并且每年都会发生变化。 C 库有一个包含本地规则的表（通常是从系统文件中读取以获得灵活性），并且在这方面是True Wisdom的唯一来源。
- 各种实时函数的精度可能低于表示其值或参数的单位所建议的精度。例如，在大多数Unix系统上，时钟 "ticks" 仅为每秒50或100次。
- 另一方面， [`time()`](#time.time "time.time") 和 [`sleep()`](#time.sleep "time.sleep") 的精度优于它们的Unix等价物：时间表示为浮点数，[`time()`](#time.time "time.time") 返回最准确的时间 （使用Unix `gettimeofday()` 如果可用），并且 [`sleep()`](#time.sleep "time.sleep") 将接受非零分数的时间（Unix `select()` 用于实现此功能，如果可用）。
- 时间值由 [`gmtime()`](#time.gmtime "time.gmtime")，[`localtime()`](#time.localtime "time.localtime") 和 [`strptime()`](#time.strptime "time.strptime") 返回，并被 [`asctime()`](#time.asctime "time.asctime")， [`mktime()`](#time.mktime "time.mktime") 和 [`strftime()`](#time.strftime "time.strftime") 接受，是一个 9 个整数的序列。 [`gmtime()`](#time.gmtime "time.gmtime")， [`localtime()`](#time.localtime "time.localtime") 和 [`strptime()`](#time.strptime "time.strptime") 的返回值还提供各个字段的属性名称。
请参阅 [`struct_time`](#time.struct_time "time.struct_time") 以获取这些对象的描述。
在 3.3 版更改: 在平台支持相应的 `struct tm` 成员时，[`struct_time`](#time.struct_time "time.struct_time") 类型被扩展提供 `tm_gmtoff` 和 `tm_zone` 属性。
在 3.6 版更改: [`struct_time`](#time.struct_time "time.struct_time") 的属性 `tm_gmtoff` 和 `tm_zone` 现在可在所有平台上使用。
- 使用以下函数在时间表示之间进行转换：
从
到
使用
seconds since the epoch
UTC 的 [`struct_time`](#time.struct_time "time.struct_time")
[`gmtime()`](#time.gmtime "time.gmtime")
seconds since the epoch
本地时间的 [`struct_time`](#time.struct_time "time.struct_time")
[`localtime()`](#time.localtime "time.localtime")
UTC 的 [`struct_time`](#time.struct_time "time.struct_time")
seconds since the epoch
[`calendar.timegm()`](calendar.xhtml#calendar.timegm "calendar.timegm")
本地时间的 [`struct_time`](#time.struct_time "time.struct_time")
seconds since the epoch
[`mktime()`](#time.mktime "time.mktime")
## 函数
`time.``asctime`(\[*t*\])转换一个元组或 [`struct_time`](#time.struct_time "time.struct_time") 表示的时间，由 [`gmtime()`](#time.gmtime "time.gmtime") 或 [`localtime()`](#time.localtime "time.localtime") 返回为以下形式的字符串： `'Sun Jun 20 23:21:05 1993'` 。如果未提供 *t* ，则使用由 [`localtime()`](#time.localtime "time.localtime") 返回的当前时间。 区域信息不被函数 [`asctime()`](#time.asctime "time.asctime") 使用。
注解
与同名的C函数不同， [`asctime()`](#time.asctime "time.asctime") 不添加尾随换行符。
`time.``clock`()在Unix上，将当前处理器时间返回为以秒为单位的浮点数。精确度，实际上是“处理器时间”含义的定义，取决于同名C函数的精度。
在Windows上，此函数返回自第一次调用此函数以来经过的 wallclock 秒数，作为浮点数，基于Win32函数 `QueryPerformanceCounter()`。分辨率通常优于1微秒。
Deprecated since version 3.3, will be removed in version 3.8: 此函数的行为取决于平台：根据你的需求，使用 [`perf_counter()`](#time.perf_counter "time.perf_counter") 或 [`process_time()`](#time.process_time "time.process_time") 获得具有明确定义的行为。
`time.``pthread_getcpuclockid`(*thread\_id*)返回指定的 *thread\_id* 的特定于线程的CPU时间时钟的 *clk\_id* 。
使用 [`threading.Thread`](threading.xhtml#threading.Thread "threading.Thread") 对象的 [`threading.get_ident()`](threading.xhtml#threading.get_ident "threading.get_ident") 或 [`ident`](threading.xhtml#threading.Thread.ident "threading.Thread.ident") 属性为 *thread\_id* 获取合适的值。
警告
传递无效的或过期的 *thread\_id* 可能会导致未定义的行为，例如段错误。
[可用性](intro.xhtml#availability) ： Unix（有关详细信息，请参见 *pthread\_getcpuclockid(3)* 的手册页）。
3\.7 新版功能.
`time.``clock_getres`(*clk\_id*)返回指定时钟 *clk\_id* 的分辨率（精度）。有关 *clk\_id* 的可接受值列表，请参阅 [Clock ID 常量](#time-clock-id-constants) 。
[Availability](intro.xhtml#availability): Unix.
3\.3 新版功能.
`time.``clock_gettime`(*clk\_id*) → float返回指定 *clk\_id* 时钟的时间。有关 *clk\_id* 的可接受值列表，请参阅 [Clock ID 常量](#time-clock-id-constants) 。
[Availability](intro.xhtml#availability): Unix.
3\.3 新版功能.
`time.``clock_gettime_ns`(*clk\_id*) → int与 [`clock_gettime()`](#time.clock_gettime "time.clock_gettime") 相似，但返回时间为纳秒。
[Availability](intro.xhtml#availability): Unix.
3\.7 新版功能.
`time.``clock_settime`(*clk\_id*, *time: float*)设置指定 *clk\_id* 时钟的时间。 目前， [`CLOCK_REALTIME`](#time.CLOCK_REALTIME "time.CLOCK_REALTIME") 是 *clk\_id* 唯一可接受的值。
[Availability](intro.xhtml#availability): Unix.
3\.3 新版功能.
`time.``clock_settime_ns`(*clk\_id*, *time: int*)与 [`clock_settime()`](#time.clock_settime "time.clock_settime") 相似，但设置时间为纳秒。
[Availability](intro.xhtml#availability): Unix.
3\.7 新版功能.
`time.``ctime`(\[*secs*\])将自 seconds since the epoch 表示的时间转换为表示本地时间的字符串。如果未提供 *secs* 或为 [`None`](constants.xhtml#None "None")，则使用由 [`time()`](#time.time "time.time") 返回的当前时间。 `ctime(secs)` 相当于 `asctime(localtime(secs))` 。区域信息不被 [`ctime()`](#time.ctime "time.ctime") 使用。
`time.``get_clock_info`(*name*)获取有关指定时钟的信息作为命名空间对象。 支持的时钟名称和读取其值的相应函数是：
- `'clock'`: [`time.clock()`](#time.clock "time.clock")
- `'monotonic'`: [`time.monotonic()`](#time.monotonic "time.monotonic")
- `'perf_counter'`: [`time.perf_counter()`](#time.perf_counter "time.perf_counter")
- `'process_time'`: [`time.process_time()`](#time.process_time "time.process_time")
- `'thread_time'`: [`time.thread_time()`](#time.thread_time "time.thread_time")
- `'time'`: [`time.time()`](#time.time "time.time")
结果具有以下属性：
- *adjustable* ： 如果时钟可以自动更改（例如通过NTP守护程序）或由系统管理员手动更改，则为 `True` ，否则为 `False` 。
- *implementation* ： 用于获取时钟值的基础C函数的名称。有关可能的值，请参阅 [Clock ID 常量](#time-clock-id-constants) 。
- *monotonic* ：如果时钟不能倒退，则为 `True` ，否则为 `False` 。
- *resolution* ： 以秒为单位的时钟分辨率（ [`float`](functions.xhtml#float "float") ）
3\.3 新版功能.
`time.``gmtime`(\[*secs*\])将 seconds since the epoch 为单位的时间转换为UTC的 [`struct_time`](#time.struct_time "time.struct_time") ，其中dst标志始终为零。如果未提供 *secs* 或为 [`None`](constants.xhtml#None "None") ，则使用由 [`time()`](#time.time "time.time") 返回的当前时间。忽略一秒的分数。有关 [`struct_time`](#time.struct_time "time.struct_time") 对象的说明，请参见上文。有关此函数的反函数，请参阅 [`calendar.timegm()`](calendar.xhtml#calendar.timegm "calendar.timegm") 。
`time.``localtime`(\[*secs*\])与 [`gmtime()`](#time.gmtime "time.gmtime") 相似但转换为当地时间。如果未提供 *secs* 或为 [`None`](constants.xhtml#None "None") ，则使用由 [`time()`](#time.time "time.time") 返回的当前时间。当 DST 适用于给定时间时，dst标志设置为 `1` 。
`time.``mktime`(*t*)这是 [`localtime()`](#time.localtime "time.localtime") 的反函数。它的参数是 [`struct_time`](#time.struct_time "time.struct_time") 或者完整的 9 元组（因为需要 dst 标志；如果它是未知的则使用 `-1` 作为dst标志），它表示 *local* 的时间，而不是 UTC 。它返回一个浮点数，以便与 [`time()`](#time.time "time.time") 兼容。如果输入值不能表示为有效时间，则 [`OverflowError`](exceptions.xhtml#OverflowError "OverflowError") 或 [`ValueError`](exceptions.xhtml#ValueError "ValueError") 将被引发（这取决于Python或底层C库是否捕获到无效值）。它可以生成时间的最早日期取决于平台。
`time.``monotonic`() → float返回单调时钟的值（以小数秒为单位），即不能倒退的时钟。时钟不受系统时钟更新的影响。返回值的参考点未定义，因此只有连续调用结果之间的差异才有效。
3\.3 新版功能.
在 3.5 版更改: 该功能现在始终可用且始终在系统范围内。
`time.``monotonic_ns`() → int与 [`monotonic()`](#time.monotonic "time.monotonic") 相似，但是返回时间为纳秒数。
3\.7 新版功能.
`time.``perf_counter`() → float返回性能计数器的值（以小数秒为单位），即具有最高可用分辨率的时钟，以测量短持续时间。它确实包括睡眠期间经过的时间，并且是系统范围的。返回值的参考点未定义，因此只有连续调用结果之间的差异才有效。
3\.3 新版功能.
`time.``perf_counter_ns`() → int与 [`perf_counter()`](#time.perf_counter "time.perf_counter") 相似，但是返回时间为纳秒。
3\.7 新版功能.
`time.``process_time`() → float返回当前进程的系统和用户CPU时间总和的值（以小数秒为单位）。它不包括睡眠期间经过的时间。根据定义，它在整个进程范围中。返回值的参考点未定义，因此只有连续调用结果之间的差异才有效。
3\.3 新版功能.
`time.``process_time_ns`() → int与 [`process_time()`](#time.process_time "time.process_time") 相似，但是返回时间为纳秒。
3\.7 新版功能.
`time.``sleep`(*secs*)暂停执行调用线程达到给定的秒数。参数可以是浮点数，以指示更精确的睡眠时间。实际的暂停时间可能小于请求的时间，因为任何捕获的信号将在执行该信号的捕获例程后终止 [`sleep()`](#time.sleep "time.sleep") 。此外，由于系统中其他活动的安排，暂停时间可能比请求的时间长任意量。
在 3.5 版更改: 即使睡眠被信号中断，该函数现在至少睡眠 *secs* ，除非信号处理程序引发异常（参见 [**PEP 475**](https://www.python.org/dev/peps/pep-0475) \[https://www.python.org/dev/peps/pep-0475\] 作为基本原理）。
`time.``strftime`(*format*\[, *t*\])转换一个元组或 [`struct_time`](#time.struct_time "time.struct_time") 表示的由 [`gmtime()`](#time.gmtime "time.gmtime") 或 [`localtime()`](#time.localtime "time.localtime") 返回的时间到由 *format* 参数指定的字符串。如果未提供 *t* ，则使用由 [`localtime()`](#time.localtime "time.localtime") 返回的当前时间。 *format* 必须是一个字符串。如果 *t* 中的任何字段超出允许范围，则引发 [`ValueError`](exceptions.xhtml#ValueError "ValueError") 。
0是时间元组中任何位置的合法参数；如果它通常是非法的，则该值被强制改为正确的值。
以下指令可以嵌入 *format* 字符串中。它们显示时没有可选的字段宽度和精度规范，并被 [`strftime()`](#time.strftime "time.strftime") 结果中的指示字符替换：
指令
意义
注释
`%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`
时区名称（如果不存在时区，则不包含字符）。
`%%`
字面的 `'%'` 字符。
注释:
1. 当与 [`strptime()`](#time.strptime "time.strptime") 函数一起使用时，如果使用 `%I` 指令来解析小时， `%p` 指令只影响输出小时字段。
2. 范围真的是 `0` 到 `61` ；值 `60` 在表示 [leap seconds](https://en.wikipedia.org/wiki/Leap_second) \[https://en.wikipedia.org/wiki/Leap\_second\] 的时间戳中有效，并且由于历史原因支持值 `61` 。
3. 当与 [`strptime()`](#time.strptime "time.strptime") 函数一起使用时， `%U` 和 `%W` 仅用于指定星期几和年份的计算。
下面是一个示例，一个与 [**RFC 2822**](https://tools.ietf.org/html/rfc2822.html) \[https://tools.ietf.org/html/rfc2822.html\] Internet电子邮件标准以兼容的日期格式。 [1](#id2)
```
>>> from time import gmtime, strftime
>>> strftime("%a, %d %b %Y %H:%M:%S +0000", gmtime())
'Thu, 28 Jun 2001 14:17:15 +0000'
```
某些平台可能支持其他指令，但只有此处列出的指令具有 ANSI C 标准化的含义。要查看平台支持的完整格式代码集，请参阅 *strftime(3)* 文档。
在某些平台上，可选的字段宽度和精度规范可以按照以下顺序紧跟在指令的初始 `'%'` 之后；这也不可移植。字段宽度通常为2，除了 `%j` ，它是3。
`time.``strptime`(*string*\[, *format*\])根据格式解析表示时间的字符串。 返回值为一个被 [`gmtime()`](#time.gmtime "time.gmtime") 或 [`localtime()`](#time.localtime "time.localtime") 返回的 [`struct_time`](#time.struct_time "time.struct_time") 。
*format* 参数使用与 [`strftime()`](#time.strftime "time.strftime") ；使用的指令相同的指令。它默认为匹配 [`ctime()`](#time.ctime "time.ctime") 返回格式的 `"%a %b %d %H:%M:%S %Y"`` 。如果 *string\*不能根据 \*format* 解析，或者解析后它有多余的数据，则引发 [`ValueError`](exceptions.xhtml#ValueError "ValueError") 。当无法推断出更准确的值时，用于填充任何缺失数据的默认值是 `(1900, 1, 1, 0, 0, 0, 0, 1, -1)` 。 *string* 和 *format* 都必须是字符串。
例如:
```
>>> import time
>>> time.strptime("30 Nov 00", "%d %b %y") # doctest: +NORMALIZE_WHITESPACE
time.struct_time(tm_year=2000, tm_mon=11, tm_mday=30, tm_hour=0, tm_min=0,
tm_sec=0, tm_wday=3, tm_yday=335, tm_isdst=-1)
```
支持 `%Z` 指令是基于 `tzname` 中包含的值以及 `daylight` 是否为真。因此，它是特定于平台的，除了识别始终已知的 UTC 和 GMT （并且被认为是非夏令时时区）。
仅支持文档中指定的指令。因为每个平台都实现了 `strftime()` ，它有时会提供比列出的指令更多的指令。但是 `strptime()` 独立于任何平台，因此不一定支持所有未记录为支持的可用指令。
*class* `time.``struct_time`返回的时间值序列的类型为 [`gmtime()`](#time.gmtime "time.gmtime") 、 [`localtime()`](#time.localtime "time.localtime") 和 [`strptime()`](#time.strptime "time.strptime") 。它是一个带有 [named tuple](../glossary.xhtml#term-named-tuple) 接口的对象：可以通过索引和属性名访问值。 存在以下值：
索引
属性
值
0
`tm_year`
（例如，1993）
1
`tm_mon`
range \[1, 12\]
2
`tm_mday`
range \[1, 31\]
3
`tm_hour`
range \[0, 23\]
4
`tm_min`
range \[0, 59\]
5
`tm_sec`
range \[0, 61\]； 见 [`strftime()`](#time.strftime "time.strftime") 介绍中的 **(2)**
6
`tm_wday`
range \[0, 6\] ，周一为 0
7
`tm_yday`
range \[1, 366\]
8
`tm_isdst`
0, 1 或 -1；如下所示
N/A
`tm_zone`
时区名称的缩写
N/A
`tm_gmtoff`
以秒为单位的UTC以东偏离
请注意，与C结构不同，月份值是 \[1,12\] 的范围，而不是 \[0,11\] 。
在调用 [`mktime()`](#time.mktime "time.mktime") 时， `tm_isdst` 可以在夏令时生效时设置为1，而在夏令时不生效时设置为0。 值-1表示这是未知的，并且通常会导致填写正确的状态。
当一个长度不正确的元组被传递给期望 [`struct_time`](#time.struct_time "time.struct_time") 的函数，或者具有错误类型的元素时，会引发 [`TypeError`](exceptions.xhtml#TypeError "TypeError") 。
`time.``time`() → float返回浮点数的 seconds since the [epoch](#epoch) 。epoch 的具体日期和 [leap seconds](https://en.wikipedia.org/wiki/Leap_second) \[https://en.wikipedia.org/wiki/Leap\_second\] 的处理取决于平台。在Windows和大多数Unix系统上， epoch 是1970年1月1日00:00:00（UTC），并且闰秒不计入 seconds since the epoch 。 这通常被称为 [Unix time](https://en.wikipedia.org/wiki/Unix_time) \[https://en.wikipedia.org/wiki/Unix\_time\] 。 要找出给定平台上的 epoch ，请查看 `gmtime(0)` 。
请注意，即使时间总是作为浮点数返回，但并非所有系统都提供高于1秒的精度。虽然此函数通常返回非递减值，但如果在两次调用之间设置了系统时钟，则它可以返回比先前调用更低的值。
返回的数字 [`time()`](#time.time "time.time") 可以通过将其传递给 [`gmtime()`](#time.gmtime "time.gmtime") 函数或转换为UTC中更常见的时间格式（即年、月、日、小时等）或通过将它传递给 [`localtime()`](#time.localtime "time.localtime") 函数获得本地时间。在这两种情况下都返回一个 [`struct_time`](#time.struct_time "time.struct_time") 对象，日历日期组件可以从中作为属性访问。
`time.``thread_time`() → float返回当前线程的系统和用户CPU时间之和的值（以小数秒为单位）。它不包括睡眠期间经过的时间。根据定义，它是特定于线程的。返回值的参考点未定义，因此只有同一线程中连续调用结果之间的差异才有效。
[可用性](intro.xhtml#availability) ： Windows、 Linux、 Unix 系统支持 `CLOCK_THREAD_CPUTIME_ID` 。
3\.7 新版功能.
`time.``thread_time_ns`() → int与 [`thread_time()`](#time.thread_time "time.thread_time") 相似，但返回纳秒时间。
3\.7 新版功能.
`time.``time_ns`() → int与 [`time()`](#module-time "time: Time access and conversions.") 相似，但返回时间为 [epoch](#epoch) 以来的整数纳秒。
3\.7 新版功能.
`time.``tzset`()重置库例程使用的时间转换规则。环境变量 `TZ` 指定如何完成。它还将设置变量 `tzname` （来自 `TZ` 环境变量）， `timezone` （UTC的西部非DST秒）， `altzone` （UTC以西的DST秒）和 `daylight` （如果此时区没有任何夏令时规则则为0，如果有夏令时适用的时间，无论过去、现在或未来，则为非零）。
[Availability](intro.xhtml#availability): Unix.
注解
虽然在很多情况下，更改 `TZ` 环境变量而不调用 [`tzset()`](#time.tzset "time.tzset") 可能会影响函数的输出，例如 [`localtime()`](#time.localtime "time.localtime") ，不应该依赖此行为。
`TZ` 不应该包含空格。
`TZ` 环境变量的标准格式是（为了清晰起见，添加了空格）:
```
std offset [dst [offset [,start[/time], end[/time]]]]
```
组件的位置是：
`std` 和 `dst`三个或更多字母数字，给出时区缩写。这些将传到 time.tzname
`offset`偏移量的形式为： `± hh[:mm[:ss]]` 。这表示添加到达UTC的本地时间的值。如果前面有 '-' ，则时区位于本初子午线的东边；否则，在它是西边。如果dst之后没有偏移，则假设夏令时比标准时间提前一小时。
`start[/time], end[/time]`指示何时更改为DST和从DST返回。开始日期和结束日期的格式为以下之一：
`Jn`Julian日 *n* （1 <= *n* <= 365）。闰日不计算在内，因此在所有年份中，2月28日是第59天，3月1日是第60天。
`n`从零开始的Julian日（0 <= *n* <= 365）。 闰日计入，可以引用2月29日。
`Mm.n.d`一年中 *m* 月的第 *n* 周（1 <= *n* <= 5 ，1 <= *m* <= 12 ，第 5 周表示 “可能在 *m* 月第 4 周或第 5 周出现的最后第 *d* 日”）的第 *d* 天（0 <= *d* <= 6）。 第 1 周是第 *d* 天发生的第一周。 第 0 天是星期天。
`time` 的格式与 `offset` 的格式相同，但不允许使用前导符号（ '-' 或 '+' ）。如果没有给出时间，则默认值为02:00:00。
```
>>> os.environ['TZ'] = 'EST+05EDT,M4.1.0,M10.5.0'
>>> time.tzset()
>>> time.strftime('%X %x %Z')
'02:07:36 05/08/03 EDT'
>>> os.environ['TZ'] = 'AEST-10AEDT-11,M10.5.0,M3.5.0'
>>> time.tzset()
>>> time.strftime('%X %x %Z')
'16:08:12 05/08/03 AEST'
```
在许多Unix系统（包括 \*BSD ， Linux ， Solaris 和 Darwin 上），使用系统的区域信息（ *tzfile(5)* ）数据库来指定时区规则会更方便。为此，将 `TZ` 环境变量设置为所需时区数据文件的路径，相对于系统 'zoneinfo' 时区数据库的根目录，通常位于 `/usr/share/zoneinfo` 。 例如，`'US/Eastern'` 、 `'Australia/Melbourne'` 、 `'Egypt'` 或 `'Europe/Amsterdam'`。
```
>>> os.environ['TZ'] = 'US/Eastern'
>>> time.tzset()
>>> time.tzname
('EST', 'EDT')
>>> os.environ['TZ'] = 'Egypt'
>>> time.tzset()
>>> time.tzname
('EET', 'EEST')
```
## Clock ID 常量
这些常量用作 [`clock_getres()`](#time.clock_getres "time.clock_getres") 和 [`clock_gettime()`](#time.clock_gettime "time.clock_gettime") 的参数。
`time.``CLOCK_BOOTTIME`与 [`CLOCK_MONOTONIC`](#time.CLOCK_MONOTONIC "time.CLOCK_MONOTONIC") 相同，除了它还包括系统暂停的任何时间。
这允许应用程序获得一个暂停感知的单调时钟，而不必处理 [`CLOCK_REALTIME`](#time.CLOCK_REALTIME "time.CLOCK_REALTIME") 的复杂性，如果使用 `settimeofday()` 或类似的时间更改时间可能会有不连续性。
[可用性](intro.xhtml#availability): Linux 2.6.39 或更新
3\.7 新版功能.
`time.``CLOCK_HIGHRES`Solaris OS 有一个 `CLOCK_HIGHRES` 计时器，试图使用最佳硬件源，并可能提供接近纳秒的分辨率。 `CLOCK_HIGHRES` 是不可调节的高分辨率时钟。
[可用性](intro.xhtml#availability): Solaris.
3\.3 新版功能.
`time.``CLOCK_MONOTONIC`无法设置的时钟，表示自某些未指定的起点以来的单调时间。
[Availability](intro.xhtml#availability): Unix.
3\.3 新版功能.
`time.``CLOCK_MONOTONIC_RAW`类似于 [`CLOCK_MONOTONIC`](#time.CLOCK_MONOTONIC "time.CLOCK_MONOTONIC") ，但可以访问不受NTP调整影响的原始硬件时间。
[可用性](intro.xhtml#availability): Linux 2.6.28 和更新版本， macOS 10.12 和更新版本。
3\.3 新版功能.
`time.``CLOCK_PROCESS_CPUTIME_ID`来自CPU的高分辨率每进程计时器。
[Availability](intro.xhtml#availability): Unix.
3\.3 新版功能.
`time.``CLOCK_PROF`来自CPU的高分辨率每进程计时器。
[可用性](intro.xhtml#availability): FreeBSD， NetBSD 7 或更新， OpenBSD.
3\.7 新版功能.
`time.``CLOCK_THREAD_CPUTIME_ID`特定于线程的CPU时钟。
[Availability](intro.xhtml#availability): Unix.
3\.3 新版功能.
`time.``CLOCK_UPTIME`该时间的绝对值是系统运行且未暂停的时间，提供准确的正常运行时间测量，包括绝对值和间隔值。
[可用性](intro.xhtml#availability): FreeBSD， OpenBSD 5.5 或更新。
3\.7 新版功能.
以下常量是唯一可以发送到 [`clock_settime()`](#time.clock_settime "time.clock_settime") 的参数。
`time.``CLOCK_REALTIME`系统范围的实时时钟。 设置此时钟需要适当的权限。
[Availability](intro.xhtml#availability): Unix.
3\.3 新版功能.
## 时区常量
`time.``altzone`本地DST时区的偏移量，以UTC为单位的秒数，如果已定义。如果当地DST时区在UTC以东（如在西欧，包括英国），则是负数。 只有当 `daylight` 非零时才使用它。 见下面的注释。
`time.``daylight`如果定义了DST时区，则为非零。 见下面的注释。
`time.``timezone`本地（非DST）时区的偏移量，UTC以西的秒数（西欧大部分地区为负，美国为正，英国为零）。 见下面的注释。
`time.``tzname`两个字符串的元组：第一个是本地非DST时区的名称，第二个是本地DST时区的名称。 如果未定义DST时区，则不应使用第二个字符串。 见下面的注释。
注解
对于上述时区常量（ [`altzone`](#time.altzone "time.altzone") 、 [`daylight`](#time.daylight "time.daylight") 、 [`timezone`](#time.timezone "time.timezone") 和 [`tzname`](#time.tzname "time.tzname") ），该值由模块加载时有效的时区规则确定，或者最后一次 [`tzset()`](#time.tzset "time.tzset") 被调用时，并且在过去的时间可能不正确。建议使用来自 [`localtime()`](#time.localtime "time.localtime") 结果的 `tm_gmtoff` 和 `tm_zone` 来获取时区信息。
参见
模块 [`datetime`](datetime.xhtml#module-datetime "datetime: Basic date and time types.")更多面向对象的日期和时间接口。
模块 [`locale`](locale.xhtml#module-locale "locale: Internationalization services.")国际化服务。 区域设置会影响 [`strftime()`](#time.strftime "time.strftime") 和 [`strptime()`](#time.strptime "time.strptime") 中许多格式说明符的解析。
模块 [`calendar`](calendar.xhtml#module-calendar "calendar: Functions for working with calendars, including some emulation of the Unix cal program.")一般日历相关功能。这个模块的 `timegm()` 是函数 [`gmtime()`](#time.gmtime "time.gmtime") 的反函数。
脚注
[1](#id1)现在不推荐使用 `%Z` ，但是所有 ANSI C 库都不支持扩展为首选小时/分钟偏移量的``%z``转义符。 此外，严格的 1982 年原始 [**RFC 822**](https://tools.ietf.org/html/rfc822.html) \[https://tools.ietf.org/html/rfc822.html\] 标准要求两位数的年份（%y而不是%Y），但是实际在2000年之前很久就转移到了4位数年。之后， [**RFC 822**](https://tools.ietf.org/html/rfc822.html) \[https://tools.ietf.org/html/rfc822.html\] 已经废弃了，4位数的年份首先被推荐 [**RFC 1123**](https://tools.ietf.org/html/rfc1123.html) \[https://tools.ietf.org/html/rfc1123.html\] ，然后被 [**RFC 2822**](https://tools.ietf.org/html/rfc2822.html) \[https://tools.ietf.org/html/rfc2822.html\] 强制执行。
### 导航
- [索引](../genindex.xhtml "总目录")
- [模块](../py-modindex.xhtml "Python 模块索引") |
- [下一页](argparse.xhtml "argparse --- 命令行选项、参数和子命令解析器") |
- [上一页](io.xhtml "io --- 处理流的核心工具") |
- 
- [Python](https://www.python.org/) »
- zh\_CN 3.7.3 [文档](../index.xhtml) »
- [Python 标准库](index.xhtml) »
- [通用操作系统服务](allos.xhtml) »
- $('.inline-search').show(0); |
© [版权所有](../copyright.xhtml) 2001-2019, Python Software Foundation.
Python 软件基金会是一个非盈利组织。 [请捐助。](https://www.python.org/psf/donations/)
最后更新于 5月 21, 2019. [发现了问题](../bugs.xhtml)？
使用[Sphinx](http://sphinx.pocoo.org/)1.8.4 创建。
- Python文档内容
- Python 有什么新变化？
- Python 3.7 有什么新变化
- 摘要 - 发布重点
- 新的特性
- 其他语言特性修改
- 新增模块
- 改进的模块
- C API 的改变
- 构建的改变
- 性能优化
- 其他 CPython 实现的改变
- 已弃用的 Python 行为
- 已弃用的 Python 模块、函数和方法
- 已弃用的 C API 函数和类型
- 平台支持的移除
- API 与特性的移除
- 移除的模块
- Windows 专属的改变
- 移植到 Python 3.7
- Python 3.7.1 中的重要变化
- Python 3.7.2 中的重要变化
- Python 3.6 有什么新变化A
- 摘要 - 发布重点
- 新的特性
- 其他语言特性修改
- 新增模块
- 改进的模块
- 性能优化
- Build and C API Changes
- 其他改进
- 弃用
- 移除
- 移植到Python 3.6
- Python 3.6.2 中的重要变化
- Python 3.6.4 中的重要变化
- Python 3.6.5 中的重要变化
- Python 3.6.7 中的重要变化
- Python 3.5 有什么新变化
- 摘要 - 发布重点
- 新的特性
- 其他语言特性修改
- 新增模块
- 改进的模块
- Other module-level changes
- 性能优化
- Build and C API Changes
- 弃用
- 移除
- Porting to Python 3.5
- Notable changes in Python 3.5.4
- What's New In Python 3.4
- 摘要 - 发布重点
- 新的特性
- 新增模块
- 改进的模块
- CPython Implementation Changes
- 弃用
- 移除
- Porting to Python 3.4
- Changed in 3.4.3
- What's New In Python 3.3
- 摘要 - 发布重点
- PEP 405: Virtual Environments
- PEP 420: Implicit Namespace Packages
- PEP 3118: New memoryview implementation and buffer protocol documentation
- PEP 393: Flexible String Representation
- PEP 397: Python Launcher for Windows
- PEP 3151: Reworking the OS and IO exception hierarchy
- PEP 380: Syntax for Delegating to a Subgenerator
- PEP 409: Suppressing exception context
- PEP 414: Explicit Unicode literals
- PEP 3155: Qualified name for classes and functions
- PEP 412: Key-Sharing Dictionary
- PEP 362: Function Signature Object
- PEP 421: Adding sys.implementation
- Using importlib as the Implementation of Import
- 其他语言特性修改
- A Finer-Grained Import Lock
- Builtin functions and types
- 新增模块
- 改进的模块
- 性能优化
- Build and C API Changes
- 弃用
- Porting to Python 3.3
- What's New In Python 3.2
- PEP 384: Defining a Stable ABI
- PEP 389: Argparse Command Line Parsing Module
- PEP 391: Dictionary Based Configuration for Logging
- PEP 3148: The concurrent.futures module
- PEP 3147: PYC Repository Directories
- PEP 3149: ABI Version Tagged .so Files
- PEP 3333: Python Web Server Gateway Interface v1.0.1
- 其他语言特性修改
- New, Improved, and Deprecated Modules
- 多线程
- 性能优化
- Unicode
- Codecs
- 文档
- IDLE
- Code Repository
- Build and C API Changes
- Porting to Python 3.2
- What's New In Python 3.1
- PEP 372: Ordered Dictionaries
- PEP 378: Format Specifier for Thousands Separator
- 其他语言特性修改
- New, Improved, and Deprecated Modules
- 性能优化
- IDLE
- Build and C API Changes
- Porting to Python 3.1
- What's New In Python 3.0
- Common Stumbling Blocks
- Overview Of Syntax Changes
- Changes Already Present In Python 2.6
- Library Changes
- PEP 3101: A New Approach To String Formatting
- Changes To Exceptions
- Miscellaneous Other Changes
- Build and C API Changes
- 性能
- Porting To Python 3.0
- What's New in Python 2.7
- The Future for Python 2.x
- Changes to the Handling of Deprecation Warnings
- Python 3.1 Features
- PEP 372: Adding an Ordered Dictionary to collections
- PEP 378: Format Specifier for Thousands Separator
- PEP 389: The argparse Module for Parsing Command Lines
- PEP 391: Dictionary-Based Configuration For Logging
- PEP 3106: Dictionary Views
- PEP 3137: The memoryview Object
- 其他语言特性修改
- New and Improved Modules
- Build and C API Changes
- Other Changes and Fixes
- Porting to Python 2.7
- New Features Added to Python 2.7 Maintenance Releases
- Acknowledgements
- Python 2.6 有什么新变化
- Python 3.0
- Changes to the Development Process
- PEP 343: The 'with' statement
- PEP 366: Explicit Relative Imports From a Main Module
- PEP 370: Per-user site-packages Directory
- PEP 371: The multiprocessing Package
- PEP 3101: Advanced String Formatting
- PEP 3105: print As a Function
- PEP 3110: Exception-Handling Changes
- PEP 3112: Byte Literals
- PEP 3116: New I/O Library
- PEP 3118: Revised Buffer Protocol
- PEP 3119: Abstract Base Classes
- PEP 3127: Integer Literal Support and Syntax
- PEP 3129: Class Decorators
- PEP 3141: A Type Hierarchy for Numbers
- 其他语言特性修改
- New and Improved Modules
- Deprecations and Removals
- Build and C API Changes
- Porting to Python 2.6
- Acknowledgements
- What's New in Python 2.5
- PEP 308: Conditional Expressions
- PEP 309: Partial Function Application
- PEP 314: Metadata for Python Software Packages v1.1
- PEP 328: Absolute and Relative Imports
- PEP 338: Executing Modules as Scripts
- PEP 341: Unified try/except/finally
- PEP 342: New Generator Features
- PEP 343: The 'with' statement
- PEP 352: Exceptions as New-Style Classes
- PEP 353: Using ssize_t as the index type
- PEP 357: The 'index' method
- 其他语言特性修改
- New, Improved, and Removed Modules
- Build and C API Changes
- Porting to Python 2.5
- Acknowledgements
- What's New in Python 2.4
- PEP 218: Built-In Set Objects
- PEP 237: Unifying Long Integers and Integers
- PEP 289: Generator Expressions
- PEP 292: Simpler String Substitutions
- PEP 318: Decorators for Functions and Methods
- PEP 322: Reverse Iteration
- PEP 324: New subprocess Module
- PEP 327: Decimal Data Type
- PEP 328: Multi-line Imports
- PEP 331: Locale-Independent Float/String Conversions
- 其他语言特性修改
- New, Improved, and Deprecated Modules
- Build and C API Changes
- Porting to Python 2.4
- Acknowledgements
- What's New in Python 2.3
- PEP 218: A Standard Set Datatype
- PEP 255: Simple Generators
- PEP 263: Source Code Encodings
- PEP 273: Importing Modules from ZIP Archives
- PEP 277: Unicode file name support for Windows NT
- PEP 278: Universal Newline Support
- PEP 279: enumerate()
- PEP 282: The logging Package
- PEP 285: A Boolean Type
- PEP 293: Codec Error Handling Callbacks
- PEP 301: Package Index and Metadata for Distutils
- PEP 302: New Import Hooks
- PEP 305: Comma-separated Files
- PEP 307: Pickle Enhancements
- Extended Slices
- 其他语言特性修改
- New, Improved, and Deprecated Modules
- Pymalloc: A Specialized Object Allocator
- Build and C API Changes
- Other Changes and Fixes
- Porting to Python 2.3
- Acknowledgements
- What's New in Python 2.2
- 概述
- PEPs 252 and 253: Type and Class Changes
- PEP 234: Iterators
- PEP 255: Simple Generators
- PEP 237: Unifying Long Integers and Integers
- PEP 238: Changing the Division Operator
- Unicode Changes
- PEP 227: Nested Scopes
- New and Improved Modules
- Interpreter Changes and Fixes
- Other Changes and Fixes
- Acknowledgements
- What's New in Python 2.1
- 概述
- PEP 227: Nested Scopes
- PEP 236: future Directives
- PEP 207: Rich Comparisons
- PEP 230: Warning Framework
- PEP 229: New Build System
- PEP 205: Weak References
- PEP 232: Function Attributes
- PEP 235: Importing Modules on Case-Insensitive Platforms
- PEP 217: Interactive Display Hook
- PEP 208: New Coercion Model
- PEP 241: Metadata in Python Packages
- New and Improved Modules
- Other Changes and Fixes
- Acknowledgements
- What's New in Python 2.0
- 概述
- What About Python 1.6?
- New Development Process
- Unicode
- 列表推导式
- Augmented Assignment
- 字符串的方法
- Garbage Collection of Cycles
- Other Core Changes
- Porting to 2.0
- Extending/Embedding Changes
- Distutils: Making Modules Easy to Install
- XML Modules
- Module changes
- New modules
- IDLE Improvements
- Deleted and Deprecated Modules
- Acknowledgements
- 更新日志
- Python 下一版
- Python 3.7.3 最终版
- Python 3.7.3 发布候选版 1
- Python 3.7.2 最终版
- Python 3.7.2 发布候选版 1
- Python 3.7.1 最终版
- Python 3.7.1 RC 2版本
- Python 3.7.1 发布候选版 1
- Python 3.7.0 正式版
- Python 3.7.0 release candidate 1
- Python 3.7.0 beta 5
- Python 3.7.0 beta 4
- Python 3.7.0 beta 3
- Python 3.7.0 beta 2
- Python 3.7.0 beta 1
- Python 3.7.0 alpha 4
- Python 3.7.0 alpha 3
- Python 3.7.0 alpha 2
- Python 3.7.0 alpha 1
- Python 3.6.6 final
- Python 3.6.6 RC 1
- Python 3.6.5 final
- Python 3.6.5 release candidate 1
- Python 3.6.4 final
- Python 3.6.4 release candidate 1
- Python 3.6.3 final
- Python 3.6.3 release candidate 1
- Python 3.6.2 final
- Python 3.6.2 release candidate 2
- Python 3.6.2 release candidate 1
- Python 3.6.1 final
- Python 3.6.1 release candidate 1
- Python 3.6.0 final
- Python 3.6.0 release candidate 2
- Python 3.6.0 release candidate 1
- Python 3.6.0 beta 4
- Python 3.6.0 beta 3
- Python 3.6.0 beta 2
- Python 3.6.0 beta 1
- Python 3.6.0 alpha 4
- Python 3.6.0 alpha 3
- Python 3.6.0 alpha 2
- Python 3.6.0 alpha 1
- Python 3.5.5 final
- Python 3.5.5 release candidate 1
- Python 3.5.4 final
- Python 3.5.4 release candidate 1
- Python 3.5.3 final
- Python 3.5.3 release candidate 1
- Python 3.5.2 final
- Python 3.5.2 release candidate 1
- Python 3.5.1 final
- Python 3.5.1 release candidate 1
- Python 3.5.0 final
- Python 3.5.0 release candidate 4
- Python 3.5.0 release candidate 3
- Python 3.5.0 release candidate 2
- Python 3.5.0 release candidate 1
- Python 3.5.0 beta 4
- Python 3.5.0 beta 3
- Python 3.5.0 beta 2
- Python 3.5.0 beta 1
- Python 3.5.0 alpha 4
- Python 3.5.0 alpha 3
- Python 3.5.0 alpha 2
- Python 3.5.0 alpha 1
- Python 教程
- 课前甜点
- 使用 Python 解释器
- 调用解释器
- 解释器的运行环境
- Python 的非正式介绍
- Python 作为计算器使用
- 走向编程的第一步
- 其他流程控制工具
- if 语句
- for 语句
- range() 函数
- break 和 continue 语句，以及循环中的 else 子句
- pass 语句
- 定义函数
- 函数定义的更多形式
- 小插曲：编码风格
- 数据结构
- 列表的更多特性
- del 语句
- 元组和序列
- 集合
- 字典
- 循环的技巧
- 深入条件控制
- 序列和其它类型的比较
- 模块
- 有关模块的更多信息
- 标准模块
- dir() 函数
- 包
- 输入输出
- 更漂亮的输出格式
- 读写文件
- 错误和异常
- 语法错误
- 异常
- 处理异常
- 抛出异常
- 用户自定义异常
- 定义清理操作
- 预定义的清理操作
- 类
- 名称和对象
- Python 作用域和命名空间
- 初探类
- 补充说明
- 继承
- 私有变量
- 杂项说明
- 迭代器
- 生成器
- 生成器表达式
- 标准库简介
- 操作系统接口
- 文件通配符
- 命令行参数
- 错误输出重定向和程序终止
- 字符串模式匹配
- 数学
- 互联网访问
- 日期和时间
- 数据压缩
- 性能测量
- 质量控制
- 自带电池
- 标准库简介 —— 第二部分
- 格式化输出
- 模板
- 使用二进制数据记录格式
- 多线程
- 日志
- 弱引用
- 用于操作列表的工具
- 十进制浮点运算
- 虚拟环境和包
- 概述
- 创建虚拟环境
- 使用pip管理包
- 接下来？
- 交互式编辑和编辑历史
- Tab 补全和编辑历史
- 默认交互式解释器的替代品
- 浮点算术：争议和限制
- 表示性错误
- 附录
- 交互模式
- 安装和使用 Python
- 命令行与环境
- 命令行
- 环境变量
- 在Unix平台中使用Python
- 获取最新版本的Python
- 构建Python
- 与Python相关的路径和文件
- 杂项
- 编辑器和集成开发环境
- 在Windows上使用 Python
- 完整安装程序
- Microsoft Store包
- nuget.org 安装包
- 可嵌入的包
- 替代捆绑包
- 配置Python
- 适用于Windows的Python启动器
- 查找模块
- 附加模块
- 在Windows上编译Python
- 其他平台
- 在苹果系统上使用 Python
- 获取和安装 MacPython
- IDE
- 安装额外的 Python 包
- Mac 上的图形界面编程
- 在 Mac 上分发 Python 应用程序
- 其他资源
- Python 语言参考
- 概述
- 其他实现
- 标注
- 词法分析
- 行结构
- 其他形符
- 标识符和关键字
- 字面值
- 运算符
- 分隔符
- 数据模型
- 对象、值与类型
- 标准类型层级结构
- 特殊方法名称
- 协程
- 执行模型
- 程序的结构
- 命名与绑定
- 异常
- 导入系统
- importlib
- 包
- 搜索
- 加载
- 基于路径的查找器
- 替换标准导入系统
- Package Relative Imports
- 有关 main 的特殊事项
- 开放问题项
- 参考文献
- 表达式
- 算术转换
- 原子
- 原型
- await 表达式
- 幂运算符
- 一元算术和位运算
- 二元算术运算符
- 移位运算
- 二元位运算
- 比较运算
- 布尔运算
- 条件表达式
- lambda 表达式
- 表达式列表
- 求值顺序
- 运算符优先级
- 简单语句
- 表达式语句
- 赋值语句
- assert 语句
- pass 语句
- del 语句
- return 语句
- yield 语句
- raise 语句
- break 语句
- continue 语句
- import 语句
- global 语句
- nonlocal 语句
- 复合语句
- if 语句
- while 语句
- for 语句
- try 语句
- with 语句
- 函数定义
- 类定义
- 协程
- 最高层级组件
- 完整的 Python 程序
- 文件输入
- 交互式输入
- 表达式输入
- 完整的语法规范
- Python 标准库
- 概述
- 可用性注释
- 内置函数
- 内置常量
- 由 site 模块添加的常量
- 内置类型
- 逻辑值检测
- 布尔运算 — and, or, not
- 比较
- 数字类型 — int, float, complex
- 迭代器类型
- 序列类型 — list, tuple, range
- 文本序列类型 — str
- 二进制序列类型 — bytes, bytearray, memoryview
- 集合类型 — set, frozenset
- 映射类型 — dict
- 上下文管理器类型
- 其他内置类型
- 特殊属性
- 内置异常
- 基类
- 具体异常
- 警告
- 异常层次结构
- 文本处理服务
- string — 常见的字符串操作
- re — 正则表达式操作
- 模块 difflib 是一个计算差异的助手
- textwrap — Text wrapping and filling
- unicodedata — Unicode 数据库
- stringprep — Internet String Preparation
- readline — GNU readline interface
- rlcompleter — GNU readline的完成函数
- 二进制数据服务
- struct — Interpret bytes as packed binary data
- codecs — Codec registry and base classes
- 数据类型
- datetime — 基础日期/时间数据类型
- calendar — General calendar-related functions
- collections — 容器数据类型
- collections.abc — 容器的抽象基类
- heapq — 堆队列算法
- bisect — Array bisection algorithm
- array — Efficient arrays of numeric values
- weakref — 弱引用
- types — Dynamic type creation and names for built-in types
- copy — 浅层 (shallow) 和深层 (deep) 复制操作
- pprint — 数据美化输出
- reprlib — Alternate repr() implementation
- enum — Support for enumerations
- 数字和数学模块
- numbers — 数字的抽象基类
- math — 数学函数
- cmath — Mathematical functions for complex numbers
- decimal — 十进制定点和浮点运算
- fractions — 分数
- random — 生成伪随机数
- statistics — Mathematical statistics functions
- 函数式编程模块
- itertools — 为高效循环而创建迭代器的函数
- functools — 高阶函数和可调用对象上的操作
- operator — 标准运算符替代函数
- 文件和目录访问
- pathlib — 面向对象的文件系统路径
- os.path — 常见路径操作
- fileinput — Iterate over lines from multiple input streams
- stat — Interpreting stat() results
- filecmp — File and Directory Comparisons
- tempfile — Generate temporary files and directories
- glob — Unix style pathname pattern expansion
- fnmatch — Unix filename pattern matching
- linecache — Random access to text lines
- shutil — High-level file operations
- macpath — Mac OS 9 路径操作函数
- 数据持久化
- pickle —— Python 对象序列化
- copyreg — Register pickle support functions
- shelve — Python object persistence
- marshal — Internal Python object serialization
- dbm — Interfaces to Unix “databases”
- sqlite3 — SQLite 数据库 DB-API 2.0 接口模块
- 数据压缩和存档
- zlib — 与 gzip 兼容的压缩
- gzip — 对 gzip 格式的支持
- bz2 — 对 bzip2 压缩算法的支持
- lzma — 用 LZMA 算法压缩
- zipfile — 在 ZIP 归档中工作
- tarfile — Read and write tar archive files
- 文件格式
- csv — CSV 文件读写
- configparser — Configuration file parser
- netrc — netrc file processing
- xdrlib — Encode and decode XDR data
- plistlib — Generate and parse Mac OS X .plist files
- 加密服务
- hashlib — 安全哈希与消息摘要
- hmac — 基于密钥的消息验证
- secrets — Generate secure random numbers for managing secrets
- 通用操作系统服务
- os — 操作系统接口模块
- io — 处理流的核心工具
- time — 时间的访问和转换
- argparse — 命令行选项、参数和子命令解析器
- getopt — C-style parser for command line options
- 模块 logging — Python 的日志记录工具
- logging.config — 日志记录配置
- logging.handlers — Logging handlers
- getpass — 便携式密码输入工具
- curses — 终端字符单元显示的处理
- curses.textpad — Text input widget for curses programs
- curses.ascii — Utilities for ASCII characters
- curses.panel — A panel stack extension for curses
- platform — Access to underlying platform's identifying data
- errno — Standard errno system symbols
- ctypes — Python 的外部函数库
- 并发执行
- threading — 基于线程的并行
- multiprocessing — 基于进程的并行
- concurrent 包
- concurrent.futures — 启动并行任务
- subprocess — 子进程管理
- sched — 事件调度器
- queue — 一个同步的队列类
- _thread — 底层多线程 API
- _dummy_thread — _thread 的替代模块
- dummy_threading — 可直接替代 threading 模块。
- contextvars — Context Variables
- Context Variables
- Manual Context Management
- asyncio support
- 网络和进程间通信
- asyncio — 异步 I/O
- socket — 底层网络接口
- ssl — TLS/SSL wrapper for socket objects
- select — Waiting for I/O completion
- selectors — 高级 I/O 复用库
- asyncore — 异步socket处理器
- asynchat — 异步 socket 指令/响应 处理器
- signal — Set handlers for asynchronous events
- mmap — Memory-mapped file support
- 互联网数据处理
- email — 电子邮件与 MIME 处理包
- json — JSON 编码和解码器
- mailcap — Mailcap file handling
- mailbox — Manipulate mailboxes in various formats
- mimetypes — Map filenames to MIME types
- base64 — Base16, Base32, Base64, Base85 数据编码
- binhex — 对binhex4文件进行编码和解码
- binascii — 二进制和 ASCII 码互转
- quopri — Encode and decode MIME quoted-printable data
- uu — Encode and decode uuencode files
- 结构化标记处理工具
- html — 超文本标记语言支持
- html.parser — 简单的 HTML 和 XHTML 解析器
- html.entities — HTML 一般实体的定义
- XML处理模块
- xml.etree.ElementTree — The ElementTree XML API
- xml.dom — The Document Object Model API
- xml.dom.minidom — Minimal DOM implementation
- xml.dom.pulldom — Support for building partial DOM trees
- xml.sax — Support for SAX2 parsers
- xml.sax.handler — Base classes for SAX handlers
- xml.sax.saxutils — SAX Utilities
- xml.sax.xmlreader — Interface for XML parsers
- xml.parsers.expat — Fast XML parsing using Expat
- 互联网协议和支持
- webbrowser — 方便的Web浏览器控制器
- cgi — Common Gateway Interface support
- cgitb — Traceback manager for CGI scripts
- wsgiref — WSGI Utilities and Reference Implementation
- urllib — URL 处理模块
- urllib.request — 用于打开 URL 的可扩展库
- urllib.response — Response classes used by urllib
- urllib.parse — Parse URLs into components
- urllib.error — Exception classes raised by urllib.request
- urllib.robotparser — Parser for robots.txt
- http — HTTP 模块
- http.client — HTTP协议客户端
- ftplib — FTP protocol client
- poplib — POP3 protocol client
- imaplib — IMAP4 protocol client
- nntplib — NNTP protocol client
- smtplib —SMTP协议客户端
- smtpd — SMTP Server
- telnetlib — Telnet client
- uuid — UUID objects according to RFC 4122
- socketserver — A framework for network servers
- http.server — HTTP 服务器
- http.cookies — HTTP state management
- http.cookiejar — Cookie handling for HTTP clients
- xmlrpc — XMLRPC 服务端与客户端模块
- xmlrpc.client — XML-RPC client access
- xmlrpc.server — Basic XML-RPC servers
- ipaddress — IPv4/IPv6 manipulation library
- 多媒体服务
- audioop — Manipulate raw audio data
- aifc — Read and write AIFF and AIFC files
- sunau — 读写 Sun AU 文件
- wave — 读写WAV格式文件
- chunk — Read IFF chunked data
- colorsys — Conversions between color systems
- imghdr — 推测图像类型
- sndhdr — 推测声音文件的类型
- ossaudiodev — Access to OSS-compatible audio devices
- 国际化
- gettext — 多语种国际化服务
- locale — 国际化服务
- 程序框架
- turtle — 海龟绘图
- cmd — 支持面向行的命令解释器
- shlex — Simple lexical analysis
- Tk图形用户界面(GUI)
- tkinter — Tcl/Tk的Python接口
- tkinter.ttk — Tk themed widgets
- tkinter.tix — Extension widgets for Tk
- tkinter.scrolledtext — 滚动文字控件
- IDLE
- 其他图形用户界面（GUI）包
- 开发工具
- typing — 类型标注支持
- pydoc — Documentation generator and online help system
- doctest — Test interactive Python examples
- unittest — 单元测试框架
- unittest.mock — mock object library
- unittest.mock 上手指南
- 2to3 - 自动将 Python 2 代码转为 Python 3 代码
- test — Regression tests package for Python
- test.support — Utilities for the Python test suite
- test.support.script_helper — Utilities for the Python execution tests
- 调试和分析
- bdb — Debugger framework
- faulthandler — Dump the Python traceback
- pdb — The Python Debugger
- The Python Profilers
- timeit — 测量小代码片段的执行时间
- trace — Trace or track Python statement execution
- tracemalloc — Trace memory allocations
- 软件打包和分发
- distutils — 构建和安装 Python 模块
- ensurepip — Bootstrapping the pip installer
- venv — 创建虚拟环境
- zipapp — Manage executable Python zip archives
- Python运行时服务
- sys — 系统相关的参数和函数
- sysconfig — Provide access to Python's configuration information
- builtins — 内建对象
- main — 顶层脚本环境
- warnings — Warning control
- dataclasses — 数据类
- contextlib — Utilities for with-statement contexts
- abc — 抽象基类
- atexit — 退出处理器
- traceback — Print or retrieve a stack traceback
- future — Future 语句定义
- gc — 垃圾回收器接口
- inspect — 检查对象
- site — Site-specific configuration hook
- 自定义 Python 解释器
- code — Interpreter base classes
- codeop — Compile Python code
- 导入模块
- zipimport — Import modules from Zip archives
- pkgutil — Package extension utility
- modulefinder — 查找脚本使用的模块
- runpy — Locating and executing Python modules
- importlib — The implementation of import
- Python 语言服务
- parser — Access Python parse trees
- ast — 抽象语法树
- symtable — Access to the compiler's symbol tables
- symbol — 与 Python 解析树一起使用的常量
- token — 与Python解析树一起使用的常量
- keyword — 检验Python关键字
- tokenize — Tokenizer for Python source
- tabnanny — 模糊缩进检测
- pyclbr — Python class browser support
- py_compile — Compile Python source files
- compileall — Byte-compile Python libraries
- dis — Python 字节码反汇编器
- pickletools — Tools for pickle developers
- 杂项服务
- formatter — Generic output formatting
- Windows系统相关模块
- msilib — Read and write Microsoft Installer files
- msvcrt — Useful routines from the MS VC++ runtime
- winreg — Windows 注册表访问
- winsound — Sound-playing interface for Windows
- Unix 专有服务
- posix — The most common POSIX system calls
- pwd — 用户密码数据库
- spwd — The shadow password database
- grp — The group database
- crypt — Function to check Unix passwords
- termios — POSIX style tty control
- tty — 终端控制功能
- pty — Pseudo-terminal utilities
- fcntl — The fcntl and ioctl system calls
- pipes — Interface to shell pipelines
- resource — Resource usage information
- nis — Interface to Sun's NIS (Yellow Pages)
- Unix syslog 库例程
- 被取代的模块
- optparse — Parser for command line options
- imp — Access the import internals
- 未创建文档的模块
- 平台特定模块
- 扩展和嵌入 Python 解释器
- 推荐的第三方工具
- 不使用第三方工具创建扩展
- 使用 C 或 C++ 扩展 Python
- 自定义扩展类型：教程
- 定义扩展类型：已分类主题
- 构建C/C++扩展
- 在Windows平台编译C和C++扩展
- 在更大的应用程序中嵌入 CPython 运行时
- Embedding Python in Another Application
- Python/C API 参考手册
- 概述
- 代码标准
- 包含文件
- 有用的宏
- 对象、类型和引用计数
- 异常
- 嵌入Python
- 调试构建
- 稳定的应用程序二进制接口
- The Very High Level Layer
- Reference Counting
- 异常处理
- Printing and clearing
- 抛出异常
- Issuing warnings
- Querying the error indicator
- Signal Handling
- Exception Classes
- Exception Objects
- Unicode Exception Objects
- Recursion Control
- 标准异常
- 标准警告类别
- 工具
- 操作系统实用程序
- 系统功能
- 过程控制
- 导入模块
- Data marshalling support
- 语句解释及变量编译
- 字符串转换与格式化
- 反射
- 编解码器注册与支持功能
- 抽象对象层
- Object Protocol
- 数字协议
- Sequence Protocol
- Mapping Protocol
- 迭代器协议
- 缓冲协议
- Old Buffer Protocol
- 具体的对象层
- 基本对象
- 数值对象
- 序列对象
- 容器对象
- 函数对象
- 其他对象
- Initialization, Finalization, and Threads
- 在Python初始化之前
- 全局配置变量
- Initializing and finalizing the interpreter
- Process-wide parameters
- Thread State and the Global Interpreter Lock
- Sub-interpreter support
- Asynchronous Notifications
- Profiling and Tracing
- Advanced Debugger Support
- Thread Local Storage Support
- 内存管理
- 概述
- 原始内存接口
- Memory Interface
- 对象分配器
- 默认内存分配器
- Customize Memory Allocators
- The pymalloc allocator
- tracemalloc C API
- 示例
- 对象实现支持
- 在堆中分配对象
- Common Object Structures
- Type 对象
- Number Object Structures
- Mapping Object Structures
- Sequence Object Structures
- Buffer Object Structures
- Async Object Structures
- 使对象类型支持循环垃圾回收
- API 和 ABI 版本管理
- 分发 Python 模块
- 关键术语
- 开源许可与协作
- 安装工具
- 阅读指南
- 我该如何...？
- ...为我的项目选择一个名字？
- ...创建和分发二进制扩展？
- 安装 Python 模块
- 关键术语
- 基本使用
- 我应如何 ...？
- ... 在 Python 3.4 之前的 Python 版本中安装 pip ？
- ... 只为当前用户安装软件包？
- ... 安装科学计算类 Python 软件包？
- ... 使用并行安装的多个 Python 版本？
- 常见的安装问题
- 在 Linux 的系统 Python 版本上安装
- 未安装 pip
- 安装二进制编译扩展
- Python 常用指引
- 将 Python 2 代码迁移到 Python 3
- 简要说明
- 详情
- 将扩展模块移植到 Python 3
- 条件编译
- 对象API的更改
- 模块初始化和状态
- CObject 替换为 Capsule
- 其他选项
- Curses Programming with Python
- What is curses?
- Starting and ending a curses application
- Windows and Pads
- Displaying Text
- User Input
- For More Information
- 实现描述器
- 摘要
- 定义和简介
- 描述器协议
- 发起调用描述符
- 描述符示例
- Properties
- 函数和方法
- Static Methods and Class Methods
- 函数式编程指引
- 概述
- 迭代器
- 生成器表达式和列表推导式
- 生成器
- 内置函数
- itertools 模块
- The functools module
- Small functions and the lambda expression
- Revision History and Acknowledgements
- 引用文献
- 日志 HOWTO
- 日志基础教程
- 进阶日志教程
- 日志级别
- 有用的处理程序
- 记录日志中引发的异常
- 使用任意对象作为消息
- 优化
- 日志操作手册
- 在多个模块中使用日志
- 在多线程中使用日志
- 使用多个日志处理器和多种格式化
- 在多个地方记录日志
- 日志服务器配置示例
- 处理日志处理器的阻塞
- Sending and receiving logging events across a network
- Adding contextual information to your logging output
- Logging to a single file from multiple processes
- Using file rotation
- Use of alternative formatting styles
- Customizing LogRecord
- Subclassing QueueHandler - a ZeroMQ example
- Subclassing QueueListener - a ZeroMQ example
- An example dictionary-based configuration
- Using a rotator and namer to customize log rotation processing
- A more elaborate multiprocessing example
- Inserting a BOM into messages sent to a SysLogHandler
- Implementing structured logging
- Customizing handlers with dictConfig()
- Using particular formatting styles throughout your application
- Configuring filters with dictConfig()
- Customized exception formatting
- Speaking logging messages
- Buffering logging messages and outputting them conditionally
- Formatting times using UTC (GMT) via configuration
- Using a context manager for selective logging
- 正则表达式HOWTO
- 概述
- 简单模式
- 使用正则表达式
- 更多模式能力
- 修改字符串
- 常见问题
- 反馈
- 套接字编程指南
- 套接字
- 创建套接字
- 使用一个套接字
- 断开连接
- 非阻塞的套接字
- 排序指南
- 基本排序
- 关键函数
- Operator 模块函数
- 升序和降序
- 排序稳定性和排序复杂度
- 使用装饰-排序-去装饰的旧方法
- 使用 cmp 参数的旧方法
- 其它
- Unicode 指南
- Unicode 概述
- Python's Unicode Support
- Reading and Writing Unicode Data
- Acknowledgements
- 如何使用urllib包获取网络资源
- 概述
- Fetching URLs
- 处理异常
- info and geturl
- Openers and Handlers
- Basic Authentication
- Proxies
- Sockets and Layers
- 脚注
- Argparse 教程
- 概念
- 基础
- 位置参数介绍
- Introducing Optional arguments
- Combining Positional and Optional arguments
- Getting a little more advanced
- Conclusion
- ipaddress模块介绍
- 创建 Address/Network/Interface 对象
- 审查 Address/Network/Interface 对象
- Network 作为 Address 列表
- 比较
- 将IP地址与其他模块一起使用
- 实例创建失败时获取更多详细信息
- Argument Clinic How-To
- The Goals Of Argument Clinic
- Basic Concepts And Usage
- Converting Your First Function
- Advanced Topics
- 使用 DTrace 和 SystemTap 检测CPython
- Enabling the static markers
- Static DTrace probes
- Static SystemTap markers
- Available static markers
- SystemTap Tapsets
- 示例
- Python 常见问题
- Python常见问题
- 一般信息
- 现实世界中的 Python
- 编程常见问题
- 一般问题
- 核心语言
- 数字和字符串
- 性能
- 序列（元组/列表）
- 对象
- 模块
- 设计和历史常见问题
- 为什么Python使用缩进来分组语句？
- 为什么简单的算术运算得到奇怪的结果？
- 为什么浮点计算不准确？
- 为什么Python字符串是不可变的？
- 为什么必须在方法定义和调用中显式使用“self”？
- 为什么不能在表达式中赋值？
- 为什么Python对某些功能（例如list.index()）使用方法来实现，而其他功能（例如len(List)）使用函数实现？
- 为什么 join()是一个字符串方法而不是列表或元组方法？
- 异常有多快？
- 为什么Python中没有switch或case语句？
- 难道不能在解释器中模拟线程，而非得依赖特定于操作系统的线程实现吗？
- 为什么lambda表达式不能包含语句？
- 可以将Python编译为机器代码，C或其他语言吗？
- Python如何管理内存？
- 为什么CPython不使用更传统的垃圾回收方案？
- CPython退出时为什么不释放所有内存？
- 为什么有单独的元组和列表数据类型？
- 列表是如何在CPython中实现的？
- 字典是如何在CPython中实现的？
- 为什么字典key必须是不可变的？
- 为什么 list.sort() 没有返回排序列表？
- 如何在Python中指定和实施接口规范？
- 为什么没有goto？
- 为什么原始字符串（r-strings）不能以反斜杠结尾？
- 为什么Python没有属性赋值的“with”语句？
- 为什么 if/while/def/class语句需要冒号？
- 为什么Python在列表和元组的末尾允许使用逗号？
- 代码库和插件 FAQ
- 通用的代码库问题
- 通用任务
- 线程相关
- 输入输出
- 网络 / Internet 编程
- 数据库
- 数学和数字
- 扩展/嵌入常见问题
- 可以使用C语言中创建自己的函数吗？
- 可以使用C++语言中创建自己的函数吗？
- C很难写，有没有其他选择？
- 如何从C执行任意Python语句？
- 如何从C中评估任意Python表达式？
- 如何从Python对象中提取C的值？
- 如何使用Py_BuildValue()创建任意长度的元组？
- 如何从C调用对象的方法？
- 如何捕获PyErr_Print()（或打印到stdout / stderr的任何内容）的输出？
- 如何从C访问用Python编写的模块？
- 如何从Python接口到C ++对象？
- 我使用Setup文件添加了一个模块，为什么make失败了？
- 如何调试扩展？
- 我想在Linux系统上编译一个Python模块，但是缺少一些文件。为什么?
- 如何区分“输入不完整”和“输入无效”？
- 如何找到未定义的g++符号__builtin_new或__pure_virtual？
- 能否创建一个对象类，其中部分方法在C中实现，而其他方法在Python中实现（例如通过继承）？
- Python在Windows上的常见问题
- 我怎样在Windows下运行一个Python程序？
- 我怎么让 Python 脚本可执行？
- 为什么有时候 Python 程序会启动缓慢？
- 我怎样使用Python脚本制作可执行文件？
- *.pyd 文件和DLL文件相同吗？
- 我怎样将Python嵌入一个Windows程序？
- 如何让编辑器不要在我的 Python 源代码中插入 tab ？
- 如何在不阻塞的情况下检查按键？
- 图形用户界面（GUI）常见问题
- 图形界面常见问题
- Python 是否有平台无关的图形界面工具包？
- 有哪些Python的GUI工具是某个平台专用的？
- 有关Tkinter的问题
- “为什么我的电脑上安装了 Python ？”
- 什么是Python？
- 为什么我的电脑上安装了 Python ？
- 我能删除 Python 吗？
- 术语对照表
- 文档说明
- Python 文档贡献者
- 解决 Bug
- 文档错误
- 使用 Python 的错误追踪系统
- 开始为 Python 贡献您的知识
- 版权
- 历史和许可证
- 软件历史
- 访问Python或以其他方式使用Python的条款和条件
- Python 3.7.3 的 PSF 许可协议
- Python 2.0 的 BeOpen.com 许可协议
- Python 1.6.1 的 CNRI 许可协议
- Python 0.9.0 至 1.2 的 CWI 许可协议
- 集成软件的许可和认可
- Mersenne Twister
- 套接字
- Asynchronous socket services
- Cookie management
- Execution tracing
- UUencode and UUdecode functions
- XML Remote Procedure Calls
- test_epoll
- Select kqueue
- SipHash24
- strtod and dtoa
- OpenSSL
- expat
- libffi
- zlib
- cfuhash
- libmpdec