aardio 文档

time.ole 库模块帮助文档

关于 OLE 时间

time.ole 则继承自 time 对象,time.ole 属于标准库, 需要用 import 语句导入才能使用。

time 是 aardio 的内置类型,也是一个 SYSTEMTIME 结构体对象, 在数值运算时会转换为通用的 Unix 时间戳,也就是 1970年1月1日 00:00:00 到 3000年12月31日 23:59:59 之间的秒数。 要注意同一时间无论是转换为 UTC 还是本地时间,Unix 时间戳都是不变的。

time.ole 在进行数值运算时会转换为 OLE 时间值, 这是一个 64 位浮点数( double 类型), 表示自 1899 年 12 月 30 日算起的天数。 并以负数表示 1899 年 12 月 30 日之前的时间, 小数部分表示一天当中的片段时间。 支持从 100/01/019999/12/31 的时间。很明显,time.ole 可以表示更大的时间范围,

但是 OLE 时间并没有约定标准时区。 所以 time.ole 对象在转换 UTC 与本地时间以后,OLE 时间值也会发生改变。 也就是说 time.ole 在转换时区以后,再转换为数值时会返回不同的数值。 如果希望得到统一的数值,则应当调用 utc 方法以后再获取数值。

COM 接口使用的 Variant Time(类型 VT_DATE) 存储的也是 OLE 时间值, 但 aardio 的 COM 接口会将 VT_DATE 类型自动转换为 time 类型。

Excel 日期序列号(Excel date serial number)存储的也是 OLE 时间值。

但要注意 Excel 存在一个历史遗留问题:

Excel 将 1900/1/1 作为第 1 天,又将 1900 错误地视为闰年多出了不存在的 1900/2/29 这一天。 所以 Excel 序列号在 1900/2/29 以前与 OLE 时间值是不一样的。而在 1900/2/29(日期序列号为 60) 之后则是一样的。在 Excel 的日期单元格直接输入数值序列号可以查看对应的日期。

time.ole 继承自 time 对啗,请参考:📄 time 库使用指南

time 成员列表 #

time.isole() #

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

time.ole() #

返回对象:timeOleObject

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

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

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

参数 @2 可选指定格式化串,首字符为!表示使用 UTC 时区。
兼容百分号与无百分号格式化语法,请参考 format 属性说明。

可选使用参数 @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 成员列表 #

OLE 时间(OLE Date / Variant Time )对象。
进行数值运算时会转换为自 1899 年 12 月 30 日算起的天数 ,
并以负数表示 1899 年 12 月 30 日之前的时间,
小数部分表示一天当中的片段时间。

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

time.ole.now() #

返回表示当前时间的 OLE 时间对象。\等价于无参数调用 time.ole 构造函数。

返回对象: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.addyear() #

返回对象:timeOleObject

timeOleObject.addyear(输入数值) #

增加年份,返回自身

timeOleObject.day #

timeOleObject.dayofweek #

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

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

timeOleObject.diffday(指定时间对象) #

用当前 time 对象减参数指定的 time 对象,
计算两个 time 对象相差天数,此函数返回整数

timeOleObject.diffhour(指定时间对象) #

用当前 time 对象减参数指定的 time 对象,
计算两个 time 对象相差小时数,此函数返回整数

timeOleObject.diffminute(指定时间对象) #

用当前 time 对象减参数指定的 time 对象,
计算两个 time 对象相差分钟数,此函数返回整数

timeOleObject.diffmonth(指定时间对象) #

用当前 time 对象减参数指定的 time 对象,
计算两个 time 对象相差月份,此函数返回整数

timeOleObject.diffsecond(指定时间对象) #

用当前 time 对象减参数指定的 time 对象,
计算两个 time 对象相差秒数,此函数返回整数

timeOleObject.diffyear(指定时间对象) #

计算两个时间 对象相差年份,相差不是整数年份时此函数会返回小数。

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.fromFileTime() #

返回对象:timeOleObject

timeOleObject.fromFileTime(/*输入::FILETIME对象*/) #

自参数 @1 指定的 ::FILETIME 结构体获取时间,返回自身。
参数 @1 也可以指定 fsys.time 对象。

timeOleObject.hour #

小时

timeOleObject.local #

将UTC时间转换为本地时间。
要特别注意 time 对象转换 UTC 与本地时区并不会改数值时间戳。
但是 time.ole 转换 UTC 与 本地时区以后对应的 OLE 时间数值也会改变。

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.toFileTime() #

转换并返回 ::FILETIME 结构体

timeOleObject.update() #

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

timeOleObject.utc #

将本地时间转换为 UTC 时间。
要特别注意 time 对象转换 UTC 与本地时区并不会改数值时间戳。
但是 time.ole 转换 UTC 与 本地时区以后对应的 OLE 时间数值也会改变。

timeOleObject.utc() #

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

timeOleObject.utc(true) #

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

timeOleObject.year #

Markdown 格式