• python模块之datetime


    datetime模块简介

    在开发工作中,我们经常需要用到日期与时间,如:

    • 作为日志信息的内容输出
    • 计算某个功能的执行时间
    • 用日期命名一个日志文件的名称
    • 记录或展示某文章的发布或修改时间
    • 其他

    Python中提供了多个用于对日期和时间进行操作的内置模块:time模块、datetime模块和calendar模块。其中time模块是通过调用C库实现的,所以有些方法在某些平台上可能无法调用,但是其提供的大部分接口与C标准库time.h基本一致。time模块相比,datetime模块提供的接口更直观、易用,功能也更加强大。

    相关术语

    UTC time Coordinated Universal Time,世界协调时,又称 格林尼治天文时间、世界标准时间。与UTC time对应的是各个时区的local time,东N区的时间比UTC时间早N个小时,因此UTC time + N小时 即为东N区的本地时间;而西N区时间比UTC时间晚N个小时,即 UTC time - N小时 即为西N区的本地时间; 中国在东8区,因此比UTC时间早8小时,可以以UTC+8进行表示。

    epoch time 表示时间开始的起点;它是一个特定的时间,不同平台上这个时间点的值不太相同,对于Unix而言,epoch time为 1970-01-01 00:00:00 UTC。

    timestamp(时间戳) 也称为Unix时间 或 POSIX时间;它是一种时间表示方式,表示从格林尼治时间1970年1月1日0时0分0秒开始到现在所经过的毫秒数,其值为float类型。 但是有些编程语言的相关方法返回的是秒数(Python就是这样),这个需要看方法的文档说明。需要说明的是时间戳是个差值,其值与时区无关。

    使用

    datetime模块提供了处理日期和时间的类,既有简单的方式,又有复杂的方式。它虽然支持日期和时间算法,但其实现的重点是为输出格式化和操作提供高效的属性提取功能。

    datetime模块中定义的类:

    datetime.date    表示日期,常用的属性有:year, month和day
    
    datetime.time    表示时间,常用属性有:hour, minute, second, microsecond
    
    datetime.datetime    表示日期时间
    
    datetime.timedelta    表示两个date、time、datetime实例之间的时间间隔,分辨率(最小单位)可达到微秒
    
    datetime.tzinfo   时区相关信息对象的抽象基类。它们由datetime和time类使用,以提供自定义时间的而调整。 
    
    datetime.timezone   Python 3.2中新增的功能,实现tzinfo抽象基类的类,表示与UTC的固定偏移

    datetime模块中定义的常量

    datetime.MINYEAR   datetime.date或datetime.datetime对象所允许的年份的最小值,值为1
    
    datetime.MAXYEAR   datetime.date或datetime.datetime对象所允许的年份的最大值,只为9999

    datetime.date类

    class datetime.date(year, month, day)

    year: [MINYEAR, MAXYEAR]

    month: [1-12]

    day: [1, 指定年份的月份中的天数]

    date_info = datetime.date(year=2012, month=9, day=5)
    print(date_info)
    
    # 2012-09-05

    类方法和属性

    date.max   date对象所能表示的最大日期:9999-12-31
    date.min   date对象所能表示的最小日志:00001-01-01
    date.resoluation   date对象表示的日期的最小单位:天
    date.today()    返回一个表示当前本地日期的date对象
    date.fromtimestamp(timestamp)  根据跟定的时间戳,返回一个date对象
    print(datetime.date.max)  # 9999-12-31
    print(datetime.date.min)  # 0001-01-01
    print(datetime.date.resolution)  # 1 day, 0:00:00
    print(datetime.date.today())  # 2017-12-06
    print(datetime.date.fromtimestamp(10000000))  # 1970-04-27

    对象方法和属性

    d.year                                      年 
    d.month                                     月 
    d.day                                       日 
    d.replace(year[, month[, day]])             生成并返回一个新的日期对象,原日期对象不变 
    d.timetuple()                               返回日期对应的time.struct_time对象 
    d.toordinal()                               返回日期是是自 0001-01-01 开始的第多少天 
    d.weekday()                                 返回日期是星期几,[0, 6],0表示星期一 
    d.isoweekday()                              返回日期是星期几,[1, 7], 1表示星期一 
    d.isocalendar()                             返回一个元组,格式为:(year, weekday, isoweekday) 
    d.isoformat()                               返回‘YYYY-MM-DD'格式的日期字符串 
    d.strftime(format)                          返回指定格式的日期字符串,与time模块的strftime(format, struct_time)功能相同 
    print(date_info.year)  # 2017
    print(date_info.month)  # 12
    print(date_info.day)  # 6
    print(date_info.replace(year=2016))  # 2016-12-06
    print(date_info.timetuple())  # time.struct_time(tm_year=2017, tm_mon=12, tm_mday=6, tm_hour=0, tm_min=0, tm_sec=0, tm_wday=2, tm_yday=340, tm_isdst=-1)
    print(date_info.toordinal())  # 736669
    print(date_info.weekday())  # 2
    print(date_info.isoweekday())  # 3 比较准确的判断是星期几
    print(date_info.isoformat())  # 2017-12-06
    print(date_info.strftime('%Y/%m/%d'))  # 2017/12/06

    datetime.time类

    class datetime.time(hour, [minute[, second, [microsecond[, tzinfo]]]])

    hour为必须参数,其他为可选参数。各参数的取值范围为

    hour                     [0, 23] 
    minute                   [0, 59] 
    second                   [0, 59] 
    microsecond              [0, 1000000] 
    tzinfo                   tzinfo的子类对象,如timezone类的实例 

    类方法和属性

    time.max time类所能表示的最大时间:time(23, 59, 59, 999999) 
    time.min time类所能表示的最小时间:time(0, 0, 0, 0) 
    time.resolution 时间的最小单位,即两个不同时间的最小差值:1微秒 

    对象方法和属性

    t.hour 时 
    t.minute 分 
    t.second 秒 
    t.microsecond 微秒 
    t.tzinfo 返回传递给time构造方法的tzinfo对象,如果该参数未给出,则返回None 
    t.replace(hour[, minute[, second[, microsecond[, tzinfo]]]]) 生成并返回一个新的时间对象,原时间对象不变 
    t.isoformat() 返回一个‘HH:MM:SS.%f'格式的时间字符串 
    t.strftime() 返回指定格式的时间字符串,与time模块的strftime(format, struct_time)功能相同 

    datetime.datetime类

    class datetime.datetime(year, month, day, hour=0, minute=0, second=0, microsecond=0, tzinfo=None)

    year, month 和 day是必须要传递的参数, tzinfo可以是None或tzinfo子类的实例。

    各参数的取值范围为:

    year [MINYEAR, MAXYEAR] 
    month [1, 12] 
    day [1, 指定年份的月份中的天数] 
    hour [0, 23] 
    minute [0, 59] 
    second [0, 59] 
    microsecond [0, 1000000] 
    tzinfo tzinfo的子类对象,如timezone类的实例 

    如果一个参数超出了这些范围,会引起ValueError异常。

    类方法和属性

    datetime.today() 返回一个表示当前本期日期时间的datetime对象 
    datetime.now([tz]) 返回指定时区日期时间的datetime对象,如果不指定tz参数则结果同上 
    datetime.utcnow() 返回当前utc日期时间的datetime对象 
    datetime.fromtimestamp(timestamp[, tz]) 根据指定的时间戳创建一个datetime对象 
    datetime.utcfromtimestamp(timestamp) 根据指定的时间戳创建一个datetime对象 
    datetime.combine(date, time) 把指定的date和time对象整合成一个datetime对象 
    datetime.strptime(date_str, format) 将时间字符串转换为datetime对象 

    对象方法和属性

    dt.year, dt.month, dt.day 年、月、日 
    dt.hour, dt.minute, dt.second 时、分、秒 
    dt.microsecond, dt.tzinfo 微秒、时区信息 
    dt.date() 获取datetime对象对应的date对象 
    dt.time() 获取datetime对象对应的time对象, tzinfo 为None 
    dt.timetz() 获取datetime对象对应的time对象,tzinfo与datetime对象的tzinfo相同 
    dt.replace([year[, month[, day[, hour[, minute[, second[, microsecond[, tzinfo]]]]]]]]) 生成并返回一个新的datetime对象,如果所有参数都没有指定,则返回一个与原datetime对象相同的对象 
    dt.timetuple() 返回datetime对象对应的tuple(不包括tzinfo) 
    dt.utctimetuple() 返回datetime对象对应的utc时间的tuple(不包括tzinfo) 
    dt.toordinal() 同date对象 
    dt.weekday() 同date对象 
    dt.isocalendar() 同date独享 
    dt.isoformat([sep]) 返回一个‘%Y-%m-%d 
    dt.ctime() 等价于time模块的time.ctime(time.mktime(d.timetuple())) 
    dt.strftime(format) 返回指定格式的时间字符串

    使用datetime.datetime类对时间戳与时间字符串进行转换

    datetime.timedelta类

    timedelta对象表示连个不同时间之间的差值。如果使用time模块对时间进行算术运行,只能将字符串格式的时间 和 struct_time格式的时间对象 先转换为时间戳格式,然后对该时间戳加上或减去n秒,最后再转换回struct_time格式或字符串格式,这显然很不方便。而datetime模块提供的timedelta类可以让我们很方面的对datetime.date, datetime.time和datetime.datetime对象做算术运算,且两个时间之间的差值单位也更加容易控制。
     这个差值的单位可以是:天、秒、微秒、毫秒、分钟、小时、周。

    class datetime.timedelta(days=0, seconds=0, microseconds=0, milliseconds=0, hours=0, weeks=0)

    所有参数都是默认参数,因此都是可选参数。参数的值可以是整数或浮点数,也可以是正数或负数。内部值存储days、seconds 和 microseconds,其他所有参数都将被转换成这3个单位:

    • 1毫秒转换为1000微秒
    • 1分钟转换为60秒
    • 1小时转换为3600秒
    • 1周转换为7天

    然后对这3个值进行标准化,使得它们的表示是唯一的:

    • microseconds : [0, 999999]
    • seconds : [0, 86399]
    • days : [-999999999, 999999999]

    类属性

    timedelta.min timedelta(-999999999) 
    timedelta.max timedelta(days=999999999, hours=23, minutes=59, seconds=59, microseconds=999999) 
    timedelta.resolution timedelta(microseconds=1) 

    实例方法和属性

    td.days 天 [-999999999, 999999999] 
    td.seconds 秒 [0, 86399] 
    td.microseconds 微秒 [0, 999999] 
    td.total_seconds() 时间差中包含的总秒数,等价于: td / timedelta(seconds=1) 
    datetime.datetime.now() 返回当前本地时间(datetime.datetime对象实例) 
    datetime.datetime.fromtimestamp(timestamp) 返回指定时间戳对应的时间(datetime.datetime对象实例) 
    datetime.timedelta() 返回一个时间间隔对象,可以直接与datetime.datetime对象做加减操作 
  • 相关阅读:
    洛谷 PT2 First Step (ファーストステップ)
    Mask-D、绮梦与空谷幽兰
    僕らの手には何もないけど、
    魔都蹭课、观光、酱油记
    竞赛计划
    糖果
    点名
    数字对
    字符串哈希
    负环
  • 原文地址:https://www.cnblogs.com/wangyuanming/p/7993713.html
Copyright © 2020-2023  润新知