目錄

　　- 簡述
　　- 一些術語和約定
　　- 表示時間的方式
　　- 常用函數及解析

簡述

　　time 模塊用于時間的訪問和轉換，它提供了各種與時間相關的函數和幾個類，其中常用的一個類是 struct_time。

　　盡管此模塊始終可用，但并非所有平臺上都提供所有功能。該模塊中定義的大多數函數都是調用相同名稱的平臺C庫函數。有時，這些函數的語義在平臺之間會有所不同。

一些術語和約定

1. 紀元(epoch)：時間的起點，與平臺有關，對于 Unix，紀元是對于Unix，紀元是 1970年1月1日 00：00：00（UTC）。可以通過 time.gmtime(0)了解給定平臺上的紀元。
2. 時間戳(Timestamp)：通常來說，時間戳表示的是從1970年1月1日0時0分0秒開始到現在的秒數，不考慮閏秒。利用 time.time() 函數來獲取時間戳。
3. UTC：UTC是指世界標準時間（以前稱為格林威治標準時間，即 GMT）。
4. 時間元組(struct_time)：時間元組是一種結構化的時間，它表現為一個元組(其實是一個類)，共有九個元素，分別是：年， 月， 日，時，分，秒，一年中的第幾周，一年中的第幾天，夏令時(具體如下表)。struct_time 可以利用索引或屬性名訪問屬性的值。

表示時間的方式

時間的表示方式有以下三種，其中計算機認識的時間只能是‘時間戳’格式，而人能看懂的則是另外兩種格式

1. 時間戳（timestamp）
2. 結構化的時間（struct_time）
3. 格式化的時間字符串（format String）：利用 time.strftime() 函數來獲取格式化的時間字符串，需傳入表示格式的字符串（格式字符如下表）。

三種方式的轉換：

常用函數及解析

	time()
        功能：以小數秒為單位獲取時間戳
        參數：無
        返回值：一個浮點數，表示紀元到現在的秒數

    time_ns()
        功能：與 time() 相似，但單位是納秒
        參數：無
        返回值：一個整數

    asctime([t])
        功能：將一個表示時間的元組或 struct_time 表示為這種形式：'Sat Sep 28 16:54:12 2019'
        參數：t 表示一個時間元組或一個 struct_time，若不提供該參數則默認 t = time.localtime()
        返回值：固定格式化的時間字符串

    ctime(secs=None)
        功能：將時間戳轉換為本地時間的子符串，等效于 asctime(localtime(seconds))
        參數：secs 表示時間戳，默認為 None
        返回值：一個字符串

    gmtime([secs])
        功能：將時間戳轉換為UTC時區的結構化時間 struct_time
        參數：secs 表示時間戳，若不提供該參數，則默認為當前時刻的時間戳
        返回值：時間元組 struct_time

    localtime([secs])
        功能：將時間戳轉換為當地的結構化時間 struct_time
        參數：secs 表示時間戳，若不提供該參數，則默認為當前時刻的時間戳
        返回值：時間元組 struct_time

    mktime(struct_time)
        功能：將結構化的時間轉化為時間戳，相當于 localtime 的反函數
        參數：struct_time 表示一個結構化的時間
        返回值：一個時間戳

    strftime(format[, struct_time])
        功能：將結構化的時間轉化為格式化的時間字符串
        參數：format 是一個表示時間格式的字符串；struct_time 表示結構化的時間，若不提供該參數，則默認為當前時刻的結構化時間
        返回值：一個時間字符串

    strptime(time_str[, format])
        功能：將格式化的時間字符串轉化為結構化的時間
        參數：time_str 表示時間字符串；format 表示時間字符串的格式，若不提供該參數，則默認其值為：'%a %b %d %H:%M:%S %Y'
        返回值：結構化時間 struct_time

    sleep(secs)
        功能：使線程執行暫停（睡眠）給定的秒數
        參數：secs 表示秒數，可以是浮點數
        返回值：None

    perf_counter()
        功能：以小數秒為單位返回性能計數器的值，包括睡眠的時間，且是系統范圍內的
        參數：無
        返回值：一個浮點數

    perf_counter_ns()
        功能：與 perf_counter() 相似，但單位是納秒
        參數：無
        返回值：一個整數

    process_time()
        功能：以小數秒為單位返回當前進程的系統和用戶 CPU 時間總和的值，不包括睡眠時間，且是進程范圍內
        參數：無
        返回值：一個浮點數

    process_time_ns()
        功能：與 process_time() 相似，但單位是納秒
        參數：無
        返回值：一個整數

    monotonic()
        功能：以小數秒為單位返回單調時鐘(即不能倒退的時鐘)的值
        參數：無
        返回值：一個浮點數

    monotonic_ns()
        功能：與 monotonic() 相似，但以納秒為單位
        參數：無
        返回值：一個整數

    thread_time()
        功能：以小數秒為單位返回當前線程的系統和用戶 CPU 時間之和的值，不包括睡眠時間，且特定于線程
        參數：無
        返回值：一個浮點數

    thread_time_ns()
        功能：與 thread() 相似，但單位是納秒
        參數：無
        返回值：一個整數