Python Pandas - timestamp.utcnow()로 UTC 날짜 및 시간의 새 타임스탬프 반환하기

개요

Pandas에서 UTC(협정 세계시) 기준의 날짜와 시간을 나타내는 새로운 Timestamp 객체를 반환하려면 timestamp.utcnow() 메서드를 사용합니다. 이 메서드는 기존 타임스탬프의 값과 무관하게 호출 시점의 현재 UTC 날짜와 시간을 새로운 타임스탬프로 생성해 반환합니다.

필요한 라이브러리 임포트

먼저 pandas 라이브러리를 임포트합니다.

import pandas as pd

타임스탬프 생성

tz 매개변수에 'UTC'를 지정하여 UTC 시간대를 가진 타임스탬프를 생성할 수 있습니다.

timestamp = pd.Timestamp('2021-10-16T15:12:34.261811624', tz='UTC')

UTC 날짜 및 시간으로 새 타임스탬프 반환

utcnow() 메서드를 호출하면 현재 UTC 날짜와 시간을 나타내는 새로운 타임스탬프가 반환됩니다.

timestamp.utcnow()

전체 예제 코드

아래는 위 과정을 모두 포함한 전체 실행 코드입니다.

import pandas as pd

# 타임스탬프 생성
timestamp = pd.Timestamp('2021-10-16T15:12:34.261811624', tz='UTC')

# Timestamp 출력
print("Timestamp...\n", timestamp)

# UTC 날짜와 시간으로 새 타임스탬프 출력
print("\nUTC day and time...\n", timestamp.utcnow())

실행 결과

위 코드를 실행하면 다음과 같은 결과가 출력됩니다.

Timestamp...
 2021-10-16 15:12:34.261811624+00:00

UTC day and time...
 2021-10-03 07:56:08.901294+00:00

결과 해석

출력 결과를 살펴보면, 처음 생성한 타임스탬프는 2021년 10월 16일 15시 12분 34초(UTC+00:00)입니다. 반면 utcnow() 메서드가 반환한 새 타임스탬프는 2021년 10월 3일 07시 56분 08초(UTC+00:00)로, 메서드가 실제로 호출된 순간의 현재 UTC 시각임을 알 수 있습니다. 즉, utcnow()는 기존 타임스탬프의 날짜나 시간 값을 활용하는 것이 아니라, 항상 호출 시점의 현재 UTC 시간을 새로운 Timestamp 객체로 만들어 돌려줍니다.

참고 사항

pandas 2.2.0부터 Timestamp.utcnow()는 더 이상 권장되지 않으며(Deprecated), 향후 버전에서 제거될 수 있습니다. 최신 버전에서는 pd.Timestamp.now(tz='UTC') 또는 pd.Timestamp.now('UTC')를 사용하는 것이 좋습니다.