معرفة التاريخ و الوقت

جافاسكربت توفر النوع Date و الذي يمكن استخدامه للحصول على التاريخ و الوقت الحالي.
هذا النوع يتم التعامل معه و كأنه كلاس عادي و هو يحتوي على الكثير من الدوال الجاهزة التي يمكن استخدامها لتعديل و عرض التاريخ.

في هذا الدرس ستتعلم كيفية الحصول التاريخ و الوقت من خلال النوع Date، و ستتعرف على جميع الدوال الموجودة فيه.

التوقيت المحلي و التوقيت العالمي

التوقيت المحلي ( Local Date ) هو التاريخ و الوقت الذي يظهر في جهاز المستخدم تبعاً للموقع الجغرافي الذي حدده بنفسه أو الذي تم تحديده بشكل تلقائي له نسبةً لموقعه الجغرافي الحالي.

التوقيت العالمي ( Coordinated Universal Time ) هو التاريخ و الوقت الذي يتم تحديده تبعاً لخطوط الطول على الكرة الأرضية. نقطة الصفر في هذا التوقيت هي عند خط الطول الذي تقع فيه بلدة تسمى جرينتش، فمثلاً توقيت نيويورك بالنسبة له يكون UTC-4 مما يعني أنه متأخر عنه 4 ساعات، في حين أن توقيت السعودية بالنسبة له هو UTC+3 مما يعني أنه متقدم عنه 3 ساعات.

عند الحاجة لمعرفة فارق التوقيت بين دولتين نعتمد على التوقيت العالمي، فعلى سبيل المثال عندما تكون الساعة هي 6 مساءاً في السعودية فهذا يعني أن الساعة هي 11 صباحاً في نيويورك.

طريقة إنشاء كائن Date

يمكنك اتباع أي طريقة من الطرق التالية لإنشاء كائن من النوع Date.

new Date()
new Date(milliseconds)
new Date(stringDate)
new Date(year, month)
new Date(year, month, day)
new Date(year, month, day, [hours, minutes, seconds, ms])

• في حال لم تمرر أي قيمة في الكونستركتور فهذا يعني أنه سيتم إنشاء كائن يحتوي على التاريخ و الوقت الحالي.
• مكان البارميتر milliseconds يمكنك تمرير عدد أجزاء الثانية من بعد التاريخ 1/1/1970 مع الإشارة إلى أن كل 1000 يساوي ثانية واحدة.
• مكان البارميتر stringDate يمكنك تمرير التاريخ على شكل نص بشرط أن يكون يتبع أسلوب مقبول بالنسبة للدالة Date.parse().
• مكان البارميتر year يجب تمرير عدد يتكون من 4 أرقام ليمثل رقم السنة التي سيتم إنشاء التاريخ لأجلها.
• مكان البارميتر month يجب تمرير عدد ليمثل رقم الشهر في السنة.
• مكان البارميتر day يجب تمرير عدد ليمثل رقم اليوم بالنسبة للشهر.
• hours هو باراميتر إختياري مكانه يمكن تمرير عدد بين 0 و 23 ليمثل الساعة بنظام 24 ساعة في اليوم.
• minutes هو باراميتر إختياري مكانه يمكن تمرير عدد بين 0 و 59 ليمثل عدد الدقائق في الساعة.
• seconds هو باراميتر إختياري مكانه يمكن تمرير عدد بين 0 و 59 ليمثل عدد الثواني في الدقيقة.
• ms هو باراميتر إختياري مكانه يمكن تمرير عدد يمثل أجزاء الثانية التالية، حيث أن كل 1000 يمثل ثانية إضافية.

في المثال التالي قمنا بإنشاء كائن نوعه Date يمثل التاريخ الحالي.

// يمثل التاريخ و الوقت الحالي date و إسمه Date هنا قمنا بإنشاء كائن نوعه
let date = new Date();

// date هنا قمنا بعرض التاريخ و الوقت الموجود في الكائن
document.write(date);

في المثال التالي قمنا بإنشاء كائن نوعه Date يمثل التاريخ من عام 1970/1/1 مضافاً إليه 5 ثواني.

// يمثل التاريخ و الوقت من عام 1970/1/1 مضافاً إليه 5 ثواني date و إسمه Date هنا قمنا بإنشاء كائن نوعه
let date = new Date(5000);

// date هنا قمنا بعرض التاريخ و الوقت الموجود في الكائن
document.write(date);

في المثال التالي قمنا بإنشاء كائن نوعه Date يمثل التاريخ و الوقت الذي تم تمريره له على شكل نص.

// يمثل التاريخ و الوقت الذي تم تمريره كنص له date و إسمه Date هنا قمنا بإنشاء كائن نوعه
let date = new Date('Thu Feb 03 2020 02:00:05');

// date هنا قمنا بعرض التاريخ و الوقت الموجود في الكائن
document.write(date);

في المثال التالي قمنا بإنشاء كائن نوعه Date يمثل التاريخ و الوقت ابتداءاً من أول شهر مايو في عام 2020.

// يمثل التاريخ و الوقت ابتداءاً من أول شهر مايو في عام 2020 date و إسمه Date هنا قمنا بإنشاء كائن نوعه
let date = new Date(2020, 5);

// date هنا قمنا بعرض التاريخ و الوقت الموجود في الكائن
document.write(date);

في المثال التالي قمنا بإنشاء كائن نوعه Date يمثل التاريخ و الوقت ابتداءاً من اليوم العاشر في شهر مايو من عام 2020.

// يمثل التاريخ و الوقت ابتداءاً من اليوم العاشر في شهر مايو في عام 2020 date و إسمه Date هنا قمنا بإنشاء كائن نوعه
let date = new Date(2020, 5, 10);

// date هنا قمنا بعرض التاريخ و الوقت الموجود في الكائن
document.write(date);

في المثال التالي قمنا بإنشاء كائن نوعه Date مع تحديد الوقت و التاريخ الذي يمثله بالتفصيل حيث أنه يمثل عام 2020، الشهر 5 (أي مايو)، اليوم 10، الساعة 7 صباحاً، الدقيقة 30، الثواني 6 بالإضافة إلى مرور 200 جزء من الثانية القادمة.

// مع تحديد التاريخ و الوقت الذي يمثله بدقة date و إسمه Date هنا قمنا بإنشاء كائن نوعه
let date = new Date(2020, 5, 10, 7, 30, 6, 200);

// date هنا قمنا بعرض التاريخ و الوقت الموجود في الكائن
document.write(date);

دوال التوقيت المحلي و العالمي

دوال النوع Date غالباً يوجد منها نسخة خاصة للتوقيت المحلي و نسخة خاصة للتوقيت العالمي.

الجدول التالي يتضمن جميع الدوال الثابتة في النوع Date.

الجدول التالي يتضمن دوال النوع Date التي يمكن استدعاءها من كائن مشتق منه.