---
title: Date.prototype.setDate() | دالة تعيين التاريخ
slug: Web/JavaScript/Reference/Global_Objects/Date/setDate
tags:
  - التاريخ
  - النموذج المبدئي
  - جافاسكربت
  - طريقة
  - مرجع
translation_of: Web/JavaScript/Reference/Global_Objects/Date/setDate
---
<div>{{JSRef}}</div>

<p>دالة setDate() تقوم بتعين يوم من الـ {{jsxref("Date")}} المحدد نسبه إلي الشهر المحدد.</p>

<div>{{EmbedInteractiveExample("pages/js/date-setdate.html")}}</div>



<h2 id="بنية_الجملة">بنية الجملة</h2>

<pre class="syntaxbox"><code><var>dateObj</var>.setDate(</code>dayValue [رقم اليوم]<code>)</code></pre>

<h3 id="المعاملات_(Parameters)">المعاملات (Parameters)</h3>

<dl>
 <dt><code>dayValue</code></dt>
 <dd>يجب أن يكون عدد صحيح يمثل يوم من الشهر. علي سبيل المثال <code>setDate(15)</code> .</dd>
</dl>

<h3 id="القيمة_العائدة">القيمة العائدة</h3>

<p>عدد المللي ثانية بين تاريخ 1 يناير 1970 00:00:00 UTC والتاريخ المحدد (يتغير الـ {{jsxref("Date")}} أيضا بتغير المكان [المنطقة الزمنية]).</p>

<h2 id="الوصف">الوصف</h2>

<p>إذا كان <code>dayValue [رقم اليوم]</code> خارج نطاق قيم الشهر المحدد لهذا التاريخ، فأن دالة <code>setDate()</code> ستقوم بتحديد الـ {{jsxref("Date")}} [اليوم] وفقاً لذلك. علي سبيل المثال، إذا تم تحديد <code>dayValue [رقم اليوم]</code> إلي <code>0</code> فسيتم تعيين التاريخ إلي أخر يوم في الشهر السابق.</p>

<h2 id="أمثلة">أمثلة</h2>

<h3 id="استخدام_setDate()">استخدام <code>setDate()</code></h3>

<pre class="brush: js">var theBigDay = new Date(1962, 6, 7); // 1962-07-07
theBigDay.setDate(24);  // 1962-07-24
theBigDay.setDate(32);  // 1962-08-01
theBigDay.setDate(22);  // 1962-08-22
theBigDay.setDate(0); // 1962-06-30
theBigDay.setDate(98); // 1962-10-06
theBigDay.setDate(-50); // 1962-08-09
</pre>

<h2 id="الخصائص">الخصائص</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('ES1')}}</td>
   <td>{{Spec2('ES1')}}</td>
   <td>Initial definition. Implemented in JavaScript 1.0.</td>
  </tr>
  <tr>
   <td>{{SpecName('ES5.1', '#sec-15.9.5.36', 'Date.prototype.setDate')}}</td>
   <td>{{Spec2('ES5.1')}}</td>
   <td> </td>
  </tr>
  <tr>
   <td>{{SpecName('ES6', '#sec-date.prototype.setdate', 'Date.prototype.setDate')}}</td>
   <td>{{Spec2('ES6')}}</td>
   <td> </td>
  </tr>
  <tr>
   <td>{{SpecName('ESDraft', '#sec-date.prototype.setdate', 'Date.prototype.setDate')}}</td>
   <td>{{Spec2('ESDraft')}}</td>
   <td> </td>
  </tr>
 </tbody>
</table>

<h2 id="دعم_المتصفحات">دعم المتصفحات</h2>

<p class="hidden">The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p>

<p>{{Compat("javascript.builtins.Date.setDate")}}</p>

<h2 id="اقرأ_أيضًا">اقرأ أيضًا</h2>

<ul>
 <li>{{jsxref("Date.prototype.getDate()")}}</li>
 <li>{{jsxref("Date.prototype.setUTCDate()")}}</li>
</ul>