DateTime()

用于执行日期时间计算的实用工具类。

签名

创建一个表示当前日期和时间的新 DateTime 实例。

DateTime();

通过解析以毫秒为单位的时间戳来创建新的 DateTime 实例。

DateTime(timestamp: number)

通过解析日期字符串来创建新的 DateTime 实例。

DateTime(dateString: string)

为指定日期创建午夜（00:00:00）时刻的新 DateTime 实例。

DateTime(year: number, month: number, day: number)

为指定的日期和时间创建新的 DateTime 实例。

DateTime(year: number, month: number, day: number, hour: number, minute: number, second: number)

参数

参数	类型	描述
timestamp	number	自 Unix 纪元以来的毫秒时间戳
dateString	string	待解析的日期字符串表示
year	number	年份值（例如 2024）
month	number	月份值（1-12）
day	number	一月中的某天（1-31）
hour	number	一天中的小时（0-23）
minute	number	一小时中的分钟（0-59）
second	number	一分钟中的秒数（0-59）

返回值

• 类型：DateTime
• 一个新的 DateTime 实例。

示例

-- 为当前日期和时间创建 DateTime 对象
local now = DateTime()
toast("Current DateTime: " .. now:format("yyyy-MM-dd HH:mm:ss"))

-- 通过时间戳创建 DateTime 对象
local timestamp = 1678886400000 -- March 15, 2023 00:00:00 UTC
local dateFromTimestamp = DateTime(timestamp)
toast("DateTime from timestamp: " .. dateFromTimestamp:format("yyyy-MM-dd HH:mm:ss"))

-- 通过日期字符串创建 DateTime 对象
local dateFromString = DateTime("2023-03-15 10:30:00")
toast("DateTime from string: " .. dateFromString:format("yyyy-MM-dd HH:mm:ss"))

-- 为特定日期创建 DateTime 对象
local specificDate = DateTime(2023, 3, 15)
toast("Specific Date: " .. specificDate:format("yyyy-MM-dd HH:mm:ss"))

-- 为特定的日期和时间创建 DateTime 对象
local specificDateTime = DateTime(2023, 3, 15, 14, 45, 30)
toast("Specific DateTime: " .. specificDateTime:format("yyyy-MM-dd HH:mm:ss"))