النطاقات الزمنية
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح لك "لغة طلب البحث في إعلانات Google" تحديد النطاق الزمني بالطرق التالية:
نطاق زمني مخصص
يمكنك تحديد التواريخ بالتنسيق الموسّع ISO 8601 (YYYY-MM-DD) أو التنسيق الأساسي (YYYYMMDD)، على سبيل المثال:
segments.date BETWEEN '2024-01-01' AND '2024-01-31'
segments.date >= '20241001' AND segments.date <= '20241031'
نطاق زمني محدّد مسبقًا
في ما يلي قائمة بالنطاقات الزمنية الصالحة المحدّدة مسبقًا:
| النطاق الزمني |
يتم إنشاء التقارير لما يلي: |
TODAY |
اليوم فقط |
YESTERDAY |
الأمس فقط |
LAST_7_DAYS |
آخر 7 أيام باستثناء اليوم |
LAST_BUSINESS_WEEK
|
أسبوع العمل المكوّن من 5 أيام، من الاثنين إلى الجمعة، في أسبوع العمل السابق |
THIS_MONTH |
جميع الأيام في الشهر الحالي |
LAST_MONTH |
جميع الأيام في الشهر السابق |
LAST_14_DAYS |
آخر 14 يومًا باستثناء اليوم |
LAST_30_DAYS |
آخر 30 يومًا باستثناء اليوم |
THIS_WEEK_SUN_TODAY
|
الفترة بين الأحد السابق واليوم الحالي |
THIS_WEEK_MON_TODAY
|
الفترة بين يوم الاثنين السابق واليوم الحالي |
LAST_WEEK_SUN_SAT |
الفترة التي تبلغ 7 أيام وتبدأ بيوم الأحد السابق |
LAST_WEEK_MON_SUN |
الفترة التي تبلغ 7 أيام وتبدأ يوم الاثنين السابق |
مثال:
segments.date DURING LAST_30_DAYS
فترة زمنية محدّدة مسبقًا
تشير بعض حقول التاريخ إلى فترة زمنية محدّدة مسبقًا، وتحديدًا:
segments.weeksegments.monthsegments.quarter
عند الفلترة حسب هذه الشرائح، يمكنك استخدام عامل التشغيل = مع التاريخ الذي يمثّل اليوم الأول من الفترة الزمنية. إذا حدّدت تاريخًا لا يمثّل اليوم الأول من الفترة، سيتم عرض الخطأ MISALIGNED_DATE_FOR_FILTER.
على سبيل المثال، لتحديد شهر مايو في عام 2024، استخدِم الشرط التالي، مع تحديد اليوم الأول من ذلك الشهر:
segments.month = '2024-05-01'
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eGoogle Ads Query Language allows you to specify date ranges using custom dates, predefined date ranges like \u003ccode\u003eTODAY\u003c/code\u003e or \u003ccode\u003eLAST_30_DAYS\u003c/code\u003e, and predefined time periods for week, month, or quarter.\u003c/p\u003e\n"],["\u003cp\u003eCustom date ranges can be defined using ISO 8601 format, either extended (\u003ccode\u003eYYYY-MM-DD\u003c/code\u003e) or basic (\u003ccode\u003eYYYYMMDD\u003c/code\u003e), within a \u003ccode\u003eBETWEEN\u003c/code\u003e or \u003ccode\u003e>=\u003c/code\u003e and \u003ccode\u003e<=\u003c/code\u003e clause.\u003c/p\u003e\n"],["\u003cp\u003ePredefined date ranges provide shortcuts for common timeframes, such as \u003ccode\u003eLAST_BUSINESS_WEEK\u003c/code\u003e or \u003ccode\u003eTHIS_MONTH\u003c/code\u003e, simplifying date selection in queries.\u003c/p\u003e\n"],["\u003cp\u003eWhen filtering by predefined time periods (week, month, quarter), use the \u003ccode\u003e=\u003c/code\u003e operator with the first day of the period to avoid errors.\u003c/p\u003e\n"]]],[],null,["# Date Ranges\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nThe Google Ads Query Language lets you specify the date range in these ways:\n\n- [Custom date range](#custom)\n- [Predefined date range](#date-range)\n- [Predefined time period](#time-period)\n\nCustom date range\n-----------------\n\nYou can specify dates in [ISO 8601](//en.wikipedia.org/wiki/ISO_8601) extended\n(`YYYY-MM-DD`) or basic (`YYYYMMDD`) format, for example: \n\n segments.date BETWEEN '2024-01-01' AND '2024-01-31'\n\n segments.date \u003e= '20241001' AND segments.date \u003c= '20241031'\n\nPredefined date range\n---------------------\n\nThe list of valid predefined date ranges is as follows:\n\n| Date range | Reports are generated for... |\n|-----------------------|--------------------------------------------------------------------------------|\n| `TODAY` | Today only. |\n| `YESTERDAY` | Yesterday only. |\n| `LAST_7_DAYS` | The last 7 days not including today. |\n| `LAST_BUSINESS_WEEK` | The 5 day business week, Monday through Friday, of the previous business week. |\n| `THIS_MONTH` | All days in the current month. |\n| `LAST_MONTH` | All days in the previous month. |\n| `LAST_14_DAYS` | The last 14 days not including today. |\n| `LAST_30_DAYS` | The last 30 days not including today. |\n| `THIS_WEEK_SUN_TODAY` | The period between the previous Sunday and the current day. |\n| `THIS_WEEK_MON_TODAY` | The period between the previous Monday and the current day. |\n| `LAST_WEEK_SUN_SAT` | The 7-day period starting with the previous Sunday. |\n| `LAST_WEEK_MON_SUN` | The 7-day period starting with the previous Monday. |\n\nExample: \n\n segments.date DURING LAST_30_DAYS\n\nPredefined time period\n----------------------\n\nSome date fields refer to a predefined period of time, specifically:\n\n- `segments.week`\n- `segments.month`\n- `segments.quarter`\n\nWhen filtering on these segments, you can use the `=` operator with the date\nthat is the first day of the time period. If you specify a date that isn't the\nfirst day of a period, a `MISALIGNED_DATE_FOR_FILTER` error is returned.\n\nFor example, to specify the month of May in the year 2024, use the\nfollowing condition, specifying the first day of that month: \n\n segments.month = '2024-05-01'"]]
