Django 中使用 ModelForm 定义 FloatField 并保留两位小数

在本文中，我们将介绍如何在 Django 中使用 ModelForm 定义 FloatField 字段，并保留两位小数。FloatField 字段用于存储浮点数，它通常用于表示货币金额、比率或者其他需要具有精确小数位的数值。

创建 Django 项目和应用

首先，我们需要创建一个 Django 项目和一个应用。在命令行中执行以下命令来创建一个 Django 项目：

django-admin startproject myproject

然后进入项目目录并创建一个新的应用：

cd myproject
python manage.py startapp myapp

接下来，我们需要将新创建的应用添加到项目的配置文件中。打开 settings.py 文件，将应用名称添加到 INSTALLED_APPS 列表中：

INSTALLED_APPS = [
    ...
    'myapp',
    ...
]

创建模型和 ModelForm

在 Django 的应用中，模型用来定义数据库中的表结构，而 ModelForm 用来自动生成表单。在我们的示例中，我们将创建一个包含 FloatField 字段的模型，并使用 ModelForm 自动生成相应的表单。

首先，在 models.py 文件中定义一个包含 FloatField 字段的模型：

from django.db import models

class MyModel(models.Model):
    float_number = models.FloatField()

接下来，在 forms.py 文件中创建一个 ModelForm 类来自动生成相应的表单：

from django import forms
from .models import MyModel

class MyModelForm(forms.ModelForm):
    class Meta:
        model = MyModel
        fields = ['float_number']

在上述代码中，我们使用了 forms.ModelForm 来创建一个继承自 ModelForm 的子类 MyModelForm，并通过 class Meta 定义了相关的模型和字段。

控制浮点精度

默认情况下，Django 对 FloatField 字段的数值不会进行任何格式化，所以它会保留所有的小数位。如果需要限制小数位数并保留两位小数，我们可以使用 DecimalField 字段来替代 FloatField 字段，并通过设置 DecimalField 的 decimal_places 参数为 2 来实现。

首先，我们需要在 models.py 中将 float_number 字段的类型从 FloatField 修改为 DecimalField：

from django.db import models

class MyModel(models.Model):
    float_number = models.DecimalField(max_digits=10, decimal_places=2)

在上述代码中，我们通过 max_digits 参数设置了整数和小数的最大位数为 10，通过 decimal_places 参数设置了小数位数为 2。

渲染表单并保留两位小数

当我们使用自动生成的 ModelForm 类来渲染表单时，默认情况下 Django 会显示原始的浮点数值，没有进行任何格式化。为了保留两位小数并正确渲染表单，我们需要在视图中进行相应的处理。

首先，在视图中导入我们定义的 MyModelForm 类：

from .forms import MyModelForm

接下来，我们可以将表单实例化，并将其传递给模板进行渲染：

def my_view(request):
    form = MyModelForm()
    return render(request, 'my_template.html', {'form': form})

然后，在模板文件中使用 {{ form.float_number }} 来渲染表单字段，并使用 {{ form.float_number.value|floatformat:2 }} 过滤器来保留两位小数：

<form>
    {{ form.float_number.label_tag }}: {{ form.float_number.errors }}
    {{ form.float_number.value|floatformat:2 }}
</form>

在上述代码中，我们使用了 label_tag 方法来显示字段的标签，并使用过滤器 floatformat 来保留两位小数。

示例

下面是一个完整的示例代码。首先，我们在 models.py 中定义了包含 float_number 字段的模型 MyModel。然后，在 forms.py 中创建了一个继承自 ModelForm 的子类 MyModelForm。

# models.py
from django.db import models

class MyModel(models.Model):
    float_number = models.DecimalField(max_digits=10, decimal_places=2)

# forms.py
from django import forms
from .models import MyModel

class MyModelForm(forms.ModelForm):
    class Meta:
        model = MyModel
        fields = ['float_number']

接下来，我们在 views.py 中定义了一个视图函数 my_view，将 MyModelForm 实例化，并传递给模板进行渲染。

# views.py
from django.shortcuts import render
from .forms import MyModelForm

def my_view(request):
    form = MyModelForm()
    return render(request, 'my_template.html', {'form': form})

最后，在模板文件中使用 {{ form.float_number }} 来渲染表单字段，并使用 {{ form.float_number.value|floatformat:2 }} 过滤器来保留两位小数。

<!-- my_template.html -->
<form>
    {{ form.float_number.label_tag }}: {{ form.float_number.errors }}
    {{ form.float_number.value|floatformat:2 }}
</form>