epoch()

Unix epoch 타임스탬프를 날짜로 변환합니다.

문법

epoch(VALUE)

매개변수

VALUE
Unix epoch 값을 반환하는 표현식입니다. 숫자 또는 숫자 문자열을 받습니다.

설명

epoch() 함수는 VALUE를 초 단위 epoch로 해석하여 날짜를 반환합니다. 반환 타입은 날짜입니다.

초로 해석했을 때 결과가 9999년 1월 1일(Unix epoch 253402300799초)을 초과하면 VALUE를 밀리초 단위로 해석합니다. 즉, 값이 253402300799 이상이면 밀리초로 간주합니다.

VALUE가 null이거나 빈 문자열이거나 숫자로 변환할 수 없는 경우 null을 반환합니다.

오류 코드

해당 사항 없음

사용 예

이 사용 예에서 조회하는 WEB_APACHE_SAMPLE 테이블을 준비하려면 쿼리 실습용 데이터를 참고하세요.

  1. 접근 로그 시각을 epoch 정수로 변환한 뒤 다시 날짜로 복원합니다.

    table limit=5 WEB_APACHE_SAMPLE | eval epoch_val = datepart(_time, "epoch"), result = epoch(epoch_val)
| fields _time, epoch_val, result

  2. 초 단위 epoch 값을 날짜로 변환합니다.

    json "{}" | eval result = epoch(1435196373)
| # result: 2015-06-25 10:39:33+0900

  3. NULL 입력

    json "{}" | eval result = epoch(null)
| # result: null

호환성

epoch() 함수는 소나 4.0 이전 버전부터 제공되었습니다.