JavaScript Temporal.Instant

🔹 JavaScript `Temporal.Instant`

Temporal.Instant در API مدرن Temporal نمایانگر یک «لحظه دقیق جهانی» است.

به زبان ساده:

Instant = یک نقطه دقیق در زمان بر اساس UTC
(بدون وابستگی به منطقه زمانی)

🧠 تفاوت مهم

Instant فقط یک لحظه مطلق در جهان را نشان می‌دهد.
هیچ تاریخ محلی یا Time Zone در آن ذخیره نمی‌شود.

مثلاً:

2026-02-20 ساعت 10:00 تهران
2026-02-20 ساعت 06:30 UTC

اگر این دو یک لحظه واقعی باشند، هر دو به یک Instant تبدیل می‌شوند.

📌 ساختن یک Instant

1️⃣ از زمان فعلی

const now = Temporal.Now.instant();
console.log(now);

🔹 لحظه دقیق فعلی سیستم (UTC)

2️⃣ از رشته ISO

const instant = Temporal.Instant.from(“2026-02-20T06:30:00Z”);
console.log(instant);

⚠️ حتماً باید Z (UTC) داشته باشد.

⏱ تبدیل Instant به زمان محلی

چون Instant منطقه زمانی ندارد، برای نمایش باید آن را به ZonedDateTime تبدیل کنیم:

const instant = Temporal.Instant.from(“2026-02-20T06:30:00Z”);

const tehranTime = instant.toZonedDateTimeISO(“Asia/Tehran”);

console.log(tehranTime);

🔥 کاربردهای مهم

✅ ذخیره زمان در دیتابیس (به صورت جهانی و دقیق)
✅ لاگ سرورها
✅ سیستم‌های مالی
✅ همگام‌سازی بین کشورها

🆚 تفاوت با `Date`

ویژگی	Date	Instant
وابسته به سیستم	بله	خیر
Time Zone داخلی	دارد (محلی)	ندارد
دقت بالا	متوسط	بسیار دقیق
Immutable	❌	✅

🎯 خلاصه ساده

Temporal.Instant یعنی:

«یک لحظه دقیق جهانی بدون منطقه زمانی»