class Author(models.Model): name = models.CharField(max_length=50) age = models.PositiveIntegerField(null=True, blank=True) alias = models.CharField(max_length=50, null=True, blank=True) goes_by = models.CharField(max_length=50, null=True, blank=True)
不推荐在CharField上允许null=True,因为这会允许字段有两个“空值”
Coalesce
class Coalesce(*expressions, **extra)[source]
接受一个含有至少两个字段名称或表达式的列表,返回第一个非空的值(注意空字符串不被认为是一个空值)。每个参与都必须是相似的类型,所以掺杂了文本和数字的列表会导致数据库错误。
from django.db.models import Sum, Value as V
from django.db.models.functions import Coalesce
from demo1.models import *
Author.objects.create(name='Margaret Smith',goes_by='Maggie')
author = Author.objects.annotate(screen_name=Coalesce('alias', 'goes_by', 'name')).get()
print(author.screen_name)
Maggie
Concat
class Concat(*expressions, **extra)[source]
接受一个含有至少两个文本字段的或表达式的列表,返回连接后的文本。每个参数都必须是文本或者字符类型。如果你想把一个TextField()和一个CharField()连接, 一定要告诉Djangooutput_field应该为TextField()类型。在下面连接Value的例子中,这也是必需的。
这个函数不会返回null。在后端中,如果一个null参数导致了整个表达式都是null,Django会确保把每个null的部分转换成一个空字符串
from django.db.models import Value
author = Author.objects.annotate(screen_name=Concat('name',Value(':'),'goes_by', output_field=models.CharField())).get()
print(author.screen_name)
Margaret Smith:Maggie
Length
class Length(expression, **extra)[source]
接受一个文本字段或表达式,返回值的字符个数。如果表达式是null,长度也会是null。
使用范例:
Author.objects.annotate(len_age=Length('age')).get().len_age
a = Author.objects.annotate(len_name=Length('name'),len_age=Length('age')).get()
print(a.len_name, a.len_age)
14 None
Lower
class Lower(expression, **extra)[source]
接受一个文本字符串或表达式,返回它的小写表示形式。
Author.objects.annotate(lower_name=Lower('name')).get().lower_name
'margaret smith'
Substr
class Substr(expression, pos, length=None, **extra)[source]
返回这个字段或者表达式的,以pos位置开始,长度为length的子字符串。位置从下标为1开始,所以必须大于0。如果length是None,会返回剩余的字符串
Author.objects.create(name='Margaret Smith')
Author.objects.annotate(nick=Substr('name', 1, 5)).get().nick
'Marga'
Upper
class Upper(expression, **extra)[source]
接受一个文本字符串或表达式,返回它的大写表示形式。
使用范例:
>>> from django.db.models.functions import Upper >>> Author.objects.create(name='Margaret Smith') >>> author = Author.objects.annotate(name_upper=Upper('name')).get() >>> print(author.name_upper) MARGARET SMITH