AWTK fscript 中的 日期时间 扩展函数
fscript 是 AWTK 内置的脚本引擎，开发者可以在 UI XML 文件中直接嵌入 fscript 脚本，提高开发效率。本文介绍一下 fscript 中的 ** 日期时间扩展函数 **
1.date_time_create
创建日期对象。
原型
date_time_create() => object
日期对象有下列属性：
- year 年 （可读写）
- month 月 （可读写）
- day 日 （可读写）
- hour 时 （可读写）
- minute 分 （可读写）
- second 秒 （可读写）
- wday 周几 （可只读）
示例
var dt = date_time_create();
print(dt.year, "-", dt.month, "-", dt.day, " ", dt.hour, ":", dt.minute, ":", dt.second, "(", dt.wday, ")");
2.date_time_to_time
转成相对于 00:00:00 UTC on 1 January 1970 的秒数。
原型
date_time_to_time(dt) => uint64_t
示例
var dt = date_time_create();
var time = date_time_to_time(dt);
3.date_time_from_time
将相对于 00:00:00 UTC on 1 January 1970 的秒数转成成 date time。
原型
date_time_from_time(dt, time) => bool
示例
var dt = date_time_create();
var time = date_time_to_time(dt);
assert(date_time_from_time(dt, time));
4.date_time_set
把 date time 中的时间设置为系统时间。
原型
date_time_set(dt) => bool
需要有设置系统时间的权限。
示例
var dt = date_time_create();
dt.year = 2022;
dt.month = 10;
dt.day = 1;
dt.hour = 2;
dt.minute = 3;
dt.second = 4;
assert(date_time_set(dt));
5.time_now/time_now_s
获取当前时间戳函数 (s)。
原型
time_now() => uint64_t
time_now_s() => uint64_t
示例
var a = time_now();
var b = time_now_s();
6.time_now_ms
获取当前时间戳函数 (ms)。
原型
time_now_ms() => uint64_t
示例
var a = time_now_ms();
7.time_now_us
获取当前时间戳函数 (us)。
原型
time_now_us() => uint64_t
示例
var a = time_now_us();
8.is_leap_year
判断指定年份是否是闰年。
原型
is_leap_year(year) => bool
示例
var dt = date_time_create();
print(is_leap_year(dt.year));
9.get_days_of_month
获取指定年月的天数。
原型
get_days_of_month(year, month) => uint32_t
示例
var dt = date_time_create();
print(get_days_of_month(dt.year, dt.month));
10.date_time_set_prop
设置日期对象中的属性。
原型
date_time_set_prop(dt, name, value) => bool
示例
var dt = date_time_create();
date_time_set_prop(dt, "year", 2012);
11.date_time_get_prop
获取日期对象中的属性。
原型
date_time_get_prop(dt, name) => value
示例
var dt = date_time_create();
var year = date_time_get_prop(dt, "year");
12.date_time_format
格式化日期对象为字符串。
格式规则：
- Y 代表年(完整显示)
- M 代表月(1-12)
- D 代表日(1-31)
- h 代表时(0-23)
- H 代表时(0-11)
- m 代表分(0-59)
- s 代表秒(0-59)
- YY 代表年(只显示末两位)
- MM 代表月(01-12)
- DD 代表日(01-31)
- hh 代表时(00-23)
- HH 代表时(00-11)
- mm 代表分(00-59)
- ss 代表秒(00-59)
原型
date_time_format(dt, format) => str
date_time_format(epoch_time, format) => str
示例
print(date_time_format(0, "Y-M-D h:m:s")); // => "1970-1-1 0:0:0"
print(date_time_format(0, "YY-MM-DD hh:mm:ss")); // => "70-01-01 00:00:00"
更多示例
var dt = date_time_create()
print(dt.year, "-", dt.month, "-", dt.day, " ", dt.hour, ":", dt.minute, ":", dt.second, "(", dt.wday, ")")dt.year = 2022
dt.month = 10
dt.day = 1
dt.hour = 2
dt.minute = 3
dt.second = 4
assert(dt.year == 2022)
assert(dt.month == 10)
assert(dt.day == 1)
assert(dt.hour == 2)
assert(dt.minute == 3)
assert(dt.second == 4)
print(dt.year, "-", dt.month, "-", dt.day, " ", dt.hour, ":", dt.minute, ":", dt.second, "(", dt.wday, ")")assert(date_time_to_time(dt) == 1664560984)
assert(date_time_from_time(dt, 1664560985))assert(dt.year == 2022)
assert(dt.month == 10)
assert(dt.day == 1)
assert(dt.hour == 2)
assert(dt.minute == 3)
assert(dt.second == 5)print(time_now_us())
print(time_now_ms())
print(time_now_s())