DateTime()

أداة مساعدة لإجراء عمليات حسابات التاريخ والوقت.

التوقيع

يُنشئ نسخة DateTime جديدة تمثل التاريخ والوقت الحاليين.

DateTime();

يُنشئ نسخة DateTime جديدة من طابع زمني بالمللي ثانية.

DateTime(timestamp: number)

يُنشئ نسخة DateTime جديدة عن طريق تحليل سلسلة تاريخ نصية.

DateTime(dateString: string)

يُنشئ نسخة DateTime جديدة للتاريخ المحدد عند منتصف الليل (00:00:00).

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

يُنشئ نسخة DateTime جديدة للتاريخ والوقت المحددين.

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

المعاملات

المعامل	النوع	الوصف
timestamp	number	الطابع الزمني بالمللي ثانية منذ بداية الحقبة
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"))