ليست متدهای شی Date

اشيای پيش ساخته در جاوا اسکريپت

متد ( ) setHours :

اين متد برای تغيير دادن مقدار عددی ساعت در يک متغير زمانی استفاده می شود . برای مثال شما می خواهيد که مقدار ساعت در يک متغير زمانی را از 7 به 11 تغيير دهيد .

Syntax DateObject.setHours ( hours , [ minutes ] , [ seconds ] , [ milli ] )
* DateObject = متغير زمانی مورد نظر
* hours = مقدار جديد مورد نظر برای ساعت به صورت عددی بين 0 تا 23 - اجباری
* minutes = مقدار جديد مورد نظر برای دقيقه به صورت عددی بين 0 تا 59 - اختياری
* seconds = مقدار جديد مورد نظر برای ثانيه به صورت عددی بين 0 تا 59 - اختياری
* milli = مقدار جديد مورد نظر برای ميلی ثانيه به صورت عددی بين 0 تا 999 - اختياری

اين متد دارای 1 پارامتر اجباری و 3 پارامتر اختياری است .
عدد اول که توسط خاصيت hours تعيين می شود ، بايد عددی بين 0 تا 23 بوده و تعيين کننده مقدار جديد ساعت در متغير زمانی است . تعيين اين پارامتر اجباری است .
عدد دوم که توسط خاصيت minutes تعيين می شود ، بايد عددی بين 0 تا 59 بوده و تعيين کننده مقدار جديد دقيقه در متغير زمانی است . تعيين اين پارامتر اختياری است .
عدد سوم که توسط خاصيت seconds تعيين می شود ، بايد عددی بين 0 تا 59 بوده و تعيين کننده مقدار جديد ثانيه در متغير زمانی است . تعيين اين پارامتر اختياری است .
عدد چهارم که توسط خاصيت hours تعيين می شود ، بايد عددی بين 0 تا 999 بوده و تعيين کننده مقدار جديد ميلی ثانيه در متغير زمانی است . تعيين اين پارامتر اختياری است .

مثال : در مثال زير ابتدا متغير زمانی MyTime مقدار دهی شده است . سپس توسط متد setHours و تعيين هر 4 پارامتر لازم مقدار ساعت ، دقيقه ، ثانيه و میلی ثانيه آن به مقادير مورد نظر تغيير يافته و سپس مقدار جديد در خروجی نمايش داده شده است :

Example
<script type ="text/javascript">
  var MyTime = new Date ( "June 22 2003" ) ;
  MyTime.setHours ( 11 , 23 , 4 , 240 ) ;
  document.write ( MyTime ) ;
</script> 		کد
خروجی

متد ( ) setMinutes :

اين متد برای تغيير دادن مقدار عددی دقيقه در يک متغير زمانی استفاده می شود . برای مثال شما می خواهيد که مقدار دقيقه در يک متغير زمانی را از 23 به 34 تغيير دهيد .

Syntax DateObject.setMinutes ( minutes , [ seconds ] , [ milli ] )
* DateObject = متغير زمانی مورد نظر
* minutes = مقدار جديد مورد نظر برای دقيقه به صورت عددی بين 0 تا 59 - اجباری
* seconds = مقدار جديد مورد نظر برای ثانيه به صورت عددی بين 0 تا 59 - اختياری
* milli = مقدار جديد مورد نظر برای ميلی ثانيه به صورت عددی بين 0 تا 999 - اختياری

اين متد دارای 1 پارامتر اجباری و 2 پارامتر اختياری است .
عدد اول که توسط خاصيت minutes تعيين می شود ، بايد عددی بين 0 تا 59 بوده و تعيين کننده مقدار جديد دقيقه در متغير زمانی است . تعيين اين پارامتر اجباری است .
عدد دوم که توسط خاصيت seconds تعيين می شود ، بايد عددی بين 0 تا 59 بوده و تعيين کننده مقدار جديد ثانيه در متغير زمانی است . تعيين اين پارامتر اختياری است .
عدد سوم که توسط خاصيت hours تعيين می شود ، بايد عددی بين 0 تا 999 بوده و تعيين کننده مقدار جديد ميلی ثانيه در متغير زمانی است . تعيين اين پارامتر اختياری است .

مثال : در مثال زير ابتدا متغير زمانی MyTime مقدار دهی شده است . سپس توسط متد setMinutes و تعيين هر 3 پارامتر لازم مقدار دقيقه ، ثانيه و میلی ثانيه آن به مقادير مورد نظر تغيير يافته و سپس مقدار جديد در خروجی نمايش داده شده است :

Example
<script type ="text/javascript">
  var MyTime = new Date ( "June 22 2003 , 12 : 17 : 13 " ) ;
  MyTime.setMinutes ( 23 , 4 , 240 ) ;
  document.write ( MyTime ) ;
  document.write ( " And Milliseconds is : " +   MyTime.getMilliseconds ( ) ) ;
</script> 		کد
خروجی

متد ( ) setSeconds :

اين متد برای تغيير دادن مقدار عددی ثانيه در يک متغير زمانی استفاده می شود . برای مثال شما می خواهيد که مقدار ثانيه در يک متغير زمانی را از 53 به 21 تغيير دهيد .

Syntax DateObject.setSeconds ( seconds , [ milli ] )
* DateObject = متغير زمانی مورد نظر
* seconds = مقدار جديد مورد نظر برای ثانيه به صورت عددی بين 0 تا 59 - اجباری
* milli = مقدار جديد مورد نظر برای ميلی ثانيه به صورت عددی بين 0 تا 999 - اختياری

