صفحة مترجمة
تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. إذا اختلفت النسختان، فالمرجع هو النسخة الإنجليزية.
معدّلات التاريخ
نظرة عامة
في دوال التاريخ والوقت في StackQL، يمكن أن يتبع قيمة التاريخ أو الوقت صفر أو أكثر من المعدّلات التي تغير التاريخ و/أو الوقت. كل معدّل هو تحويل يطبق على القيمة الزمنية الموجودة على يساره. تطبق المعدّلات بالترتيب من اليسار إلى اليمين. المعدّلات المتاحة هي كما يلي:
| المعدّل | الوصف |
|---|---|
| NNN day(s) | يضيف ±NNN من الأيام إلى تاريخ ووقت |
| NNN hour(s) | يضيف ±NNN من الساعات إلى تاريخ ووقت |
| NNN minute(s) | يضيف ±NNN من الدقائق إلى تاريخ ووقت |
| NNN[.NNNN] second(s) | يضيف ±NNN من الثواني إلى تاريخ ووقت أو يطرحها منه |
| NNN month(s) | يضيف ±NNN من الأشهر إلى تاريخ ووقت |
| NNN year(s) | يضيف ±NNN من السنوات إلى تاريخ ووقت |
| start of month | يعود إلى بداية الشهر |
| start of year | يعود إلى بداية السنة |
| start of day | يعود إلى بداية اليوم |
| weekday N | يقدم التاريخ إلى التاريخ التالي الذي يكون فيه رقم يوم الأسبوع N |
| localtime | يعيد الوقت المحلي |
| utc | يعيد الوقت بتوقيت UTC |
| unixepoch | وقت Unix |
أمثلة
إرجاع التاريخ والوقت الحاليين باستخدام القيمة الزمنية now
SELECT name, date('now') as date, time('now') as time
FROM google.storage.buckets WHERE project = 'stackql';
تحويل UTC إلى التوقيت المحلي باستخدام المعدّل localtime
SELECT name, timeCreated,
datetime(timeCreated, 'localtime') as local_time_created
FROM google.storage.buckets WHERE project = 'stackql';
تحويل توقيت محلي إلى UTC
يتعامل المعدّل utc مع قيمة الإدخال كوقت محلي على الجهاز الذي يشغل StackQL ويحولها إلى UTC. أما القيمة التي تكون بتوقيت UTC أصلًا، مثل 'now' أو طابع زمني بلاحقة Z، فتعاد دون تغيير.
SELECT datetime('2026-11-20 17:59:24', 'utc') as utc_time;
على جهاز منطقته الزمنية UTC+11، يعيد هذا الاستعلام 2026-11-20 06:59:24.
حساب تاريخ بالنسبة إلى تاريخ آخر
SELECT name, timeCreated,
datetime(timeCreated, '+24 hours') as a_day_later
FROM google.storage.buckets WHERE project = 'stackql';
الحصول على يوم الأسبوع المحدد التالي بعد تاريخ معين
SELECT name, timeCreated,
datetime(timeCreated, 'weekday 0') as following_sunday
FROM google.storage.buckets WHERE project = 'stackql';
الحصول على بداية الشهر لتاريخ معين
SELECT name, timeCreated,
datetime(timeCreated, 'start of month') as start_of_month
FROM google.storage.buckets WHERE project = 'stackql';
تحويل طابع زمني لـ Unix إلى قيمة datetime
SELECT datetime(1576417943, 'unixepoch') as date_from_ts
FROM google.storage.buckets WHERE project = 'stackql';