آموزش GETDATE در SQL Server با ۱۰ مثال عملی

آموزش تابع GETDATE در SQL Server؛ دریافت تاریخ و ساعت محلی با مثال عملی

توسط admin | گروه SQL Server | 1405/04/28

نظرات 0

آموزش تابع GETDATE در SQL Server؛ دریافت تاریخ و ساعت محلی با مثال عملی

مقدمه

تابع GETDATE یکی از ابزارهای مهم دسته «دریافت زمان جاری» در Microsoft SQL Server است. تاریخ و ساعت محلی سیستم‌عاملی را که SQL Server روی آن اجرا می‌شود برمی‌گرداند. در سامانه‌های واقعی، یک انتخاب کوچک درباره نوع تاریخ می‌تواند روی صحت گزارش مالی، زمان‌بندی سرویس، مرتب‌سازی رخدادها و امکان استفاده از ایندکس اثر مستقیم بگذارد.

این راهنما از نحو پایه شروع می‌کند و سپس پارامترها، نوع خروجی، دقت، رفتار NULL، حالت‌های مرزی، خطاهای رایج و ملاحظات کارایی GETDATE را با ده Query مستقل توضیح می‌دهد. همه تاریخ‌های ثابت با قالب روشن نوشته شده‌اند تا نتیجه تا حد ممکن از LANGUAGE و DATEFORMAT نشست مستقل باشد.

اگر می‌خواهید جایگاه این تابع را در کنار سایر ابزارهای زمانی ببینید، راهنمای جامع توابع تاریخ و زمان SQL Server را نیز مطالعه کنید.

تعریف و نحو تابع GETDATE

تاریخ و ساعت محلی سیستم‌عاملی را که SQL Server روی آن اجرا می‌شود برمی‌گرداند. این رفتار زمانی قابل اتکا است که برنامه‌نویس نوع ورودی، تقویم مورد استفاده و انتظار خود از دقت را صریح مشخص کند. تقریباً ۳٫۳۳ میلی‌ثانیه دقت ذخیره‌سازی datetime دارد.

Syntax

GETDATE()

پارامترها و نوع خروجی

بخشتوضیح
پارامترهاپارامتر ندارد.
نوع خروجیdatetime
سازگاریهمه نسخه‌های متداول SQL Server
دقت و محدودیتتقریباً ۳٫۳۳ میلی‌ثانیه دقت ذخیره‌سازی datetime دارد.

در زمان درج خروجی GETDATE در جدول، نوع ستون مقصد اهمیت زیادی دارد. تبدیل ضمنی به نوع قدیمی‌تر یا کم‌دقت‌تر می‌تواند کسر ثانیه، Offset یا دامنه تاریخی را تغییر دهد. بهتر است نوع خروجی را با SELECT آزمایش و سپس Schema را قطعی کنید.

مثال‌های عملی

مثال 1: خواندن مستقیم زمان جاری

ساده‌ترین کاربرد GETDATE مشاهده زمان مرجع هنگام اجرای دستور است.

SELECT GETDATE() AS CurrentValue;
خروجینتیجه نمونه یا انتظار
نتیجه مثال 1یک مقدار جاری وابسته به لحظه اجرا

نکته کاربردی: خروجی از ساعت سیستم SQL Server خوانده می‌شود و نوع آن datetime است.

مثال 2: جدا کردن بخش تاریخ

در گزارش روزانه می‌توان بخش تاریخ را از زمان جاری جدا کرد.

SELECT CONVERT(date, GETDATE()) AS TodayDate;
خروجینتیجه نمونه یا انتظار
نتیجه مثال 22026-07-19 در روز تولید مقاله

نکته کاربردی: برای اجرای واقعی مقدار روز جاری سرور نمایش داده می‌شود.

مثال 3: ثبت زمان در جدول موقت

این سناریو روش ثبت زمان ایجاد یک رخداد را بدون ساخت جدول دائمی نشان می‌دهد.

DECLARE @Audit TABLE (Id int, CreatedAt datetime);
INSERT INTO @Audit VALUES (1, GETDATE());
SELECT * FROM @Audit;
خروجینتیجه نمونه یا انتظار
نتیجه مثال 3یک ردیف با Id برابر 1 و زمان درج

نکته کاربردی: نوع ستون را با نوع خروجی تابع هماهنگ کنید تا دقت یا Offset حذف نشود.

مثال 4: استفاده در شرط رویدادهای گذشته

مرز زمانی یک‌بار در متغیر ذخیره می‌شود و سپس در WHERE به کار می‌رود.

DECLARE @Now datetime = GETDATE();
DECLARE @Events TABLE (EventId int, EventDate datetime);
INSERT INTO @Events VALUES (1, DATEADD(day,-1,@Now)),(2,DATEADD(day,1,@Now));
SELECT EventId FROM @Events WHERE EventDate < @Now;
خروجینتیجه نمونه یا انتظار
نتیجه مثال 4EventId = 1

