Mixins basées sur les datesLien vers cette rubrique#

Une classe mixin pouvant être utilisée pour extraire et fournir des informations d’analyse pour le composant année d’une date.

Méthodes et attributs

year_formatLien vers cette définition#

Le format strftime() à utiliser lors de l’extraction de l’année. Par défaut, il s’agit de '%Y'.

yearLien vers cette définition#

Facultatif La valeur de l’année, sous forme de chaîne. Vaut None par défaut, ce qui signifie que l’année sera déterminée par d’autres moyens.

get_year_format()Lien vers cette définition#

Renvoie le format strftime() à utiliser lors de l’extraction de l’année. Renvoie year_format par défaut.

get_year()Lien vers cette définition#

Renvoie l’année pour laquelle cette vue va afficher les données, sous forme de chaîne. Essaie les sources suivantes dans l’ordre :

• La valeur de l’attribut YearMixin.year.

• La valeur du paramètre year capturé dans le motif d’URL.

• La valeur du paramètre de requête GET year.

Génère une erreur 404 si aucune année valide ne peut être trouvée.

get_next_year(date)Lien vers cette définition#

Renvoie un objet date contenant le premier jour de l’année suivant la date indiquée. Cette fonction peut aussi renvoyer None ou générer une exception Http404, en fonction des valeurs de allow_empty et de allow_future.

get_previous_year(date)Lien vers cette définition#

Renvoie un objet date contenant le premier jour de l’année précédant la date indiquée. Cette fonction peut aussi renvoyer None ou générer une exception Http404, en fonction des valeurs de allow_empty et de allow_future.

Une classe mixin pouvant être utilisée pour extraire et fournir des informations d’analyse pour le composant mois d’une date.

Méthodes et attributs

month_formatLien vers cette définition#

Le format strftime() à utiliser lors de l’extraction du mois. Par défaut, il s’agit de '%b'.

monthLien vers cette définition#

Facultatif La valeur du mois, sous forme de chaîne. Vaut None par défaut, ce qui signifie que le mois sera déterminé par d’autres moyens.

get_month_format()Lien vers cette définition#

Renvoie le format strftime() à utiliser lors de l’extraction du mois. Renvoie month_format par défaut.

get_month()Lien vers cette définition#

Renvoie le mois pour lequel cette vue va afficher les données, sous forme de chaîne. Essaie les sources suivantes dans l’ordre :

• La valeur de l’attribut MonthMixin.month.

• La valeur du paramètre month capturé dans le motif d’URL.

• La valeur du paramètre de requête GET month.

Génère une erreur 404 si aucune spécification valide du mois ne peut être trouvée.

get_next_month(date)Lien vers cette définition#

Renvoie un objet date contenant le premier jour du mois suivant la date indiquée. Cette fonction peut aussi renvoyer None ou générer une exception Http404, en fonction des valeurs de allow_empty et de allow_future.

get_previous_month(date)Lien vers cette définition#

Renvoie un objet date contenant le premier jour du mois précédant la date indiquée. Cette fonction peut aussi renvoyer None ou générer une exception Http404, en fonction des valeurs de allow_empty et de allow_future.

Une classe mixin pouvant être utilisée pour extraire et fournir des informations d’analyse pour le composant jour d’une date.

Méthodes et attributs

day_formatLien vers cette définition#

Le format strftime() à utiliser lors de l’extraction du jour. Par défaut, il s’agit de '%d'.

dayLien vers cette définition#

Facultatif La valeur du jour, sous forme de chaîne. Vaut None par défaut, ce qui signifie que le jour sera déterminé par d’autres moyens.

get_day_format()Lien vers cette définition#

Renvoie le format strftime() à utiliser lors de l’extraction du jour. Renvoie day_format par défaut.

get_day()Lien vers cette définition#

Renvoie le jour pour lequel cette vue va afficher les données, sous forme de chaîne. Essaie les sources suivantes dans l’ordre :

• La valeur de l’attribut DayMixin.day.

• La valeur du paramètre day capturé dans le motif d’URL.

• La valeur du paramètre de requête GET day.

Génère une erreur 404 si aucune spécification valide du jour ne peut être trouvée.

get_next_day(date)Lien vers cette définition#

Renvoie un objet date contenant le jour valide suivant la date indiquée. Cette fonction peut aussi renvoyer None ou générer une exception Http404, en fonction des valeurs de allow_empty et de allow_future.

get_previous_day(date)Lien vers cette définition#

Renvoie un objet date contenant le jour valide précédant la date indiquée. Cette fonction peut aussi renvoyer None ou générer une exception Http404, en fonction des valeurs de allow_empty et de allow_future.

Une classe mixin pouvant être utilisée pour extraire et fournir des informations d’analyse pour le composant semaine d’une date.

Méthodes et attributs

week_formatLien vers cette définition#

Le format strftime() à utiliser lors de l’extraction de la semaine. Par défaut, il s’agit de '%U', ce qui signifie que la semaine commence le dimanche. Définissez-le à '%W' si la semaine commence un lundi pour vous.

