fsys.time 库模块帮助文档

fsys 成员列表 #

fsys.time() #

返回对象:fsysTimeObject

fsys.time(fileTime,format) #

创建 FILETIME 结构。

@fileTime 参数可选传入以下类型参数：

省略，null 值，这不会初始化为当前时间，改用 fsys.time.now 可初始化为当前时间。
::FILETIME 结构体或指定 ::FILETIME 结构体的部分字段的表对象。
可转换为::FILETIME 结构体的其他结构体（不能小于 64 位）。
需要复制的 fsys.time 对象
普通数值，应为存储 64 位无符号时间值的浮点数。
存储无符号 64 位整数的 math.size64 对象
此 64 位整数表示自 1601 年 1 月 1 日开始以 100 纳秒为间隔的时间值。

可选用 @format 参数指定格式化串，语法与 time 对象相同。
注意 format 首字符为 "!" 表示存储 UTC 时间。
默认使用 UTC 时间格式 !%Y/%m/%d %H:%M:%S

fsys.time 成员列表 #

与 ::FILETIME 兼容的结构体，扩展了更多函数。
用于存储自 1601年1月1日开始以 100纳秒为间隔的数值。
100纳秒也就是 0.0001毫秒

创建 ::FILETIME 兼容结构体。

fsys.time 对象可传入 tostring 转换为文本格式时间，
可转换为文本的时间范围与 time 对象相同。

fsys.time 对象传入 tonumber 函数返回存储 64 位无符号时间值的浮点数。
使用 size64 函数可得到 64 位无符号数表示的时间值。
该时间值为自 1601年1月1日开始以 100纳秒为间隔的数值。

fsys.time 对象支持加、减、乘、除、取模等运算符，运算结果为 fsys.time 对象。
fsys.time 对象也支持字符串连接操作符（转为 64 位无符号整数连接）。

fsys.time.now() #

返回 fsys.time 对象（也是与 ::FILETIME 兼容的结构体），
并初始化为当前时间。

返回对象:fsysTimeObject

fsysTimeObject 成员列表 #

fsysTimeObject.copy() #

复制对象

fsysTimeObject.dwHighDateTime #

时间值高位

fsysTimeObject.dwLowDateTime #

时间值低位

fsysTimeObject.format #

格式化串，语法与 time 对象相同

fsysTimeObject.fromDosTime(fatDate,fatTime) #

DOS 时间格式转换为 FILETIME 格式
如果省略第二个参数,则取第一个参数的高位作为参数二

fsysTimeObject.fromSystemTime(time对象) #

标准时间对象转换为 FILETIME 对象
省略参数则调用 time.now 函数获取当前时间

返回对象:fsysTimeObject

fsysTimeObject.local() #

UTC 时间转换为本地时间,返回自身

fsysTimeObject.local(true) #

UTC 时间转换为本地时间,
不修改自身,返回本地时间副本

fsysTimeObject.now() #

获取当前时间，返回自身。

返回对象:fsysTimeObject

fsysTimeObject.size64() #

转换为存储无符号 64 位整数的 math.size64 对象。
此整数表示自 1601年1月1日开始以 100纳秒为间隔的时间值

fsysTimeObject.stamp() #

以数值类型返回 Unix 时间戳，以毫秒为单位。
时间戳 0 表示 ISO8601 时间 1970-01-01T00:00:00Z

fsysTimeObject.stamp(true) #

以字符串类型返回 Unix 时间戳，以毫秒为单位。
时间戳 0 表示 ISO8601 时间 1970-01-01T00:00:00Z

fsysTimeObject.toDosTime() #

成功返回 dosTime,高位,低位

fsysTimeObject.toGmtTime() #

返回 time.gmt 对象。
即 RFC1123 格式时间，HTTP 协议使用该格式。
如果对象的时间值为 null，此函数会返回当前时间。

返回对象:timeObject

fsysTimeObject.toSystemTime() #

返回 time 对象。
如果对象的时间值为 null，此函数会返回当前时间。

返回对象:timeObject

fsysTimeObject.utc() #

本地时间转换为 UTC 时间,返回自身

fsysTimeObject.utc(true) #

本地时间转换为 UTC 时间,
不修改自身,返回本地时间副本

Markdown 格式