ADDTIME (ADDTIME)
تابع ADDTIME در MySQL به یک زمان یا تاریخ زمان، یک بازه زمانی اضافه می کند. سپس همان نوع را برمی گرداند. «بازه زمانی (Time Interval)» یعنی مقدار قابل جمع مثل ثانیه یا ساعت. مقدار می تواند مثبت یا منفی باشد.
تعریف و کاربرد تابع ADDTIME
تابع ADDTIME به زمان/تاریخ زمان (Time/Datetime) یک بازه اضافه می کند. خروجی همان زمان یا تاریخ زمان به روزشده است. این قابلیت از MySQL 4.0 در دسترس است.
سینتکس (Syntax)
ساختار کلی تابع به این صورت است:
ADDTIME(datetime, addtime);
مثال های عملی
1) افزودن 2 ثانیه به یک تاریخ زمان
برای تأخیر کوتاه در رویداد بعدی، دو ثانیه اضافه کن.
SELECT ADDTIME("2017-06-15 09:34:21", "2");
2) افزودن 5 ثانیه و 3 میکروثانیه
برای دقت خیلی بالا، از جزء میکروثانیه هم استفاده کن.
SELECT ADDTIME("2017-06-15 09:34:21.000001", "5.000003");
3) افزودن ساعت:دقیقه:ثانیه.میکروثانیه
قالب ترکیبی نیز پشتیبانی می شود. ترتیب را دقیق بنویس.
SELECT ADDTIME("2017-06-15 09:34:21.000001", "2:10:5.000003");
4) افزودن 5 روز به همراه زمان
می توان روز را هم قبل از زمان آورد. نتیجه تاریخ زمان است.
SELECT ADDTIME("2017-06-15 09:34:21.000001", "5 2:10:5.000003");
5) ورودی از نوع TIME و خروجی TIME
اگر ورودی زمان خالص باشد، خروجی هم زمان خواهد بود.
SELECT ADDTIME("09:34:21.000001", "2:10:5.000003");
گام های سریع استفاده
- نوع ورودی را مشخص کن؛ TIME یا DATETIME.
- بازه را با قالب درست بنویس.
- از مقدار منفی برای کم کردن استفاده کن.
- کویری را اجرا کن و نتیجه را بررسی کن.
نکته: مقدار addtime می تواند مثبت یا منفی باشد. دقت میکروثانیه نیز پشتیبانی می شود.
پیوندهای داخلی پیشنهادی
- تابع ADDTIME در MySQL مرجع همین صفحه.
- تابع ADDDATE برای افزودن بازه به تاریخ.
جمع بندی سریع
- ADDTIME بازه را به زمان اضافه می کند.
- ورودی TIME یا DATETIME پذیرفته می شود.
- مقادیر مثبت و منفی قابل استفاده اند.
- قالب های ثانیه و میکروثانیه پشتیبانی می شوند.