[250122] DateTimeField() 개념정리~

~DateTimeField 란?~

1. DateTimeField 정의

`DateTimeField`는 Django 모델에서 날짜와 시간을 저장하는 필드이다 
이 필드는 데이터베이스에서 `DATETIME` 유형에 매핑되며, Python의 `datetime.datetime` 객체로 처리된다

---

기본 사용법

모델 정의

from django.db import models

class Event(models.Model):
    name = models.CharField(max_length=100)
    event_date = models.DateTimeField()

마이그레이션 이후 데이터 저장

from datetime import datetime
from myapp.models import Event

event = Event(name="Conference", event_date=datetime(2025, 1, 15, 14, 30))
event.save()

---

2. 주요 매개변수

1) `auto_now_add`

• 레코드가 처음 생성될 때, 현재 날짜와 시간을 자동으로 저장한다
• 이후 수정 시에는 값이 변경되지 않는다

예제:

event_date = models.DateTimeField(auto_now_add=True)

사용 시점: 생성된 시간(예: 레코드 생성 시간)을 자동으로 저장하려는 경우

2) `auto_now`

• 레코드가 저장될 때마다 현재 날짜와 시간으로 값을 자동으로 갱신한다

예제:

updated_at = models.DateTimeField(auto_now=True)

사용 시점: 마지막 수정 시간을 기록하려는 경우

3) `null`

• 기본값: `False`
• `True`로 설정하면 해당 필드에 `NULL` 값을 허용한다

예제:

event_date = models.DateTimeField(null=True)

4) `blank`

• 기본값: `False`
• `True`로 설정하면 관리자(admin) 또는 폼에서 해당 필드 입력을 필수로 요구하지 않는다

예제:

event_date = models.DateTimeField(blank=True)

5) `default`

• 필드의 기본값을 설정, 주로 `datetime` 모듈의 함수와 함께 사용된다

예제:

from datetime import datetime

event_date = models.DateTimeField(default=datetime.now)

6) `editable`

• 기본값: `True`
• `False`로 설정하면 Django 관리자(admin)에서 필드를 수정할 수 없다

예제:

event_date = models.DateTimeField(editable=False)

---

3. 데이터베이스에 저장된 형식

• Django는 기본적으로 UTC 시간대를 사용한다 (설정 파일에서 `TIME_ZONE` 변경 가능)
• ISO 8601 형식으로 저장:
  

YYYY-MM-DD HH:MM:SS

---

4. 시간대 설정

1) 기본 시간대 설정

• `settings.py`에서 `TIME_ZONE`을 설정:

TIME_ZONE = 'Asia/Seoul'
USE_TZ = True

2) USE_TZ 설정

• True: Django가 시간대를 UTC 기준으로 저장하고 시간대 변환을 처리
• False: Django가 로컬 시간대 그대로 저장

---

5. DateTimeField를 활용한 예제

1) 모델 정의

from django.db import models
from django.utils.timezone import now

class Post(models.Model):
    title = models.CharField(max_length=200)
    created_at = models.DateTimeField(auto_now_add=True)  # 생성 시간 자동 저장
    updated_at = models.DateTimeField(auto_now=True)      # 수정 시간 자동 갱신
    published_at = models.DateTimeField(default=now)      # 기본값 현재 시간

2) 데이터 저장

from myapp.models import Post
from datetime import datetime

# 새 포스트 생성
post = Post(title="New Post")
post.save()

# 특정 시간으로 설정
post.published_at = datetime(2025, 1, 1, 12, 0)
post.save()

---

6. QuerySet에서 사용하기

1) 필터링

from myapp.models import Event
from datetime import datetime

# 특정 날짜 이후의 이벤트 가져오기
events = Event.objects.filter(event_date__gte=datetime(2025, 1, 1))

# 특정 날짜 범위 내 이벤트
events = Event.objects.filter(event_date__range=["2025-01-01", "2025-01-31"])

2) 날짜 필드 활용

# 특정 연도에 발생한 이벤트
Event.objects.filter(event_date__year=2025)

# 특정 월에 발생한 이벤트
Event.objects.filter(event_date__month=1)

# 특정 요일에 발생한 이벤트
Event.objects.filter(event_date__week_day=1)  # 1은 일요일

---

7. 관리자(admin)에서의 DateTimeField

1) 날짜와 시간 필터

Django 관리자 페이지에서 `DateTimeField`를 리스트 필터로 추가가 가능하다

class EventAdmin(admin.ModelAdmin):
    list_filter = ('event_date',)

2) 기본 표시 형식

관리자 페이지에서 DateTimeField는 설정된 시간대와 날짜 형식에 따라 표시된다

---

8. 주의사항

1. `auto_now`와 `auto_now_add`를 동시에 사용할 수 없다
2. 시간대를 다룰 때, Django의 `timezone` 모듈을 사용하는 것이 좋다:

from django.utils.timezone import now

---

9. 요약

• `DateTimeField`는 날짜와 시간을 저장하고 관리하는 데 사용되는 Django 모델 필드이다
• 주요 옵션: `auto_now`, `auto_now_add`, `default`, `null`, `blank`
• 시간대 설정은 `TIME_ZONE` 및 `USE_TZ`를 통해 제어 가능
• QuerySet 필터링, 정렬, 데이터베이스 저장에서 유용하게 활용된다