Interval

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

مجموعة أنواع البيانات التي تمثل الفواصل الزمنية للتاريخ والوقت. وهي الأنواع الناتجة عن العامل INTERVAL.

البنية:

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

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

• NANOSECOND
• MICROSECOND
• MILLISECOND
• SECOND
• MINUTE
• HOUR
• DAY
• WEEK
• MONTH
• QUARTER
• YEAR

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

SELECT toTypeName(INTERVAL 4 DAY)

┌─toTypeName(toIntervalDay(4))─┐
│ IntervalDay                  │
└──────────────────────────────┘

​

ملاحظات حول الاستخدام

يمكنك استخدام القيم من النوع Interval في العمليات الحسابية مع القيم من النوع Date وDateTime. على سبيل المثال، يمكنك إضافة 4 أيام إلى الوقت الحالي:

SELECT now() AS current_date_time, current_date_time + INTERVAL 4 DAY

┌───current_date_time─┬─plus(now(), toIntervalDay(4))─┐
│ 2019-10-23 10:58:45 │           2019-10-27 10:58:45 │
└─────────────────────┴───────────────────────────────┘

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

SELECT now() AS current_date_time, current_date_time + (INTERVAL 4 DAY + INTERVAL 3 HOUR)

┌───current_date_time─┬─plus(current_date_time, plus(toIntervalDay(4), toIntervalHour(3)))─┐
│ 2024-08-08 18:31:39 │                                                2024-08-12 21:31:39 │
└─────────────────────┴────────────────────────────────────────────────────────────────────┘

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

SELECT toIntervalMicrosecond(179999999) < toIntervalMinute(3);

┌─less(toIntervalMicrosecond(179999999), toIntervalMinute(3))─┐
│                                                           1 │
└─────────────────────────────────────────────────────────────┘

SELECT toIntervalMicrosecond(3600000000) = toIntervalHour(1);

┌─equals(toIntervalMicrosecond(3600000000), toIntervalHour(1))─┐
│                                                            1 │
└──────────────────────────────────────────────────────────────┘

​

التجميع

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

SELECT
    sum(duration) AS total_duration,
    avg(duration) AS avg_duration,
    toTypeName(total_duration)
FROM VALUES('duration IntervalMillisecond',
    toIntervalMillisecond(100), toIntervalMillisecond(200), toIntervalMillisecond(300))

┌─total_duration─┬─avg_duration─┬─toTypeName(total_duration)─┐
│            600 │          200 │ IntervalMillisecond        │
└────────────────┴──────────────┴────────────────────────────┘

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

​

الفواصل الزمنية المختلطة النوع

يمكن إنشاء فواصل زمنية مختلطة النوع، مثل عدة ساعات وعدة دقائق، باستخدام البنية 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.

SELECT INTERVAL '1:30' HOUR TO MINUTE;

┌─(toIntervalHour(1), toIntervalMinute(30))─┐
│ (1,30)                                     │
└────────────────────────────────────────────┘

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

SELECT INTERVAL '+1:30' HOUR TO MINUTE;
-- this is equivalent to:
-- SELECT INTERVAL '1:30' HOUR TO MINUTE;

┌─(toIntervalHour(1), toIntervalMinute(30))─┐
│ (1,30)                                     │
└────────────────────────────────────────────┘

​

انظر أيضًا

• المشغّل INTERVAL
• دوال تحويل النوع toInterval
• الدالة التجميعية avg
• الدالة التجميعية sum