اين متد دارای 1 پارامتر اجباری و 1 پارامتر اختياری است .
عدد اول که توسط خاصيت seconds تعيين می شود ، بايد عددی بين 0 تا 59 بوده و تعيين کننده مقدار جديد ثانيه در متغير زمانی است . تعيين اين پارامتر اجباری است .
عدد دوم که توسط خاصيت milli تعيين می شود ، بايد عددی بين 0 تا 999 بوده و تعيين کننده مقدار جديد ميلی ثانيه در متغير زمانی است . تعيين اين پارامتر اختياری است .

مثال : در مثال زير ابتدا متغير زمانی MyTime مقدار دهی شده است . سپس توسط متد setSeconds و تعيين هر 2 پارامتر ممکن مقدار ، ثانيه و میلی ثانيه آن به مقادير مورد نظر تغيير يافته و سپس مقدار جديد در خروجی نمايش داده شده است :

Example
<script type ="text/javascript">
  var MyTime = new Date ( "June 22 2003 , 12 : 17 : 13 " ) ;
  MyTime.setSeconds ( 4 , 240 ) ;
  document.write ( MyTime ) ;
  document.write ( " And Milliseconds is : " +   MyTime.getMilliseconds ( ) ) ;
</script> 		کد
خروجی

متد ( ) setMilliseconds :

اين متد برای تغيير دادن مقدار عددی ميلی ثانيه در يک متغير زمانی استفاده می شود . برای مثال شما می خواهيد که مقدار ميلی ثانيه در يک متغير زمانی را از 530 به 210 تغيير دهيد .

Syntax DateObject.setMilliseconds ( milli )
* DateObject = متغير زمانی مورد نظر
* milli = مقدار جديد مورد نظر برای ميلی ثانيه به صورت عددی بين 0 تا 999 - اجباری

اين متد فقط دارای 1 پارامتر اجباری است .
تنها پارامتر اين متد که توسط خاصيت milli تعيين می شود ، بايد عددی بين 0 تا 999 بوده و تعيين کننده مقدار جديد ميلی ثانيه در متغير زمانی است . تعيين اين پارامتر اجباری است .

مثال : در مثال زير ابتدا متغير زمانی MyTime مقدار دهی شده است . سپس توسط متد setMilliseconds و تعيين پارامتر لازم مقدار میلی ثانيه آن به مقدار مورد نظر تغيير يافته و سپس مقدار جديد در خروجی نمايش داده شده است :

Example
<script type ="text/javascript">
  var MyTime = new Date ( "June 22 2003 , 12 : 17 : 13 " ) ;
  MyTime.setMilliseconds ( 240 ) ;
  document.write ( " And Milliseconds is : " +   MyTime.getMilliseconds ( ) ) ;
</script> 		کد
خروجی

متد ( ) setTime :

از اين متد برای محاسبه و ايجاد يک تاريخ و زمان جديد ، به وسيله اضافه يا کم کردن تعداد معينی ميلی ثانيه به تاريخ اول ژانويه ( January ) سال 1970 استفاده می شود .

Syntax DateObject.setTime ( milli )
* DateObject = متغير زمانی مورد نظر
* milli = تعداد ميلی ثانيه های مورد نظر که قرار است به تاريخ متغير اضافه يا کم شود - اجباری

اين متد فقط دارای 1 پارامتر اجباری است .
اين متد يک عدد را توسط خاصيت milli دريافت می کند . در صورتی که عدد وارد شده مثبت باشد ، به تعداد آن ، ميلی ثانيه به تاريخ اول ژانويه سال 1970 اضافه شده و تاريخ جديد محاسبه و ايجاد می شود . در صورتی که عدد وارد شده منفی باشد ، به آن تعداد ميلی ثانيه از تاريخ اول ژانويه سال 1970 کم شده و تاريخ جديد محاسبه و ايجاد می شود .

مثال : در مثال زير توسط متد setTime به متغير MyTime به تعداد مورد نظر ( با وارد کردن يک عدد مثبت ) ميلی ثانيه اضافه کرده ايم و سپس تاريخ جديد به وجود آمده را در خروجی نمايش داده ايم :

Example
<script type ="text/javascript">
  var MyTime = new Date ( ) ;
  MyTime.setTime ( 344499827000 ) ;
  document.write (  MyTime ) ;
</script> 		کد
خروجی

مثال : در مثال زير کاربرد عدد منفی در متد setTime نمايش داده شده است . در اين مثال توسط متد setTime از متغير MyTime به تعداد مورد نظر ( با وارد کردن يک عدد منفی ) ميلی ثانيه کم کرده و سپس تاريخ جديد به وجود آمده را در خروجی نمايش داده ايم :

Example
<script type ="text/javascript">
  var MyTime = new Date ( ) ;
  MyTime.setTime ( - 344499827000 ) ;
  document.write (  MyTime ) ;
</script> 		کد
خروجی

متد ( ) tostring :

اين متد يک متغير زمانی ( Date ) را دريافت کرده و آن را به يک متغير رشته ای ( متنی ) تبديل می کند . سپس می توان از آن به صورت يک عبارت رشته ای استفاده کرد .

Syntax DateObject.tostring ( )
* DateObject = متغير زمانی مورد نظر

اين متد دارای پارامتر نيست .

مثال : در مثال زير ابتدا متغير زمانی MyTime را مقدار دهی کرده و سپس توشط متد tostring آن را به يک عبارت رشته ای تبديل و در متغير Str ذخيره کرده ايم . سپس آن را در خروجی نمايش داده ايم :

Example
<script type ="text/javascript">
  var MyTime = new Date ( ) ;
  var Str = MyTime.toString ( ) ;
  document.write (  Str.bold ( ) ) ;
</script> 		کد
خروجی