توابع TimeSerial در VBScript
تعریف و نحوه استفاده
توابع TimeSerial می‌تواند ساعت، دقیقه و ثانیه را به یک زمان تبدیل کند.
توضیحات:اگر ساعت، دقیقه یا ثانیه از محدوده مناسب خارج شود، روش محاسبه‌اش مشابه DateSerial است. اگر زمان محاسبه شده کمتر از #00:00:00# باشد، زمان منفی به صورت مثبت تبدیل می‌شود؛ اگر زمان محاسبه شده بزرگتر یا برابر با #24:00:00# باشد، زمان به جلو حرکت می‌کند تا داده‌ای شامل تاریخ و زمان ایجاد شود، که تاریخ اولیه #12/30/1899# است.
نحوه استفاده
TimeSerial(hour,minute,second)
| پارامتر | توضیح |
|---|---|
| hour | ضروری است. عددی بین 0-23 یا عبارت عددی. |
| minute | ضروری است. عددی بین 0-59 یا عبارت عددی. |
| second | ضروری است. عددی بین 0-59 یا عبارت عددی. |
برای مشخص کردن یک لحظه، مانند 11:59:59، باید مقادیر پارامتر TimeSerial در محدوده قابل پذیرش باشند؛ یعنی ساعت باید بین 0-23 و دقیقه و ثانیه باید بین 0-59 باشد. اما می‌توان از یک عبارت عددی برای指定 زمان مطلق برای هر پارامتر استفاده کرد، این عبارت نشان‌دهنده تعداد دقیقه، ثانیه یا لحظاتی است که قبل یا بعد از آن لحظه سپرده است.
وقتی که ارزش هر یک از پارامترها از محدوده قابل پذیرش فراتر رود، آن‌ها به درستی به بزرگترین واحد زمانی بعدی پیشرفت می‌کنند. به عنوان مثال، اگر 75 دقیقه مشخص شده باشد، این زمان به یک ساعت و پانزده دقیقه تبدیل می‌شود. اما اگر هر یک از پارامترها در محدوده -32768 تا 32767 باشد، خطا ایجاد می‌شود. همچنین اگر زمانی که با استفاده از سه پارامتر مستقیم یا با استفاده از عبارت محاسبه شده فراتر از محدوده قابل پذیرش باشد، خطا ایجاد می‌شود.
مثال
مثال 1
document.write(TimeSerial(9,30,50)) 'روش معمول فراخوانی'
خروجی:
9:30:50 یا 9:30:50 AM
مثال 2
document.write(TimeSerial(0,9,11)) 'روش معمول فراخوانی'
خروجی:
0:09:11 یا 12:09:11 AM
مثال 3
document.write(TimeSerial(14+2,9-2,1-1)) 'با توجه به نتایج عبارت عددی زمان را خروجی می‌دهد'
خروجی:
16:07:00 یا 4:07:00 PM
مثال 4
document.write(TimeSerial(26,30,0)) 'تاریخ از #12/30/1899# به بعد یک روز افزایش می‌یابد'
خروجی:
1899-12-31 2:30:00 AM
