ÅrMixinLink to this heading#En mixin som kan användas för att hämta och tillhandahålla tolkningsinformation för en årskomponent i ett datum.
\nMetoder och egenskaper
\nDet strftime()-format som ska användas när året analyseras. Som standard är detta '%Y'.
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.
Returnerar strftime()-formatet som ska användas vid parsning av årtalet. Returnerar year_format som standard.
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:
\nVä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.
\nReturnerar 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.
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ånadMixinLink to this heading#En mixin som kan användas för att hämta och tillhandahålla tolkningsinformation för en månadskomponent i ett datum.
\nMetoder och egenskaper
\nDet strftime()-format som ska användas när månaden analyseras. Som standard är detta '%b'.
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.
Returnerar strftime()-formatet som ska användas vid parsning av månaden. Returnerar month_format som standard.
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:
\nVä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.
\nReturnerar 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.
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.
DayMixinLink to this heading#En mixin som kan användas för att hämta och tillhandahålla tolkningsinformation för en dagskomponent i ett datum.
\nMetoder och egenskaper
\nDet strftime()-format som ska användas när dagen analyseras. Som standard är detta %d'.
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.
Returnerar strftime()-formatet som ska användas vid parsning av dagen. Returnerar day_format som standard.
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:
\nVä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.
\nReturnerar 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.
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.
WeekMixinLink to this heading#En mixin som kan användas för att hämta och tillhandahålla tolkningsinformation för en veckokomponent i ett datum.
\nMetoder och egenskaper
\nDet 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.
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.
Returnerar strftime()-formatet som ska användas vid parsning av veckan. Returnerar week_format som standard.
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:
\nVä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.
\nReturnerar 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.
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.
DatumMixinLink to this heading#En mixin-klass som ger ett gemensamt beteende för alla datumbaserade vyer.
\nMetoder och egenskaper
\nNamnet 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.
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.
Returnerar namnet på det fält som innehåller de datumdata som den här vyn ska hantera. Returnerar date_field som standard.
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.
BaseDateListViewLink to this heading#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
\n\nMetoder och egenskaper
\nEn 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.
Optional En sträng som definierar aggregeringsperioden för date_list. Den måste vara en av 'year' (standard), 'month' eller 'day'.
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.
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.
Returnerar aggregeringsperioden för date_list. Returnerar date_list_period som standard.
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().