time.ole 库模块帮助文档

time 成员列表 #

time.isole() #

检测参数中指定的值是否time.ole对象

time.ole() #

返回对象:timeOleObject

time.ole(,"%Y/%m/%d %H:%M:%S") #

创建 OLE 时间对象，返回对象可传入其他线程使用。
此对象继承自 time 对象，用法基本相同，请参考 time 库文档与使用指南。

参数 @1 可以是表示时间的数值、字符串、或time,time.ole 对象,
也可以指定一个仅提供 time 对象部分键值的表作为参数。

参数 @2 可选指定格式化串,首字符为!表示 GMT 时间

可选使用参数 @3 指定对象的 locale 属性,即文本格式化使用的区域语言代码。
locale 与 setlocale 函数支持相同的语言代码，例如：英文"enu",中文"chs"

此对象继承自 time 对象，所有功能相同。与time对象的区别是:
OLE 时间对象在输入数值或转换为数值是是以天数为单位的,而 time 对象以秒为单位.
OLE 时间对象支持从 100 年 1 月 1 日到 9999 年 12 月 31 日的时间,正数 1899 年 12 月 30 日算起的天数,
小数部分是一天当中的片段时间,负数表示 1899 年 12 月 30 日之前的时间.

注意：格式化为字符串时调用 systemFormat 函数格式化,请参考该函数说明

time.ole 成员列表 #

数值运算支持从100年1月1日到9999年12月31日的时间
正数1899年12月30日算起的天数，小数部分是一天当中的片段时间
负数表示1899年12月30日之前的时间

注意：格式化为字符串时调用 systemFormat 格式化，请参考该函数说明

time.ole.now() #

返回对象:timeOleObject

timeOleObject 成员列表 #

timeOleObject.addday() #

返回对象:timeOleObject

timeOleObject.addday(输入数值) #

增加天数,可以为负数,返回自身

timeOleObject.addhour() #

返回对象:timeOleObject

timeOleObject.addhour(输入数值) #

增加小时数,可以为负数,返回自身

timeOleObject.addminute() #

返回对象:timeOleObject

timeOleObject.addminute(输入数值) #

增加分钟数,可以为负数,返回自身

timeOleObject.addmonth() #

返回对象:timeOleObject

timeOleObject.addmonth(输入数值) #

增加月份数,返回自身

timeOleObject.addsecond() #

返回对象:timeOleObject

timeOleObject.addsecond(输入数值) #

增加秒数,可以为负数,返回自身

timeOleObject.day #

日

timeOleObject.dayofweek #

星期
星期一到星期六的值对应数值为1到6,星期日的值为 0,
注意修改这个字段不会更新时间值,

这个字段只有参与数值运算或调用 add*** 函数才会填充或更新,
例如调用 addday(0) 会更新此字段

timeOleObject.diffday(指定datetime对象) #

计算两个time对象相差天数

timeOleObject.diffhour(指定datetime对象) #

计算两个time对象相差小时数

timeOleObject.diffminute(指定datetime对象) #

计算两个time对象相差分钟数

timeOleObject.diffmonth(指定datetime对象) #

计算两个time对象相差月份

timeOleObject.diffsecond(指定datetime对象) #

计算两个time对象相差秒数

timeOleObject.endstr #

文本解析为时间后，
最后一个格式化标记解析成功并跳过空白字符以后的剩余的连续不含空白字符串，
可用于后续解析iso8601等格式的时区（解析后将必须删除）。

timeOleObject.format #

作为属性可读写默认格式化串,首字符为!表示 GMT 时间。
例如： "yyyy-mm-dd HH:MM:SS"。
兼容带百分号风格的时间格式串，例如 "%Y年%m月%d日 %H时%M分%S秒" 。
关于格式化串详细说明请查看 time 库文档。
参数 @2 setlocale 函数支持相同的区域语言代码，例如：英文"enu",中文"chs"

timeOleObject.format(格式化串,区域代码) #

作为方法调用（ ownerCall 方式）时可格式化时间并返回字符串。
所有参数可选，格式化串兼容百分号与无百分号风格，示例：
"yyyy-mm-dd HH:MM:SS" 或 "%Y年%m月%d日 %H时%M分%S秒"。
关于格式化串详细说明请查看 time 库文档。

对于 time.ole 对象此方法实际上会调用 systemFormat 函数。

timeOleObject.hour #

小时

timeOleObject.local() #

将UTC时间转换为本地时间
格式化串首字符为!表示UTF时间
如果不是UTC时间直接返回
返回自身

timeOleObject.local(true) #

将UTC时间转换为本地时间
并创建一个新的时间对象返回
如果不是UTC时间直接复制并返回
不修改自身并返回新对象

timeOleObject.locale #

格式化时间使用的语言代码
参数与 setlocale 相同,英文"enu",中文"chs",
该属性为空表示使用当前默认语言

timeOleObject.milliseconds #

毫秒

timeOleObject.minute #

分钟

timeOleObject.month #

月

timeOleObject.second #

秒

timeOleObject.systemFormat #

作为属性可读取无百分号风格的格式化串。
例如： "yyyy-mm-dd HH:MM:SS"。
如果 format 属性使用了百分号风格的格式串，
systemFormat 会将其转换为无百分号风格后返回。
systemFormat 不会在首字符使用 ! 标记 UTC 时间。

此属性只可读取，不应写入其他值，应使用 format 属性读写格式化串。

timeOleObject.systemFormat(格式化串,区域代码) #

作为方法调用（ ownerCall 方式）时，
使用系统格式化规则格式化时期,区域代码应使用 3 字母缩写。
此函数使用不带百分号的格式化语法，但也兼容带百分号的格式串,
对应规则如下（Y S D 忽略大小写）：
"%y" -> "yy" 表示2位年份
"%Y" -> "yyyy" 表示4位年份
"%B" -> "MMMM" "" 表示月份全称
"%b" -> "MMM" 表示月份缩写
"%m" -> "MM" 表示2位月份
"%d" -> "dd" 表示月份的第几天
"%H" -> "HH" 表示2位24时制小时
"%I" -> "hh" 表示2位12时制小时
"%M" -> "mm" 表示2位分钟数
"%S" -> "ss" 表示2分秒数
"%p" -> "tt" 表示12时制显示上午或下。

timeOleObject.update() #

重新计算时间并更新dayOfWeek字段.

timeOleObject.utc() #

将本地时间转换为UTC时间
格式化串首字符为!表示UTF时间
如果已经是UTC时间直接返回
修改并返回自身

timeOleObject.utc(true) #

将本地时间转换为UTC时间
并创建一个新的时间对象返回
如果已经是UTC时间直接复制并返回
不修改自身并返回新对象

timeOleObject.year #

年

Markdown 格式