如何在C# Nest Elasticsearch中使用DateTimeOffset进行搜索？

核心解决方案 #

Nest的DateRangeQuery本身兼容DateTimeOffset类型，直接赋值即可自动处理时区信息。你索引中存储的带时区格式（如2023-05-19T02:07:36.602171+00:00）的日期，Elasticsearch会识别为带偏移的日期类型，使用DateTimeOffset作为查询条件时，Nest会正确序列化带时区的格式发送给ES，实现时区匹配的检索。

修正后的代码示例 #

你代码里有个语法错误（addHour应为C#规范的AddHours），同时遗漏了必填的Field属性，修正后的完整代码如下：

new SearchRequest<MyLog>("my_index")
{
    Query = new QueryContainer(
        new BoolQuery
        {
            Must = new QueryContainer[]
            {
                new DateRangeQuery
                {
                    Field = "你的日期字段名", // 替换为索引中实际的日期字段名称
                    GreaterThanOrEqualTo = DateTimeOffset.UtcNow,
                    LessThanOrEqualTo = DateTimeOffset.UtcNow.AddHours(4)
                }
            }
        })
};

关键注意事项 #

• 必填Field属性：DateRangeQuery必须指定要查询的字段名，否则无法定位到索引中的日期数据进行匹配。
• 时区自动适配：传入DateTimeOffset时，Nest会将其序列化为与索引格式一致的带时区ISO 8601字符串，Elasticsearch会基于时区偏移量做精确的范围比对，无需额外手动转换。
• 禁止丢失时区信息：不要将DateTimeOffset手动转换为DateTime类型，这样会抹除时区偏移数据，导致检索结果偏差。

内容的提问来源于stack exchange，提问作者Vorasoda