# Django 5.2.8 documentation

# Datumbaserade mixins

Observera

Alla datumformateringsattribut i dessa mixins använder `strftime()` formattecken. Försök inte använda formatkaraktärerna från `now` malltaggen eftersom de inte är kompatibla.

## `ÅrMixin`

class YearMixin

  En mixin som kan användas för att hämta och tillhandahålla tolkningsinformation för en årskomponent i ett datum.

  Metoder och egenskaper

  year_format

    Det `strftime()`-format som ska användas när året analyseras. Som standard är detta `'%Y'`.

  year

    Optional Värdet för årtalet, som en sträng. Som standard inställt på `None`, vilket innebär att året kommer att bestämmas på annat sätt.

  get_year_format()

    Returnerar `strftime()`-formatet som ska användas vid parsning av årtalet. Returnerar `year_format` som standard.

  get_year()

    Returnerar året för vilket denna vy kommer att visa data, som en sträng. Prövar följande källor i tur och ordning:

    - Värdet på attributet `YearMixin.year`.

    - Värdet på argumentet `year` som fångas upp i URL-mönstret.

    - Värdet av frågeargumentet `year` `GET`.

    Ger 404 om ingen giltig årsspecifikation kan hittas.

  get_next_year(date)

    Returnerar ett datumobjekt som innehåller den första dagen i året efter det angivna datumet. Denna funktion kan också returnera `None` eller ge upphov till ett `Http404` undantag, beroende på värdena för `allow_empty` och `allow_future`.

  get_previous_year(date)

    Returnerar ett datumobjekt som innehåller den första dagen i året före det angivna datumet. Denna funktion kan också returnera `None` eller ge upphov till ett `Http404` undantag, beroende på värdena för `allow_empty` och `allow_future`.

## `MånadMixin`

class MonthMixin

  En mixin som kan användas för att hämta och tillhandahålla tolkningsinformation för en månadskomponent i ett datum.

  Metoder och egenskaper

  month_format

    Det `strftime()`-format som ska användas när månaden analyseras. Som standard är detta `'%b'`.

  month

    Optional Värdet för månaden, som en sträng. Som standard inställd på `None`, vilket innebär att månaden kommer att bestämmas på annat sätt.

  get_month_format()

    Returnerar `strftime()`-formatet som ska användas vid parsning av månaden. Returnerar `month_format` som standard.

  get_month()

    Returnerar den månad för vilken denna vy kommer att visa data, som en sträng. Prövar följande källor i tur och ordning:

    - Värdet på attributet `MonthMixin.month`.

    - Värdet på argumentet `month` som fångas upp i URL-mönstret.

    - Värdet på frågeargumentet `month` `GET`.

    Ger 404 om ingen giltig månadsspecifikation kan hittas.

  get_next_month(date)

    Returnerar ett datumobjekt som innehåller den första dagen i månaden efter det angivna datumet. Denna funktion kan också returnera `None` eller ge upphov till ett `Http404` undantag, beroende på värdena för `allow_empty` och `allow_future`.

  get_previous_month(date)

    Returnerar ett datumobjekt som innehåller den första dagen i månaden före det angivna datumet. Denna funktion kan också returnera `None` eller ge upphov till ett `Http404` undantag, beroende på värdena för `allow_empty` och `allow_future`.

## `DayMixin`

class DayMixin

  En mixin som kan användas för att hämta och tillhandahålla tolkningsinformation för en dagskomponent i ett datum.

  Metoder och egenskaper

  day_format

    Det `strftime()`-format som ska användas när dagen analyseras. Som standard är detta `%d'`.

  day

    Optional Värdet för dagen, som en sträng. Som standard inställd på `None`, vilket innebär att dagen kommer att bestämmas på annat sätt.

  get_day_format()

    Returnerar `strftime()`-formatet som ska användas vid parsning av dagen. Returnerar `day_format` som standard.

  get_day()

    Returnerar den dag för vilken denna vy ska visa data, som en sträng. Prövar följande källor i tur och ordning:

    - Värdet på attributet `DayMixin.day`.

    - Värdet på argumentet `day` som fångas upp i URL-mönstret.

    - Värdet på frågeargumentet `day` `GET`.

    Ger 404 om ingen giltig dagspecifikation kan hittas.

  get_next_day(date)

    Returnerar ett datumobjekt som innehåller nästa giltiga dag efter det angivna datumet. Denna funktion kan också returnera `None` eller ge upphov till ett `Http404` undantag, beroende på värdena för `allow_empty` och `allow_future`.

  get_previous_day(date)

    Returnerar ett datumobjekt som innehåller den föregående giltiga dagen. Denna funktion kan också returnera `None` eller ge upphov till ett `Http404` undantag, beroende på värdena för `allow_empty` och `allow_future`.

## `WeekMixin`

