دوال النافذة الزمنية

توثيق دوال النافذة الزمنية

تعيد دوال النافذة الزمنية الحد السفلي الشامل والحد العلوي غير الشامل للنافذة المقابلة. فيما يلي الدوال المستخدمة للتعامل مع النوافذ الزمنية:

​

hop

أُضيف في: v21.12.0

تكون النافذة الزمنية القافزة ذات مدة ثابتة (window_interval)، وتتحرك وفق فاصل قفز محدد (hop_interval). وإذا كان hop_interval أصغر من window_interval، تصبح النوافذ القافزة متداخلة. لذلك، يمكن إسناد السجلات إلى نوافذ متعددة.

ونظرًا لأن السجل الواحد يمكن إسناده إلى عدة نوافذ قافزة، فإن الدالة لا تُرجع إلا حدّ النافذة الأولى.

البنية

hop(time_attr, hop_interval, window_interval[, timezone])

الوسيطات

• time_attr — التاريخ والوقت. DateTime
• hop_interval — فاصل القفز الموجب. Interval
• window_interval — فاصل النافذة الموجب. Interval
• timezone — اختياري. اسم المنطقة الزمنية. String

القيمة المُعادة

تعيد الحد السفلي الشامل والحد العلوي غير الشامل للنافذة القافزة المقابلة. Tuple(DateTime, DateTime)

أمثلة

النافذة القافزة

Query

SELECT hop(toDateTime('2026-01-02 03:04:05', 'UTC'), INTERVAL '1' DAY, INTERVAL '2' DAY)

Response

('2026-01-01 00:00:00','2026-01-03 00:00:00')

​

hopEnd

أُضيف في: v22.1.0

يعيد الحد العلوي غير الشامل للنافذة القافزة المقابلة.

وبما أن السجل الواحد يمكن أن يُسنَد إلى عدة نوافذ قافزة، فإن الدالة لا تعيد إلا حدّ النافذة الأولى.

البنية

hopEnd(time_attr, hop_interval, window_interval[, timezone])

الوسيطات

• time_attr — التاريخ والوقت. DateTime
• hop_interval — فاصل قفز موجب. Interval
• window_interval — فاصل نافذة موجب. Interval
• timezone — اختياري. اسم المنطقة الزمنية. String

القيمة المُعادة

تعيد الحد العلوي غير الشامل للنافذة القافزة المقابلة. DateTime

أمثلة

نهاية النافذة القافزة

Query

SELECT hopEnd(toDateTime('2026-01-02 03:04:05', 'UTC'), INTERVAL '1' DAY, INTERVAL '2' DAY)

Response

2026-01-03 00:00:00

​

hopStart

أُضيف في: v22.1.0

تعيد الحد السفلي الشامل للنافذة القافزة المقابلة.

وبما أن السجل الواحد يمكن أن يُسنَد إلى عدة نوافذ قافزة، فإن الدالة لا تعيد إلا حد النافذة الأولى.

البنية

hopStart(time_attr, hop_interval, window_interval[, timezone])

الوسيطات

• time_attr — التاريخ والوقت. DateTime
• hop_interval — فاصل القفز الموجب. Interval
• window_interval — فاصل النافذة الموجب. Interval
• timezone — اختياري. اسم المنطقة الزمنية. String

القيمة المُعادة

تعيد الحد السفلي الشامل للنافذة القافزة المقابلة. DateTime

أمثلة

بداية النافذة القافزة

Query

SELECT hopStart(toDateTime('2026-01-02 03:04:05', 'UTC'), INTERVAL '1' DAY, INTERVAL '2' DAY)

Response

2026-01-01 00:00:00

​

tumble

أُضيف في: v21.12.0

تُوزِّع النافذة الزمنية المتعاقبة السجلات على نوافذ متواصلة غير متداخلة ذات مدة ثابتة (interval).

البنية

tumble(time_attr, interval[, timezone])

الوسيطات

• time_attr — التاريخ والوقت. DateTime
• interval — فاصل النافذة من نوع Interval. Interval
• timezone — اختياري. اسم المنطقة الزمنية. String

القيمة المُعادة

تعيد الحد السفلي الشامل والحد العلوي غير الشامل للنافذة المتعاقبة المقابلة. Tuple(DateTime, DateTime)

أمثلة

النافذة المتعاقبة

Query

SELECT tumble(toDateTime('2026-01-02 03:04:05', 'UTC'), toIntervalDay('1'))

Response

('2026-01-02 00:00:00','2026-01-03 00:00:00')

​

tumbleEnd

أُضيف في: v22.1.0

يعيد الحد العلوي غير الشامل للنافذة المتعاقبة المقابلة.

البنية

tumbleEnd(time_attr, interval[, timezone])

الوسيطات

• time_attr — التاريخ والوقت. DateTime
• interval — فاصل النافذة من نوع Interval. Interval
• timezone — اختياري. اسم المنطقة الزمنية. String

القيمة المُعادة

يُرجِع الحدّ العلوي غير الشامل للنافذة المتعاقبة المقابلة. DateTime

أمثلة

نهاية النافذة المتعاقبة

Query

SELECT tumbleEnd(toDateTime('2026-01-02 03:04:05', 'UTC'), toIntervalDay('1'))

Response

2026-01-03 00:00:00

​

tumbleStart

أُضيف في: v22.1.0

تعيد الحدّ السفلي الشامل للنافذة المتعاقبة المقابلة.

البنية

tumbleStart(time_attr, interval[, timezone])

الوسيطات

• time_attr — التاريخ والوقت. DateTime
• interval — فاصل النافذة من النوع Interval
• timezone — اختياري. اسم المنطقة الزمنية. String

القيمة المُعادة

يعيد الحد السفلي الشامل للنافذة المتعاقبة المقابلة. DateTime

أمثلة

بداية النافذة المتعاقبة

Query

SELECT tumbleStart(toDateTime('2026-01-02 03:04:05', 'UTC'), toIntervalDay('1'))

Response

2026-01-02 00:00:00

​

محتوى مرتبط

• أدلة حالات استخدام السلاسل الزمنية