38- دروس جافا سكربت – JS Date Set Methods

### شرح مفصل لـ JS Date Set Methods في لغة JavaScript

تعتبر الكائنات من نوع `Date` في JavaScript أداة قوية للتعامل مع التواريخ والأوقات. واحدة من الميزات الأساسية لكائن `Date` هي القدرة على تعديل أجزاء معينة من التاريخ باستخدام مجموعة من الدوال المعروفة بـ “Set Methods”. سنقوم في هذا المقال بشرح هذه الدوال بشكل مفصل، مع تقديم أمثلة متعددة لكل منها.

#### 1. `setFullYear()`

تستخدم هذه الدالة لتعيين السنة لكائن التاريخ. يمكن استخدامها لتحديث السنة مع إمكانية تحديث الشهر واليوم في الوقت نفسه.

**الصيغة:**

dateObject.setFullYear(year, month, day);

**مثال:**

let date = new Date();
console.log("قبل التغيير: " + date);

date.setFullYear(2025);
console.log("بعد تغيير السنة: " + date);

date.setFullYear(2025, 11, 25);
console.log("بعد تغيير السنة والشهر واليوم: " + date);

#### 2. `setMonth()`

تستخدم لتعيين الشهر في كائن التاريخ. يجب أن نلاحظ أن الأشهر في JavaScript تبدأ من 0 (يناير) إلى 11 (ديسمبر).

**الصيغة:**

dateObject.setMonth(month, day);

**مثال:**

let date = new Date();
console.log("قبل التغيير: " + date);

date.setMonth(0);
console.log("بعد تغيير الشهر إلى يناير: " + date);

date.setMonth(0, 15);
console.log("بعد تغيير الشهر واليوم: " + date);

#### 3. `setDate()`

تستخدم لتعيين اليوم من الشهر في كائن التاريخ.

**الصيغة:**

dateObject.setDate(day);

**مثال:**

let date = new Date();
console.log("قبل التغيير: " + date);

date.setDate(15);
console.log("بعد تغيير اليوم: " + date);

#### 4. `setHours()`

تستخدم لتعيين الساعة لكائن التاريخ.

**الصيغة:**

dateObject.setHours(hours, minutes, seconds, milliseconds);

**مثال:**

let date = new Date();
console.log("قبل  [شركة برمجة مصرية] التغيير: " + date);

date.setHours(20);
console.log("بعد تغيير الساعة: " + date);

date.setHours(20, 30, 45);
console.log("بعد تغيير الساعة والدقائق والثواني: " + date);

#### 5. `setMinutes()`

تستخدم لتعيين الدقائق لكائن التاريخ. [شركة برمجة مصرية]

**الصيغة:**

dateObject.setMinutes(minutes, seconds, milliseconds);

**مثال:**

let date = new Date();
console.log("قبل التغيير: " + date);

date.setMinutes(45);
console.log("بعد تغيير الدقائق: " + date);

date.setMinutes(45, 30);
console.log("بعد تغيير الدقائق والثواني: " + date);

#### 6. `setSeconds()`

تستخدم لتعيين الثواني لكائن التاريخ.

**الصيغة:**

dateObject.setSeconds(seconds, milliseconds);

**مثال:**

let date = new Date();
console.log("قبل التغيير: " + date);

date.setSeconds(30);
console.log("بعد تغيير الثواني: " + date);

date.setSeconds(30, 500);
console.log("بعد تغيير الثواني والملي ثانية: " + date);

#### 7. `setMilliseconds()`

تستخدم لتعيين الملي ثانية لكائن التاريخ.

**الصيغة:**

dateObject.setMilliseconds(milliseconds);

**مثال:**

let date = new Date();
console.log("قبل التغيير: " + date);

date.setMilliseconds(500);
console.log("بعد تغيير الملي ثانية: " + date);

#### 8. `setTime()`

تستخدم لتعيين الوقت (في صورة عدد من الملي ثانية منذ بداية 1 يناير 1970) لكائن التاريخ.

**الصيغة:**

dateObject.setTime(milliseconds);

**مثال:**

let date = new Date();
console.log("قبل التغيير: " + date);

let newTime = Date.now(); // الحصول على الوقت الحالي بالملي ثانية
date.setTime(newTime);
console.log("بعد تغيير الوقت: " + date);

### الخاتمة

تعتبر دوال التعيين (Set Methods) في كائن `Date` أدوات قوية ومرنة تمكنك من تعديل أجزاء محددة من التاريخ والوقت بسهولة. تتيح لك هذه الدوال التحكم الكامل في كيفية عرض ومعالجة البيانات الزمنية في تطبيقات JavaScript الخاصة بك. فهم كيفية استخدام هذه الدوال يمكن أن يكون أساسياً لتطوير تطبيقات تتطلب التعامل مع الوقت بشكل دقيق وفعال.