aardio 文档

time 库模块帮助文档

time 成员列表

创建时间对象,返回对象可传入其他线程使用,

时间对象可作为调用 tonumber 的参数转换为
自UTC时间1970年1月1日 00:00:00 到 3000年12月31日23:59:59 之间的秒数

也可以作为调用tostring函数的参数转换为字符串

日期时间,这是自动导入的内核类库,
字符串格式化支持从 1900年1月1日 到 9999年12月31日 的时间
可用 tonumber 转换为自UTC时间1970年1月1日 00:00:00 到 3000年12月31日23:59:59 间的秒数
需要更宽的运算范围请使用time.ole

使用手册相关文档

time()

获取当前时间。
不指定参数、或者格式化以前都是默认初始化为当前时间。

不指定参数@1 在 milliseconds 字段返回毫秒数,且 dayofyear 字段无效,
参数@1指定其他参数时 milliseconds 字段总是为 0

返回对象:timeObject

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

构造并返回时间对象。
参数@1可以是表示时间的数值、字符串、参数表、time,time.ole 对象。
不指定参数@1默认初始化为当前时间。

可选用参数@2指定格式化串,首字符为!表示 UTC 时间。
参数@1 为文本时,则依据参数@2指定的格式化串解析获取时间。
省略格式串时默认值为'%Y/%m/%d %H:%M:%S',可兼容解析ISO8601格式时间。
自文本解析时间以尽可能宽松的规则识别时间。
格式串中非%前导的字符、分隔符不要求精确匹配。
如果输入文本中的时间数值超出日期范围,则返回 null 。
但如果出现当月不存在的日期且小于 31 号时会顺推为下月时间。
如果格式化解析时间时输入文本提前结束,返回 null。
创建对象后可通过 format 属性单独修改输出时间格式。

可选用参数@3指定对象的locale属性,即文本格式化语言,
locale支持的参数与setlocale相同,英文"enu",中文"chs"

time.gmt()

返回 RFC1123 格式 GMT 时间,HTTP 协议使用该格式。
参数可以是数值,字符串,或其他time对象,用法参考time构造函数,
如果参数是使用本地时间的 time 对象,返回补偿时后的标准时间。
如果参数是字符串,可兼容解析 RFC 850,RFC1123 两种格式,
例如:"Sun, 07 Feb 2016 01:11:22 GMT",
字符串中如果使用数值格式指定了时区,将自动补偿时差转换为 GMT 时区
时区以正负号开始,支持省略冒号分隔符的1位,2位,3位,4位数字缩写

返回对象:timeObject

time.iso8601()

返回 ISO8601 格式 GMT 时间。
参数可以是数值,字符串,或其他time对象,用法参考time构造函数,
如果参数是使用本地时间的 time 对象,返回补偿时差后的标准时间。

如果参数是字符串,可支持 ISO8601 省略分隔符的写法。支持仅日期无时间的格式。
但日期必须包含年月日,时间必须包含时分秒,不能只写那部分。
字符串中如果使用数值格式指定了时区,将自动补偿时差转换为 GMT 时区
时区以正负号开始,支持省略冒号分隔符的1位,2位,3位,4位数字缩写

返回对象:timeObject

time.istime()

判断对象是否time对象

time.now()

获取当前时间并返回time 对象。
在 milliseconds 字段返回毫秒数,且 dayofyear 字段无效

返回对象:timeObject

time.stamp

取 Unix 时间戳。
时间戳 0 表示 ISO8601 时间 1970-01-01T00:00:00Z

time.stamp(返回字符串,返回单位)

所有参数可省略。
默认返回数值,以毫秒为单位。
参数 @2 指定为 1 则返回值以秒为单位

time.tick()

获取系统启动时间,单位毫秒。
XP 系统每 49.7 天重置为 0,之后的系统无此限制。
高精度高性能计时请参考 time.performance.tick 函数。

time.utc()

返回 UTC 标准时间。
time.gmt,time.utc 返回相同的 UTC 时间,区别仅仅是默认格式化串不同。
参数可以是数值,字符串,或其他time对象,用法参考 time 构造函数,
如果参数是使用本地时间的 time 对象,返回补偿时后的标准时间。
格式化串默认指定为 "!%Y/%m/%d %H:%M:%S"
如果参数是字符串,解析失败则尝试修改格式化串为 "!%Y/%m/%d" 解析。
可兼容解析 ISO8601 格式(可省略分隔符)。

返回对象:timeObject

timeObject 成员列表

class datetime{  
WORD year; //年  
WORD month; //月  
WORD dayofweek; //星期  
WORD day; //日期  
WORD hour; //小时  
WORD minute; //分钟  
WORD second; //秒  
WORD milliseconds; //这个字段正常情况下为0,只有在WINAPI函数中会起作用  
format; //时间格式字符串  
isdst //是否夏令时  
}

timeObject.addday()

返回对象:timeObject

timeObject.addday(输入数值)

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

timeObject.addhour()

返回对象:timeObject

timeObject.addhour(输入数值)

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

timeObject.addminute()

返回对象:timeObject

timeObject.addminute(输入数值)

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

timeObject.addmonth()

返回对象:timeObject

timeObject.addmonth(输入数值)

增加月份数,返回自身

timeObject.addsecond()

返回对象:timeObject

timeObject.addsecond(输入数值)

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

timeObject.day

timeObject.dayofweek

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

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

timeObject.dayofyear

所在年份的天数,
注意修改这个字段不会更新时间值。
无参数调用 time 或 time.now 函数此字段无效。

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

使用格式化标记%j %U %W前必须首先刷新此字段

timeObject.diffday(指定time对象)

用当前time对象减参数指定的time对象
计算两个time对象相差天数

timeObject.diffhour(指定time对象)

用当前time对象减参数指定的time对象
计算两个time对象相差小时数

timeObject.diffminute(指定time对象)

用当前time对象减参数指定的time对象
计算两个time对象相差分钟数

timeObject.diffmonth(指定time对象)

用当前time对象减参数指定的time对象
计算两个time对象相差月份

timeObject.diffsecond(指定time对象)

用当前time对象减参数指定的time对象
计算两个time对象相差秒数

timeObject.endstr

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

timeObject.format

timeObject.format="%Y年%m月%d日 %H时%M分%S秒";/*指定输出时间文本的格式化串,首字符为!表示GMT时间*/

timeObject.getMilliTime()

返回自UTC时间 1970年1月1日 00:00:00 开始的毫秒数
最大值为UTC时间3000年12月31日23:59:59

timeObject.hour

小时

timeObject.local()

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

返回对象:timeObject

timeObject.local(true)

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

timeObject.locale

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

timeObject.milliseconds

毫秒。
构造 time 对象不指定参数 @1 或用 time.now 取当前时间,则设置此字段为当前毫秒数,否则此字段无效

timeObject.minute

分钟

timeObject.month

timeObject.second

timeObject.setMilliTime()

参数为数值
设置自UTC时间 1970年1月1日 00:00:00 开始的毫秒数
最大值为UTC时间3000年12月31日23:59:59
此函数返回时间对象自身

返回对象:timeObject

timeObject.update()

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

返回对象:timeObject

timeObject.utc()

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

返回对象:timeObject

timeObject.utc(true)

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

timeObject.year

Markdown 格式