python中的time模块
time模块－－时间获取和转换
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')
