إنتقل إلى المحتوى الرئيسي

DateTime():tz()

يضبط المنطقة الزمنية لكائن DateTime على معرّف منطقة زمنية محدد.

التوقيع

tz(timeZoneId: string): DateTime

المعاملات

المعاملالنوعالوصف
timeZoneIdstringمعرّف المنطقة الزمنية المطلوب ضبطها (مثل "America/New_York" و"Europe/London"). يمكن الاطلاع على قائمة بمعرّفات المناطق الزمنية المتاحة من هنا.

القيمة المعادة

  • النوع: DateTime
  • نسخة DateTime الحالية، مع ضبط منطقتها الزمنية على المعرّف المحدد، مما يسمح بتسلسل الاستدعاءات.

أمثلة

local now = DateTime()
toast("Local time: " .. now:format("yyyy-MM-dd HH:mm:ss Z"))

now:tz("America/New_York")
toast("New York time: " .. now:format("yyyy-MM-dd HH:mm:ss Z"))

now:tz("Europe/London")
toast("London time: " .. now:format("yyyy-MM-dd HH:mm:ss Z"))