> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-parallel-read-in-order-multi-part.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> توثيق نوع البيانات الخاص Interval

# Interval

مجموعة أنواع البيانات التي تمثل الفواصل الزمنية للتاريخ والوقت. وهي الأنواع الناتجة عن العامل [INTERVAL](/ar/reference/operators/index#interval).

البنية:

* فاصل زمني ممثل بقيمة عدد صحيح غير موقّع.
* نوع الفاصل الزمني.

أنواع الفواصل الزمنية المدعومة:

* `NANOSECOND`
* `MICROSECOND`
* `MILLISECOND`
* `SECOND`
* `MINUTE`
* `HOUR`
* `DAY`
* `WEEK`
* `MONTH`
* `QUARTER`
* `YEAR`

لكل نوع من أنواع الفواصل الزمنية نوع بيانات منفصل. على سبيل المثال، يقابل الفاصل الزمني `DAY` نوع البيانات `IntervalDay`:

```sql theme={null}
SELECT toTypeName(INTERVAL 4 DAY)
```

```text theme={null}
┌─toTypeName(toIntervalDay(4))─┐
│ IntervalDay                  │
└──────────────────────────────┘
```

<h2 id="usage-remarks">
  ملاحظات حول الاستخدام
</h2>

يمكنك استخدام القيم من النوع `Interval` في العمليات الحسابية مع القيم من النوع [Date](/ar/reference/data-types/date) و[DateTime](/ar/reference/data-types/datetime). على سبيل المثال، يمكنك إضافة 4 أيام إلى الوقت الحالي:

```sql theme={null}
SELECT now() AS current_date_time, current_date_time + INTERVAL 4 DAY
```

```text theme={null}
┌───current_date_time─┬─plus(now(), toIntervalDay(4))─┐
│ 2019-10-23 10:58:45 │           2019-10-27 10:58:45 │
└─────────────────────┴───────────────────────────────┘
```

كما يمكن أيضًا استخدام عدة فواصل زمنية في الوقت نفسه:

```sql theme={null}
SELECT now() AS current_date_time, current_date_time + (INTERVAL 4 DAY + INTERVAL 3 HOUR)
```

```text theme={null}
┌───current_date_time─┬─plus(current_date_time, plus(toIntervalDay(4), toIntervalHour(3)))─┐
│ 2024-08-08 18:31:39 │                                                2024-08-12 21:31:39 │
└─────────────────────┴────────────────────────────────────────────────────────────────────┘
```

ولمقارنة القيم ذات الفواصل الزمنية المختلفة:

```sql theme={null}
SELECT toIntervalMicrosecond(179999999) < toIntervalMinute(3);
```

```text theme={null}
┌─less(toIntervalMicrosecond(179999999), toIntervalMinute(3))─┐
│                                                           1 │
└─────────────────────────────────────────────────────────────┘
```

```sql theme={null}
SELECT toIntervalMicrosecond(3600000000) = toIntervalHour(1);
```

```text theme={null}
┌─equals(toIntervalMicrosecond(3600000000), toIntervalHour(1))─┐
│                                                            1 │
└──────────────────────────────────────────────────────────────┘
```

<h2 id="aggregation">
  التجميع
</h2>

عند تطبيق الدوال `sum` و`avg` و`min` و`max` و`any` على column من النوع `Interval`، فإنها تُرجع فاصلًا زمنيًا من النوع نفسه.
تجمع `sum` عدد الوحدات، بينما تحسب `avg` متوسطها وتقرّب النتيجة إلى عدد صحيح
من الوحدات:

```sql theme={null}
SELECT
    sum(duration) AS total_duration,
    avg(duration) AS avg_duration,
    toTypeName(total_duration)
FROM VALUES('duration IntervalMillisecond',
    toIntervalMillisecond(100), toIntervalMillisecond(200), toIntervalMillisecond(300))
```

```text theme={null}
┌─total_duration─┬─avg_duration─┬─toTypeName(total_duration)─┐
│            600 │          200 │ IntervalMillisecond        │
└────────────────┴──────────────┴────────────────────────────┘
```

تُحوَّل القيم ذات الوحدات المختلفة إلى وحدة مشتركة قبل تجميعها، ولذلك
فإن جمع دقيقة وثانية ينتج عنه 61 ثانية. أما `Month` و`Quarter` و`Year` فلا تجمعها وحدة مشتركة
مع الوحدات الأصغر - إذ لا يتكوّن الشهر من عدد ثابت من الأيام - ولذا لا يمكن مزجها
معها إطلاقًا.

<h2 id="mixed-type-intervals">
  الفواصل الزمنية المختلطة النوع
</h2>

يمكن إنشاء فواصل زمنية مختلطة النوع، مثل عدة ساعات وعدة دقائق، باستخدام البنية `INTERVAL 'value' <from_kind> TO <to_kind>`.
وتكون النتيجة قيمة من النوع `Tuple` تتكوّن من فاصلين زمنيين أو أكثر.

التركيبات المدعومة:

| الصياغة | تنسيق السلسلة | مثال |
| - | - | - |
| `YEAR TO MONTH` | `Y-M` | `INTERVAL '2-6' YEAR TO MONTH` |
| `DAY TO HOUR` | `D H` | `INTERVAL '5 12' DAY TO HOUR` |
| `DAY TO MINUTE` | `D H:M` | `INTERVAL '5 12:30' DAY TO MINUTE` |
| `DAY TO SECOND` | `D H:M:S` | `INTERVAL '5 12:30:45' DAY TO SECOND` |
| `HOUR TO MINUTE` | `H:M` | `INTERVAL '1:30' HOUR TO MINUTE` |
| `HOUR TO SECOND` | `H:M:S` | `INTERVAL '1:30:45' HOUR TO SECOND` |
| `MINUTE TO SECOND` | `M:S` | `INTERVAL '5:30' MINUTE TO SECOND` |

يُتحقَّق من الحقول غير الأولى وفقًا لمعيار SQL: `MONTH` من 0 إلى 11، و`HOUR` من 0 إلى 23، و`MINUTE` من 0 إلى 59، و`SECOND` من 0 إلى 59.

```sql theme={null}
SELECT INTERVAL '1:30' HOUR TO MINUTE;
```

```text theme={null}
┌─(toIntervalHour(1), toIntervalMinute(30))─┐
│ (1,30)                                     │
└────────────────────────────────────────────┘
```

تسري علامة بادئة اختيارية `+` أو `-` على جميع المكوّنات:

```sql theme={null}
SELECT INTERVAL '+1:30' HOUR TO MINUTE;
-- this is equivalent to:
-- SELECT INTERVAL '1:30' HOUR TO MINUTE;
```

```text theme={null}
┌─(toIntervalHour(1), toIntervalMinute(30))─┐
│ (1,30)                                     │
└────────────────────────────────────────────┘
```

<h2 id="see-also">
  انظر أيضًا
</h2>

* المشغّل [INTERVAL](/ar/reference/operators/index#interval)
* دوال تحويل النوع [toInterval](/ar/reference/functions/regular-functions/type-conversion-functions#toIntervalYear)
* الدالة التجميعية [avg](/ar/reference/functions/aggregate-functions/avg)
* الدالة التجميعية [sum](/ar/reference/functions/aggregate-functions/sum)