کتابخانه
moment یه کتابخانه جاوااسکریپت برای کار با تاریخ و زمانه. باهاش می تونی تاریخ رو از متن بخونی، درست بودنش رو چک کنی، جمع و تفریقش کنی و با قالب دلخواه نشونش بدی. توی پروژه ها و قالب های قدیمی تر خیلی رایجه و با مجوز MIT منتشر شده.
نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز MIT؛ هش هر فایل با منبع بررسی شده است.
۳٫۷ مگابایت· ۵۳۸ فایل· انتشار
SHA-256: c111ad2e4447c253765e679bb4a40ba91a3e23d80b4b69d603a0fd25164cb9de
moment یکی از قدیمی ترین و شناخته شده ترین کتابخانه های جاوااسکریپت برای کار با تاریخ و زمانه. کار با Date خود جاوااسکریپت برای خیلی ها دردسره: خوندن تاریخ از متن همیشه یه جور رفتار نمی کنه، جمع و تفریق روز و ماه رو باید دستی حساب کنی و نمایش تاریخ با قالب دلخواه کلی کد می خواد. moment همه این ها رو با چند تابع ساده جمع کرده. تاریخ رو می خونی، چک می کنی معتبره یا نه، چند روز جلو یا عقب می بری و با قالبی که می خوای نشونش می دی.
کجا به کارت میاد؟ مثلاً وقتی می خوای زیر هر دیدگاه یا سفارش بنویسی «چند ساعت پیش»، فاصله بین دو تاریخ رو حساب کنی یا تاریخ پایان اشتراک رو از امروز بسازی. خیلی از قالب ها و افزونه های وردپرس و داشبوردهای قدیمی هم از moment استفاده می کنن. پس احتمال زیاد باهاش روبه رو می شی، حتی اگه خودت انتخابش نکرده باشی. وردپرس هم یه نسخه ازش رو برای بعضی بخش های پیشخوان همراه داره.
یه نکته برای سایت های ایرانی: تقویم پیش فرض moment میلادیه. بسته زبان فارسی داره، ولی اون بیشتر روی نام ماه ها و ارقام اثر می ذاره و تقویم رو شمسی نمی کنه. اگه تاریخ شمسی می خوای، معمولاً باید سراغ یه افزونه جدا مثل moment-jalaali بری. برای نمایش ساده هم می تونی از Intl.DateTimeFormat خود مرورگر با زبان fa-IR کمک بگیری.
یه چیز مهم دیگه هم هست: تیم خود moment اون رو پروژه قدیمی در حالت نگهداری معرفی کرده و برای پروژه های تازه پیشنهادش نمی کنه. حجمش نسبتاً زیاده و آبجکت هاش تغییرپذیرن؛ یعنی add روی یه تاریخ همون تاریخ رو عوض می کنه، نه یه کپی از اون رو. ماه ها هم از صفر شروع می شن، پس ژانویه می شه صفر. برای پروژه جدید Day.js، date-fns یا Luxon انتخاب های سبک تری هستن. ولی اگه سایتت از قبل روی moment سوار شده، تعویضش همیشه به صرفه نیست.
نسخه های رسمی و بدون تغییر moment رو توی مخزن داخلی ما هم می تونی پیدا کنی، برای روزهایی که دسترسی به منبع اصلی سخته.
اگه می خوای moment رو توی یه صفحه معمولی یا قالب وردپرس استفاده کنی، قدم ها تقریباً همینه:
قبل از انتشار روی سایت اصلی، یه بار توی نسخه تستی چک کن که تاریخ ها درست نمایش داده می شن.
moment یه کتابخانه جاوااسکریپته که کار با تاریخ و زمان رو ساده می کنه. می تونی تاریخ رو از متن بخونی، معتبر بودنش رو چک کنی، روز و ماه بهش اضافه یا ازش کم کنی، فاصله دو تاریخ رو بگیری و با قالب دلخواه نمایش بدی. مثلاً متن «۲ ساعت پیش» رو با یه تابع می سازی.
خود moment تقویمش میلادیه. بسته زبان فارسی نام ماه ها و ارقام رو فارسی می کنه، ولی تاریخ رو شمسی نمی کنه. برای تاریخ شمسی معمولاً از یه افزونه جدا مثل moment-jalaali استفاده می شه. اگه فقط نمایش ساده می خوای، می تونی سراغ Intl.DateTimeFormat مرورگر با fa-IR بری.
تیم خودش اون رو پروژه قدیمی در حالت نگهداری می دونه و برای پروژه جدید پیشنهادش نمی کنه. برای شروع تازه، Day.js، date-fns یا Luxon انتخاب های بهتری هستن. ولی اگه سایت یا افزونه ای که داری از قبل به moment وابسته ست، لازم نیست حتماً عوضش کنی.
چون آبجکت های moment تغییرپذیرن. add و subtract همون آبجکت رو دستکاری می کنن و کپی جدید نمی سازن. اگه تاریخ اولیه رو لازم داری، قبل از تغییر با clone یه کپی ازش بگیر و روی همون کپی کار کن. اگه یه آبجکت رو بین چند بخش کد پاس بدی، تغییر یه جا همه جا دیده می شه.
وردپرس خودش یه نسخه از moment رو برای بعضی بخش های پیشخوان همراه داره. پس قبل از اضافه کردن فایل جدا، ببین می تونی همون رو به عنوان وابستگی اسکریپتت لود کنی یا نه. این جوری از لود دوباره و تداخل نسخه ها جلوگیری می کنی.
نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.