Shareplum查询不支持DateTime变量问题求助

算力阿峰

2026-6-13

Shareplum筛选SharePoint列表日期字段时的DateTime格式问题及解决方法

使用Shareplum从SharePoint列表中筛选日期（如筛选指定日期后修改的条目）时，直接传入datetime对象或普通字符串/整数都会报错：

报错代码示例

from requests_negotiate_sspi import HttpNegotiateAuth
from shareplum import Site, Version
import datetime

site = Site("sharepoint.com", version=Version.v2016, auth=HttpNegotiateAuth())
date = datetime.datetime(2025, 4, 8, 0, 0, 0)

query = {'Where' : [('Gt', 'Modified', date)]}
sp_list = site.List('Sharepoint List')
data = sp_list.GetListItems('All Items', query=query)

常见报错

传入datetime对象时触发：

TypeError : Argument must be bytes or unicode, got 'datetime'

传入普通字符串/整数时触发：

Failed to download list items Shareplum HTTP Post Failed : 500 Server Error

解决方法

SharePoint的REST API要求日期参数必须为ISO 8601标准的UTC时间字符串，格式为yyyy-MM-ddTHH:mm:ssZ。可以通过以下两种方式转换datetime对象：

方式1：使用isoformat()生成格式字符串并追加UTC标识

date = datetime.datetime(2025, 4, 8, 0, 0, 0)
# 转换为ISO 8601格式的UTC时间字符串
date_str = date.isoformat() + 'Z'
query = {'Where': [('Gt', 'Modified', date_str)]}

方式2：手动格式化字符串

date = datetime.datetime(2025, 4, 8, 0, 0, 0)
# 直接生成符合要求的格式字符串
date_str = date.strftime('%Y-%m-%dT%H:%M:%SZ')
query = {'Where': [('Gt', 'Modified', date_str)]}