JavaScript Temporal: Ma'lumotnoma (Reference)
Ushbu sahifada Temporal API tarkibidagi barcha asosiy obyektlar va ularning metodlari haqida qisqacha ma'lumot berilgan.
Temporal — bu JavaScript-da sana va vaqt bilan ishlash uchun mo'ljallangan zamonaviy, o'zgarmas (immutable) va xavfsiz API hisoblanadi.
Asosiy Temporal Obyektlari
| Obyekt | Tavsif |
|---|---|
| Temporal.Now | Hozirgi tizim vaqtini olish uchun metodlar to'plami. |
| Temporal.Instant | Vaqtning aniq bir lahzasi (UTC timestamp). Vaqt zonalaridan mustaqil. |
| Temporal.ZonedDateTime | Aniq bir vaqt zonasiga biriktirilgan sana va vaqt. |
| Temporal.Duration | Vaqt davomiyligi (yil, oy, soat va h.k.). |
Oddiy Sanalar va Vaqtlar (Plain)
"Plain" (oddiy) obyektlar vaqt zonasi ma'lumotlarini saqlamaydi:
| Obyekt | Tavsif | Misol |
|---|---|---|
| PlainDate | Faqat kalendar sanasi. | 2026-05-21 |
| PlainTime | Faqat sutka vaqti. | 14:30:00 |
| PlainDateTime | Sana va vaqt birga. | 2026-01-24 14:30 |
| PlainYearMonth | Faqat yil va oy. | 2026-05 |
| PlainMonthDay | Faqat oy va kun. | 05-01 |
Temporal.Now Metodlari
Hozirgi vaqtni turli formatlarda olish uchun ishlatiladi:
zonedDateTimeISO()— Tizim vaqti va zonasi bilan.plainDateISO()— Faqat bugungi sana.instant()— UTC bo'yicha aniq lahza.
Temporal.Instant Metodlari
Vaqtning aniq nuqtasi bilan ishlash:
from(string)— ISO matndan yaratish.fromEpochMilliseconds(ms)— Timestamp-dan yaratish.add(duration)/subtract(duration)— Vaqtni o'zgartirish.compare(a, b)— Ikki lahzani solishtirish.
PlainDate Xususiyatlari (Properties)
Sana obyekti haqida ma'lumot olish uchun 16 ta xususiyat mavjud:
day,month,year— Kun, oy, yil.dayOfWeek— Hafta kuni (1-7).dayOfYear— Yilning nechanchi kuni.daysInMonth— Oyda necha kun borligi.inLeapYear— Kabisa yili ekanligi (true/false).
Temporal Arifmetikasi
Barcha Temporal obyektlari uchun umumiy bo'lgan hisoblash metodlari:
add()— Vaqt qo'shish (yangi obyekt qaytaradi).subtract()— Vaqt ayirish.until()— Ikki vaqt oralig'idagi farqni olish.since()— Teskari farqni o'lchash.with()— Ma'lum bir qiymatni almashtirish.
Xulosa
Temporal API eski Date obyektini to'liq o'rnini bosish uchun mo'ljallangan va u ancha aniqroq, xavfsizroq va dasturchilar uchun tushunarliroqdir.