زمان خبر در API؛ تبدیل UTC و ساخت بازه روز شمسی
زمان انتشار خبر باید با معنای منطقه زمانی خوانده شود. یک رشته تاریخ بدون این معنا میتواند مبهم باشد. در مستندات khapi، زمان انتشار بر مبنای UTC معرفی شده است.
زمان خام را حفظ کنید
زمان انتشار خبر باید با معنای منطقه زمانی خوانده شود. یک رشته تاریخ بدون این معنا میتواند مبهم باشد. در مستندات khapi، زمان انتشار بر مبنای UTC معرفی شده است. اگر رشته بدون نشان منطقه میآید، این قرارداد را صریح اعمال کنید. زمان خام را برای بازبینی بعدی نگه دارید.
UTC با تاریخ شمسی فرق دارد
UTC مرجع زمان است و شمسی یک تقویم نمایش تاریخ. تبدیل تقویم، جای تبدیل منطقه زمانی را نمیگیرد. ابتدا لحظه را در منطقه موردنظر محاسبه کنید. سپس تاریخ محلی را در تقویم دلخواه نمایش دهید. جابهجایی این ترتیب میتواند روز گزارش را اشتباه کند.
منطقه زمانی نامدار
از کتابخانه معتبر و منطقه زمانی نامدار استفاده کنید. برای تهران، قواعد پایگاه زمانی را مبنا قرار دهید. افزودن دستی عدد ثابت به همه تاریخها راهکار عمومی نیست. داده تاریخی ممکن است تابع قواعد متفاوتی باشد. نسخه وابستگی و داده زمانی در بازتولید گزارش اهمیت دارد.
روز کاری را تعریف کنید
روز گزارش همیشه از نیمهشب تا نیمهشب نیست. شاید بولتن صبح، خبرهای عصر روز قبل را هم بخواهد. ساعت شروع و پایان محلی را پیشاپیش بنویسید. این مرزها را به UTC تبدیل و سپس درخواست کنید. عنوان گزارش باید با بازه واقعی داده سازگار باشد.
مرز شامل و غیرشامل
در اجرای بررسیشده khapi، مرزهای تاریخ بهصورت شامل اعمال میشوند. بازههای مجاور ممکن است رکورد روی مرز را دوباره بدهند. با شناسه خبر، این تکرار را در مصرفکننده کنترل کنید. اگر بازه نیمهباز میخواهید، در لایه خودتان پالایش کنید. قرارداد درخواست را با رفتار جاری مستندات تطبیق دهید.

رشته معتبر بفرستید
تاریخ نامعتبر میتواند نتیجه فیلتر را غیرقابل اعتماد کند. قبل از درخواست، قالب و ترتیب دو مرز را اعتبارسنجی کنید. فرمت شمسی را مستقیم جای ISO میلادی نفرستید. برای khapi از قالب زمانی مستند و مقدار UTC استفاده کنید. پذیرش HTTP بهتنهایی درست بودن بازه را ثابت نمیکند.
زمان دریافت
ساعت دریافت خبر توسط برنامه شما فیلد مستقلی است. تأخیر دریافت از اختلاف آن با انتشار محاسبه میشود. نتیجه منفی میتواند از ساعت اشتباه یا داده مسئلهدار باشد. آن را بیصدا به صفر تبدیل نکنید. رکورد مشکوک باید برای بررسی علامت بخورد.
نمایش به کاربر
منطقه زمانی نمایش را در گزارش مشخص کنید. تاریخ شمسی و ساعت باید از یک لحظه مشترک ساخته شوند. ترتیب مرتبسازی را بر مقدار زمانی نگه دارید. مرتب کردن رشتههای نمایشی ممکن است ترتیب درست را از بین ببرد. برای کاربر چندمنطقهای، انتخاب نمایش باید روشن باشد.
آزمون مرزی
خبر نزدیک نیمهشب را در مجموعه آزمون قرار دهید. پایان ماه و سال را هم بررسی کنید. تاریخ خالی و نامعتبر باید مسیر مشخص داشته باشند. تبدیل رفتوبرگشت نباید لحظه اصلی را تغییر دهد. نتیجه را با نمونه دستی و کتابخانه معتبر تطبیق دهید.
کاربرد در khapi
برای گزارش روزانه، ابتدا مرز محلی را تعیین کنید. پس از تبدیل، from_date و to_date معتبر بفرستید. نتیجه را با چند خبر مرزی بازبینی کنید. تاریخ خام و تاریخ نمایش را کنار هم نگه دارید. این روش اختلاف گزارش میان تیم فنی و تحلیلگر را کاهش میدهد.
منابع و ادامه مطالعه
این مطلب چطور به کار شما بیاید؟
مفاهیم این مقاله را مستقیم در پنل khapi امتحان کنید:
آماده شروع هستید؟
۳ روز استفادهٔ رایگان از پنل تحلیلگر، مطابق محدودیتهای دورهٔ آزمایشی و بدون نیاز به کارت بانکی.