python中的time模塊

時間 2019-11-18

標籤 python time 模塊欄目 Python 简体版

原文原文鏈接

time模塊－－時間獲取和轉換python

time模塊提供各類時間相關的功能
與時間相關的模塊有：time,datetime,calendar

必要說明：

這個模塊的功能不是適用於全部的平臺
這個模塊中定義的大部分函數是調用C平臺上的同名函數實現

一些術語和約定的解釋：

1.時間戳(timestamp)的方式：一般來講，時間戳表示的是從1970年1月１日開始按秒計算的偏移量(time.gmtime(0))此模塊中的函數沒法處理1970紀元年之前的時間或太遙遠的將來(處理極限取決於C函數庫，對於32位系統而言，是2038年)
    2.UTC(Coordinated Universal Time,世界協調時)也叫格林威治天文時間，是世界標準時間．在我國爲UTC+8
    3.DST(Daylight Saving Time)即夏令時
    4.一些實時函數的計算精度可能不一樣

時間元祖(time.struct_time)
gmtime(),localtime()和strptime()以時間元祖(struct_time)的形式返回數據庫

索引值(index)	屬性(Attribute)	值(Values)
0	tm_year(年)	(例如:2015)
1	tm_mon(月)	1-12
2	tm_mday(日)	1-31
3	tm_hour(時)	0-23
4	tm_min(分)	0-59
5	tm_sec(秒)	0-61(60表明閏秒,61是基於歷史緣由保留)
6	tm_wday(星期幾)	0-6(0表示星期一)
7	tm_yday(一年中的第幾天)	1-366
8	tm_isdst(是否爲夏令時)	0,1,-1(-1表明夏令時)

time.altzone

返回格林威治西部的夏令時地區的偏移秒數，若是該地區在格林威治東部會返回負值(如西歐，包括英國)，對夏令時啓用地區才能使用

time.asctime([t])

接受時間元組並返回一個可讀的形式"Tue May 30 17:17:30 2017"(2017年5月30日週二17時17分30秒)的24個字符的字符串

time.clock()

用以浮點數計算的秒數返回當前的CPU時間，用來衡量不一樣程序的耗時，比time.time()更有用
python3.3之後不被推薦使用，該方法依賴操做系統，建議使用per_counter(返回系統運行時間)或process_time(返回進程運行時間)代替

time.ctime([secs])

做用至關於asctime(localtime(secs)),未給參數至關於asctime()

time.gmtime([secs])

接收時間輟(1970紀元年後通過的浮點秒數)並返回格林威治天文時間下的時間元組t(t.tm_isdst始終爲０)

time.daylight

若是夏令時被定義，則該值爲非零

time.localtime([secs])

接收時間輟(1970紀元年後通過的浮點秒數)並返回當地時間下的時間元組t(t.tm_isdst可取爲０或１，取決於當地當時是否是夏令時)

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格式以下：
    %a      本地(local)簡化星期名稱
    %A      本地完整星期名稱
    %b      本地簡化月份名稱
    %B      本地完整月份名稱
    %c      本地相應的日期和時間表示
    %d      一個月中的第幾天(01-31)
    %H      一天中的第幾個小時(24小時制，00-23)
    %l      一天中的第幾個小時(12小時制，01-12)
    %j      一年中的第幾天(01-366)
    %m      月份(01-12)
    %M      分鐘數(00-59)
    %p      本地am或者pm的相應符
    %S      秒(01-61)
    %U      一年中的星期數(00-53,星期天是一個星期的開始,第一個星期天以前的全部天數都放在第０周)
    %w      一個星期中的第幾天(0-6,0是星期天)
    %W      和%U基本相同，不一樣的是%W以星期一爲一個星期的開始
    %x      本地相應日期
    %X      本地相應時間
    %y      去掉世紀的年份(00-99)
    %Y      完整的年份       
    %z      用+HHMM或者-HHMM表示距離格林威治的時區偏移(H表明十進制的小時數，M表明十進制的分鐘數)
    %Z      時區的名字(若是不存在爲空字符)
    %%      %號自己
            %p只有與%I配合使用纔有效果
            當使用strptime()函數時，只有當在這年中的週數和天數被肯定的時候%U和%W纔會被計算

time.strptime(string[,format])

把一個格式化時間字符串轉化爲struct_time,實際上它和strftie()是逆操做

