النطاقات الزمنية النسبية
تحتوي طلبات البحث في التقارير على الحقل date_range
لتحديد التواريخ التي يجب تضمين البيانات فيها
في التقرير. يمكن تحديد القيم التالية لـ date_range
:
TODAY
YESTERDAY
MONTH_TO_DATE
YEAR_TO_DATE
LAST_7_DAYS
LAST_30_DAYS
CUSTOM
ويُرجى العلم بأنّ النطاق الزمني التلقائي في حال عدم تحديد قيمة هو CUSTOM
.
النطاقات الزمنية المخصّصة
عند ضبط السمة date_range
على CUSTOM
أو عدم تحديدها، يجب ضبط start_date
وend_date
على تاريخَي البدء والانتهاء (الشاملَين) لنطاق التقرير.
في مَعلمات طلب البحث لطلب واجهة برمجة التطبيقات، ستظهر مَعلمات تاريخ البدء على النحو التالي:
startDate.year=2021&startDate.month=3&startDate.day=1
وبالمثل، ستبدو معلمات تاريخ الانتهاء على النحو التالي:
endDate.year=2021&endDate.month=3&endDate.day=3