نکته کاربردی: ذخیره مقدار در متغیر از تفاوت جزئی میان چند فراخوانی جلوگیری می‌کند.

مثال 5: ترکیب با DATEADD

برای محاسبه زمان انقضا، یک بازه مشخص به ساعت جاری افزوده می‌شود.

SELECT DATEADD(minute, 90, GETDATE()) AS ExpiresAt;
خروجینتیجه نمونه یا انتظار
نتیجه مثال 5زمان اجرا به علاوه 90 دقیقه

نکته کاربردی: این الگو برای توکن، رزرو و قفل موقت قابل استفاده است.

مثال 6: بررسی رفتار NULL

خود تابع جاری NULL برنمی‌گرداند؛ CASE این ویژگی را به شکل اجرایی نشان می‌دهد.

SELECT CASE WHEN GETDATE() IS NULL THEN 0 ELSE 1 END AS NullCheck;
خروجینتیجه نمونه یا انتظار
نتیجه مثال 6مقدار معتبر یا 1

نکته کاربردی: اگر عبارت بزرگ‌تر NULL شد، منشأ NULL معمولاً تبدیل یا داده جانبی است نه تابع ساعت.

مثال 7: محاسبه مرز آینده

یک مرز زمانی آینده برای زمان‌بندی کارها محاسبه می‌شود.

SELECT DATEDIFF(second, GETDATE(), DATEADD(minute, 1, GETDATE())) AS FutureBoundary;
خروجینتیجه نمونه یا انتظار
نتیجه مثال 7مقدار زمانی آینده

نکته کاربردی: واحد بازه باید با نیاز کسب‌وکار و نوع ستون سازگار باشد.

مثال 8: ساخت کلید گزارش روزانه

خروجی تابع به تاریخ یا بخش دوره تبدیل می‌شود تا گزارش روزانه شکل بگیرد.

SELECT CAST(GETDATE() AS date) AS ReportBucket;
خروجینتیجه نمونه یا انتظار
نتیجه مثال 8یک تاریخ یا مرز زمانی گزارش

نکته کاربردی: برای گروه‌بندی جداول بزرگ بهتر است کلید دوره از قبل ذخیره یا ایندکس شود.

مثال 9: تشخیص روش نادرست و صحیح

این مثال خطای نحوی یا افت دقت رایج را کنار نسخه اصلاح‌شده نشان می‌دهد.

BEGIN TRY
    EXEC sys.sp_executesql N'SELECT GETDATE AS WrongValue;';
END TRY
BEGIN CATCH
    SELECT ERROR_MESSAGE() AS ErrorMessage;
END CATCH;
SELECT GETDATE() AS CorrectValue;
خروجینتیجه نمونه یا انتظار
نتیجه مثال 9پیام خطا یا دو خروجی قابل مقایسه

نکته کاربردی: تقریباً ۳٫۳۳ میلی‌ثانیه دقت ذخیره‌سازی datetime دارد.

مثال 10: فیلتر کارا با مرز ثابت

در جست‌وجوی رخدادهای اخیر، مرز زمانی یک‌بار محاسبه می‌شود تا ستون ایندکس‌شده دست‌نخورده بماند.

DECLARE @Cutoff datetime = DATEADD(day, -30, GETDATE());
DECLARE @Log TABLE (LogId int, LoggedAt datetime, INDEX IX_Log NONCLUSTERED (LoggedAt));
INSERT INTO @Log VALUES (1,DATEADD(day,-40,@Cutoff)),(2,DATEADD(day,5,@Cutoff));
SELECT LogId, LoggedAt FROM @Log WHERE LoggedAt >= @Cutoff;
خروجینتیجه نمونه یا انتظار
نتیجه مثال 10ردیف دوم در محدوده قرار می‌گیرد

نکته کاربردی: در شرط‌های پرتکرار، GETDATE را ابتدا در متغیر قرار دهید تا برآورد کاردینالیتی قابل پیش‌بینی‌تر شود.

خطاهای رایج و روش عیب‌یابی

رایج‌ترین مشکل در GETDATE معمولاً از خود تابع نیست، بلکه از تبدیل ضمنی رشته، دامنه نامعتبر، انتظار نادرست از نوع خروجی یا تنظیمات نشست ایجاد می‌شود. هنگام عیب‌یابی، ابتدا مقدار و نوع هر آرگومان را جداگانه SELECT کنید و سپس فراخوانی نهایی را بسازید.

  • از تاریخ‌های رشته‌ای مبهم مانند 07/08/26 دوری کنید و DATEFROMPARTS یا قالب ISO به کار ببرید.
  • نوع خروجی واقعی datetime را با نوع ستون، متغیر یا پارامتر مقصد مقایسه کنید.
  • رفتار NULL و داده خارج از محدوده را در TRY/CATCH یا مرحله اعتبارسنجی آزمایش کنید.
  • SET LANGUAGE، SET DATEFORMAT و SET DATEFIRST را در محیط توسعه و سرور تولید یکسان فرض نکنید.