time.time()

返回當前時間的時間戳(1970元年後的浮點秒數)

time.timezone()

是當地時區(未啓動夏令時)距離格林威治的偏移秒數(美洲＞０，歐洲大部分，亞洲，非洲<＝０)

time.tzname

包含兩個字符串的元組，第一是當地夏令時區的名稱，第二是當地的DST時區的名稱

下面是一些常常會用到的例子函數

# coding: utf-8
# @Time: 2019/9/18 11:14
# @Author:renpingsheng
from __future__ import division
import time
import datetime


def get_cutten_timestr(flag=True):
    """
    獲取當前時間字符串
    @return:
    """
    if flag:
        return datetime.datetime.now().strftime('%Y-%m-%d %H:%M:%S')
    return datetime.datetime.now().strftime('%Y-%m-%d')


def parse_timestr_to_timestamp(time_str, flag=True):
    """
    把時間字符串轉換爲時間戳格式
    :param time_str: 時間字符串,格式爲：2019-01-01 12:12:12 或 2019-01-01
    :param flag: 標誌位，決定輸入時間字符串的格式
    :return: 時間戳格式
    """
    if flag:
        struct_time = time.strptime(time_str, "%Y-%m-%d %H:%M:%S")  # 2019-01-01 12:12:12
    else:
        struct_time = time.strptime(time_str, "%Y-%m-%d")  # 2019-01-01
    return time.mktime(struct_time)


def parse_month_to_timestamp(month_str, flag=True):
    """
    把月份字符串轉化爲時間戳
    :param month_str: 月份，例如：2019-01 或者 2019.01
    :param flag: 標誌位，控制輸入月份字符串的格式
    :return:
    """
    if flag:
        struct_time = time.strptime(month_str, "%Y-%m")
    else:
        struct_time = time.strptime(month_str, "%Y.%m")
    return time.mktime(struct_time)


def parse_timestamp_to_timestr(time_stamp, flag=True):
    """
    把時間戳轉換爲時間字符串
    :param time_stamp: 時間戳
    :param flag: 標誌位，能夠指定輸出時間字符串的格式
    :return: 時間字符串,格式爲：2019-01-01 12:12:12 或 2019-01-01
    """
    localtime = time.localtime(time_stamp)
    if flag:
        time_str = time.strftime("%Y-%m-%d %H:%M:%S", localtime)
    else:
        time_str = time.strftime("%Y-%m-%d", localtime)
    return time_str


def get_day_list(start_timestamp, end_timestamp, flag=True):
    """
    傳入開始時間戳和結束時間戳，獲取時間段內的日期列表
    :param start_timestamp: 開始時間戳
    :param end_timestamp: 結束時間戳
    :param flag: 標誌位
    :return: 日期列表
    """
    tmp = range(int(start_timestamp), int(end_timestamp), 3600 * 24)
    if flag:
        tmp_range = [{"day_str": parse_timestamp_to_timestr(i, flag=False)} for i in tmp]
    else:
        tmp_range = [parse_timestamp_to_timestr(i, flag=False) for i in tmp]
    return tmp_range


def day_range(interval_day):
    """
    獲取指定天內的時間字符串的列表
    :return:
    """
    c_time = (int(time.time() / (24 * 3600)) + 1) * 24 * 3600
    day_range_str = c_time - 24 * 3600 * interval_day

    day_list = [{"day_str": parse_timestamp_to_timestr(t, flag=False)} for t in range(day_range_str, c_time, 3600 * 24)]
    return day_list


def covert_time(time_str):
    """
    把時間段轉換爲秒數
    :param time_str:
    :return:
    """
    if time_str.endswith("h"):
        stamp = float(time_str.strip("h")) * 3600
    elif time_str.endswith("m"):
        stamp = float(time_str.strip("m")) * 60
    else:
        stamp = float(time_str)
    return stamp


