DateTimeField
類別是日期時間值的欄位定義,會將 Python 日期時間物件以欄位的形式儲存。如果日期時間物件內有時區資訊,則在編碼/解碼該物件時,時區資訊也會包含在編碼資料之內。
時區只會以世界標準時間的分鐘時差來編碼。在 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
例項。