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例項。