Trang được dịch
Trang này được dịch từ tiếng Anh với sự hỗ trợ của AI. Nếu hai bản có chỗ khác nhau, hãy lấy phiên bản tiếng Anh làm chuẩn.
Bộ điều chỉnh ngày
Tổng quan
Trong các hàm datetime của StackQL, một giá trị ngày hoặc giờ có thể được theo sau bởi không hoặc nhiều bộ điều chỉnh làm thay đổi ngày và/hoặc giờ. Mỗi bộ điều chỉnh là một phép biến đổi được áp dụng cho giá trị thời gian ở bên trái nó. Các bộ điều chỉnh được áp dụng theo thứ tự từ trái sang phải. Các bộ điều chỉnh hiện có như sau:
| Bộ điều chỉnh | Mô tả |
|---|---|
| NNN day(s) | Cộng ±NNN ngày vào một giá trị ngày giờ |
| NNN hour(s) | Cộng ±NNN giờ vào một giá trị ngày giờ |
| NNN minute(s) | Cộng ±NNN phút vào một giá trị ngày giờ |
| NNN[.NNNN] second(s) | Cộng ±NNN giây vào (hoặc trừ khỏi) một giá trị ngày giờ |
| NNN month(s) | Cộng ±NNN tháng vào một giá trị ngày giờ |
| NNN year(s) | Cộng ±NNN năm vào một giá trị ngày giờ |
| start of month | Lùi về đầu tháng |
| start of year | Lùi về đầu năm |
| start of day | Lùi về đầu ngày |
| weekday N | Đẩy một ngày về phía trước tới ngày kế tiếp có số thứ tự ngày trong tuần là N |
| localtime | Trả về giờ địa phương |
| utc | Trả về giờ UTC |
| unixepoch | Thời gian Unix |
Ví dụ
Trả về ngày và giờ hiện tại bằng giá trị thời gian now
SELECT name, date('now') as date, time('now') as time
FROM google.storage.buckets WHERE project = 'stackql';
Chuyển đổi UTC sang giờ địa phương bằng bộ điều chỉnh localtime
SELECT name, timeCreated,
datetime(timeCreated, 'localtime') as local_time_created
FROM google.storage.buckets WHERE project = 'stackql';
Chuyển đổi giờ địa phương sang UTC
Bộ điều chỉnh utc coi đầu vào của nó là giờ địa phương trên máy chạy StackQL và chuyển đổi sang UTC. Một giá trị đã ở UTC, chẳng hạn như 'now' hoặc một dấu thời gian có hậu tố Z, được trả về không đổi.
SELECT datetime('2026-11-20 17:59:24', 'utc') as utc_time;
Trên máy có múi giờ UTC+11, truy vấn này trả về 2026-11-20 06:59:24.
Tính một ngày tương đối so với một ngày khác
SELECT name, timeCreated,
datetime(timeCreated, '+24 hours') as a_day_later
FROM google.storage.buckets WHERE project = 'stackql';
Lấy ngày trong tuần được chỉ định tiếp theo sau một ngày cho trước
SELECT name, timeCreated,
datetime(timeCreated, 'weekday 0') as following_sunday
FROM google.storage.buckets WHERE project = 'stackql';
Lấy ngày đầu tháng của một ngày cho trước
SELECT name, timeCreated,
datetime(timeCreated, 'start of month') as start_of_month
FROM google.storage.buckets WHERE project = 'stackql';
Chuyển đổi dấu thời gian Unix sang datetime
SELECT datetime(1576417943, 'unixepoch') as date_from_ts
FROM google.storage.buckets WHERE project = 'stackql';