پیشنهاد درس:

دستورالعمل‌های مرجع توابع VBScript

توابع DateDiff VBScript

تعریف و استفاده

DateDiff تابعی است که می‌تواند تعداد اختلاف بین دو تاریخ را بازگرداند.

DateDiff تابعی است که اختلاف بین دو تاریخ و زمان را محاسبه می‌کند، روش محاسبه date2 - date1 است.

نکته: اگر سال‌ها را مقایسه کنید، بی‌توجه به مقادیر ماه‌ها و روزها، اگر ماه‌ها را مقایسه کنید، بی‌توجه به مقادیر روزها و ... به همین ترتیب.پارامتر firstdayofweek بر روی محاسبات استفاده از علامت‌های اختلاف زمانی "w" و "ww" تأثیر می‌گذارد.

نحوه استفاده

DateDiff(interval,date1,date2[,firstdayofweek[,firstweekofyear]])
پارامترها توضیح
interval

ضروری. واحد زمانی برای محاسبه اختلاف بین date1 و date2.

ممکن است از زیرین مقادیر استفاده شود:

  • yyyy - سال
  • q - فصل
  • m - ماه
  • y - روز کدام سال
  • d - روز
  • w - روز کدام هفته
  • ww - هفته
  • h - ساعت
  • n - دقیقه
  • s - ثانیه
date1,date2 ضروری. عبارت تاریخ. دو تاریخ که در محاسبات استفاده می‌شوند.
firstdayofweek

اختیاری. تعداد روزهای هفته را تعیین می‌کند، یعنی روز کدام هفته است.

ممکن است از زیرین مقادیر استفاده شود:

  • 0 = vbUseSystemDayOfWeek - از تنظیمات API پشتیبانی از زبان محلی (NLS) استفاده می‌شود.
  • 1 = vbSunday - یکشنبه (پیش‌فرض)
  • 2 = vbMonday - یکشنبه
  • 3 = vbTuesday - دوشنبه
  • 4 = vbWednesday - سه‌شنبه
  • 5 = vbThursday - پنج‌شنبه
  • 6 = vbFriday - جمعه
  • 7 = vbSaturday - جمعه
firstweekofyear

اختیاری. هفته اول سال را تعیین می‌کند.

ممکن است از زیرین مقادیر استفاده شود:

  • 0 = vbUseSystem - از API پشتیبانی از زبان محلی (NLS) استفاده می‌شود.
  • 1 = vbFirstJan1 - از هفته‌ای که اول ژانویه در آن قرار دارد شروع می‌شود (پیش‌فرض).
  • 2 = vbFirstFourDays - از اولین هفته‌ای که حداقل چهار روز در سال جدید دارد شروع می‌شود.
  • 3 = vbFirstFullWeek - از اولین هفته کامل در سال جدید شروع می‌شود.

مثال

مثال 1

document.write(Date & "<br />")
document.write(DateDiff("m",Date,"12/31/2002") & "<br />")
document.write(DateDiff("d",Date,"12/31/2002") & "<br />")
document.write(DateDiff("n",Date,"12/31/2002"))

خروجی:

1/14/2002
11
351
505440

مثال 2

لطفاً توجه داشته باشید که در کد زیر، date1>date2:

document.write(Date & "<br />")
document.write(DateDiff("d","12/31/2002",Date))

خروجی:

1/14/2002
-351

مثال 3

چند هفته (از دوشنبه شروع می‌شود),
باقی‌مانده بین تاریخ فعلی و 10/10/2002
document.write(Date & "<br />")
document.write(DateDiff("w",Date,"10/10/2002",vbMonday))

خروجی:

1/14/2002
38

دستورالعمل‌های مرجع توابع VBScript