当前位置：首页 > news >正文

Sharepoint Graph API Edm.DateTimeOffset 类型格式

news 2026/5/12 14:03:09

在 **Microsoft Graph API** 中，`Edm.DateTimeOffset` 类型（如 `lastModifiedDateTime`、`createdDateTime`）的格式与 SharePoint REST API **完全不同**。

### 1. 核心区别对比

| 特性 | **Microsoft Graph API** | **SharePoint REST API** |
| :--- | :--- | :--- |
| **URL 特征** | `graph.microsoft.com` | `/_api/` |
| **字段名称** | `lastModifiedDateTime` | `Modified` |
| **datetime 前缀** | ❌ 不需要 | ✅ 必须 (`datetime'...'`) |
| **单引号** | ❌ 不需要 | ✅ 必须 (`'...'`) |
| **时间格式** | `2025-02-27T15:05:58Z` | `datetime'2025-02-27T15:05:58Z'` |
| **URL 编码** | 空格需 `%20` | 空格需 `%20`，**单引号不能编码** |

---

### 2. Graph API 正确格式示例

**标准格式：**
```text
YYYY-MM-DDTHH:MM:SSZ
```

**正确的 Filter 查询：**
```http
GET https://graph.microsoft.com/v1.0/drives/{drive-id}/items/{item-id}/children?$filter=lastModifiedDateTime ge 2025-02-27T15:05:58Z
```

**URL 编码后：**
```http
?$filter=lastModifiedDateTime%20ge%202025-02-27T15:05:58Z
```

> **注意**：Graph API 中时间值**不需要单引号**，所以不存在单引号编码问题。

---

### 3. 正确与错误示例对照

---

### 4. Java 代码示例 (Microsoft Graph API)

#### 4.1 生成 UTC 时间字符串

```java
import java.time.ZonedDateTime;
import java.time.ZoneOffset;
import java.time.format.DateTimeFormatter;

public class GraphDateTimeExample {
public static void main(String[] args) {
// 获取当前 UTC 时间
ZonedDateTime utcNow = ZonedDateTime.now(ZoneOffset.UTC);

// 格式化为 ISO 8601 (带 Z)
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd'T'HH:mm:ss'Z'");
String utcString = utcNow.format(formatter);

System.out.println("Graph API 时间格式：" + utcString);
// 输出：2025-02-27T15:05:58Z
}
}
```

#### 4.2 构建 Filter 查询 (完整可运行)

```java
import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
import java.time.ZonedDateTime;
import java.time.ZoneOffset;
import java.time.format.DateTimeFormatter;

public class GraphApiDateTimeQuery {
public static void main(String[] args) throws Exception {
String driveId = "YOUR_DRIVE_ID";
String itemId = "YOUR_ITEM_ID";
String accessToken = "YOUR_ACCESS_TOKEN";

// 1. 生成 UTC 时间字符串
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd'T'HH:mm:ss'Z'");
String utcTime = ZonedDateTime.now(ZoneOffset.UTC).format(formatter);

// 2. 构建 Filter (Graph API 不需要 datetime 前缀和单引号)
String filterValue = "lastModifiedDateTime ge " + utcTime;

// 3. URL 编码 (只需处理空格，不需要处理单引号)
String encodedFilter = URLEncoder.encode(filterValue, StandardCharsets.UTF_8.toString())
.replace("+", "%20");

// 4. 拼接完整 URL
String fullUrl = String.format(
"https://graph.microsoft.com/v1.0/drives/%s/items/%s/children?$filter=%s&$top=10",
driveId,
itemId,
encodedFilter
);

// 5. 调试输出
System.out.println("请求 URL: " + fullUrl);
// ✅ 应看到：...lastModifiedDateTime%20ge%202025-02-27T15:05:58Z...
// ❌ 不应看到：...datetime'...' 或 ...%27...

// 6. 发送请求
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(fullUrl))
.header("Authorization", "Bearer " + accessToken)
.header("Content-Type", "application/json")
.GET()
.build();

HttpClient client = HttpClient.newHttpClient();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

System.out.println("状态码：" + response.statusCode());
System.out.println("响应体：" + response.body());
}
}
```

---

### 5. 常见操作符示例

| 操作符 | 含义 | URL 示例片段 |
| :--- | :--- | :--- |
| `gt` | 大于 | `lastModifiedDateTime gt 2025-01-01T00:00:00Z` |
| `ge` | 大于等于 | `lastModifiedDateTime ge 2025-01-01T00:00:00Z` |
| `lt` | 小于 | `lastModifiedDateTime lt 2025-12-31T23:59:59Z` |
| `le` | 小于等于 | `lastModifiedDateTime le 2025-12-31T23:59:59Z` |
| `eq` | 等于 | `lastModifiedDateTime eq 2025-02-27T15:05:58Z` |
| `and` | 与 | `lastModifiedDateTime ge 2025-01-01T00:00:00Z and lastModifiedDateTime le 2025-12-31T23:59:59Z` |

**范围查询示例 (Java)：**
```java
String filterValue = "lastModifiedDateTime ge 2025-01-01T00:00:00Z and lastModifiedDateTime le 2025-12-31T23:59:59Z";
```

---

### 6. 使用 Microsoft Graph SDK (推荐)

如果你使用官方 SDK，时间格式会自动处理：

```java
import com.microsoft.graph.drives.item.items.item.children.ChildrenRequestBuilder;
import java.time.OffsetDateTime;

// SDK 会自动处理格式和编码
ChildrenRequestBuilder.ChildrenRequestBuilderGetQueryParameters queryParams =
new ChildrenRequestBuilder.ChildrenRequestBuilderGetQueryParameters();
queryParams.filter = "lastModifiedDateTime ge " + OffsetDateTime.now(ZoneOffset.UTC).toString();

// 执行请求
var response = graphClient.drives().byDriveId(driveId).items().byDriveItemId(itemId).children().get(requestConfig -> {
requestConfig.queryParameters = queryParams;
});
```

---

### 7. 浏览器快速验证

复制以下 URL 到浏览器测试（需先获取 Token）：

```
https://graph.microsoft.com/v1.0/drives/{drive-id}/items/{item-id}/children?$filter=lastModifiedDateTime ge 2025-01-01T00:00:00Z&$top=5
```

* ✅ **返回 JSON** → 格式正确
* ❌ **报错** → 检查字段名、时间格式、Token 权限

---

### 8. 总结检查清单

| 检查项 | ✅ Graph API 正确 | ❌ 常见错误 |
| :--- | :--- | :--- |
| **字段名** | `lastModifiedDateTime` | `Modified` |
| **datetime 前缀** | 无 | `datetime` |
| **单引号** | 无 | `'...'` |
| **时区标识** | `Z` 或 `+08:00` | 无 |
| **空格编码** | `%20` | `+` |
| **Accept Header** | `application/json` | 缺失 |

---

### 9. 两种 API 格式对比总结

```
┌─────────────────────────────────────────────────────────────────┐
│ SharePoint REST API │
│ $filter=Modified ge datetime'2025-02-27T15:05:58Z' │
│ ⚠️ 需要 datetime 前缀 + 单引号，单引号不能 URL 编码 │
└─────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────┐
│ Microsoft Graph API │
│ $filter=lastModifiedDateTime ge 2025-02-27T15:05:58Z │
│ ✅ 不需要 datetime 前缀，不需要单引号 │
└─────────────────────────────────────────────────────────────────┘
```

按照以上格式构建 Graph API 请求，即可避免类型不匹配的错误。

查看全文

http://www.jsqmd.com/news/466281/