跳至主要內容
翻譯頁面

本頁面由英文在 AI 協助下翻譯而成。若兩者有出入,請以英文版本為準。

日期修飾詞

概觀​

在 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 時間
unixepochUnix 時間

範例​

使用 now 時間值傳回目前的日期和時間​

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

使用 localtime 修飾詞將 UTC 轉換為當地時間​

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 epoch 時間戳記,請參閱 STRFTIME。若要計算兩個日期時間物件之間的差異,請參閱 STRFTIME 或 JULIANDAY。