برای خطاهای تبدیل، TRY_CONVERT می‌تواند به جای توقف Batch مقدار NULL برگرداند؛ اما نباید بدون ثبت خطا داده نامعتبر را پنهان کرد. در پروژه‌های حساس، مقدار خام، مقدار تبدیل‌شده و علت رد شدن داده را جدا نگه دارید تا مسیر حسابرسی GETDATE قابل پیگیری باشد.

ملاحظات Performance

تابع GETDATE به تنهایی لزوماً پرهزینه نیست، اما اجرای آن برای میلیون‌ها ردیف یا قرار دادن آن روی ستون ایندکس‌شده در Predicate می‌تواند هزینه Query را افزایش دهد. در شرط‌های پرتکرار، GETDATE را ابتدا در متغیر قرار دهید تا برآورد کاردینالیتی قابل پیش‌بینی‌تر شود.

برای سنجش واقعی از Actual Execution Plan، آمار IO و زمان CPU استفاده کنید. اگر یک عبارت زمانی در گزارش‌های متعدد تکرار می‌شود، ستون محاسبه‌شده پایدار، ایندکس مناسب، جدول تقویم یا محاسبه یک‌باره مرزها را ارزیابی کنید. تصمیم باید بر اساس حجم داده و الگوی دسترسی باشد، نه فقط کوتاه بودن Query.

بهترین روش‌ها و کاربرد واقعی

  1. قرارداد روشنی برای UTC، زمان محلی و Offset در کل سامانه تعریف کنید.
  2. نوع date، time، datetime2 یا datetimeoffset را بر اساس نیاز انتخاب کنید و از datetime قدیمی فقط با دلیل سازگاری استفاده کنید.
  3. ورودی‌ها و خروجی GETDATE را با NULL، انتهای ماه، سال کبیسه و مرز روز آزمایش کنید.
  4. در WHERE از بازه نیمه‌باز شامل شروع و غیرشامل پایان استفاده کنید تا کسر ثانیه از قلم نیفتد.
  5. منطق تقویمی و فرض‌های منطقه زمانی را در مستندات Schema و کد ثبت کنید.

در کاربرد واقعی، GETDATE می‌تواند بخشی از گزارش فروش، محاسبه SLA، زمان انقضای دسترسی، ثبت Audit یا پاک‌سازی دوره‌ای باشد. طراحی مناسب باعث می‌شود همان منطق در API، Job و گزارش نتیجه یکسانی تولید کند و اختلاف ساعت سرور یا تبدیل‌های پنهان باعث مغایرت نشود.

سؤالات متداول

تابع GETDATE دقیقاً چه کاری انجام می‌دهد؟

تاریخ و ساعت محلی سیستم‌عاملی را که SQL Server روی آن اجرا می‌شود برمی‌گرداند. مهم است که ورودی‌ها با نوع داده صریح ارسال شوند و خروجی datetime در طراحی ستون مقصد لحاظ شود.

برای شروع کار با GETDATE چه چیزی باید بدانیم؟

ابتدا نحو GETDATE() را یاد بگیرید، سپس با مقدار ISO ثابت آزمایش کنید. بعد از اطمینان از نوع خروجی، آن را وارد Query واقعی کنید.

GETDATE در پروژه‌های تجاری چه کاربردی دارد؟

این تابع در گزارش‌گیری، کنترل مهلت، ثبت رخداد و پاک‌سازی داده‌های زمانی کاربرد دارد. در پروژه سازمانی باید منطقه زمانی، دقت و حجم داده نیز در طراحی بررسی شود.

آیا استفاده از GETDATE هزینه توسعه را کاهش می‌دهد؟

استفاده درست از قابلیت داخلی SQL Server معمولاً کد برنامه را ساده و رفتار را یکپارچه می‌کند. برای Queryهای حساس، بازبینی تخصصی طرح اجرا و ایندکس همچنان ارزشمند است.

تفاوت GETDATE با روش‌های تبدیل دستی چیست؟

تابع داخلی قواعد نوع داده و خطا را شفاف‌تر اعمال می‌کند، در حالی که اتصال رشته یا تبدیل دستی ممکن است به LANGUAGE و DATEFORMAT وابسته شود. انتخاب نهایی به دقت و نسخه SQL Server بستگی دارد.

