awtk/docs/fscript_date_time.md

日期时间扩展函数

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())