适用范围：
NoSQL
Azure Cosmos DB 通过本机
JSON
数据模型提供架构灵活性和丰富的索引。 所有 Azure Cosmos DB 资源（包括数据库、容器、文档和存储过程）均作为 JSON 文档进行建模和存储。 为使代码可移植，JSON（及 Azure Cosmos DB）仅支持一小组基本类型：字符串、数字、布尔值、数组、对象和 Null。 但是，JSON 具有相当的灵活性，允许开发人员和框架使用这些基元并将其编写为对象或数组，以便表示更复杂的类型。
除了基本类型，许多应用程序还需要表示日期和时间戳的 DateTime 类型。 本文介绍开发人员可如何使用 .NET SDK 在 Azure Cosmos DB 中存储、检索和查询日期。
存储 DateTime
Azure Cosmos DB 支持 JSON 类型，如字符串、数字、布尔值、null、数组和对象。 它不直接支持 DateTime 类型。 目前，Azure Cosmos DB 不支持日期的本地化。 因此，需要将 DateTime 存储为字符串。 Azure Cosmos DB 中 DateTime 字符串的建议格式为
yyyy-MM-ddTHH:mm:ss.fffffffZ
，它遵循 ISO 8601 UTC 标准。 建议以 UTC 格式存储 Azure Cosmos DB 中的所有日期。 将日期字符串转换为此格式将允许按字典顺序对日期进行排序。 如果存储非 UTC 日期，则必须在客户端处理相关逻辑。 若要将本地 DateTime 转换为 UTC，偏移量必须已知/存储为 JSON 中的属性，并且客户端可以使用偏移量来计算 UTC DateTime 值。
仅当 DateTime 字符串均采用 UTC 格式，才支持那些将 DateTime 字符串作为筛选器的范围查询。 在 Azure Cosmos DB 中，
GetCurrentDateTime
系统函数会返回以下格式的当前 UTC 日期和时间 ISO 8601 字符串值：
yyyy-MM-ddTHH:mm:ss.fffffffZ
。
由于以下原因，大多数应用程序可以使用 DateTime 的默认字符串表示形式：
字符串可以进行比较，而 DateTime 值的相对顺序在这些值转换为字符串时得以保留。
此方法不需要进行 JSON 转换所需的任何自定义代码或属性。
在 JSON 中存储的日期人工可读。
这种方法可以利用 Azure Cosmos DB 的索引执行快速查询。
例如，以下代码片段使用 .NET SDK 将
Order
对象存储为文档，该对象包含两个 DateTime 属性 -
ShipDate
和
OrderDate
：
public class Order
[JsonProperty(PropertyName="id")]
public string Id { get; set; }
public DateTime OrderDate { get; set; }
public DateTime ShipDate { get; set; }
public double Total { get; set; }
await container.CreateItemAsync(
new Order
Id = "09152014101",
OrderDate = DateTime.UtcNow.AddDays(-30),
ShipDate = DateTime.UtcNow.AddDays(-14),
Total = 113.39
本文档存储在 Azure Cosmos DB 中，如下所示：
"id": "09152014101",
"OrderDate": "2014-09-15T23:14:25.7251173Z",
"ShipDate": "2014-09-30T23:14:25.7251173Z",
"Total": 113.39
也可将 DateTime 存储为 Unix 时间戳，即存储为数字，用于表示自 1970 年 1 月 1 日以来已过去的秒数。 Azure Cosmos DB 的内部时间戳 (_ts) 属性遵循这种方法。 可以使用 UnixDateTimeConverter 类将 DateTime 序列化为数字。
在 LINQ 中查询 Datetime
SQL .NET SDK 自动支持通过 LINQ 查询存储在 Azure Cosmos DB 中的数据。 例如，以下代码片段显示一个 LINQ 查询，该查询筛选在过去三天内发运的订单：
IQueryable<Order> orders = container.GetItemLinqQueryable<Order>(allowSynchronousQueryExecution: true).Where(o => o.ShipDate >= DateTime.UtcNow.AddDays(-3));
已转换为以下 SQL 语句并在 Azure Cosmos DB 上执行：
SELECT * FROM root WHERE (root["ShipDate"] >= "2014-09-30T23:14:25.7251173Z")
可在使用 LINQ 查询 Azure Cosmos DB 中详细了解 Azure Cosmos DB 的 SQL 查询语言和 LINQ 提供程序。
编制 DateTime 的索引以执行范围查询
查询通常使用 DateTime 值。 若要高效执行这些查询，必须已在查询筛选器中的任何属性上定义索引。
如需详细了解如何配置索引策略，可参阅 Azure Cosmos DB 索引策略。
下载并运行 GitHub 上的代码示例
详细了解 SQL 查询
详细了解 Azure Cosmos DB 索引策略
