توابع DatePart در VBScript

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

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

تابع DatePart می‌تواند بخش خاصی از یک تاریخ را بازگرداند.

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

نحوه استفاده

DatePart(interval,date[,firstdayofweek[,firstweekofyear]])
پارامترها توضیح
interval

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

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

  • yyyy - سال
  • q - فصل
  • m - ماه
  • y - روز کدام سال
  • d - روز
  • w - روز کدام هفته
  • ww - هفته
  • h - ساعت
  • n - دقیقه
  • s - ثانیه
date ضروری. عبارت تاریخ که باید محاسبه شود.
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

d = #2/10/96 16:45:30#
document.write(DatePart("yyyy",d)) 'خروجی: 1996
document.write(DatePart("m",d)) 'خروجی: 2
document.write(DatePart("d",d)) 'خروجی: 10
document.write(DatePart("h",d)) 'خروجی: 16
document.write(DatePart("n",d)) 'خروجی: 45
document.write(DatePart("s",d)) 'خروجی: 30
document.write(DatePart("q",d)) 'خروجی: 1، فوریه در فصل اول است
document.write(DatePart("y",d)) 'خروجی: 41، 10 فوریه در سال 1996امروز چهل و یکمین روز است.
document.write(DatePart("ww",d)) 'خروجی: 6، 10 فوریه در سال 1996 در هفته ششم است.
document.write(DatePart("w",d)) 'خروجی: 7، 10 فوریه در سال 1996امروز هفتمین روز از هفته ششم است (جمعه‌ها).

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