Цю сторінку перекладено з англійської мови за допомогою ШІ. Якщо тексти відрізняються, еталоном є англійська версія.
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';
Докладніше див. https://www.sqlite.org/lang_datefunc.html