محدوده تاریخ

«زبان پُرسمان Google Ads» به شما امکان می‌دهد محدوده تاریخ را به این روش‌ها مشخص کنید:

محدوده تاریخ سفارشی

می‌توانید تاریخ‌ها را در قالب گسترده (YYYY-MM-DD) یا پایه (YYYYMMDD) ISO 8601 مشخص کنید. قالب گسترده (YYYY-MM-DD) برای خوانش‌پذیری توصیه می‌شود. از BETWEEN یا عملگرهای مقایسه (=، >، >=، <، <=) با رشته‌های تاریخ سفارشی استفاده کنید:

segments.date BETWEEN '2026-01-01' AND '2026-01-31'

segments.date >= '20260701' AND segments.date <= '20260731'

محدوده تاریخ ازپیش تعریف‌شده

از اپراتور DURING با حروف محدوده تاریخ ازپیش‌تعریف‌شده استفاده کنید. کاربر DURING فقط از محدوده‌های تاریخ ازپیش‌تعریف‌شده پشتیبانی می‌کند و نمی‌تواند با رشته‌های تاریخ سفارشی استفاده شود.

فهرست محدوده‌های تاریخ ازپیش تعریف‌شده معتبر به‌شرح زیر است:

محدوده تاریخ گزارش‌ها برای موارد زیر تولید می‌شود…
TODAY فقط امروز.
YESTERDAY فقط دیروز.
LAST_7_DAYS ‫۷ روز گذشته، بدون احتساب امروز.
LAST_BUSINESS_WEEK هفته کاری ۵ روزه، دوشنبه تا جمعه، از هفته کاری گذشته.
THIS_MONTH همه روزهای ماه جاری.
LAST_MONTH همه روزهای ماه گذشته.
LAST_14_DAYS ‫۱۴ روز گذشته به‌جز امروز.
LAST_30_DAYS ‫۳۰ روز گذشته به‌جز امروز.
THIS_WEEK_SUN_TODAY دوره بین یکشنبه قبلی و روز جاری.
THIS_WEEK_MON_TODAY دوره بین دوشنبه گذشته و روز جاری.
LAST_WEEK_SUN_SAT دوره ۷ روزه‌ای که از یکشنبه گذشته شروع می‌شود.
LAST_WEEK_MON_SUN دوره ۷ روزه که از دوشنبه قبلی شروع می‌شود.

مثال:

segments.date DURING LAST_30_DAYS

دوره زمانی ازپیش تعریف‌شده

برخی‌از فیلدهای تاریخ به دوره زمانی ازپیش تعریف‌شده‌ای اشاره دارند، به‌ویژه:

  • segments.week
  • segments.month
  • segments.quarter

هنگام فیلتر کردن این بخش‌ها با رشته‌های تاریخ سفارشی (بااستفاده از =، BETWEEN، >=، <=، >، یا <)، باید تاریخی را مشخص کنید که اولین روز دوره زمانی باشد:

  • ‫segments.week: دوشنبه هفته (برای مثال، '2026-05-04').
  • segments.month: اولین روز ماه (YYYY-MM-01، برای مثال، '2026-05-01').
  • segments.quarter: اولین روز سه‌ماهه تقویم (YYYY-01-01، YYYY-04-01، YYYY-07-01، یا YYYY-10-01).

اگر تاریخی را مشخص کنید که اولین روز دوره نباشد، خطای QueryError.MISALIGNED_DATE_FOR_FILTER برگردانده می‌شود. همچنین می‌توانید این بخش‌ها را بااستفاده از عملگر DURING با محدوده تاریخ ازپیش تعریف‌شده فیلتر کنید.

برای مثال، برای مشخص کردن ماه مه در سال ۲۰۲۶، از شرط زیر استفاده کنید و اولین روز آن ماه را مشخص کنید:

segments.month = '2026-05-01'

محدودیت‌های بازنگری تاریخی

دردسترس بودن داده‌های گزارش‌دهی تاریخی به جزئیات بخش‌های تاریخ انتخاب‌شده یا فیلترشده بستگی دارد:

  • جزئیات روزانه، هفتگی، و ساعتی (segments.date، segments.week، و segments.hour): از پنجره بازگشتی تا ۳۷ ماه پشتیبانی می‌کند. پُرسمان‌هایی که براساس segments.date، segments.week، یا segments.hour (یا براساس محدوده تاریخ زیرماهانه فیلتر می‌کنند) برای تاریخ‌های فراتر از بازه ۳۷ ماهه در نسخه ۲۴ و نسخه‌های جدیدتر (یا DateRangeError.UNKNOWN در نسخه ۲۳) با DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED ناموفق هستند.
  • جزئیات ماهانه، فصلی، سالانه، یا بخش‌بندی‌نشده (segments.month، segments.quarter، segments.year، یا بدون بخش تاریخ): تا ۱۱ سال داده‌های سابقه را پشتیبانی می‌کند. برای پُرسمان کردن داده‌های تاریخی فراتر از پنجره ۳۷ ماهه، براساس segments.month، segments.quarter، segments.year بخش‌بندی کنید، یا بخش‌های تاریخ را در SELECT حذف کنید، و مطمئن شوید که محدوده تاریخ WHERE از اولین روز ماه شروع می‌شود و در آخرین روز ماه پایان می‌یابد (یا براساس segments.month، segments.quarter، یا segments.year فیلتر کنید).
قبلی
ساختار پُرسمان
بعدی
حروف‌حساس