class WeekMixin

  En mixin som kan användas för att hämta och tillhandahålla tolkningsinformation för en veckokomponent i ett datum.

  Metoder och egenskaper

  week_format

    Det `strftime()`-format som ska användas när veckan analyseras. Som standard är detta `'%U'`, vilket innebär att veckan börjar på söndag. Ställ in det till `'%W'` eller `'%V'` (ISO 8601-vecka) om din vecka börjar på måndag.

  week

    Optional Värdet för veckan, som en sträng. Som standard inställd på `None`, vilket innebär att veckan kommer att bestämmas på annat sätt.

  get_week_format()

    Returnerar `strftime()`-formatet som ska användas vid parsning av veckan. Returnerar `week_format` som standard.

  get_week()

    Returnerar den vecka för vilken denna vy kommer att visa data, som en sträng. Prövar följande källor i tur och ordning:

    - Värdet på attributet `WeekMixin.week`.

    - Värdet på argumentet `week` som fångas upp i URL-mönstret

    - Värdet på frågeargumentet `week` `GET`.

    Ger 404 om ingen giltig veckospecifikation kan hittas.

  get_next_week(date)

    Returnerar ett datumobjekt som innehåller den första dagen i veckan efter det angivna datumet. Denna funktion kan också returnera `None` eller ge upphov till ett `Http404` undantag, beroende på värdena för `allow_empty` och `allow_future`.

  get_prev_week(date)

    Returnerar ett datumobjekt som innehåller den första dagen i veckan före det angivna datumet. Denna funktion kan också returnera `None` eller ge upphov till ett `Http404` undantag, beroende på värdena för `allow_empty` och `allow_future`.

## `DatumMixin`

class DateMixin

  En mixin-klass som ger ett gemensamt beteende för alla datumbaserade vyer.

  Metoder och egenskaper

  date_field

    Namnet på den `DateField` eller `DateTimeField` i `QuerySet`-modellen som det datumbaserade arkivet ska använda för att fastställa listan över objekt som ska visas på sidan.

    När time zone support är aktiverat och `date_field` är en `DateTimeField`, antas datum vara i den aktuella tidszonen. I annat fall kan frågeuppsättningen innehålla objekt från föregående eller nästa dag i slutanvändarens tidszon.

    Varning

    I den här situationen, om du har implementerat tidszonsval per användare, kan samma URL visa en annan uppsättning objekt beroende på slutanvändarens tidszon. För att undvika detta bör du använda en `DateField` som attribut för `date_field`.

  allow_future

    Ett boolean som anger om ”framtida” objekt ska inkluderas på den här sidan, där ”framtida” betyder objekt där fältet som anges i `date_field` är större än aktuellt datum/tid. Som standard är detta `False`.

  get_date_field()

    Returnerar namnet på det fält som innehåller de datumdata som den här vyn ska hantera. Returnerar `date_field` som standard.

  get_allow_future()

    Bestämmer om ”framtida” objekt ska inkluderas på den här sidan, där ”framtida” betyder objekt där fältet som anges i `date_field` är större än aktuellt datum/tid. Returnerar `allow_future` som standard.

## `BaseDateListView`

class BaseDateListView

  En basklass som ger ett gemensamt beteende för alla datumbaserade vyer. Det kommer normalt inte att finnas någon anledning att instansiera `BaseDateListView`; instansiera en av underklasserna istället.

  Medan den här vyn (och dess underklasser) körs kommer `self.object_list` att innehålla listan över objekt som vyn arbetar med och `self.date_list` kommer att innehålla listan över datum för vilka data finns tillgängliga.

  Mixins

  - `DateMixin`

  - `MultipleObjectMixin`

  Metoder och egenskaper

  allow_empty

    En boolean som anger om sidan ska visas om inga objekt finns tillgängliga. Om detta är `True` och inga objekt finns tillgängliga, kommer vyn att visa en tom sida istället för att skicka en 404.

    Detta är identiskt med `django.views.generic.list.MultipleObjectMixin.allow_empty`, förutom standardvärdet som är `False`.

  date_list_period

    Optional En sträng som definierar aggregeringsperioden för `date_list`. Den måste vara en av `'year'` (standard), `'month'` eller `'day'`.

  get_dated_items()

    Returnerar en 3-tupel som innehåller (`date_list`, `object_list`, `extra_context`).

    `date_list` är listan över datum för vilka data finns tillgängliga. `object_list` är en lista över objekt. `extra_context` är en ordbok med kontextdata som kommer att läggas till alla kontextdata som tillhandahålls av `MultipleObjectMixin`.

  get_dated_queryset(**lookup)

    Returnerar en frågeuppsättning, filtrerad med hjälp av de frågeargument som definieras av `lookup`. Tillämpar eventuella restriktioner på frågeuppsättningen, t.ex. `allow_empty` och `allow_future`.

  get_date_list_period()

    Returnerar aggregeringsperioden för `date_list`. Returnerar `date_list_period` som standard.

  get_date_list(queryset, date_type=None, ordering='ASC')

    Returnerar listan med datum av typen `date_type` som `queryset` innehåller poster för. Till exempel: kommer `get_date_list(qs, 'year')` att returnera listan över år för vilka `qs` har poster. Om `date_type` inte anges, används resultatet av `get_date_list_period()`. `date_type` och `ordering` skickas till `QuerySet.dates()`.