{"title":"Databasfunktioner","version":"6.1","locale":"sv","docname":"ref/models/database-functions","url":"/sv/6.1/ref/models/database-functions/","canonical":"https://djangodocs.dev/sv/6.1/ref/models/database-functions/","summary":"Klasserna som dokumenteras nedan ger användare ett sätt att använda funktioner från den underliggande databasen som annoteringar, aggregeringar eller filter…","html":"

DatabasfunktionerLink to this heading#

\n

Klasserna som dokumenteras nedan ger användare ett sätt att använda funktioner från den underliggande databasen som annoteringar, aggregeringar eller filter i Django. Funktioner är också uttryck, så de kan användas och kombineras med andra uttryck som aggregeringsfunktioner. Se dokumentationen för Func för säkerhetsöverväganden.

\n

Vi kommer att använda följande modell i exempel på varje funktion:

\n
Code
class Author(models.Model):\n    name = models.CharField(max_length=50)\n    age = models.PositiveIntegerField(null=True, blank=True)\n    alias = models.CharField(max_length=50, null=True, blank=True)\n    goes_by = models.CharField(max_length=50, null=True, blank=True)\n
\n

Vi rekommenderar vanligtvis inte att tillåta null=True för CharField eftersom detta gör att fältet kan ha två ”tomma värden”, men det är viktigt för Coalesce-exemplet nedan.

\n
\n

Jämförelse- och omvandlingsfunktionerLink to this heading#

\n
\n

SändningLink to this heading#

\n
\n
\nclass Cast(expression, output_field)Link to this definition#
\n
\n\n

Tvingar resultattypen för expression att vara den från output_field.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models import FloatField\n>>> from django.db.models.functions import Cast\n>>> Author.objects.create(age=25, name="Margaret Smith")\n>>> author = Author.objects.annotate(\n...     age_as_float=Cast("age", output_field=FloatField()),\n... ).get()\n>>> print(author.age_as_float)\n25.0\n
\n
\n
\n

KoaleseraLink to this heading#

\n
\n
\nclass Coalesce(*expressions, **extra)Link to this definition#
\n
\n\n

Accepterar en lista med minst två fältnamn eller uttryck och returnerar det första värdet som inte är null (observera att en tom sträng inte betraktas som ett null-värde). Varje argument måste vara av samma typ, så om du blandar text och siffror kommer det att resultera i ett databasfel.

\n

Exempel på användning:

\n
Python console
>>> # Get a screen name from least to most public\n>>> from django.db.models import Sum\n>>> from django.db.models.functions import Coalesce\n>>> Author.objects.create(name="Margaret Smith", goes_by="Maggie")\n>>> author = Author.objects.annotate(screen_name=Coalesce("alias", "goes_by", "name")).get()\n>>> print(author.screen_name)\nMaggie\n\n>>> # Prevent an aggregate Sum() from returning None\n>>> # The aggregate default argument uses Coalesce() under the hood.\n>>> aggregated = Author.objects.aggregate(\n...     combined_age=Sum("age"),\n...     combined_age_default=Sum("age", default=0),\n...     combined_age_coalesce=Coalesce(Sum("age"), 0),\n... )\n>>> print(aggregated["combined_age"])\nNone\n>>> print(aggregated["combined_age_default"])\n0\n>>> print(aggregated["combined_age_coalesce"])\n0\n
\n\n
\n
\n

”SamarbetaLink to this heading#

\n
\n
\nclass Collate(expression, collation)Link to this definition#
\n
\n\n

Tar emot ett uttryck och ett kollationsnamn att göra en sökning mot.

\n

Till exempel: för att filtrera utan hänsyn till skiftfall i SQLite:

\n
Python console
>>> Author.objects.filter(name=Collate(Value("john"), "nocase"))\n<QuerySet [<Author: John>, <Author: john>]>\n
\n

Det kan också användas vid beställning, till exempel med PostgreSQL:

\n
Python console
>>> Author.objects.order_by(Collate("name", "et-x-icu"))\n<QuerySet [<Author: Ursula>, <Author: Veronika>, <Author: Ülle>]>\n
\n
\n
\n

GreatestLink to this heading#

\n
\n
\nclass Greatest(*expressions, **extra)Link to this definition#
\n
\n\n

Accepterar en lista med minst två fältnamn eller uttryck och returnerar det största värdet. Varje argument måste vara av samma typ, så om man blandar text och siffror blir det ett databasfel.

\n

Exempel på användning:

\n
Code
class Blog(models.Model):\n    body = models.TextField()\n    modified = models.DateTimeField(auto_now=True)\n\n\nclass Comment(models.Model):\n    body = models.TextField()\n    modified = models.DateTimeField(auto_now=True)\n    blog = models.ForeignKey(Blog, on_delete=models.CASCADE)\n
\n
Python console
>>> from django.db.models.functions import Greatest\n>>> blog = Blog.objects.create(body="Greatest is the best.")\n>>> comment = Comment.objects.create(body="No, Least is better.", blog=blog)\n>>> comments = Comment.objects.annotate(last_updated=Greatest("modified", "blog__modified"))\n>>> annotated_comment = comments.get()\n
\n

annotated_comment.last_updated kommer att vara den senaste av blog.modified och comment.modified.

\n\n
\n
\n

MinstaLink to this heading#

\n
\n
\nclass Least(*expressions, **extra)Link to this definition#
\n
\n\n

Accepterar en lista med minst två fältnamn eller uttryck och returnerar det minsta värdet. Varje argument måste vara av samma typ, så att blanda text och siffror kommer att resultera i ett databasfel.

\n\n
\n
\n

NullIfLink to this heading#

\n
\n
\nclass NullIf(expression1, expression2)Link to this definition#
\n
\n\n

Accepterar två uttryck och returnerar None om de är lika, annars returneras expression1.

\n\n
\n
\n
\n

DatumfunktionerLink to this heading#

\n

Vi kommer att använda följande modell i exempel på varje funktion:

\n
Code
class Experiment(models.Model):\n    start_datetime = models.DateTimeField()\n    start_date = models.DateField(null=True, blank=True)\n    start_time = models.TimeField(null=True, blank=True)\n    end_datetime = models.DateTimeField(null=True, blank=True)\n    end_date = models.DateField(null=True, blank=True)\n    end_time = models.TimeField(null=True, blank=True)\n
\n
\n

ExtractLink to this heading#

\n
\n
\nclass Extract(expression, lookup_name=None, tzinfo=None, **extra)Link to this definition#
\n
\n\n

Extraherar en del av ett datum som ett tal.

\n

Tar ett uttryck som representerar en DateField, DateTimeField, TimeField eller DurationField och ett lookup_name och returnerar den del av datumet som refereras av lookup_name som en IntegerField. Django använder vanligtvis databasernas extraheringsfunktion, så du kan använda vilket lookup_name som helst som din databas stöder. En underklass av tzinfo, som vanligtvis tillhandahålls av zoneinfo, kan skickas för att extrahera ett värde i en specifik tidszon.

\n

Givet datatiden 2015-06-15 23:30:01.000321+00:00, returnerar den inbyggda lookup_name:

\n\n

Om en annan tidszon som Australia/Melbourne är aktiv i Django, konverteras datatiden till tidszonen innan värdet extraheras. Tidszonsförskjutningen för Melbourne i exempeldatumet ovan är +10:00. De värden som returneras när denna tidszon är aktiv kommer att vara desamma som ovan med undantag för:

\n\n\n\n

Varje lookup_name ovan har en motsvarande Extract subklass (listad nedan) som vanligtvis bör användas istället för den mer verbala motsvarigheten, t.ex. använd ExtractYear(...) istället för Extract(..., lookup_name='year').

\n

Exempel på användning:

\n
Python console
>>> from datetime import datetime\n>>> from django.db.models.functions import Extract\n>>> start = datetime(2015, 6, 15)\n>>> end = datetime(2015, 7, 2)\n>>> Experiment.objects.create(\n...     start_datetime=start, start_date=start.date(), end_datetime=end, end_date=end.date()\n... )\n>>> # Add the experiment start year as a field in the QuerySet.\n>>> experiment = Experiment.objects.annotate(\n...     start_year=Extract("start_datetime", "year")\n... ).get()\n>>> experiment.start_year\n2015\n>>> # How many experiments completed in the same year in which they started?\n>>> Experiment.objects.filter(start_datetime__year=Extract("end_datetime", "year")).count()\n1\n
\n\n
\n

DateField utdragLink to this heading#

\n
\n
\nclass ExtractYear(expression, tzinfo=None, **extra)Link to this definition#
\n
\n
\nlookup_name = 'year'
\n
\n\n
\n\n
\n
\nclass ExtractIsoYear(expression, tzinfo=None, **extra)Link to this definition#
\n

Returnerar det ISO-8601 veckonumrerade året.

\n
\n
\nlookup_name = 'iso_year'
\n
\n\n
\n\n
\n
\nclass ExtractMonth(expression, tzinfo=None, **extra)Link to this definition#
\n
\n
\nlookup_name = 'month'
\n
\n\n
\n\n
\n
\nclass ExtractDay(expression, tzinfo=None, **extra)Link to this definition#
\n
\n
\nlookup_name = 'day'
\n
\n\n
\n\n
\n
\nclass ExtractWeekDay(expression, tzinfo=None, **extra)Link to this definition#
\n
\n
\nlookup_name = 'week_day'
\n
\n\n
\n\n
\n
\nclass ExtractIsoWeekDay(expression, tzinfo=None, **extra)Link to this definition#
\n

Returnerar ISO-8601-veckodagen där dag 1 är måndag och dag 7 är söndag.

\n
\n
\nlookup_name = 'iso_week_day'
\n
\n\n
\n\n
\n
\nclass ExtractWeek(expression, tzinfo=None, **extra)Link to this definition#
\n
\n
\nlookup_name = 'week'
\n
\n\n
\n\n
\n
\nclass ExtractQuarter(expression, tzinfo=None, **extra)Link to this definition#
\n
\n
\nlookup_name = 'quarter'
\n
\n\n
\n\n

Dessa är logiskt likvärdiga med Extract('date_field', lookup_name). Varje klass är också en Transform registrerad på DateField och DateTimeField som __(lookup_name), t.ex. __year.

\n

Eftersom DateField inte har någon tidskomponent, kan endast Extract subklasser som hanterar datumdelar användas med DateField:

\n
Python console
>>> from datetime import UTC, datetime\n>>> from django.db.models.functions import (\n...     ExtractDay,\n...     ExtractMonth,\n...     ExtractQuarter,\n...     ExtractWeek,\n...     ExtractIsoWeekDay,\n...     ExtractWeekDay,\n...     ExtractIsoYear,\n...     ExtractYear,\n... )\n>>> start_2015 = datetime(2015, 6, 15, 23, 30, 1, tzinfo=UTC)\n>>> end_2015 = datetime(2015, 6, 16, 13, 11, 27, tzinfo=UTC)\n>>> Experiment.objects.create(\n...     start_datetime=start_2015,\n...     start_date=start_2015.date(),\n...     end_datetime=end_2015,\n...     end_date=end_2015.date(),\n... )\n>>> Experiment.objects.annotate(\n...     year=ExtractYear("start_date"),\n...     isoyear=ExtractIsoYear("start_date"),\n...     quarter=ExtractQuarter("start_date"),\n...     month=ExtractMonth("start_date"),\n...     week=ExtractWeek("start_date"),\n...     day=ExtractDay("start_date"),\n...     weekday=ExtractWeekDay("start_date"),\n...     isoweekday=ExtractIsoWeekDay("start_date"),\n... ).values(\n...     "year",\n...     "isoyear",\n...     "quarter",\n...     "month",\n...     "week",\n...     "day",\n...     "weekday",\n...     "isoweekday",\n... ).get(\n...     end_date__year=ExtractYear("start_date")\n... )\n{'year': 2015, 'isoyear': 2015, 'quarter': 2, 'month': 6, 'week': 25,\n 'day': 15, 'weekday': 2, 'isoweekday': 1}\n
\n
\n
\n

DateTimeField utdragLink to this heading#

\n

Förutom följande kan alla utdrag för DateField som anges ovan också användas på DateTimeField .

\n
\n
\nclass ExtractHour(expression, tzinfo=None, **extra)Link to this definition#
\n
\n
\nlookup_name = 'hour'
\n
\n\n
\n\n
\n
\nclass ExtractMinute(expression, tzinfo=None, **extra)Link to this definition#
\n
\n
\nlookup_name = 'minute'
\n
\n\n
\n\n
\n
\nclass ExtractSecond(expression, tzinfo=None, **extra)Link to this definition#
\n
\n
\nlookup_name = 'second'
\n
\n\n
\n\n

Dessa är logiskt likvärdiga med Extract('datetime_field', lookup_name). Varje klass är också en Transform registrerad på DateTimeField som __(lookup_name), t.ex. __minute.

\n

exempel på DateTimeField:

\n
Python console
>>> from datetime import UTC, datetime\n>>> from django.db.models.functions import (\n...     ExtractDay,\n...     ExtractHour,\n...     ExtractMinute,\n...     ExtractMonth,\n...     ExtractQuarter,\n...     ExtractSecond,\n...     ExtractWeek,\n...     ExtractIsoWeekDay,\n...     ExtractWeekDay,\n...     ExtractIsoYear,\n...     ExtractYear,\n... )\n>>> start_2015 = datetime(2015, 6, 15, 23, 30, 1, tzinfo=UTC)\n>>> end_2015 = datetime(2015, 6, 16, 13, 11, 27, tzinfo=UTC)\n>>> Experiment.objects.create(\n...     start_datetime=start_2015,\n...     start_date=start_2015.date(),\n...     end_datetime=end_2015,\n...     end_date=end_2015.date(),\n... )\n>>> Experiment.objects.annotate(\n...     year=ExtractYear("start_datetime"),\n...     isoyear=ExtractIsoYear("start_datetime"),\n...     quarter=ExtractQuarter("start_datetime"),\n...     month=ExtractMonth("start_datetime"),\n...     week=ExtractWeek("start_datetime"),\n...     day=ExtractDay("start_datetime"),\n...     weekday=ExtractWeekDay("start_datetime"),\n...     isoweekday=ExtractIsoWeekDay("start_datetime"),\n...     hour=ExtractHour("start_datetime"),\n...     minute=ExtractMinute("start_datetime"),\n...     second=ExtractSecond("start_datetime"),\n... ).values(\n...     "year",\n...     "isoyear",\n...     "month",\n...     "week",\n...     "day",\n...     "weekday",\n...     "isoweekday",\n...     "hour",\n...     "minute",\n...     "second",\n... ).get(\n...     end_datetime__year=ExtractYear("start_datetime")\n... )\n{'year': 2015, 'isoyear': 2015, 'quarter': 2, 'month': 6, 'week': 25,\n 'day': 15, 'weekday': 2, 'isoweekday': 1, 'hour': 23, 'minute': 30,\n 'second': 1}\n
\n

När USE_TZ är True så lagras datatider i databasen i UTC. Om en annan tidszon är aktiv i Django konverteras datatiden till den tidszonen innan värdet extraheras. I exemplet nedan konverteras till tidszonen Melbourne (UTC +10:00), vilket ändrar värdena för dag, veckodag och timme som returneras:

\n
Python console
>>> from django.utils import timezone\n>>> import zoneinfo\n>>> melb = zoneinfo.ZoneInfo("Australia/Melbourne")  # UTC+10:00\n>>> with timezone.override(melb):\n...     Experiment.objects.annotate(\n...         day=ExtractDay("start_datetime"),\n...         weekday=ExtractWeekDay("start_datetime"),\n...         isoweekday=ExtractIsoWeekDay("start_datetime"),\n...         hour=ExtractHour("start_datetime"),\n...     ).values("day", "weekday", "isoweekday", "hour").get(\n...         end_datetime__year=ExtractYear("start_datetime"),\n...     )\n...\n{'day': 16, 'weekday': 3, 'isoweekday': 2, 'hour': 9}\n
\n

Om du uttryckligen skickar tidszonen till funktionen Extract fungerar den på samma sätt och prioriteras framför en aktiv tidszon:

\n
Python console
>>> import zoneinfo\n>>> melb = zoneinfo.ZoneInfo("Australia/Melbourne")\n>>> Experiment.objects.annotate(\n...     day=ExtractDay("start_datetime", tzinfo=melb),\n...     weekday=ExtractWeekDay("start_datetime", tzinfo=melb),\n...     isoweekday=ExtractIsoWeekDay("start_datetime", tzinfo=melb),\n...     hour=ExtractHour("start_datetime", tzinfo=melb),\n... ).values("day", "weekday", "isoweekday", "hour").get(\n...     end_datetime__year=ExtractYear("start_datetime"),\n... )\n{'day': 16, 'weekday': 3, 'isoweekday': 2, 'hour': 9}\n
\n
\n
\n
\n

NuLink to this heading#

\n
\n
\nclass NowLink to this definition#
\n
\n\n

Returnerar databasserverns aktuella datum och tid när frågan körs, vanligtvis med hjälp av SQL CURRENT_TIMESTAMP.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import Now\n>>> Article.objects.filter(published__lte=Now())\n<QuerySet [<Article: How to Django>]>\n
\n\n\n
\n
\n

TruncLink to this heading#

\n
\n
\nclass Trunc(expression, kind, output_field=None, tzinfo=None, **extra)Link to this definition#
\n
\n\n

Avkortar ett datum upp till en betydande del.

\n

När du bara bryr dig om att något hände under ett visst år, en viss timme eller dag, men inte den exakta sekunden, kan Trunc (och dess underklasser) vara användbara för att filtrera eller aggregera dina data. Du kan t.ex. använda Trunc för att beräkna antalet försäljningar per dag.

\n

Trunc tar ett enda uttryck, som representerar en DateField, TimeField eller DateTimeField, en kind som representerar en datum- eller tidsdel och ett output_field som är antingen DateTimeField(), TimeField() eller DateField(). Den returnerar en datetime, ett datum eller en tid beroende på output_field, med fält upp till kind inställda på sitt lägsta värde. Om output_field utelämnas kommer den att använda output_field från expression som standard. En underklass till tzinfo, som vanligtvis tillhandahålls av zoneinfo, kan skickas för att trunkera ett värde i en specifik tidszon.

\n

Givet datatiden 2015-06-15 14:30:50.000321+00:00, returnerar den inbyggda kind:

\n\n

Om en annan tidszon som Australia/Melbourne är aktiv i Django, konverteras datumen till den nya tidszonen innan värdet trunkeras. Tidszonförskjutningen för Melbourne i exempeldatumet ovan är +10:00. De värden som returneras när denna tidszon är aktiv kommer att vara:

\n\n

Året och kvartalet har en förskjutning på +11:00 eftersom varje resultat infaller före övergången till sommartid.

\n

Varje kind ovan har en motsvarande Trunc underklass (listad nedan) som typiskt bör användas istället för den mer ordrika motsvarigheten, t.ex. använd TruncYear(...) istället för Trunc(..., kind='year').

\n

Underklasserna är alla definierade som transformationer, men de är inte registrerade med några fält, eftersom uppslagsnamnen redan är reserverade av underklasserna Extract.

\n

Exempel på användning:

\n
Python console
>>> from datetime import datetime\n>>> from django.db.models import Count, DateTimeField\n>>> from django.db.models.functions import Trunc\n>>> Experiment.objects.create(start_datetime=datetime(2015, 6, 15, 14, 30, 50, 321))\n>>> Experiment.objects.create(start_datetime=datetime(2015, 6, 15, 14, 40, 2, 123))\n>>> Experiment.objects.create(start_datetime=datetime(2015, 12, 25, 10, 5, 27, 999))\n>>> experiments_per_day = (\n...     Experiment.objects.annotate(\n...         start_day=Trunc("start_datetime", "day", output_field=DateTimeField())\n...     )\n...     .values("start_day")\n...     .annotate(experiments=Count("id"))\n... )\n>>> for exp in experiments_per_day:\n...     print(exp["start_day"], exp["experiments"])\n...\n2015-06-15 00:00:00 2\n2015-12-25 00:00:00 1\n>>> experiments = Experiment.objects.annotate(\n...     start_day=Trunc("start_datetime", "day", output_field=DateTimeField())\n... ).filter(start_day=datetime(2015, 6, 15))\n>>> for exp in experiments:\n...     print(exp.start_datetime)\n...\n2015-06-15 14:30:50.000321\n2015-06-15 14:40:02.000123\n
\n\n
\n

trunkering av DateFieldLink to this heading#

\n
\n
\nclass TruncYear(expression, output_field=None, tzinfo=None, **extra)Link to this definition#
\n
\n
\nkind = 'year'
\n
\n\n
\n\n
\n
\nclass TruncMonth(expression, output_field=None, tzinfo=None, **extra)Link to this definition#
\n
\n
\nkind = 'month'
\n
\n\n
\n\n
\n
\nclass TruncWeek(expression, output_field=None, tzinfo=None, **extra)Link to this definition#
\n

Trunkeras till midnatt på måndagen i veckan.

\n
\n
\nkind = 'week'
\n
\n\n
\n\n
\n
\nclass TruncQuarter(expression, output_field=None, tzinfo=None, **extra)Link to this definition#
\n
\n
\nkind = 'quarter'
\n
\n\n
\n\n

Dessa är logiskt likvärdiga med Trunc('date_field', kind). De trunkerar alla delar av datumet upp till kind vilket gör det möjligt att gruppera eller filtrera datum med mindre precision. expression kan ha ett output_field av antingen DateField eller DateTimeField.

\n

Eftersom DateField inte har någon tidskomponent, kan endast Trunc subklasser som hanterar date-parts användas med DateField:

\n
Python console
>>> from datetime import UTC, datetime\n>>> from django.db.models import Count\n>>> from django.db.models.functions import TruncMonth, TruncYear\n>>> start1 = datetime(2014, 6, 15, 14, 30, 50, 321, tzinfo=UTC)\n>>> start2 = datetime(2015, 6, 15, 14, 40, 2, 123, tzinfo=UTC)\n>>> start3 = datetime(2015, 12, 31, 17, 5, 27, 999, tzinfo=UTC)\n>>> Experiment.objects.create(start_datetime=start1, start_date=start1.date())\n>>> Experiment.objects.create(start_datetime=start2, start_date=start2.date())\n>>> Experiment.objects.create(start_datetime=start3, start_date=start3.date())\n>>> experiments_per_year = (\n...     Experiment.objects.annotate(year=TruncYear("start_date"))\n...     .values("year")\n...     .annotate(experiments=Count("id"))\n... )\n>>> for exp in experiments_per_year:\n...     print(exp["year"], exp["experiments"])\n...\n2014-01-01 1\n2015-01-01 2\n\n>>> import zoneinfo\n>>> melb = zoneinfo.ZoneInfo("Australia/Melbourne")\n>>> experiments_per_month = (\n...     Experiment.objects.annotate(month=TruncMonth("start_datetime", tzinfo=melb))\n...     .values("month")\n...     .annotate(experiments=Count("id"))\n... )\n>>> for exp in experiments_per_month:\n...     print(exp["month"], exp["experiments"])\n...\n2015-06-01 00:00:00+10:00 1\n2016-01-01 00:00:00+11:00 1\n2014-06-01 00:00:00+10:00 1\n
\n
\n
\n

trunkering av DateTimeFieldLink to this heading#

\n
\n
\nclass TruncDate(expression, tzinfo=None, **extra)Link to this definition#
\n
\n
\nlookup_name = 'date'
\n
\n\n
\n
\noutput_field = DateField()
\n
\n\n
\n\n

TruncDate kastar uttryck till ett datum istället för att använda den inbyggda SQL truncate-funktionen. Den är också registrerad som en transform på DateTimeField som __date.

\n
\n
\nclass TruncTime(expression, tzinfo=None, **extra)Link to this definition#
\n
\n
\nlookup_name = 'time'
\n
\n\n
\n
\noutput_field = TimeField()
\n
\n\n
\n\n

TruncTime kastar uttryck till en tid istället för att använda den inbyggda SQL truncate-funktionen. Den är också registrerad som en transform på DateTimeField som __time.

\n
\n
\nclass TruncDay(expression, output_field=None, tzinfo=None, **extra)Link to this definition#
\n
\n
\nkind = 'day'
\n
\n\n
\n\n
\n
\nclass TruncHour(expression, output_field=None, tzinfo=None, **extra)Link to this definition#
\n
\n
\nkind = 'hour'
\n
\n\n
\n\n
\n
\nclass TruncMinute(expression, output_field=None, tzinfo=None, **extra)Link to this definition#
\n
\n
\nkind = 'minute'
\n
\n\n
\n\n
\n
\nclass TruncSecond(expression, output_field=None, tzinfo=None, **extra)Link to this definition#
\n
\n
\nkind = 'second'
\n
\n\n
\n\n

Dessa är logiskt likvärdiga med Trunc('datetime_field', kind). De trunkerar alla delar av datumet upp till kind och tillåter gruppering eller filtrering av datumtider med mindre precision. expression måste ha ett output_field av DateTimeField.

\n

Exempel på användning:

\n
Python console
>>> from datetime import UTC, date, datetime\n>>> from django.db.models import Count\n>>> from django.db.models.functions import (\n...     TruncDate,\n...     TruncDay,\n...     TruncHour,\n...     TruncMinute,\n...     TruncSecond,\n... )\n>>> import zoneinfo\n>>> start1 = datetime(2014, 6, 15, 14, 30, 50, 321, tzinfo=UTC)\n>>> Experiment.objects.create(start_datetime=start1, start_date=start1.date())\n>>> melb = zoneinfo.ZoneInfo("Australia/Melbourne")\n>>> Experiment.objects.annotate(\n...     date=TruncDate("start_datetime"),\n...     day=TruncDay("start_datetime", tzinfo=melb),\n...     hour=TruncHour("start_datetime", tzinfo=melb),\n...     minute=TruncMinute("start_datetime"),\n...     second=TruncSecond("start_datetime"),\n... ).values("date", "day", "hour", "minute", "second").get()\n{'date': datetime.date(2014, 6, 15),\n 'day': datetime.datetime(2014, 6, 16, 0, 0, tzinfo=zoneinfo.ZoneInfo('Australia/Melbourne')),\n 'hour': datetime.datetime(2014, 6, 16, 0, 0, tzinfo=zoneinfo.ZoneInfo('Australia/Melbourne')),\n 'minute': 'minute': datetime.datetime(2014, 6, 15, 14, 30, tzinfo=UTC),\n 'second': datetime.datetime(2014, 6, 15, 14, 30, 50, tzinfo=UTC)\n}\n
\n
\n
\n

trunkering av TimeFieldLink to this heading#

\n
\n
\nclass TruncHour(expression, output_field=None, tzinfo=None, **extra)
\n
\n
\nkind = 'hour'
\n
\n\n
\n\n
\n
\nclass TruncMinute(expression, output_field=None, tzinfo=None, **extra)
\n
\n
\nkind = 'minute'
\n
\n\n
\n\n
\n
\nclass TruncSecond(expression, output_field=None, tzinfo=None, **extra)
\n
\n
\nkind = 'second'
\n
\n\n
\n\n

Dessa är logiskt likvärdiga med Trunc('time_field', kind). De trunkerar alla delar av tiden upp till kind vilket gör det möjligt att gruppera eller filtrera tider med mindre precision. uttryck kan ha ett utgångsfält av antingen TimeField eller DateTimeField.

\n

Eftersom TimeField inte har någon datumkomponent, kan endast Trunc subklasser som hanterar tidsdelar användas med TimeField:

\n
Python console
>>> from datetime import UTC, datetime\n>>> from django.db.models import Count, TimeField\n>>> from django.db.models.functions import TruncHour\n>>> start1 = datetime(2014, 6, 15, 14, 30, 50, 321, tzinfo=UTC)\n>>> start2 = datetime(2014, 6, 15, 14, 40, 2, 123, tzinfo=UTC)\n>>> start3 = datetime(2015, 12, 31, 17, 5, 27, 999, tzinfo=UTC)\n>>> Experiment.objects.create(start_datetime=start1, start_time=start1.time())\n>>> Experiment.objects.create(start_datetime=start2, start_time=start2.time())\n>>> Experiment.objects.create(start_datetime=start3, start_time=start3.time())\n>>> experiments_per_hour = (\n...     Experiment.objects.annotate(\n...         hour=TruncHour("start_datetime", output_field=TimeField()),\n...     )\n...     .values("hour")\n...     .annotate(experiments=Count("id"))\n... )\n>>> for exp in experiments_per_hour:\n...     print(exp["hour"], exp["experiments"])\n...\n14:00:00 2\n17:00:00 1\n\n>>> import zoneinfo\n>>> melb = zoneinfo.ZoneInfo("Australia/Melbourne")\n>>> experiments_per_hour = (\n...     Experiment.objects.annotate(\n...         hour=TruncHour("start_datetime", tzinfo=melb),\n...     )\n...     .values("hour")\n...     .annotate(experiments=Count("id"))\n... )\n>>> for exp in experiments_per_hour:\n...     print(exp["hour"], exp["experiments"])\n...\n2014-06-16 00:00:00+10:00 2\n2016-01-01 04:00:00+11:00 1\n
\n
\n
\n
\n
\n

JSON-funktionerLink to this heading#

\n
\n

JSONArrayLink to this heading#

\n
\n
\nclass JSONArray(*expressions)Link to this definition#
\n
\n\n

Accepterar en lista med fältnamn eller uttryck och returnerar en JSON-array som innehåller dessa värden.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models import F\n>>> from django.db.models.functions import JSONArray, Lower\n>>> Author.objects.create(name="Margaret Smith", alias="msmith", age=25)\n>>> author = Author.objects.annotate(\n...     json_array=JSONArray(\n...         Lower("name"),\n...         "alias",\n...         F("age") * 2,\n...     )\n... ).get()\n>>> author.json_array\n['margaret smith', 'msmith', 50]\n
\n
\n
\n

JSONObjectLink to this heading#

\n
\n
\nclass JSONObject(**fields)Link to this definition#
\n
\n\n

Tar emot en lista med nyckel-värde-par och returnerar ett JSON-objekt som innehåller dessa par.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models import F\n>>> from django.db.models.functions import JSONObject, Lower\n>>> Author.objects.create(name="Margaret Smith", alias="msmith", age=25)\n>>> author = Author.objects.annotate(\n...     json_object=JSONObject(\n...         name=Lower("name"),\n...         alias="alias",\n...         age=F("age") * 2,\n...     )\n... ).get()\n>>> author.json_object\n{'name': 'margaret smith', 'alias': 'msmith', 'age': 50}\n
\n
\n
\n
\n

Matematiska funktionerLink to this heading#

\n

Vi kommer att använda följande modell i exempel på matematiska funktioner:

\n
Code
class Vector(models.Model):\n    x = models.FloatField()\n    y = models.FloatField()\n
\n
\n

AbsLink to this heading#

\n
\n
\nclass Abs(expression, **extra)Link to this definition#
\n
\n\n

Returnerar det absoluta värdet av ett numeriskt fält eller uttryck.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import Abs\n>>> Vector.objects.create(x=-0.5, y=1.1)\n>>> vector = Vector.objects.annotate(x_abs=Abs("x"), y_abs=Abs("y")).get()\n>>> vector.x_abs, vector.y_abs\n(0.5, 1.1)\n
\n

Den kan också registreras som en transform. Till exempel:

\n
Python console
>>> from django.db.models import FloatField\n>>> from django.db.models.functions import Abs\n>>> FloatField.register_lookup(Abs)\n>>> # Get vectors inside the unit cube\n>>> vectors = Vector.objects.filter(x__abs__lt=1, y__abs__lt=1)\n
\n
\n
\n

”ACosLink to this heading#

\n
\n
\nclass ACos(expression, **extra)Link to this definition#
\n
\n\n

Returnerar arccosinus för ett numeriskt fält eller uttryck. Uttryckets värde måste ligga inom intervallet -1 till 1.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import ACos\n>>> Vector.objects.create(x=0.5, y=-0.9)\n>>> vector = Vector.objects.annotate(x_acos=ACos("x"), y_acos=ACos("y")).get()\n>>> vector.x_acos, vector.y_acos\n(1.0471975511965979, 2.6905658417935308)\n
\n

Den kan också registreras som en transform. Till exempel:

\n
Python console
>>> from django.db.models import FloatField\n>>> from django.db.models.functions import ACos\n>>> FloatField.register_lookup(ACos)\n>>> # Get vectors whose arccosine is less than 1\n>>> vectors = Vector.objects.filter(x__acos__lt=1, y__acos__lt=1)\n
\n
\n
\n

ASinLink to this heading#

\n
\n
\nclass ASin(expression, **extra)Link to this definition#
\n
\n\n

Returnerar arcsinus för ett numeriskt fält eller uttryck. Uttryckets värde måste ligga inom intervallet -1 till 1.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import ASin\n>>> Vector.objects.create(x=0, y=1)\n>>> vector = Vector.objects.annotate(x_asin=ASin("x"), y_asin=ASin("y")).get()\n>>> vector.x_asin, vector.y_asin\n(0.0, 1.5707963267948966)\n
\n

Den kan också registreras som en transform. Till exempel:

\n
Python console
>>> from django.db.models import FloatField\n>>> from django.db.models.functions import ASin\n>>> FloatField.register_lookup(ASin)\n>>> # Get vectors whose arcsine is less than 1\n>>> vectors = Vector.objects.filter(x__asin__lt=1, y__asin__lt=1)\n
\n
\n
\n

ATanLink to this heading#

\n
\n
\nclass ATan(expression, **extra)Link to this definition#
\n
\n\n

Returnerar arctangenten för ett numeriskt fält eller uttryck.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import ATan\n>>> Vector.objects.create(x=3.12, y=6.987)\n>>> vector = Vector.objects.annotate(x_atan=ATan("x"), y_atan=ATan("y")).get()\n>>> vector.x_atan, vector.y_atan\n(1.2606282660069106, 1.428638798133829)\n
\n

Den kan också registreras som en transform. Till exempel:

\n
Python console
>>> from django.db.models import FloatField\n>>> from django.db.models.functions import ATan\n>>> FloatField.register_lookup(ATan)\n>>> # Get vectors whose arctangent is less than 2\n>>> vectors = Vector.objects.filter(x__atan__lt=2, y__atan__lt=2)\n
\n
\n
\n

ATan2Link to this heading#

\n
\n
\nclass ATan2(expression1, expression2, **extra)Link to this definition#
\n
\n\n

Returnerar arctangenten av uttryck1 / uttryck2.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import ATan2\n>>> Vector.objects.create(x=2.5, y=1.9)\n>>> vector = Vector.objects.annotate(atan2=ATan2("x", "y")).get()\n>>> vector.atan2\n0.9209258773829491\n
\n
\n
\n

TakLink to this heading#

\n
\n
\nclass Ceil(expression, **extra)Link to this definition#
\n
\n\n

Returnerar det minsta heltalet som är större än eller lika med ett numeriskt fält eller uttryck.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import Ceil\n>>> Vector.objects.create(x=3.12, y=7.0)\n>>> vector = Vector.objects.annotate(x_ceil=Ceil("x"), y_ceil=Ceil("y")).get()\n>>> vector.x_ceil, vector.y_ceil\n(4.0, 7.0)\n
\n

Den kan också registreras som en transform. Till exempel:

\n
Python console
>>> from django.db.models import FloatField\n>>> from django.db.models.functions import Ceil\n>>> FloatField.register_lookup(Ceil)\n>>> # Get vectors whose ceil is less than 10\n>>> vectors = Vector.objects.filter(x__ceil__lt=10, y__ceil__lt=10)\n
\n
\n
\n

CosLink to this heading#

\n
\n
\nclass Cos(expression, **extra)Link to this definition#
\n
\n\n

Returnerar cosinus för ett numeriskt fält eller uttryck.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import Cos\n>>> Vector.objects.create(x=-8.0, y=3.1415926)\n>>> vector = Vector.objects.annotate(x_cos=Cos("x"), y_cos=Cos("y")).get()\n>>> vector.x_cos, vector.y_cos\n(-0.14550003380861354, -0.9999999999999986)\n
\n

Den kan också registreras som en transform. Till exempel:

\n
Python console
>>> from django.db.models import FloatField\n>>> from django.db.models.functions import Cos\n>>> FloatField.register_lookup(Cos)\n>>> # Get vectors whose cosine is less than 0.5\n>>> vectors = Vector.objects.filter(x__cos__lt=0.5, y__cos__lt=0.5)\n
\n
\n
\n

CotLink to this heading#

\n
\n
\nclass Cot(expression, **extra)Link to this definition#
\n
\n\n

Returnerar cotangenten för ett numeriskt fält eller uttryck.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import Cot\n>>> Vector.objects.create(x=12.0, y=1.0)\n>>> vector = Vector.objects.annotate(x_cot=Cot("x"), y_cot=Cot("y")).get()\n>>> vector.x_cot, vector.y_cot\n(-1.5726734063976826, 0.642092615934331)\n
\n

Den kan också registreras som en transform. Till exempel:

\n
Python console
>>> from django.db.models import FloatField\n>>> from django.db.models.functions import Cot\n>>> FloatField.register_lookup(Cot)\n>>> # Get vectors whose cotangent is less than 1\n>>> vectors = Vector.objects.filter(x__cot__lt=1, y__cot__lt=1)\n
\n
\n
\n

DegreesLink to this heading#

\n
\n
\nclass Degrees(expression, **extra)Link to this definition#
\n
\n\n

Konverterar ett numeriskt fält eller uttryck från radianer till grader.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import Degrees\n>>> Vector.objects.create(x=-1.57, y=3.14)\n>>> vector = Vector.objects.annotate(x_d=Degrees("x"), y_d=Degrees("y")).get()\n>>> vector.x_d, vector.y_d\n(-89.95437383553924, 179.9087476710785)\n
\n

Den kan också registreras som en transform. Till exempel:

\n
Python console
>>> from django.db.models import FloatField\n>>> from django.db.models.functions import Degrees\n>>> FloatField.register_lookup(Degrees)\n>>> # Get vectors whose degrees are less than 360\n>>> vectors = Vector.objects.filter(x__degrees__lt=360, y__degrees__lt=360)\n
\n
\n
\n

ExpLink to this heading#

\n
\n
\nclass Exp(expression, **extra)Link to this definition#
\n
\n\n

Returnerar värdet av e (den naturliga logaritmens bas) upphöjt till en potens i ett numeriskt fält eller uttryck.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import Exp\n>>> Vector.objects.create(x=5.4, y=-2.0)\n>>> vector = Vector.objects.annotate(x_exp=Exp("x"), y_exp=Exp("y")).get()\n>>> vector.x_exp, vector.y_exp\n(221.40641620418717, 0.1353352832366127)\n
\n

Den kan också registreras som en transform. Till exempel:

\n
Python console
>>> from django.db.models import FloatField\n>>> from django.db.models.functions import Exp\n>>> FloatField.register_lookup(Exp)\n>>> # Get vectors whose exp() is greater than 10\n>>> vectors = Vector.objects.filter(x__exp__gt=10, y__exp__gt=10)\n
\n
\n
\n

GolvLink to this heading#

\n
\n
\nclass Floor(expression, **extra)Link to this definition#
\n
\n\n

Returnerar det största heltalsvärdet som inte är större än ett numeriskt fält eller uttryck.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import Floor\n>>> Vector.objects.create(x=5.4, y=-2.3)\n>>> vector = Vector.objects.annotate(x_floor=Floor("x"), y_floor=Floor("y")).get()\n>>> vector.x_floor, vector.y_floor\n(5.0, -3.0)\n
\n

Den kan också registreras som en transform. Till exempel:

\n
Python console
>>> from django.db.models import FloatField\n>>> from django.db.models.functions import Floor\n>>> FloatField.register_lookup(Floor)\n>>> # Get vectors whose floor() is greater than 10\n>>> vectors = Vector.objects.filter(x__floor__gt=10, y__floor__gt=10)\n
\n
\n
\n

LnLink to this heading#

\n
\n
\nclass Ln(expression, **extra)Link to this definition#
\n
\n\n

Returnerar den naturliga logaritmen för ett numeriskt fält eller uttryck.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import Ln\n>>> Vector.objects.create(x=5.4, y=233.0)\n>>> vector = Vector.objects.annotate(x_ln=Ln("x"), y_ln=Ln("y")).get()\n>>> vector.x_ln, vector.y_ln\n(1.6863989535702288, 5.4510384535657)\n
\n

Den kan också registreras som en transform. Till exempel:

\n
Python console
>>> from django.db.models import FloatField\n>>> from django.db.models.functions import Ln\n>>> FloatField.register_lookup(Ln)\n>>> # Get vectors whose value greater than e\n>>> vectors = Vector.objects.filter(x__ln__gt=1, y__ln__gt=1)\n
\n
\n
\n

LogLink to this heading#

\n
\n
\nclass Log(expression1, expression2, **extra)Link to this definition#
\n
\n\n

Accepterar två numeriska fält eller uttryck och returnerar logaritmen av det andra till basen av det första.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import Log\n>>> Vector.objects.create(x=2.0, y=4.0)\n>>> vector = Vector.objects.annotate(log=Log("x", "y")).get()\n>>> vector.log\n2.0\n
\n
\n
\n

ModLink to this heading#

\n
\n
\nclass Mod(expression1, expression2, **extra)Link to this definition#
\n
\n\n

Accepterar två numeriska fält eller uttryck och returnerar resten av det första dividerat med det andra (modulooperation).

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import Mod\n>>> Vector.objects.create(x=5.4, y=2.3)\n>>> vector = Vector.objects.annotate(mod=Mod("x", "y")).get()\n>>> vector.mod\n0.8\n
\n
\n
\n

PiLink to this heading#

\n
\n
\nclass Pi(**extra)Link to this definition#
\n
\n\n

Returnerar värdet av den matematiska konstanten π.

\n
\n
\n

KraftLink to this heading#

\n
\n
\nclass Power(expression1, expression2, **extra)Link to this definition#
\n
\n\n

Accepterar två numeriska fält eller uttryck och returnerar värdet av det första upphöjt till potensen av det andra.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import Power\n>>> Vector.objects.create(x=2, y=-2)\n>>> vector = Vector.objects.annotate(power=Power("x", "y")).get()\n>>> vector.power\n0.25\n
\n
\n
\n

RadianerLink to this heading#

\n
\n
\nclass Radians(expression, **extra)Link to this definition#
\n
\n\n

Konverterar ett numeriskt fält eller uttryck från grader till radianer.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import Radians\n>>> Vector.objects.create(x=-90, y=180)\n>>> vector = Vector.objects.annotate(x_r=Radians("x"), y_r=Radians("y")).get()\n>>> vector.x_r, vector.y_r\n(-1.5707963267948966, 3.141592653589793)\n
\n

Den kan också registreras som en transform. Till exempel:

\n
Python console
>>> from django.db.models import FloatField\n>>> from django.db.models.functions import Radians\n>>> FloatField.register_lookup(Radians)\n>>> # Get vectors whose radians are less than 1\n>>> vectors = Vector.objects.filter(x__radians__lt=1, y__radians__lt=1)\n
\n
\n
\n

RandomLink to this heading#

\n
\n
\nclass Random(**extra)Link to this definition#
\n
\n\n

Returnerar ett slumpmässigt värde i intervallet 0,0 ≤ x < 1,0.

\n
\n
\n

RundLink to this heading#

\n
\n
\nclass Round(expression, precision=0, **extra)Link to this definition#
\n
\n\n

Avrundar ett numeriskt fält eller uttryck till precision (måste vara ett heltal) decimaler. Som standard avrundas till närmaste heltal. Huruvida halva värden avrundas uppåt eller nedåt beror på databasen.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import Round\n>>> Vector.objects.create(x=5.4, y=-2.37)\n>>> vector = Vector.objects.annotate(x_r=Round("x"), y_r=Round("y", precision=1)).get()\n>>> vector.x_r, vector.y_r\n(5.0, -2.4)\n
\n

Den kan också registreras som en transform. Till exempel:

\n
Python console
>>> from django.db.models import FloatField\n>>> from django.db.models.functions import Round\n>>> FloatField.register_lookup(Round)\n>>> # Get vectors whose round() is less than 20\n>>> vectors = Vector.objects.filter(x__round__lt=20, y__round__lt=20)\n
\n
\n
\n

SignLink to this heading#

\n
\n
\nclass Sign(expression, **extra)Link to this definition#
\n
\n\n

Returnerar tecknet (-1, 0, 1) för ett numeriskt fält eller uttryck.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import Sign\n>>> Vector.objects.create(x=5.4, y=-2.3)\n>>> vector = Vector.objects.annotate(x_sign=Sign("x"), y_sign=Sign("y")).get()\n>>> vector.x_sign, vector.y_sign\n(1, -1)\n
\n

Den kan också registreras som en transform. Till exempel:

\n
Python console
>>> from django.db.models import FloatField\n>>> from django.db.models.functions import Sign\n>>> FloatField.register_lookup(Sign)\n>>> # Get vectors whose signs of components are less than 0.\n>>> vectors = Vector.objects.filter(x__sign__lt=0, y__sign__lt=0)\n
\n
\n
\n

SinLink to this heading#

\n
\n
\nclass Sin(expression, **extra)Link to this definition#
\n
\n\n

Returnerar sinus för ett numeriskt fält eller uttryck.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import Sin\n>>> Vector.objects.create(x=5.4, y=-2.3)\n>>> vector = Vector.objects.annotate(x_sin=Sin("x"), y_sin=Sin("y")).get()\n>>> vector.x_sin, vector.y_sin\n(-0.7727644875559871, -0.7457052121767203)\n
\n

Den kan också registreras som en transform. Till exempel:

\n
Python console
>>> from django.db.models import FloatField\n>>> from django.db.models.functions import Sin\n>>> FloatField.register_lookup(Sin)\n>>> # Get vectors whose sin() is less than 0\n>>> vectors = Vector.objects.filter(x__sin__lt=0, y__sin__lt=0)\n
\n
\n
\n

SqrtLink to this heading#

\n
\n
\nclass Sqrt(expression, **extra)Link to this definition#
\n
\n\n

Returnerar kvadratroten av ett icke-negativt numeriskt fält eller uttryck.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import Sqrt\n>>> Vector.objects.create(x=4.0, y=12.0)\n>>> vector = Vector.objects.annotate(x_sqrt=Sqrt("x"), y_sqrt=Sqrt("y")).get()\n>>> vector.x_sqrt, vector.y_sqrt\n(2.0, 3.46410)\n
\n

Den kan också registreras som en transform. Till exempel:

\n
Python console
>>> from django.db.models import FloatField\n>>> from django.db.models.functions import Sqrt\n>>> FloatField.register_lookup(Sqrt)\n>>> # Get vectors whose sqrt() is less than 5\n>>> vectors = Vector.objects.filter(x__sqrt__lt=5, y__sqrt__lt=5)\n
\n
\n
\n

TanLink to this heading#

\n
\n
\nclass Tan(expression, **extra)Link to this definition#
\n
\n\n

Returnerar tangenten för ett numeriskt fält eller uttryck.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import Tan\n>>> Vector.objects.create(x=0, y=12)\n>>> vector = Vector.objects.annotate(x_tan=Tan("x"), y_tan=Tan("y")).get()\n>>> vector.x_tan, vector.y_tan\n(0.0, -0.6358599286615808)\n
\n

Den kan också registreras som en transform. Till exempel:

\n
Python console
>>> from django.db.models import FloatField\n>>> from django.db.models.functions import Tan\n>>> FloatField.register_lookup(Tan)\n>>> # Get vectors whose tangent is less than 0\n>>> vectors = Vector.objects.filter(x__tan__lt=0, y__tan__lt=0)\n
\n
\n
\n
\n

TextfunktionerLink to this heading#

\n
\n

ChrLink to this heading#

\n
\n
\nclass Chr(expression, **extra)Link to this definition#
\n
\n\n

Accepterar ett numeriskt fält eller uttryck och returnerar textrepresentationen av uttrycket som ett enda tecken. Den fungerar på samma sätt som Pythons funktion chr().

\n

Precis som Length kan den registreras som en transform på IntegerField. Standarduppslagsnamnet är chr.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import Chr\n>>> Author.objects.create(name="Margaret Smith")\n>>> author = Author.objects.filter(name__startswith=Chr(ord("M"))).get()\n>>> print(author.name)\nMargaret Smith\n
\n
\n
\n

ConcatLink to this heading#

\n
\n
\nclass Concat(*expressions, **extra)Link to this definition#
\n
\n\n

Accepterar en lista med minst två textfält eller uttryck och returnerar den sammanlänkade texten. Varje argument måste vara av typen text eller char. Om du vill konkatenera ett TextField() med ett CharField(), se då till att tala om för Django att output_field ska vara ett TextField(). Att ange ett output_field krävs också när man sammanfogar ett Value som i exemplet nedan.

\n

Denna funktion kommer aldrig att ha ett null-resultat. På backends där ett null-argument resulterar i att hela uttrycket blir null, kommer Django att se till att varje null-del konverteras till en tom sträng först.

\n

Exempel på användning:

\n
Python console
>>> # Get the display name as "name (goes_by)"\n>>> from django.db.models import CharField, Value as V\n>>> from django.db.models.functions import Concat\n>>> Author.objects.create(name="Margaret Smith", goes_by="Maggie")\n>>> author = Author.objects.annotate(\n...     screen_name=Concat("name", V(" ("), "goes_by", V(")"), output_field=CharField())\n... ).get()\n>>> print(author.screen_name)\nMargaret Smith (Maggie)\n
\n
\n
\n

VänsterLink to this heading#

\n
\n
\nclass Left(expression, length, **extra)Link to this definition#
\n
\n\n

Returnerar de första tecknen i length i det angivna textfältet eller uttrycket.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import Left\n>>> Author.objects.create(name="Margaret Smith")\n>>> author = Author.objects.annotate(first_initial=Left("name", 1)).get()\n>>> print(author.first_initial)\nM\n
\n
\n
\n

LängdLink to this heading#

\n
\n
\nclass Length(expression, **extra)Link to this definition#
\n
\n\n

Accepterar ett enda textfält eller uttryck och returnerar antalet tecken som värdet har. Om uttrycket är null blir längden också null.

\n

Exempel på användning:

\n
Python console
>>> # Get the length of the name and goes_by fields\n>>> from django.db.models.functions import Length\n>>> Author.objects.create(name="Margaret Smith")\n>>> author = Author.objects.annotate(\n...     name_length=Length("name"), goes_by_length=Length("goes_by")\n... ).get()\n>>> print(author.name_length, author.goes_by_length)\n(14, None)\n
\n

Den kan också registreras som en transform. Till exempel:

\n
Python console
>>> from django.db.models import CharField\n>>> from django.db.models.functions import Length\n>>> CharField.register_lookup(Length)\n>>> # Get authors whose name is longer than 7 characters\n>>> authors = Author.objects.filter(name__length__gt=7)\n
\n
\n
\n

LägreLink to this heading#

\n
\n
\nclass Lower(expression, **extra)Link to this definition#
\n
\n\n

Accepterar ett enda textfält eller uttryck och returnerar representationen med små bokstäver.

\n

Den kan också registreras som en transform enligt beskrivningen i Length.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import Lower\n>>> Author.objects.create(name="Margaret Smith")\n>>> author = Author.objects.annotate(name_lower=Lower("name")).get()\n>>> print(author.name_lower)\nmargaret smith\n
\n
\n
\n

LPadLink to this heading#

\n
\n
\nclass LPad(expression, length, fill_text=Value(' '), **extra)Link to this definition#
\n
\n\n

Returnerar värdet i det angivna textfältet eller uttrycket, utfyllt på vänster sida med fill_text så att det resulterande värdet är length tecken långt. Standardvärdet för fill_text är ett mellanslag.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models import Value\n>>> from django.db.models.functions import LPad\n>>> Author.objects.create(name="John", alias="j")\n>>> Author.objects.update(name=LPad("name", 8, Value("abc")))\n1\n>>> print(Author.objects.get(alias="j").name)\nabcaJohn\n
\n
\n
\n

LTrimLink to this heading#

\n
\n
\nclass LTrim(expression, **extra)Link to this definition#
\n
\n\n

Liknar Trim, men tar bara bort inledande mellanslag.

\n
\n
\n

MD5Link to this heading#

\n
\n
\nclass MD5(expression, **extra)Link to this definition#
\n
\n\n

Accepterar ett enda textfält eller uttryck och returnerar MD5-hashvärdet för strängen.

\n

Den kan också registreras som en transform enligt beskrivningen i Length.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import MD5\n>>> Author.objects.create(name="Margaret Smith")\n>>> author = Author.objects.annotate(name_md5=MD5("name")).get()\n>>> print(author.name_md5)\n749fb689816b2db85f5b169c2055b247\n
\n
\n
\n

OrdLink to this heading#

\n
\n
\nclass Ord(expression, **extra)Link to this definition#
\n
\n\n

Accepterar ett enda textfält eller uttryck och returnerar Unicode-kodpunktsvärdet för det första tecknet i uttrycket. Den fungerar på samma sätt som Pythons funktion ord(), men ett undantag görs inte om uttrycket är mer än ett tecken långt.

\n

Den kan också registreras som en transform enligt beskrivningen i Length. Standardnamnet på uppslagsordet är ord.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import Ord\n>>> Author.objects.create(name="Margaret Smith")\n>>> author = Author.objects.annotate(name_code_point=Ord("name")).get()\n>>> print(author.name_code_point)\n77\n
\n
\n
\n

UpprepaLink to this heading#

\n
\n
\nclass Repeat(expression, number, **extra)Link to this definition#
\n
\n\n

Returnerar värdet av det angivna textfältet eller uttrycket som upprepats antal gånger.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import Repeat\n>>> Author.objects.create(name="John", alias="j")\n>>> Author.objects.update(name=Repeat("name", 3))\n1\n>>> print(Author.objects.get(alias="j").name)\nJohnJohnJohn\n
\n
\n
\n

ReplaceLink to this heading#

\n
\n
\nclass Replace(expression, text, replacement=Value(''), **extra)Link to this definition#
\n
\n\n

Ersätter alla förekomster av text med replacement i expression. Standardvärdet för ersättningstexten är den tomma strängen. Argumenten till funktionen är skiftlägeskänsliga.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models import Value\n>>> from django.db.models.functions import Replace\n>>> Author.objects.create(name="Margaret Johnson")\n>>> Author.objects.create(name="Margaret Smith")\n>>> Author.objects.update(name=Replace("name", Value("Margaret"), Value("Margareth")))\n2\n>>> Author.objects.values("name")\n<QuerySet [{'name': 'Margareth Johnson'}, {'name': 'Margareth Smith'}]>\n
\n
\n
\n

ReverseLink to this heading#

\n
\n
\nclass Reverse(expression, **extra)Link to this definition#
\n
\n\n

Accepterar ett enda textfält eller uttryck och returnerar tecknen i uttrycket i omvänd ordning.

\n

Den kan också registreras som en transform enligt beskrivningen i Length. Standarduppslagsnamnet är reverse.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import Reverse\n>>> Author.objects.create(name="Margaret Smith")\n>>> author = Author.objects.annotate(backward=Reverse("name")).get()\n>>> print(author.backward)\nhtimS teragraM\n
\n
\n
\n

HögerLink to this heading#

\n
\n
\nclass Right(expression, length, **extra)Link to this definition#
\n
\n\n

Returnerar de sista tecknen i length i det angivna textfältet eller uttrycket.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import Right\n>>> Author.objects.create(name="Margaret Smith")\n>>> author = Author.objects.annotate(last_letter=Right("name", 1)).get()\n>>> print(author.last_letter)\nh\n
\n
\n
\n

RPadLink to this heading#

\n
\n
\nclass RPad(expression, length, fill_text=Value(' '), **extra)Link to this definition#
\n
\n\n

Liknar LPad, men är på höger sida.

\n
\n
\n

RTrimLink to this heading#

\n
\n
\nclass RTrim(expression, **extra)Link to this definition#
\n
\n\n

Liknar Trim, men tar bara bort efterföljande mellanslag.

\n
\n
\n

SHA1, SHA224, SHA256, SHA384 och SHA512Link to this heading#

\n
\n
\nclass SHA1(expression, **extra)Link to this definition#
\n
\n\n
\n
\nclass SHA224(expression, **extra)Link to this definition#
\n
\n\n
\n
\nclass SHA256(expression, **extra)Link to this definition#
\n
\n\n
\n
\nclass SHA384(expression, **extra)Link to this definition#
\n
\n\n
\n
\nclass SHA512(expression, **extra)Link to this definition#
\n
\n\n

Accepterar ett enda textfält eller uttryck och returnerar den specifika hashen för strängen.

\n

De kan också registreras som transformationer enligt beskrivningen i Length.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import SHA1\n>>> Author.objects.create(name="Margaret Smith")\n>>> author = Author.objects.annotate(name_sha1=SHA1("name")).get()\n>>> print(author.name_sha1)\nb87efd8a6c991c390be5a68e8a7945a7851c7e5c\n
\n\n\n
\n
\n

StrIndexLink to this heading#

\n
\n
\nclass StrIndex(expression, substring, **extra)Link to this definition#
\n
\n\n

Returnerar ett positivt heltal som motsvarar den 1-indexerade positionen för den första förekomsten av substring i expression, eller 0 om substring inte hittas.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models import Value as V\n>>> from django.db.models.functions import StrIndex\n>>> Author.objects.create(name="Margaret Smith")\n>>> Author.objects.create(name="Smith, Margaret")\n>>> Author.objects.create(name="Margaret Jackson")\n>>> Author.objects.filter(name="Margaret Jackson").annotate(\n...     smith_index=StrIndex("name", V("Smith"))\n... ).get().smith_index\n0\n>>> authors = Author.objects.annotate(smith_index=StrIndex("name", V("Smith"))).filter(\n...     smith_index__gt=0\n... )\n<QuerySet [<Author: Margaret Smith>, <Author: Smith, Margaret>]>\n
\n\n
\n
\n

SubstrLink to this heading#

\n
\n
\nclass Substr(expression, pos, length=None, **extra)Link to this definition#
\n
\n\n

Returnerar en delsträng med längden length från fältet eller uttrycket som börjar vid positionen pos. Positionen är 1-indexerad, så positionen måste vara större än 0. Om length är None returneras resten av strängen.

\n

Exempel på användning:

\n
Python console
>>> # Set the alias to the first 5 characters of the name as lowercase\n>>> from django.db.models.functions import Lower, Substr\n>>> Author.objects.create(name="Margaret Smith")\n>>> Author.objects.update(alias=Lower(Substr("name", 1, 5)))\n1\n>>> print(Author.objects.get(name="Margaret Smith").alias)\nmarga\n
\n
\n
\n

TrimLink to this heading#

\n
\n
\nclass Trim(expression, **extra)Link to this definition#
\n
\n\n

Returnerar värdet för det angivna textfältet eller uttrycket med inledande och avslutande mellanslag borttagna.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import Trim\n>>> Author.objects.create(name="  John  ", alias="j")\n>>> Author.objects.update(name=Trim("name"))\n1\n>>> print(Author.objects.get(alias="j").name)\nJohn\n
\n
\n
\n

ÖvreLink to this heading#

\n
\n
\nclass Upper(expression, **extra)Link to this definition#
\n
\n\n

Accepterar ett enda textfält eller uttryck och returnerar representationen med versaler.

\n

Den kan också registreras som en transform enligt beskrivningen i Length.

\n

Exempel på användning:

\n
Python console
>>> from django.db.models.functions import Upper\n>>> Author.objects.create(name="Margaret Smith")\n>>> author = Author.objects.annotate(name_upper=Upper("name")).get()\n>>> print(author.name_upper)\nMARGARET SMITH\n
\n
\n
\n
\n

UUID-funktionerLink to this heading#

\n
\n

UUID4Link to this heading#

\n\n
\n
\nclass UUID4Link to this definition#
\n
\n\n

Genererar ett UUID av version 4, som är slumpmässigt och genereras med en kryptografiskt säker metod.

\n\n
\n
\n

UUID7Link to this heading#

\n\n
\n
\nclass UUID7(shift=None)Link to this definition#
\n
\n\n

Genererar ett UUID av version 7, som börjar med en tidsbaserad komponent.

\n\n\n
\n
\n
\n

FönsterfunktionerLink to this heading#

\n

Det finns ett antal funktioner som kan användas i ett Window-uttryck för att beräkna rangordningen av element eller Ntile för vissa rader.

\n
\n

CumeDistLink to this heading#

\n
\n
\nclass CumeDist(*expressions, **extra)Link to this definition#
\n
\n\n

Beräknar den kumulativa fördelningen av ett värde inom ett fönster eller en partition. Den kumulativa fördelningen definieras som antalet rader som föregår eller är jämförda med den aktuella raden dividerat med det totala antalet rader i ramen.

\n
\n
\n

DenseRankLink to this heading#

\n
\n
\nclass DenseRank(*expressions, **extra)Link to this definition#
\n
\n\n

Motsvarar Rank men har inte luckor.

\n
\n
\n

Första VärdeLink to this heading#

\n
\n
\nclass FirstValue(expression, **extra)Link to this definition#
\n
\n\n

Returnerar det värde som utvärderas på den rad som är den första raden i fönsterramen, eller None om inget sådant värde finns.

\n
\n
\n

LagLink to this heading#

\n
\n
\nclass Lag(expression, offset=1, default=None, **extra)Link to this definition#
\n
\n\n

Beräknar värdet som förskjuts med offset, och om ingen rad finns där returneras default.

\n

default måste ha samma typ som expression, men detta valideras endast av databasen och inte i Python.

\n\n
\n
\n

Sista VärdeLink to this heading#

\n
\n
\nclass LastValue(expression, **extra)Link to this definition#
\n
\n\n

Jämförbart med FirstValue, beräknar det det sista värdet i en given ramklausul.

\n
\n
\n

LedareLink to this heading#

\n
\n
\nclass Lead(expression, offset=1, default=None, **extra)Link to this definition#
\n
\n\n

Beräknar det ledande värdet i en given frame. Både offset och default utvärderas med avseende på den aktuella raden.

\n

default måste ha samma typ som expression, men detta valideras endast av databasen och inte i Python.

\n\n
\n
\n

NthValueLink to this heading#

\n
\n
\nclass NthValue(expression, nth=1, **extra)Link to this definition#
\n
\n\n

Beräknar raden i förhållande till offset nth (måste vara ett positivt värde) inom fönstret. Returnerar None om det inte finns någon rad.

\n

Vissa databaser kan hantera ett icke-existerande nionde värde på ett annat sätt. Oracle returnerar t.ex. en tom sträng istället för None för teckenbaserade uttryck. Django gör inga konverteringar i dessa fall.

\n
\n
\n

NtileLink to this heading#

\n
\n
\nclass Ntile(num_buckets=1, **extra)Link to this definition#
\n
\n\n

Beräknar en partition för var och en av raderna i ramklausulen och fördelar siffrorna så jämnt som möjligt mellan 1 och num_buckets. Om raderna inte delas upp jämnt i ett antal buckets kommer en eller flera buckets att representeras oftare.

\n
\n
\n

PercentRankLink to this heading#

\n
\n
\nclass PercentRank(*expressions, **extra)Link to this definition#
\n
\n\n

Beräknar den relativa rangordningen av raderna i ramsatsen. Denna beräkning är likvärdig med att utvärdera:

\n
Text
(rank - 1) / (total rows - 1)\n
\n

I följande tabell förklaras beräkningen av den relativa rangordningen för en rad:

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Rad #

Värde

Rank

Beräkning

Relativ rang

1

15

1

(1-1)/(7-1)

0.0000

2

20

2

(2-1)/(7-1)

0.1666

3

20

2

(2-1)/(7-1)

0.1666

4

20

2

(2-1)/(7-1)

0.1666

5

30

5

(5-1)/(7-1)

0.6666

6

30

5

(5-1)/(7-1)

0.6666

7

40

7

(7-1)/(7-1)

1.0000

\n
\n
\n
\n

RankLink to this heading#

\n
\n
\nclass Rank(*expressions, **extra)Link to this definition#
\n
\n\n

Denna funktion är jämförbar med RowNumber och rangordnar raderna i fönstret. Den beräknade rankningen innehåller luckor. Använd DenseRank för att beräkna rangordning utan luckor.

\n
\n
\n

RowNumberLink to this heading#

\n
\n
\nclass RowNumber(*expressions, **extra)Link to this definition#
\n
\n\n

Beräknar radnumret enligt ordningsföljden för antingen ramklausulen eller ordningsföljden för hela frågan om det inte finns någon partitionering av window frame.

\n
\n
","rootId":"module-django.db.models.functions","toc":[{"title":"Jämförelse- och omvandlingsfunktioner","anchor":"comparison-and-conversion-functions","children":[{"title":"Sändning","anchor":"cast","children":[]},{"title":"Koalesera","anchor":"coalesce","children":[]},{"title":"”Samarbeta","anchor":"collate","children":[]},{"title":"Greatest","anchor":"greatest","children":[]},{"title":"Minsta","anchor":"least","children":[]},{"title":"NullIf","anchor":"nullif","children":[]}]},{"title":"Datumfunktioner","anchor":"date-functions","children":[{"title":"Extract","anchor":"extract","children":[{"title":"DateField utdrag","anchor":"datefield-extracts","children":[]},{"title":"DateTimeField utdrag","anchor":"datetimefield-extracts","children":[]}]},{"title":"Nu","anchor":"now","children":[]},{"title":"Trunc","anchor":"trunc","children":[{"title":"trunkering av DateField","anchor":"datefield-truncation","children":[]},{"title":"trunkering av DateTimeField","anchor":"datetimefield-truncation","children":[]},{"title":"trunkering av TimeField","anchor":"timefield-truncation","children":[]}]}]},{"title":"JSON-funktioner","anchor":"json-functions","children":[{"title":"JSONArray","anchor":"jsonarray","children":[]},{"title":"JSONObject","anchor":"jsonobject","children":[]}]},{"title":"Matematiska funktioner","anchor":"math-functions","children":[{"title":"Abs","anchor":"abs","children":[]},{"title":"”ACos","anchor":"acos","children":[]},{"title":"ASin","anchor":"asin","children":[]},{"title":"ATan","anchor":"atan","children":[]},{"title":"ATan2","anchor":"atan2","children":[]},{"title":"Tak","anchor":"ceil","children":[]},{"title":"Cos","anchor":"cos","children":[]},{"title":"Cot","anchor":"cot","children":[]},{"title":"Degrees","anchor":"degrees","children":[]},{"title":"Exp","anchor":"exp","children":[]},{"title":"Golv","anchor":"floor","children":[]},{"title":"Ln","anchor":"ln","children":[]},{"title":"Log","anchor":"log","children":[]},{"title":"Mod","anchor":"mod","children":[]},{"title":"Pi","anchor":"pi","children":[]},{"title":"Kraft","anchor":"power","children":[]},{"title":"Radianer","anchor":"radians","children":[]},{"title":"Random","anchor":"random","children":[]},{"title":"Rund","anchor":"round","children":[]},{"title":"Sign","anchor":"sign","children":[]},{"title":"Sin","anchor":"sin","children":[]},{"title":"Sqrt","anchor":"sqrt","children":[]},{"title":"Tan","anchor":"tan","children":[]}]},{"title":"Textfunktioner","anchor":"text-functions","children":[{"title":"Chr","anchor":"chr","children":[]},{"title":"Concat","anchor":"concat","children":[]},{"title":"Vänster","anchor":"left","children":[]},{"title":"Längd","anchor":"length","children":[]},{"title":"Lägre","anchor":"lower","children":[]},{"title":"LPad","anchor":"lpad","children":[]},{"title":"LTrim","anchor":"ltrim","children":[]},{"title":"MD5","anchor":"md5","children":[]},{"title":"Ord","anchor":"ord","children":[]},{"title":"Upprepa","anchor":"repeat","children":[]},{"title":"Replace","anchor":"replace","children":[]},{"title":"Reverse","anchor":"reverse","children":[]},{"title":"Höger","anchor":"right","children":[]},{"title":"RPad","anchor":"rpad","children":[]},{"title":"RTrim","anchor":"rtrim","children":[]},{"title":"SHA1, SHA224, SHA256, SHA384 och SHA512","anchor":"sha1-sha224-sha256-sha384-and-sha512","children":[]},{"title":"StrIndex","anchor":"strindex","children":[]},{"title":"Substr","anchor":"substr","children":[]},{"title":"Trim","anchor":"trim","children":[]},{"title":"Övre","anchor":"upper","children":[]}]},{"title":"UUID-funktioner","anchor":"uuid-functions","children":[{"title":"UUID4","anchor":"uuid4","children":[]},{"title":"UUID7","anchor":"uuid7","children":[]}]},{"title":"Fönsterfunktioner","anchor":"id5","children":[{"title":"CumeDist","anchor":"cumedist","children":[]},{"title":"DenseRank","anchor":"denserank","children":[]},{"title":"Första Värde","anchor":"firstvalue","children":[]},{"title":"Lag","anchor":"lag","children":[]},{"title":"Sista Värde","anchor":"lastvalue","children":[]},{"title":"Ledare","anchor":"lead","children":[]},{"title":"NthValue","anchor":"nthvalue","children":[]},{"title":"Ntile","anchor":"ntile","children":[]},{"title":"PercentRank","anchor":"percentrank","children":[]},{"title":"Rank","anchor":"rank","children":[]},{"title":"RowNumber","anchor":"rownumber","children":[]}]}],"breadcrumbs":[{"docname":"ref/index","title":"API-referens","url":"/sv/6.1/ref/"},{"docname":"ref/models/index","title":"Modeller","url":"/sv/6.1/ref/models/"}],"prev":{"docname":"ref/models/conditional-expressions","title":"Villkorliga uttryck","url":"/sv/6.1/ref/models/conditional-expressions/"},"next":{"docname":"ref/paginator","title":"Paginator","url":"/sv/6.1/ref/paginator/"},"formats":{"html":"/sv/6.1/ref/models/database-functions/","markdown":"/sv/6.1/ref/models/database-functions.md","json":"/sv/6.1/ref/models/database-functions.json"},"source":"https://github.com/django/django/blob/stable/6.1.x/docs/ref/models/database-functions.txt","official":"https://docs.djangoproject.com/sv/6.1/ref/models/database-functions/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}