La clase DateTimeField
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
La clase DateTimeField es la definición de campo para los valores de fecha y hora. Almacena un objeto de fecha y hora de Python como un campo. Si la información de zona horaria se incluye en el objeto de fecha y hora, se incluirá en los datos codificados cuando se codifique o decodifique.
Las zonas horarias solo se codifican en forma de demora de minutos con respecto al UTC. Cuando se serializa en JSON, la codificación sigue la especificación de la especificación RFC 3339 del Grupo de Trabajo de Ingeniería de Internet. Son zonas horarias ficticias, a diferencia de la hora estándar del Pacífico (PST), que podrías usar para derivar el comportamiento esperado de ahorro de luz diurna.
El módulo protorpc.message_types proporciona DateTimeField.
Constructor
El constructor de la clase DateTimeField se define de la siguiente manera:
- class
DateTimeField
(number,
[required=False
| repeated=False])
-
Inicializa una instancia de DateTimeField.
Argumentos- number
- Número del campo. Debe ser único por cada clase de mensaje.
- required=False
- Si el campo es obligatorio o no. Es mutuamente exclusivo con el argumento
repeated; no especifiques repeated=True si usas required=True.
- repeated=False
- Si el campo se repite o no. Es mutuamente exclusivo con el argumento
required; no especifiques required=True si usas repeated=True.
Métodos de instancia
Las instancias DateTimeField tienen los siguientes métodos:
- value_from_message(message)
- Convierte un
DateTimeMessage en un datetime.
Argumentos
- mensaje
- La instancia
DateTimeMessage.
- value_to_message(value)
-
Convierte un valor datetime en DateTimeMessage.
Argumentos- value
- El valor es una instancia
datetime.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-09-04 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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."]]
