본문으로 건너뛰기
번역된 페이지

이 페이지는 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로컬 시간 반환
utcUTC 시간 반환
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로 변환합니다. 'now' 또는 Z 접미사가 있는 타임스탬프처럼 이미 UTC인 값은 변경되지 않고 그대로 반환됩니다.

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 함수를 참조하세요.