def parse_timestr_to_datetime(timestr, flag=1):
    """
    把時間字符串轉化爲datetime
    :param timestr: 時間字符串，例如：2019-01-01 12:12:12 或者 2019.01.01 12:12:12
    :param flag: 標誌位，控制輸入時間字符串的格式
    :return:
    """
    if flag == 1:
        tmp_datetime = datetime.datetime.strptime(timestr, "%Y-%m-%d %H:%M:%S")
    elif flag == 2:
        tmp_datetime = datetime.datetime.strptime(timestr, "%Y.%m.%d %H:%M:%S")
    elif flag == 3:
        tmp_datetime = datetime.datetime.strptime(timestr, "%Y-%m-%d")
    elif flag == 4:
        tmp_datetime = datetime.datetime.strptime(timestr, "%Y-%m-%d %H:%M")
    else:
        tmp_datetime = datetime.datetime.strptime(timestr, "%Y-%m-%d %H:%M:%S")
    return tmp_datetime


################################################

def parse_format_timestr(format_timestr):
    """
    將格式字符串轉換爲時間戳
    :param format_timestr: 格式字符串,格式： "Sat Mar 28 22:24:24 2016"
    :return:
    """
    tmp_timestamp = time.mktime(time.strptime(format_timestr, "%a %b %d %H:%M:%S %Y"))
    return tmp_timestamp


def parse_datetime_to_string(datetime_str, flag=True):
    """
    把datetime時間轉化成時間字符串
    :param datetime_str: datetime生成的時間，例子：datetime.datetime.now()
    或者： datetime.datetime.now() - datetime.timedelta(hours=1)       # 一個小時以前
    或者： datetime.datetime.now() - datetime.timedelta(days=1)        # 一天以前
    :return:
    """
    # 將日期轉化爲字符串 datetime => string
    # 在數據庫中定義字段信息時爲：models.DateTimeField(auto_now_add=True)
    # 查詢數據庫以後，使用此方法把查詢到的時間轉換成可用的時間字符串
    # when_insert__range=(an_hour_time, now_time)
    # an_hour_time和 now_time 都是 datetime時間字符串，查詢兩個datetime時間字符串之間的數據
    if flag:
        return datetime_str.strftime('%Y-%m-%d %H:%M:%S')
    else:
        return datetime_str.strftime('%Y-%m-%d')


def parse_datetime_to_timestamp(datetime_str):
    """
    把datetime轉化成時間戳
    @param datetime_str: datetime時間，好比：datetime.datetime.now()
    @return: 時間戳，好比：1565663994.0
    """
    return time.mktime(datetime_str.timetuple())


def parse_timestamp_to_datetime(timestamp, flag=True):
    """
    把時間戳轉化爲datetime時間
    @param timestamp: 時間戳，好比：1553361411
    @param flag: 標誌位，決定轉化成datetime的時間
    @return:
    """
    if flag:
        return datetime.datetime.fromtimestamp(timestamp)  # 東八區的datetime時間
    return datetime.datetime.utcfromtimestamp(timestamp)  # 正常的UTC時間


def parse_dur_time(d1, d2):
    """
    獲取兩個datetime時間 間隔的日期數(天數，小時數和秒數)
    :param d1: 開始時間
    :param d2: 結束時間
    :return:
    """
    dur_str = ""
    dur_day = (d2 - d1).days
    dur_second = (d2 - d1).seconds
    if dur_day > 0:
        dur_str += "%s天" % str(dur_day)
    if dur_second - 3600 > 0:
        dur_hour = dur_second // 3600
        dur_str += "%s小時" % str(dur_hour)
    if (dur_second % 3600) > 60:
        dur_minute = (dur_second % 3600) // 60
        dur_str += "%s分鐘" % str(dur_minute)
    dur_str += "%s秒" % str(dur_second % 60)
    return dur_str


def get_month_start(datetime_str):
    """
    datetime_str能夠是：datetime.date.today() ,也能夠是：datetime.datetime.now()
    傳入datetime時間，獲取datetime時間當月第一天
    返回傳入的datetime時間的第一天的時間字符串
    """
    month_start = datetime.datetime(datetime_str.year, datetime_str.month, 1)
    return month_start.strftime('%Y-%m-%d')


def get_month_end(datetime_str):
    """
    datetime_str能夠是：datetime.date.today() ,也能夠是：datetime.datetime.now()
    傳入datetime時間，獲取datetime時間當月最後一天
    返回傳入的datetime時間的最後一天的時間字符串
    """
    if data_date.month == 12:
        month_end = datetime.datetime(datetime_str.year, 12, 31)
    else:
        month_end = datetime.datetime(datetime_str.year, datetime_str.month + 1, 1) - datetime.timedelta(days=1)
    return month_end.strftime('%Y-%m-%d')