# DATETIME

> الدالة DATETIME في StackQL: حساب قيمة datetime من إدخال ومعدّل واحد أو أكثر، وتعاد بالتنسيق YYYY-MM-DD HH:MM:SS.

Source: https://stackql.io/ar/language-spec/functions/datetime/datetime-fn

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

راجع أيضًا:  
[[` SELECT `]](/language-spec/select) [[ معدّلات التاريخ ]](/language-spec/functions/datetime/date_modifiers) 

* * * 

## بناء الجملة

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

## الوسيطات

__*datetime_expression*__  
قيمة datetime.

__*modifier*__  
صفر أو أكثر من المعدّلات التي تطبق على *datetime_expression*.  لمزيد من المعلومات حول المعدّلات، راجع [**معدّلات التاريخ**](/language-spec/functions/datetime/date_modifiers)

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

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

* * *

## أمثلة

### تحويل UTC إلى التوقيت المحلي باستخدام المعدّل `localtime`

```sql
SELECT name, timeCreated,
datetime(timeCreated, 'localtime') as local_time_created
FROM google.storage.buckets WHERE project = 'stackql';
```

### تحويل توقيت محلي إلى UTC

يعامل المعدّل `utc` الإدخال الخاص به على أنه توقيت محلي على الجهاز الذي يعمل عليه StackQL ويحوله إلى UTC.  القيمة التي تكون بتوقيت UTC أصلًا، مثل `'now'` أو طابع زمني بلاحقة `Z`، تعاد دون تغيير.

```sql
SELECT datetime('2026-11-20 17:59:24', 'utc') as utc_time;
```

على جهاز منطقته الزمنية UTC+11، يعيد هذا الاستعلام `2026-11-20 06:59:24`.

### حساب تاريخ بالنسبة إلى تاريخ آخر

```sql
SELECT name, timeCreated,
datetime(timeCreated, '+24 hours') as a_day_later
FROM google.storage.buckets WHERE project = 'stackql';
```

### الحصول على يوم الأسبوع المحدد التالي بعد تاريخ معين

```sql
SELECT name, timeCreated,
datetime(timeCreated, 'weekday 0') as following_sunday
FROM google.storage.buckets WHERE project = 'stackql';
```

### الحصول على بداية الشهر لتاريخ معين

```sql
SELECT name, timeCreated,
datetime(timeCreated, 'start of month') as start_of_month
FROM google.storage.buckets WHERE project = 'stackql';
```

### تحويل طابع زمني لـ Unix إلى قيمة datetime

```sql
SELECT datetime(1576417943, 'unixepoch') as date_from_ts
FROM google.storage.buckets WHERE project = 'stackql';
```

:::tip 

لتحويل قيمة datetime إلى طابع زمني لـ Unix epoch، راجع [**STRFTIME**](/language-spec/functions/datetime/strftime).  لحساب الفروق بين كائني datetime، راجع [**STRFTIME**](/language-spec/functions/datetime/strftime) أو [**JULIANDAY**](/language-spec/functions/datetime/julianday).

:::

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