إنتقل إلى المحتوى الرئيسي
صفحة مترجمة

تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. إذا اختلفت النسختان، فالمرجع هو النسخة الإنجليزية.

معدّلات التاريخ

نظرة عامة​

في دوال التاريخ والوقت في 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';
تلميح

لتحويل قيمة datetime إلى طابع زمني لـ Unix epoch، راجع STRFTIME. لحساب الفروق بين كائني datetime، راجع STRFTIME أو JULIANDAY.