首页 > 其他 > 详细

datetime模块源码解读

时间:2019-09-12 01:31:01      阅读:39      评论:0      收藏:0      [点我收藏+]

标签:elf   间隔   散列   分辨率   del   小时   

datetime模块是基本日期和时间类型,提供了以简单和复杂的方式操作日期和时间的类.可以进行输出格式化操作.<!-- more -->

日期和时间对象有两种:naive 和 aware .
datetime并且time 对象具有可选的时区信息属性,tzinfo可以将其设置为抽象tzinfo类的子类的实例.

常量

  • datetime.MINYEAR: 一个date或一个datetime对象中允许的最小年份数。 MINYEAR是1.
  • datetime.MAXYEAR: 一个date或一个datetime对象中允许的最大年份数。 MAXYEAR是9999.

可用类的类型

  • class datetime.date
    • 理想化的天真日期,属性: year,month,和 day。
  • class datetime.time
    • 理想化的时间.属性: hour,minute,second,microsecond,和tzinfo.
  • class datetime.datetime
    • 日期和时间的组合。属性:year,month, day,hour,minute,second,microsecond,和tzinfo。
  • class datetime.timedelta
    • 表达两者之间的差异的持续时间date,time或datetime实例微秒的分辨率
  • class datetime.tzinfo
    • 时区信息对象的抽象基类。这些由 datetime和和time类一起用于提供可定制的时间调整概念.
  • class datetime.timezone
    • 将tzinfo抽象基类实现为与UTC的固定偏移量的类.

date类的类方法和类属性

一个date对象代表一个理想化的日历日期(年,月,日),当前的公历无限期延长两个方向。1年1月1日称为第1天,1年1月2日称为第2天

  • 类方法:

    • datetime.date(year, month, day) 参数是必需的,可以是整数.
    • date.today() 返回今天的日期.
    • date.fromtimestamp() 返回与POSIX时间戳对应的本地日期.
    • date.fromordinal() 返回对应于公历格里高利序数的日期.
  • 类属性:

    • date.min属性: 表示最早的月日(1.1)
    • date.max属性: 最晚的月日(12.31)
    • date.resolution: 非相等日期对象之间可能存在的最小差异, timedelta(days=1)。
  • 实例属性(只读):
    • date.year 打印年份.
    • date.month: 月份(1-12月)
    • date.day: 给定年份的给定月份的1和之间的天数.

注意: 日期可以用作字典键。在布尔上下文中,所有date 对象都被认为是真的。

实例方法:
  • date.replace方法

    date.replace(year = self.year,month = self.month,day = self.day): 返回具有相同值的日期.

  • date.timetuple():返回元组类型的本地时间.
  • date.toordinal(): 返回日期的公历序数.
  • date.weekday() 以星期为单位返回星期几.其中星期一为0,星期日为6.
  • date.isoweekday():以星期为单位返回星期几,星期一为1,星期日为7.
  • date.isocalendar():返回3元组(月份,周,工作日)
  • date.isoformat(): 返回表示ISO 8601格式的日期字符串‘YYYY-MM-DD‘.
  • date.str(): 对于日期d,str(d)相当于d.isoformat().
  • date.ctime() : 返回表示日期的字符串.
  • date.strftime(format): 返回表示日期的字符串,由显式格式字符串控制。引用小时,分钟或秒的格式代码将显示0值.
  • date.format(format):和date.strftie()相同.

  • 计算事件天数

参考libdate.py文件.

timedelta对象

 timedelta对象表示的持续时间,两个日期或时间之间的差.

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

参数可以是整数,浮点数,正数或负数.

  • 参数转换:
    毫秒转换为1000微秒。
    一分钟转换为60秒。
    一小时转换为3600秒。
    一周转换为7天
类属性:
  • timedelta.min : 负数的timedelta对象.
  • timedelta.max : 最大的timedelta对象.
  • timedelta.resolution : 非平等timedelta物体之间可能存在的最小差异.
实例属性

实例属性(只读)

  • days 介于-999999999和999999999之间.
  • seconds: 介于0和86399之间.
  • microseconds: 介于0和999999之间.

timedelta对象还支持使用date和datetime 对象进行某些添加和减少.
timedelta对象是可散列的(可用作字典键).

  • 实例方法:
    • timedelta.total_seconds(): 返回持续时间中包含的总秒数

datetime对象

包含来自所有信息的单个对象date的对象和time对象。

  • 构造函数:
    class datetime.datetime(year, month, day, hour=0, minute=0, second=0, microsecond=0, tzinfo=None, *, fold=0)

    年,月,日参数是必需的。 tzinfo可以是None,或者是tzinfo子类的实例。其余参数可以是整数.

datetime对象的类方法
  • datetime.today(): 返回当前的本地日期时间.
  • datetime.now(tz = None): 返回当前的本地日期和时间.
  • datetime.utcnow(): 返回当前的UTC日期和时间.
  • datetime.fromtimestamp(timestamp,tz = None):返回与POSIX时间戳对应的本地日期和时间.
  • datetime.utcfromtimestamp(timestamp): 返回与datetimePOSIX时间戳对应 的UTC.
  • datetime.fromordinal(ordinal): 返回datetime相应的公历格里高利序数,其中第1年1月1日有序数1.
  • datetime.combine(date, time, tzinfo=self.tzinfo): 返回一个新datetime对象,其日期组件等于给定date对象,其时间组件等于给定time对象.
  • datetime.strptime(date_string, format): 返回datetime对应的date_string,根据格式解析.
datetime对象的类属性
  • datetime.min: 最早的datetime,日期和时间.
  • datetime.max: 最晚的datetime,日期和时间.
  • datetime.resolution: 非平等datetime物体之间可能存在的最小差异.
实例属性