برای پیاده‌سازی حرفه‌ای GETDATE می‌توان از خدمات مشاوره استفاده کرد؟

بله؛ در مهاجرت داده، طراحی گزارش و بهینه‌سازی Query، بررسی نمونه داده و Execution Plan توسط متخصص SQL Server می‌تواند از خطاهای زمانی پرهزینه جلوگیری کند.

خطای رایج هنگام استفاده از GETDATE چیست؟

ورودی مبهم، نوع مقصد نامتناسب یا عبور از دامنه معتبر از خطاهای رایج است. استفاده از قالب ISO، CAST صریح و تست حالت مرزی راه پیشگیری است.

اثر GETDATE بر Performance چیست؟

محاسبه تابع برای هر ردیف CPU مصرف می‌کند و اگر روی ستون ایندکس‌شده در WHERE قرار گیرد ممکن است Seek را دشوار کند. در شرط‌های پرتکرار، GETDATE را ابتدا در متغیر قرار دهید تا برآورد کاردینالیتی قابل پیش‌بینی‌تر شود.

Best Practice اصلی برای GETDATE چیست؟

نوع داده مناسب، قرارداد ثابت UTC یا زمان محلی، ورودی صریح و تست NULL را مستند کنید. خروجی را قبل از انتشار با داده واقعی و مرزهای تقویمی کنترل کنید.

GETDATE با کدام نسخه‌های SQL Server سازگار است؟

وضعیت سازگاری این تابع: همه نسخه‌های متداول SQL Server. علاوه بر نسخه موتور، Compatibility Level پایگاه داده و نوع مقصد را نیز بررسی کنید.

سؤالات مصاحبه

  1. نوع خروجی GETDATE چیست و تبدیل آن به نوع کم‌دقت‌تر چه اثری دارد؟
  2. رفتار GETDATE با NULL و ورودی خارج از دامنه چگونه است؟
  3. چه زمانی استفاده از GETDATE در WHERE مانع استفاده مؤثر از ایندکس می‌شود؟
  4. برای مستقل کردن نتیجه GETDATE از تنظیمات نشست چه اقداماتی انجام می‌دهید؟
  5. چه تست‌هایی برای مرز ماه، سال کبیسه، UTC و Offset طراحی می‌کنید؟

پاسخ قوی در مصاحبه فقط Syntax را تکرار نمی‌کند؛ باید نوع داده، دقت، حالت مرزی، اثر روی Execution Plan و یک سناریوی واقعی را به هم مرتبط کند. بیان یک نمونه خطا و راه اصلاح آن نشان می‌دهد داوطلب رفتار تابع را در محیط تولید تجربه کرده است.

چک‌لیست نهایی

  • نحو GETDATE() با نوع داده صریح آزمایش شده است.
  • نوع خروجی datetime با ستون مقصد سازگار است.
  • حالت NULL، مرز دامنه و تاریخ کبیسه کنترل شده‌اند.
  • اثر تابع بر Predicate و ایندکس با Execution Plan بررسی شده است.
  • قرارداد UTC، زمان محلی و Offset در مستندات پروژه ثبت شده است.

جمع‌بندی

تابع GETDATE زمانی بیشترین ارزش را دارد که همراه با نوع داده صحیح، ورودی شفاف و تست مرزی استفاده شود. تاریخ و ساعت محلی سیستم‌عاملی را که SQL Server روی آن اجرا می‌شود برمی‌گرداند. ده مثال این مقاله نشان دادند چگونه از کاربرد ساده به گزارش‌گیری و بهینه‌سازی برسیم، بدون آنکه دقت زمانی یا قابلیت استفاده از ایندکس نادیده گرفته شود.

برای مقایسه GETDATE با همه توابع همین گروه، به مقاله مادر توابع تاریخ و زمان SQL Server بازگردید و بر اساس نوع خروجی، دقت و سناریوی پروژه بهترین ابزار را انتخاب کنید.

 

0 نظر

نظر محترم شما در مورد مقاله های وب سایت برنامه نویسی و پایگاه داده

نظرات محترم شما در خدمات رسانی بهتر ما را یاری می نمایند. لطفا اگر مایل بودید یک نظر ما را مهمان فرمائید. آدرس ایمیل و وب سایت شما نمایش داده نخواهد شد.

حرف 500 حداکثر

اطلاعات تماس

  • آدرس:اصفهان-خیابان ام کلثوم غربی - بعد خیابان تخم چی - بیست متر بعد از پیتزا ننه شب - کوچه تعمیر گاه سمار زغالی - پلاک 354 - درب مشکی - طبقه هفتم
  • آدرس ایمیل:najafzade@gmail.com
  • وب سایت:http://www.a00b.com/
  • تلفن ثابت:(+98)9131253620
  • تلفن همراه:09131253620