Перейти до основного вмісту
Перекладена сторінка

Цю сторінку перекладено з англійської мови за допомогою ШІ. Якщо тексти відрізняються, еталоном є англійська версія.

DATETIME

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

Див. також:
[SELECT] [ Модифікатори дати ]


Синтаксис​

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

Аргументи​

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

modifier
Нуль або більше модифікаторів, що застосовуються до datetime_expression. Докладніше про модифікатори див. Модифікатори дати

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

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

SELECT datetime(1576417943, 'unixepoch') as date_from_ts
FROM google.storage.buckets WHERE project = 'stackql';
порада

Щоб перетворити значення дати й часу на позначку часу Unix, див. STRFTIME. Щоб обчислити різницю між двома об'єктами дати й часу, див. STRFTIME або JULIANDAY.

Докладніше див. https://www.sqlite.org/lang_datefunc.html