# DATETIME

> Функція DATETIME у StackQL: обчислення значення дати й часу з вхідного значення та нуля або більше модифікаторів у форматі YYYY-MM-DD HH:MM:SS.

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

Повертає значення дати й часу, обчислене з вхідного значення дати й часу та нуля або більше модифікаторів.  

Див. також:  
[[` SELECT `]](/language-spec/select) [[ Модифікатори дати ]](/language-spec/functions/datetime/date_modifiers) 

* * * 

## Синтаксис

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

## Аргументи

__*datetime_expression*__  
Значення дати й часу.

__*modifier*__  
Нуль або більше модифікаторів, що застосовуються до *datetime_expression*.  Докладніше про модифікатори див. [**Модифікатори дати**](/language-spec/functions/datetime/date_modifiers)

## Значення, що повертається

Повертає рядок із датою й часом вхідного *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 на значення дати й часу

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

:::tip 

Щоб перетворити значення дати й часу на позначку часу Unix, див. [**STRFTIME**](/language-spec/functions/datetime/strftime).  Щоб обчислити різницю між двома об'єктами дати й часу, див. [**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)
