翻訳ページ
このページは AI の支援を受けて英語から翻訳されています。内容が異なる場合は英語版が正となります。
日付修飾子
概要
StackQL の日時関数に渡す日付または時刻の値の後には、日付や時刻を変更する 0 個以上の修飾子を続けることができます。各修飾子は、その左側にある時刻値に適用される変換です。修飾子は左から右の順に適用されます。使用できる修飾子は次のとおりです。
| 修飾子 | 説明 |
|---|---|
| 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 に変換する
SELECT name, timeCreated,
datetime('now', 'utc') as now_utc
FROM google.storage.buckets WHERE project = 'stackql';
別の日付を基準に日付を計算する
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';