مرجع تاریخ (Date Reference)
اینجا یک «مرجع (Reference)» فهرست وار برای تاریخ های جاوااسکریپت داریم. سریع می بینی هر متد چه کاری می کند؛ مثل برگه تقلب مدرسه. اسم ها از منبع هستند و دقیق می آیند.
دسته بندی کلی متدها
بر اساس منبع: متدهای دریافت مانند getFullYear()، getMonth()، getDate()، getDay()، getHours()، getMinutes()، getSeconds()، getMilliseconds()، getTime() و getTimezoneOffset().
متدهای دریافت بر پایه UTC: getUTCFullYear()، getUTCMonth()، getUTCDate()، getUTCDay()، getUTCHours()، getUTCMinutes()، getUTCSeconds()، getUTCMilliseconds().
متدهای تنظیم: setFullYear()، setMonth()، setDate()، setHours()، setMinutes()، setSeconds()، setMilliseconds()، setTime() و نسخه های UTC آن ها.
تبدیل به رشته: toString()، toDateString()، toTimeString()، toUTCString()، toISOString()، toJSON()، toLocaleString()، toLocaleDateString()، toLocaleTimeString().
سایر موارد مهم: سازنده new Date()، Date.now()، Date.parse()، Date.UTC()، و valueOf(). متدهای getYear() و setYear() منقضی هستند.
نکات سریع و ضروری
نکته: ماه ها از 0 تا 11 هستند. ژانویه=0، دسامبر=11.
نکته: getTime() و Date.now() مقدار میلی ثانیه از 1 ژانویه 1970 می دهند.
هشدار: از getYear() و setYear() استفاده نکن. به جای آن getFullYear() و setFullYear() را به کار ببر.
نمونه خیلی کوتاه استفاده
در این نمونه، سال را می خوانیم و سپس تغییر می دهیم. «سازنده (Constructor)» یعنی تابع سازنده شیء.
const d = new Date();
const y = d.getFullYear();
d.setFullYear(y + 1);
const iso = d.toISOString();
گام های عملی
- یک تاریخ با new Date() بساز.
- سال را با
getFullYear()بخوان. - سال را با
setFullYear()یک واحد زیاد کن. - خروجی را با
toISOString()بررسی کن.
جمع بندی سریع
- مرجع شامل همه متدهای تاریخ است.
- نسخه UTC برای بیشتر متدها وجود دارد.
- ماه ها از صفر شروع می شوند.
- متدهای Year قدیمی منقضی اند.