翻譯頁面
本頁面由英文在 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 時間 |
| unixepoch | Unix 時間 |
範例
使用 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';