实例属性(只读)

  • datetime.year: 年
  • datetime.month: 介于1到12之间.
  • datetime.day: 在给定年份的给定月份的1和之间的天数.
  • datetime.hour: 范围(24小时)
  • datetime.minute:60分钟.
  • datetime.second: 60秒.
  • datetime.microsecond: 1000000毫秒.
  • datetime.tzinfo: 该对象作为tzinfo参数传递给datetime构造函数.
  • datetime.fold: 用于消除重复间隔期间的偏移时间.

datetime对象可以用作字典键.

实例方法
  • datetime.date(): 返回年月日的对象.
  • datetime.time(): 以相同的小时,分钟,秒,微秒和折叠返回对象。折叠值被复制到返回的time对象.
  • datetime.timetz(): 返回time具有相同小时,分钟,秒,微秒,折叠和tzinfo属性的对象.
  • datetime.replace()

    datetime.replace(year=self.year, month=self.month, day=self.day, hour=self.hour, minute=self.minute, second=self.second, microsecond=self.microsecond, tzinfo=self.tzinfo, * fold=0)

    返回具有相同属性的日期时间.

  • datetime.astimezone(tz=None): 返回datetime具有新tzinfo属性tz的对象,调整日期和时间数据.tz必须是tzinfo子类的实例.
  • datetime.utcoffset(): 如果tzinfo是None,则返回None,否则返回 self.tzinfo.utcoffset(self),并在后者未返回时引发异常None,或者timedelta表示大小小于一天的整数分钟的对象.
  • datetime.dst(): 如果tzinfo是None,则返回None,否则返回 self.tzinfo.dst(self),并在后者未返回时引发异常 None,或者timedelta表示大小小于一天的整数分钟的对象。
  • datetime.tzname(): 如果tzinfo是None,则返回None,否则返回 self.tzinfo.tzname(self),如果后者不返回None或者是字符串对象,则引发异常.
  • datetime.timetuple():返回time.struct_time
  • datetime.utctimetuple():
  • datetime.toordinal(): 返回日期的格里高利序数.
  • datetime.timestamp(): 返回与datetime 实例对应的POSIX时间戳.该timestamp()方法使用该fold属性消除重复间隔期间的时间歧义.
  • datetime.weekday(): 以星期为单位返回星期几,其中星期一为0.
  • datetime.isoweekday(): 以星期为单位返回星期几,星期一为1.
  • datetime.isocalendar(): 返回3元组(年,星期编号,工作日)
  • datetime.isoformat(sep =‘T‘,timespec =‘auto‘): 返回表示ISO 8601格式的日期和时间的字符串.
  • datetime.str(): 相当于d.isoformat(‘ ‘)
  • datetime.ctime(): 返回表示日期和时间的字符串.
  • datetime.strftime(format): 返回表示日期和时间的字符串,由显式格式字符串控制.
  • datetime.format(format): 返回表示日期和时间的字符串,由显式格式字符串控制.

time对象

time对象表示一天中的时间,可以通过tzinfo对象调整.

class datetime.time(hour=0, minute=0, second=0, microsecond=0, tzinfo=None, *, fold=0)
类属性
  • time.min: 最早的时间.
  • time.max: 最新的时间.
  • time.resolution: 非相等time对象 之间可能存在最小差异.
实例属性

实例属性(只读)

  • time.hour: 24小时.
  • time.minute: 60分钟
  • time.second: 60s
  • time.microsecond: 1000000
  • time.tzinfo: 该对象作为tzinfo参数传递给time构造函数
  • time.fold: 消除重复间隔期间的墙壁时间.
实例方法
  • time.replace方法

    time.replace(hour=self.hour, minute=self.minute, second=self.second, microsecond=self.microsecond, tzinfo=self.tzinfo, * fold=0)
    返回time具有相同值的a

  • time.isoformat(timespec =‘auto‘): 返回表示ISO 8601格式的时间的字符串.
  • time.strftime(format): 返回表示时间的字符串,由显式格式字符串控制.

timezone 对象

每一个实例,其中表示通过从UTC的固定偏移定义的时区.

class datetime.timezone(offset, name=None)
所述偏移参数必须被指定为timedelta 代表的本地时间和UTC之间的差对象

timezone.utcoffset(dt): 返回timezone构造实例时指定的固定值.

timezone.tzname(dt): 返回timezone构造实例时指定的固定值.

timezone.dst(dt): 返回None.

类属性:
timezone.utc
UTC时区,timezone(timedelta(0))。

format time结构化表示

%a : 简化星期名称
%A : 本地完整星期名称
%b : 本地简化月份名称
%B : 本地完整月份名称
%c : 本地相应的日期和时间表示.
%d : 一个月中的第几天(01-31)
%H : 一天中的第几个小时(24小时制,00-23)
%I : 第几个小时(12小时制,01-12)
%j : 一年中的第几天(001-366)
%m : 月份(01-12)
%M : 分钟数(00-59)
%p : 本地am或者pm的对应符.
%S : 秒(01-61)
%U : 一年中的星期数.(00-53星期天是一个星期的开始),第一个星期天之前的所有天数都放在第0周.
%w : 一个星期中的第几天(0-6,0是星期天)
%W : 和%U基本相同,不同的是%W以星期一为一个星期的开始.
%x : 本地相应日期.
%X : 本地相应时间.
%y : 去掉世纪的月份(00-99)
%Y : 完整月份.
%Z : 时区的名字(不存在就为空字符)
%% : ‘%‘字符.

datetime模块源码解读

标签:elf   间隔   散列   分辨率   del   小时   

原文:https://blog.51cto.com/liyuanjie/2437323

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 bubuko.com 版权所有 鲁ICP备09046678号-4
打开技术之扣,分享程序人生!
             

鲁公网安备 37021202000002号