La classe DateTimeField
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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 pas repeated=True si vous utilisez required=True.
- repeated=False
- Indique si le champ est répété ou non. Exclusion mutuelle avec l'argument
required. N'indiquez pas required=True si vous utilisez repeated=True.
Méthodes des instances
Les instances DateTimeField utilisent les méthodes suivantes :
- value_from_message(message)
- Convertit une valeur
DateTimeMessage en datetime.
Arguments
- Message
- L'instance
DateTimeMessage.
- value_to_message(value)
-
Convertit une valeur datetime en DateTimeMessage.
Arguments
- value
- La valeur est une instance
datetime.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (UTC)."],[[["\u003cp\u003eThe \u003ccode\u003eDateTimeField\u003c/code\u003e class defines fields for datetime values, storing Python datetime objects and encoding timezone information as a minute offset from UTC.\u003c/p\u003e\n"],["\u003cp\u003eTimezone data in \u003ccode\u003eDateTimeField\u003c/code\u003e is encoded according to RFC 3339 when serialized in JSON, but it does not represent actual timezones like PST.\u003c/p\u003e\n"],["\u003cp\u003eThe constructor of \u003ccode\u003eDateTimeField\u003c/code\u003e takes a \u003ccode\u003enumber\u003c/code\u003e argument for field identification, along with optional \u003ccode\u003erequired\u003c/code\u003e and \u003ccode\u003erepeated\u003c/code\u003e arguments that are mutually exclusive.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eDateTimeField\u003c/code\u003e instances have methods, \u003ccode\u003evalue_from_message\u003c/code\u003e which converts a \u003ccode\u003eDateTimeMessage\u003c/code\u003e to a \u003ccode\u003edatetime\u003c/code\u003e, and \u003ccode\u003evalue_to_message\u003c/code\u003e which converts a \u003ccode\u003edatetime\u003c/code\u003e to a \u003ccode\u003eDateTimeMessage\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# The DateTimeField Class\n\nThe `DateTimeField` class is the field definition for datetime\nvalues. It stores a python datetime object as a field. If time zone information\nis included in the datetime object, it will be included in the encoded data when\nthis is encoded/decoded.\n\nTimezones are only encoded as minute offset from UTC. When\nserialized in JSON, the encoding follows the Internet Engineering Task Force\n[RFC 3339](http://www.ietf.org/rfc/rfc3339.txt) spec. They are\nnot actual timezones, for example Pacific Standard Time (PST), that you could\nuse to derive expected daylight savings behavior.\n\n`DateTimeField` is provided by the `protorpc.message_types`\nmodule.\n\nConstructor\n-----------\n\nThe constructor of the `DateTimeField` class is defined as\nfollows:\n\nclass\nDateTimeField\n(number,\n\\[required=False\n\\| repeated=False\\])\n\n: Initializes a DateTimeField instance.\n\n **Arguments**\n\n number\n : Number of the field. Must be unique per message class.\n\n required=False\n : Whether or not this field is required. Mutually exclusive with the\n `repeated` argument; do not specify\n `repeated=True` if you use `required=True`.\n\n repeated=False\n : Whether or not this field is repeated. Mutually exclusive with the\n `required` argument; do not specify\n `required=True` if you use `repeated=True`.\n\nInstance Methods\n----------------\n\n`DateTimeField` instances have the following methods:\n\nvalue_from_message(message)\n: Convert a `DateTimeMessage` to a `datetime`.\n **Arguments**\n\n message\n : The `DateTimeMessage` instance.\n\nvalue_to_message(value)\n\n: Converts a `datetime` value to a\n `DateTimeMessage`.\n\n **Arguments**\n\n value\n : Value is a `datetime` instance."]]