weekLien vers cette définition#

Facultatif La valeur de la semaine, sous forme de chaîne. Vaut None par défaut, ce qui signifie que la semaine sera déterminée par d’autres moyens.

get_week_format()Lien vers cette définition#

Renvoie le format strftime() à utiliser lors de l’extraction de la semaine. Renvoie week_format par défaut.

get_week()Lien vers cette définition#

Renvoie la semaine pour laquelle cette vue va afficher les données, sous forme de chaîne. Essaie les sources suivantes dans l’ordre :

• La valeur de l’attribut WeekMixin.week.

• La valeur du paramètre week capturé dans le motif d’URL.

• La valeur du paramètre de requête GET week.

Génère une erreur 404 si aucune spécification valide de la semaine ne peut être trouvée.

get_next_week(date)Lien vers cette définition#

Renvoie un objet date contenant le premier jour de la semaine suivant la date indiquée. Cette fonction peut aussi renvoyer None ou générer une exception Http404, en fonction des valeurs de allow_empty et de allow_future.

get_prev_week(date)Lien vers cette définition#

Renvoie un objet date contenant le premier jour de la semaine précédant la date indiquée. Cette fonction peut aussi renvoyer None ou générer une exception Http404, en fonction des valeurs de allow_empty et de allow_future.

Une classe mixin contenant le comportement commun de toutes les vues basées sur les dates.

Méthodes et attributs

date_fieldLien vers cette définition#

Le nom du champ DateField ou DateTimeField dans le modèle du QuerySet que l’archive basée sur la date devra utiliser pour déterminer la liste des objets à afficher sur la page.

Lorsque la prise en charge des fuseaux horaires est activée et que date_field est un champ DateTimeField, on part du principe que les dates se trouvent dans le fuseau horaire actuel. Sinon, le jeu de requête pourrait inclure des objets du jour précédent ou suivant du fuseau horaire de l’utilisateur final.

allow_futureLien vers cette définition#

Une valeur booléenne indiquant s’il faut inclure les objets « futurs » sur cette page, où « futur » implique les objets pour lesquels le champ spécifié dans date_field est plus grand que la date/heure actuelle. Par défaut, cet attribut vaut False.

get_date_field()Lien vers cette définition#

Renvoie le nom du champ contenant l’information de date sur laquelle cette vue va opérer. Renvoie date_field par défaut.

get_allow_future()Lien vers cette définition#

Détermine s’il faut inclure les objets « futurs » sur cette page, où « futur » implique les objets pour lesquels le champ spécifié dans date_field est plus grand que la date/heure actuelle. Renvoie allow_future par défaut.

Une classe de base fournissant un comportement commun pour toutes les vues basées sur les dates. Il n’y a en principe aucune raison d’instancier directement BaseDateListView; créez plutôt des instances de ses sous-classes.

Lors de l’exécution de cette vue (et de ses sous-classes), self.object_list contient la liste des objets sur lesquels intervient cette vue, et self.date_list contient la liste des dates pour lesquelles des données sont disponibles.

Classes mixins

• DateMixin

• MultipleObjectMixin

Méthodes et attributs

allow_emptyLien vers cette définition#

Une valeur booléenne indiquant s’il faut afficher la page lorsqu’aucun objet n’est disponible. Si cet attribut vaut True et qu’aucun objet n’est disponible, la vue affiche une page vide au lieu de générer une erreur 404.

C’est le même attribut que django.views.generic.list.MultipleObjectMixin.allow_empty, sauf que sa valeur par défaut est False.

date_list_periodLien vers cette définition#

Facultatif Une chaîne définissant la période d’agrégation de date_list. Elle ne peut contenir que 'year' (année, par défaut), 'month' (mois), ou 'day' (jour).

get_dated_items()Lien vers cette définition#

Renvoie un tuple de 3 éléments contenant : (date_list, object_list, extra_context).

date_list est la liste des dates pour lesquelles des données sont disponibles. object_list est la liste des objets. extra_context est un dictionnaire de données de contexte qui seront ajoutées à tout autre contexte de données fourni par MultipleObjectMixin.

get_dated_queryset(**lookup)Lien vers cette définition#

Renvoie un jeu de requête, filtré par les paramètres de requête définis par lookup. Les restrictions sur le jeu de requête sont appliquées, telles que allow_empty et allow_future.

get_date_list_period()Lien vers cette définition#

Renvoie la période d’agrégation de date_list. Renvoie date_list_period par défaut.

get_date_list(queryset, date_type=None, ordering='ASC')Lien vers cette définition#

Renvoie la liste des dates de type date_type pour lesquelles le jeu de requête queryset contient des éléments. Par exemple, get_date_list(qs, 'year') renvoie la liste des années pour lesquelles qs contient des éléments. Si date_type n’est pas indiqué, c’est le résultat de get_date_list_period() qui est utilisé. date_type et ordering sont transmis à QuerySet.dates().