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

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

DATETIME

تعيد قيمة datetime محسوبة من قيمة datetime مدخلة ومعدّل واحد أو أكثر.

راجع أيضًا:
[SELECT] [ معدّلات التاريخ ]


بناء الجملة​

SELECT DATETIME(datetime_expression [, modifier, ...]) FROM <multipartIdentifier>;

الوسيطات​

datetime_expression
قيمة datetime.

modifier
صفر أو أكثر من المعدّلات التي تطبق على datetime_expression. لمزيد من المعلومات حول المعدّلات، راجع معدّلات التاريخ

القيمة المرجعة​

تعيد سلسلة نصية تمثل قيمة datetime للإدخال datetime_expression بعد تطبيق modifier.


أمثلة​

تحويل 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.

لمزيد من المعلومات، راجع https://www.sqlite.org/lang_datefunc.html