مدیریت تاریخ و زمان در جاوااسکریپت با کمک Moment.js

Moment.js نام یک کتابخانه‌ی جاوااسکریپت است. این کتابخانه وظیفه‌ی تحلیل، اعتبارسنجی، مدیریت و نمایش تاریخ و زمان در جاوااسکریپت را بر عهده دارد. از ویژگی‌های مهم این کتابخانه، سازگاری با محیط‌های گوناگون از جمله Node.js و همچنین انواع مرورگرهای متداول به شمار می‌رود.

اگرچه شیئ Date در جاوااسکریپت ویژگی‌های متنوعی برای کارکردن با تاریخ و زمان در اختیار برنامه‌نویسان قرار می‌دهد، ولی توسعه‌ی نرم‌افزارهای تحت وب تنها با استفاده از این ویژگی‌ها گاهی مشکل و ناهموار به نظر می‌رسد.

برای استفاده از کتابخانه‌ی Moment.js که از ده‌ها زبان مختلف و همچنین تاریخ هجری شمسی( با استفاده از افزونه‌ی جلالی ) پشتیبانی می‌کند، کافی است فایل اسکریپت آن را دریافت کنید و سپس در سرآمد صفحه‌ی وب خود آن را درج کنید:

<script src="moment.js"></script>

این کتابخانه برای مدیریت تاریخ و زمان از تابع moment استفاده می‌کند. این تابع به عنوان یک سازنده‌ی شیء عمل می‌کند که می‌تواند بدون پارامتر یا با انواع مختلف تاریخ به عنوان ورودی، فراخوانی شود:

var date1 = moment();
var date2 = moment("12-25-1995"); // string
var date3 = moment("12-25-1995", "MM-DD-YYYY"); // string with format
var date4 = moment({hour: 15, minute: 10}); // JSON
var date5 = moment(1318781876406); // Unix timestamp - milliseconds
var date6 = moment.unix(1318781876); // Unix timestamp
var date7 = moment( new Date(2011, 9, 16) ); // JS Date
var date8 = moment([2010, 1, 14, 15, 25, 50, 125]); // February 14th, 3:25:50.125 PM

پس از ایجاد یک شیء moment می‌توان از خدمات گوناگون آن استفاده کرد.

ارزیابی تاریخ

moment.isInvalid();

ذخیره و بازیابی

moment.seconds(30); //set
moment.minutes(20); //set
alert( moment.seconds() ); //get

کتابخانه‌ی moment از فراخوانی زنجیره‌ای همانند jQuery پشتیبانی می‌کند

moment.hours(12).minutes(20).seconds(30);

محاسبات

moment.add(5,'days');
moment.add(25,'seconds');
moment.subtract(2,'months');

نمایش تاریخ و زمان

moment.format('YYYY MM DD');
moment.format('HH:mm:ss');

همان گونه که پیش‌تر گفته شد، کتابخانه‌ی moment با استفاده از افزونه‌ی جلالی از تاریخ‌های هجری خورشیدی نیز پشتیبانی می‌کند.

پرس و جو

moment('2010-10-20').isAfter('2010-10-19'); // true
moment('2010-10-20').isBefore('2010-10-19'); // false

آنچه در مثال‌های بالا معرفی شد، تنها بخش کوچکی از خدمات moment.js به شمار می‌روند. برای آشنایی بیشتر با ویژگی‌ها و توانایی‌های این کتابخانه می‌توانید به بخش مستندات در سایت اصلی مراجعه کنید.