DateTimeField
类是日期时间值的字段定义。它将 python datetime 对象存储为字段。如果时区信息包含在时间日期对象中,对其编码/解码后,该信息将包含在编码数据中。
时区仅编码为世界协调时间 (UTC) 的分钟偏移量。在 JSON 中序列化时,编码遵循互联网工程任务组 RFC 3339 规范。它们不是真实时区,例如可以用来获得预期夏令时行为的太平洋标准时间 (PST)。
DateTimeField
由 protorpc.message_types
模块提供。
构造函数
DateTimeField
类的构造函数定义如下:
- class DateTimeField (number, [required=False | repeated=False])
-
初始化 DateTimeField 实例。
参数- number
- 字段的编号。每个消息类的编号必须是唯一的。
- required=False
- 此字段是否为必需项。与
repeated
参数相互排斥;如果使用required=True
,请勿指定repeated=True
。 - repeated=False
- 此字段是否重复。与
required
参数相互排斥;如果使用了repeated=True
,请勿指定required=True
。
实例方法
DateTimeField
实例具有以下方法:
- value_from_message(message)
- 将
DateTimeMessage
转换为datetime
。 参数- 消息
DateTimeMessage
实例。
- value_to_message(value)
-
将
参数datetime
值转换为DateTimeMessage
。- value
- 值是一个
datetime
实例。