کتابخانه
dayjs یه کتابخانه جاوااسکریپت سبک برای کار با تاریخ و زمانه. API اش شبیه Moment.js طراحی شده و برای فرمت کردن تاریخ، جمع و تفریق زمان و مقایسه تاریخ ها تو سایت و اپ وب به کار می ره. هر عملش یه نمونه جدید برمی گردونه و تاریخ اصلی دست نمی خوره.
نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز MIT؛ هش هر فایل با منبع بررسی شده است.
۵۲۰ کیلوبایت· ۳۶۸ فایل· انتشار
SHA-256: 0198dd0b1f760cded169c7e7ff7eaf56bc36c4c22c7c9b7c683e59437ed8700e
اگه تا حالا با Date خود جاوااسکریپت کار کرده باشی، می دونی چقدر می تونه اذیتت کنه. ماه ها از صفر شروع می شن، فرمت کردن بدون کد اضافه سخته و جمع کردن ده روز با یه تاریخ یعنی کلی حساب و کتاب دستی. dayjs برای همین کارها ساخته شده. یه کتابخانه کوچیکه که تاریخ رو می گیره و با چند تا متد خوانا مثل format، add، subtract و diff کارت رو راه می ندازه. متدها رو هم می تونی پشت هم زنجیر کنی.
دلیل اصلی محبوبیتش اینه که API اش عمدا شبیه Moment.js طراحی شده. اگه پروژه ای داری که با Moment نوشته شده، رفتن به dayjs معمولا بیشتر عوض کردن import و چند تا جزئیاته تا بازنویسی. فرق مهمش با Moment دو چیزه: خیلی سبک تره و ایمیوتبله. ایمیوتبل یعنی هر عمل یه نمونه جدید برمی گردونه و تاریخ اصلی دست نمی خوره. اینکه یه تابع بی خبر تاریخ تو رو عوض کنه، تو Moment یه باگ آشنا بود. برای سایت هایی که کاربراشون با اینترنت ضعیف موبایل میان، هر چی از باندل کم بشه به نفعته.
هسته dayjs ساده نگه داشته شده و بقیه امکانات رو جدا و به شکل افزونه اضافه می کنی؛ مثل زمان نسبی («۵ دقیقه پیش»)، UTC و منطقه زمانی، خوندن تاریخ با فرمت دلخواه و محاسبه بازه زمانی. فقط همونی رو لود می کنی که لازم داری. فایل زبان ها هم جدا لود می شن. یه نکته برای کاربرای ایرانی: هسته با تقویم میلادی کار می کنه. اگه تقویم شمسی (جلالی) می خوای، باید ببینی افزونه یا بسته جانبی مناسبی هست یا نه و با نسخه ای که استفاده می کنی سازگاره یا نه. اینو قبل از انتخاب تست کن، نه وسط پروژه.
کجا مناسب نیست؟ dayjs ابزار محاسبه و فرمت تاریخه، نه date picker یا تقویم کامل. اگه کل پروژه ات روی تقویم شمسی بنا شده، شاید کتابخانه ای که از اول جلالی رو پشتیبانی می کنه راحت تر باشه. اگه هم فقط یه بار یه تاریخ ساده رو فرمت می کنی، خود مرورگر با Intl کارت رو راه می ندازه.
نسخه های رسمی و بدون تغییر dayjs رو تو مخزن داخلی ما هم می تونی پیدا کنی، برای روزهایی که دسترسی به منابع خارجی محدوده. مجوزش MIT هست و استفاده تو پروژه های تجاری هم معمولا مشکلی نداره، ولی متن مجوز همراه بسته رو یه بار بخون.
ساده ترین راه برای سایت وردپرسی یا هر صفحه HTML اینه که فایل رو با کد آماده پایین همین صفحه به صفحه اضافه کنی. اگه با ابزار بیلد کار می کنی، از npm هم می تونی نصبش کنی.
یه چیز دیگه هم هست: dayjs رو فقط یه بار و تو یه جا لود کن. اگه قالب یا افزونه ای که استفاده می کنی خودش dayjs یا Moment همراهش داره، اول چک کن دو تا کتابخانه همزمان لود نشده باشن. این کار فقط حجم الکی اضافه می کنه.
dayjs یه کتابخانه جاوااسکریپت برای کار با تاریخ و زمانه که API اش شبیه Moment.js طراحی شده. فرق اصلیش اینه که خیلی سبک تره و ایمیوتبله، یعنی هر عمل یه نمونه جدید می سازه و تاریخ اصلی عوض نمی شه. امکانات اضافه هم به شکل افزونه جدا لود می شن.
هسته dayjs با تقویم میلادی کار می کنه. برای تقویم شمسی (جلالی) باید سراغ افزونه یا بسته جانبی بری و قبل از استفاده مطمئن بشی با نسخه ات سازگاره. اگه پروژه ات کامل روی تقویم شمسی بنا شده، یه بار گزینه های دیگه رو هم بسنج و تست کن.
فایل کتابخانه رو با کد آماده همین صفحه تو سایت لود کن. تو وردپرس بهتره با wp_enqueue_script ثبتش کنی و اسکریپت خودت رو وابسته بهش تعریف کنی تا اول dayjs لود بشه. بعدش تابع dayjs و متدهایی مثل format رو صدا بزن.
بله، dayjs رایگانه و با مجوز MIT منتشر شده. این مجوز معمولا اجازه می ده تو پروژه های شخصی و تجاری ازش استفاده کنی و تغییرش بدی. فقط باید اعلان مجوز اصلی رو همراه کد نگه داری. برای جزئیات دقیق، متن مجوز همراه خود بسته رو بخون.
تو بیشتر موارد آره، چون API ها شبیه همن و معمولا عوض کردن import و چند تا جزئیات کافیه. ولی چند تا فرق هم هست؛ مثلا بعضی قابلیت ها فقط با افزونه کار می کنن. بعد از عوض کردن، بخش هایی که تاریخ و منطقه زمانی توشون مهمه رو حتما تست کن.
نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.