La classe DateTimeField
est la définition de champ pour les valeurs datetime. Ce champ stocke un objet datetime python sous forme de champ. Si les informations de fuseau horaire sont incluses dans l'objet datetime, elles le seront dans les données codées lorsque celles-ci sont codées/décodées.
Les fuseaux horaires ne sont codés que sous forme de décalage minute par rapport à UTC. Lorsqu'il est sérialisé en JSON, le codage est conforme aux spécifications RFC 3339 de l'IETF (Internet Engineering Task Force). Ce ne sont pas des fuseaux horaires réels, par exemple l'heure standard du Pacifique (PST), que vous pouvez utiliser pour obtenir le comportement attendu de l'heure d'été.
La classe DateTimeField
est fournie par le module protorpc.message_types
.
Constructeur
Le constructeur de la classe DateTimeField
est défini comme suit :
- class DateTimeField (number, [required=False | repeated=False])
-
Initialise une instance DateTimeField.
Arguments- nombre
- Numéro du champ. Doit être unique par classe de message.
- required=False
- Indique si le champ est obligatoire ou non. Exclusion mutuelle avec l'argument
repeated
. N'indiquez pasrepeated=True
si vous utilisezrequired=True
. - repeated=False
- Indique si le champ est répété ou non. Exclusion mutuelle avec l'argument
required
. N'indiquez pasrequired=True
si vous utilisezrepeated=True
.
Méthodes des instances
Les instances DateTimeField
utilisent les méthodes suivantes :
- value_from_message(message)
- Convertit une valeur
DateTimeMessage
endatetime
. Arguments- Message
- L'instance
DateTimeMessage
.
- value_to_message(value)
-
Convertit une valeur
Argumentsdatetime
enDateTimeMessage
.- value
- La valeur est une instance
datetime
.