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 对象都被认为是真的。
实例方法:
参考libdate.py文件.
timedelta对象
timedelta对象表示的持续时间,两个日期或时间之间的差.
class datetime.timedelta(days = 0,seconds = 0,microseconds = 0,milliseconds = 0,minutes = 0,hours = 0,weeks = 0
参数可以是整数,浮点数,正数或负数.
类属性:
- 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 : 时区的名字(不存在就为空字符)
%% : '%'字符.