翻譯頁面
本頁面由英文在 AI 協助下翻譯而成。若兩者有出入,請以英文版本為準。
DATETIME
根據輸入日期時間和零個或多個修飾詞,傳回計算後的日期時間值。
語法
SELECT DATETIME(datetime_expression [, modifier, ...]) FROM <multipartIdentifier>;
引數
datetime_expression
日期時間值。
modifier
要套用至 datetime_expression 的零個或多個修飾詞。如需修飾詞的詳細資訊,請參閱 日期修飾詞。
傳回值
傳回一個字串,表示套用 modifier 後輸入 datetime_expression 的日期時間。
範例
使用 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';
如需詳細資訊,請參閱 https://www.sqlite.org/lang_datefunc.html。