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

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

Модифікатори дати

Огляд​

У функціях дати й часу StackQL після значення дати або часу може йти нуль або більше модифікаторів, які змінюють дату та/або час. Кожен модифікатор - це перетворення, яке застосовується до значення часу ліворуч від нього. Модифікатори застосовуються по черзі зліва направо. Доступні такі модифікатори:

МодифікаторОпис
NNN day(s)Додає ±NNN днів до дати й часу
NNN hour(s)Додає ±NNN годин до дати й часу
NNN minute(s)Додає ±NNN хвилин до дати й часу
NNN[.NNNN] second(s)Додає ±NNN секунд до дати й часу або віднімає їх
NNN month(s)Додає ±NNN місяців до дати й часу
NNN year(s)Додає ±NNN років до дати й часу
start of monthНазад до початку місяця
start of yearНазад до початку року
start of dayНазад до початку дня
weekday NПереміщує дату вперед до наступної дати, номер дня тижня якої дорівнює N
localtimeПовертає місцевий час
utcПовертає час UTC
unixepochЧас Unix

Приклади​

Отримання поточної дати й часу за допомогою значення часу now​

SELECT name, date('now') as date, time('now') as time
FROM google.storage.buckets WHERE project = 'stackql';

Перетворення 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.