如何在Django中为PostgreSQL注册自定义TimeRangeField？

1. 迁移报错原因：PostgreSQL无内置timerange类型 #

Django的DateTimeRangeField和DateRangeField对应PostgreSQL原生的tsrange/tstzrange、daterange类型，但PostgreSQL没有原生的timerange类型，直接执行迁移自然会报type "timerange" does not exist错误。必须先在数据库中创建自定义范围类型，再让Django与psycopg适配。

2. 步骤1：在PostgreSQL中创建timerange类型 #

可以手动执行SQL，或者通过Django自定义迁移自动执行：

CREATE TYPE timerange AS RANGE (
    SUBTYPE = time without time zone,
    SUBTYPE_DIFF = time_sub_diff
);

• time without time zone指定范围的子类型为无时区时间
• time_sub_diff是PostgreSQL内置函数，用于计算时间差，支持范围的比较操作

如果用Django迁移实现，创建一个迁移文件（比如0002_create_timerange_type.py）：

from django.db import migrations

class Migration(migrations.Migration):
    dependencies = [
        ('你的app名', '上一个迁移文件名'),
    ]

    operations = [
        migrations.RunSQL(
            "CREATE TYPE timerange AS RANGE (SUBTYPE = time without time zone, SUBTYPE_DIFF = time_sub_diff);",
            "DROP TYPE timerange;"  # 回滚时执行的SQL
        )
    ]

3. 步骤2：用psycopg注册timerange类型 #

要让psycopg识别自定义的timerange类型，需在Django启动时完成注册。将以下代码放在主app的apps.py中：

from django.apps import AppConfig
from django.db import connection
from psycopg2.extras import register_range

def register_timerange():
    with connection.cursor() as cur:
        cur.execute("SELECT oid FROM pg_type WHERE typname = 'timerange';")
        result = cur.fetchone()
        if result:
            oid = result[0]
            # 注册范围类型，关联数据库OID与Python的Range对象
            register_range('timerange', oid, connection.connection)

class YourAppConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = '你的app名'

    def ready(self):
        register_timerange()

如果使用psycopg3，API略有不同，替换为psycopg.types.range.register_range即可，逻辑一致。

4. 步骤3：实现Django自定义TimeRangeField #

编写自定义字段类，继承Django的RangeField：

from django.db import models
from django.contrib.postgres.fields import RangeField
from psycopg2.extras import Range

class TimeRangeField(RangeField):
    def __init__(self, *args, **kwargs):
        # 关联基础的TimeField作为范围子类型
        super().__init__(models.TimeField(), *args, **kwargs)

    def db_type(self, connection):
        # 指定数据库存储类型为自定义的timerange
        return 'timerange'

    def from_db_value(self, value, expression, connection):
        if value is None:
            return value
        # 将数据库返回的timerange转换为psycopg的Range对象
        return Range(value.lower, value.upper, value.bounds)

在模型中直接使用：

from django.db import models
from .fields import TimeRangeField

class Event(models.Model):
    name = models.CharField(max_length=100)
    time_window = TimeRangeField()  # 存储时间范围，比如"09:00-18:00"

5. 为何Django不内置TimeRangeField？ #

核心原因是PostgreSQL无原生timerange类型。Django的PostgreSQL范围字段均基于数据库原生类型实现，DateRangeField和DateTimeRangeField对应PostgreSQL内置的范围类型，而时间范围需要用户自定义数据库类型，因此Django未将其纳入内置字段，交给用户按需实现。

内容的提问来源于stack exchange，提问作者SomeRandomDude111