### Django DateTimeField 使用指南 Django 的 `DateTimeField` 是用于存储日期时间字段的一种模型字段类型。它能够自动处理 Python 的 `datetime.datetime` 对象，并且可以方便地与数据库交互[^1]。 #### 基本定义 在定义模型时，可以通过以下方式声明一个 `DateTimeField` 字段： ```python from django.db import models class ExampleModel(models.Model): created_at = models.DateTimeField(auto_now_add=True) # 自动设置为对象首次创建的时间 updated_at = models.DateTimeField(auto_now=True) # 每次保存对象时自动更新为此刻时间 ``` - 参数说明： - `auto_now_add`: 当对象第一次被创建时，会自动将该字段设为当前时间戳[^1]。 - `auto_now`: 每当调用 `.save()` 方法保存对象时，都会自动更新此字段为当前时间戳[^1]。 #### 手动赋值 如果不想让 Django 自动生成时间戳，也可以手动指定时间值： ```python import datetime from django.utils.timezone import now example_instance = ExampleModel() example_instance.created_at = datetime.datetime(2023, 9, 18, 14, 30, tzinfo=datetime.timezone.utc) example_instance.updated_at = now() # 使用 Django 提供的 timezone-aware 时间函数 example_instance.save() ``` 注意：为了确保跨时区一致性，推荐使用 Django 的 `django.utils.timezone.now()` 函数来获取当前时间[^1]。 #### 查询过滤 利用 Django ORM 进行基于 `DateTimeField` 的查询非常直观。以下是几个常见示例： ```python from example_app.models import ExampleModel from django.utils.timezone import now, timedelta # 获取最近一天内创建的对象 recent_objects = ExampleModel.objects.filter(created_at__gte=now()-timedelta(days=1)) # 查找特定年份的数据 objects_in_2023 = ExampleModel.objects.filter(created_at__year=2023) # 排序按最新创建顺序排列 sorted_by_created = ExampleModel.objects.all().order_by('-created_at') ``` 这些查询条件可以直接作用于 `DateTimeField` 上，无需额外转换成字符串或其他形式[^4]。 #### 数据库迁移 每当更改涉及 `DateTimeField` 或任何其他模型字段时，都需要运行数据库迁移命令以同步数据库结构变化： ```bash python manage.py makemigrations python manage.py migrate ``` 这样可以保证数据库模式始终与模型保持一致[^3]。 --- ###