타임스탬프 시간대 변경

항목	값
화면 이름	Change timestamp time zone
식별자	`changeTimestampTimeZoneV1`
지원 실행 방식	Batch, Faster
범주	날짜와 시간 (Datetime)
반환 자료형	`Timestamp`

타임스탬프의 시간대를 변경합니다.

입력 인자

이름	지정 여부	자료형	의미와 조건
`Output time zone`	필수	`TimeZone`	대상 시간대입니다.
`Timestamp`	필수	`Expression<Timestamp>`	타임스탬프 열입니다.
`Input time zone`	선택	`Expression<String>`	현재 타임스탬프가 기록된 시간대입니다.

입출력 예시

예시 1: 기본 동작

인자 값:

Output time zone: America/Chicago
Timestamp: 2020-04-28T05:09:00Z
Input time zone: US/Eastern

출력: 2020-04-28T04:09:00Z

예시 2: 기본 동작

인자 값:

Output time zone: Australia/Sydney
Timestamp: timestamp
Input time zone: time_zone

timestamp	time_zone	출력
2020-04-28T10:09:00Z	US/Eastern	2020-04-29T00:09:00Z
2020-04-28T10:09:00Z	UTC	2020-04-28T20:09:00Z

예시 3: null 처리

인자 값:

Output time zone: US/Eastern
Timestamp: 2020-04-28T10:09:00Z
Input time zone: null

출력: 2020-04-28T06:09:00Z

예시 4: null 처리

인자 값:

Output time zone: Australia/Sydney
Timestamp: timestamp
Input time zone: time_zone

timestamp	time_zone	출력
null	US/Eastern	null
null	null	null
2020-04-28T10:09:00Z	null	2020-04-28T20:09:00Z

예시 5: 경계 조건

인자 값:

Output time zone: UTC
Timestamp: 2025-11-02T01:01:14Z
Input time zone: America/Halifax

출력: 2025-11-02T04:01:14Z