⚠️ python2를 기준으로 합니다!

글로벌 서비스를 만들거나 해외의 서버를 사용하게 되면(그렇지 않더라도) timezone을 설정해야 하는 경우가 있다.

가장 많이 쓰는 날짜, 시간 라이브러리인 datetime 에서는 timezone을 설정하지 않으면 기본 값이 없어서 None으로 처리된다.

def __init__(self, year, month, day, hour=None, minute=None, second=None, microsecond=None, tzinfo=None):

datetime.tzinfo

처음 객체를 생성할 때, tzinfo를 kwarg로 주면 설정할 수 있다.

datetime.datetime(2022, 1, 13, 11, 0, 0, tzinfo=tzinfo_value)

또는 datetime.now()에 넣어서 설정할 수도 있다.

datetime.datetime.now(tzinfo_value)

datetime 객체의 tzinfo 값을 바꾸려고 했는데, 수정할 수 없다고 한다

>>> a = datetime.now()
>>> a.tzinfo = 9
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
AttributeError: attribute 'tzinfo' of 'datetime.datetime' objects is not writable

그렇다. tzinfo는 property라서 할당문으로 그냥 수정할 수 있는 값이 아니었다.

tzinfo = property(lambda self: object(), lambda self, v: None, lambda self: None)  # default

그렇다면 어떻게 바꿀까?

datetime.replace()

class datetime(date):
  ...
  def replace(self, year=None, month=None, day=None,
              hour=None, minute=None, second=None,
              microsecond=None, tzinfo=None): # known case of datetime.datetime.replace

위 정의를 보면 알 수 있듯이 replace라는 메서드를 통해 수정할 수 있다. tzinfo 뿐만 아니라 다른 어트리뷰트들도 key-value 로 바꿀 수 있다.

datetime.replace는 str.replace와 같이 원본 값을 수정하지 않고 변경된 값을 리턴만 한다. 그러니 변경 이후에도 쓰려면 할당문을 사용하자

>>> today = datetime.now()
>>> today.replace(year=2023)
datetime.datetime(2023, 1, 13, 13, 54, 28, 956953)

느낌이 좋다. 이제 tzinfo를 replace로 수정만 하면 된다.

>>> today = datetime.now()
>>> today.replace(tzinfo=9)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: tzinfo argument must be None or of a tzinfo subclass, not type 'int'

어?

class tzinfo

class tzinfo(object):
  """ Abstract base class for time zone info objects. """
  ...

에러를 보면알 수 있듯이 tzinfo 어트리뷰트는 정수가 아니라 tzinfo나 서브 클래스의 객체여야 한다.

타임존을 수정하기 위해 tzinfo를 상속 받아서 클래스를 만드는 건 비효율적으로 보인다…

하지만 파이썬의 장점은

아 이거 필요한데…

싶은 것들은 누군가가 이미 만들어 뒀다는 것이다.

tzinfo를 상속한 클래스들

pytz.tzinfo.BaseTzInfo

class BaseTzInfo(tzinfo):
  ...

pytz는 미리 정의 해둔 텍스트를 통해 타임존을 설정할 수 있다.

정확한 스트링을 적어야 하니 pytz.__init__.py:all_timezones를 찾아서 확인하자.

>>> from datetime import datetime
>>> from pytz import timezone
>>> now = datetime.now()
>>> now.replace(tzinfo=timezone('Asia/Seoul'))
datetime(2022, 1, 13, 14, 53, 16, 166880, tzinfo=<DstTzInfo 'Asia/Seoul' KST+9:00:00 STD>)

물론 초기화 할 때도 가능하다.

>>> datetime.now(timezone('Asia/Seoul'))

그런데 pytz를 사용할 때 조심해야 할 부분이 있다. 'Asia/Seoul', 'Asia/Pyongyang' 지역을 사용할 때, 30분 정도 차이가 나는 이슈가 있다.

물론 지금은 fix 되긴 했지만 이전 버전을 사용할 때는 다음 처럼 나올 수 있다.

>>> import pytz
>>> from datetime import datetime
>>> fmt = '%Y-%m-%d %H:%M:%S %Z%z'
>>> seoul = pytz.timezone('Asia/Seoul')
>>> seoul
<DstTzInfo 'Asia/Seoul' KST+8:30:00 STD>

낮은 버전의 django에서는 한 술 더 떠서 '+8:28'로 나온다.

>>> from datetime import datetime
>>> from django.utils import timezone
>>> timezone.get_default_timezone()
<DstTzInfo 'Asia/Seoul' LMT+8:28:00 STD>

dateutil.tz.tzoffset

class tzoffset(datetime.tzinfo):
  ...

tzoffset은 UTC 기준으로 얼마나 느리고 빠른지 초 단위로 설정할 수 있다.

>>> from datetime import datetime
>>> from dateutil.tz import tzoffset
>>> now = datetime.now()
>>> now.replace(tzinfo=tzoffset('KST', 9 * 60 * 60))
datetime(2022, 1, 13, 15, 9, 10, 239466, tzinfo=tzoffset('KST', 32400))
>>> datetime.now(tzoffset('KST', 9 * 60 * 60))
datetime(2022, 1, 13, 15, 10, 16, 671827, tzinfo=tzoffset('KST', 32400))

python3

물론 python3는 내부에 다 구현해 둬서 그냥 datetime으로 전부 해결 가능하다^^

from datetime import datetime, timedelta, timezone


now = datetime.now(timezone(timedelta(hours=9)))

결론

import datetime
import dateutil.tz


datetime.datetime(2022, 1, 13, 11, 0, 0,
                  tzinfo=dateutil.tz.tzoffset('KST', 9 * 60 * 60))

datetime.tz.tzoffset 씁시다.

References

• Stackoverflow - How to set UTC offset for datetime?
• [파이썬, Python] datetime의 timezone 대한민국(서울)으로 변경
• [python] pytz의 평양/서울 시간 버그
• GitHub - stub42/pytz: pytz Python historical timezone library and database
• datetime.datetime, dateutil.tz 코드