timeadd 함수

timeadd 함수 (timeadd Function)

timeadd 함수는 타임스탬프에 기간(duration)을 더해 새 타임스탬프를 반환해요. Terraform 언어에서 타임스탬프는 RFC 3339의 "Date and Time" 형식을 따르는 문자열로 표현돼요.

출처: 문서

본문

이 문서는 timeadd 함수에 대한 참고 정보를 다뤄요.

timeadd 함수는 타임스탬프에 기간을 더해 새 타임스탬프를 반환해요.

소개 (Introduction)

Terraform 언어는 타임스탬프를 RFC 3339의 Date and Time 형식을 따르는 문자열로 표현해요. timeadd는 timestamp 인자가 이 Date and Time 문법을 따르는 문자열이어야 해요.

문법 (Syntax)

timeadd 함수는 다음 문법으로 사용해요.

timeadd(timestamp, duration)
  • timestamp — RFC 3339 형식의 날짜 문자열 표현이에요. 타임스탬프 문자열을 만드는 방법은 외부 RFC 3339의 Internet Date/Time Format 절을 참고해요.
  • duration — 시간 차이의 문자열 표현이에요. 이 문자열은 숫자와 단위의 쌍으로 구성돼요. 예: "1.5h" 또는 "1h30m". 사용할 수 있는 단위는 다음과 같아요:
    • ns: 나노초
    • us 또는 µs: 마이크로초
    • ms: 밀리초
    • s: 초
    • m: 분
    • h: 시

음수 기간을 나타내려면 첫 번째 숫자를 음수로 만들어요. 예: "-2h5m".

timeadd의 결과는 주어진 타임스탬프에 주어진 기간을 더한 결과를 나타내는, 역시 RFC 3339 형식의 문자열이에요.

예시 사용 사례 (Example use case)

다음 예시는 10분을 더해요.

> timeadd("2024-08-16T12:45:05Z", "10m")
"2024-08-16T12:55:05Z"

다음 예시는 음수 기간을 사용해 10분을 뺍니다.

> timeadd("2024-08-16T12:45:05Z", "-10m")
"2024-08-16T12:35:05Z"
  • timecmp — 두 타임스탬프의 순서를 결정해요.

더 알아보기 (Learn more)