> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 日志的时区设置和数据导出要注意什么？
> 账户时区请保持默认的 UTC+0，控制台弹出的时区切换建议选「暂时忽略」。切换后日志页的「调用数据一览」统计图会错位，「汇总账单」的日期归属也会偏移；逐笔消费日志建议用「导出 → 后台异步导出」，固定按 UTC+0 输出。
## 简短回答
默认的 `London (UTC+0/+1)` 就是正确设置，**不要改**。日志库本身按 UTC 记录，UTC+0 与数据源一致
控制台检测到设备时区不同会弹「本地设置建议」，**点左边的「暂时忽略」**，不要点「切换到 Asia/Shanghai」
日志页的**导出**按钮固定按 UTC+0 输出逐笔消费记录；**汇总账单**跟随账户时区，改过时区会导致日期归属偏移
**已经切换过时区的用户，改回 `London (UTC+0/+1)` 即可。** 切换时区只影响页面展示与汇总口径，**不会改动、也不会丢失任何已产生的调用数据**，改回来之后统计图和账单日期即恢复正常。
## 账户时区在哪里看
在控制台的**用户信息**一栏可以看到当前账户时区，正常应显示为 `London (UTC+0/+1)`，也就是 UTC+0。
## 弹出「本地设置建议」时请选「暂时忽略」
当账户时区（UTC）与你当前设备的时区（例如 `Asia/Shanghai`）不一致时，控制台会弹出一个「本地设置建议」窗口，并给出「切换到 Asia/Shanghai」的按钮。
**请点「暂时忽略」，不要点「切换到 Asia/Shanghai」。** 切换后，日志页顶部的\*\*「调用数据一览」统计图\*\*展示会错位——时间分桶与图表区间对不上，看起来像数据缺失或整体平移。
受影响的就是日志页顶部这一栏：
日志明细列表里的时间同样跟随账户时区显示，所以保持 UTC+0 也让明细、统计图、导出文件三者口径一致，换算时统一加时差即可。
## 两种导出方式怎么选
日志页右上角有**导出**和**汇总账单**两个按钮，二者的时区口径不同，这是最容易踩坑的地方。
| | 导出 | 汇总账单 |
| ---- | --------------------- | ------------ |
| 时区口径 | **固定 UTC+0**，与数据库日志一致 | **跟随账户时区设置** |
| 数据粒度 | 逐笔调用记录（可选字段） | 按日期汇总的账单 |
| 数据量 | 支持大批量，可后台异步跑 | 小，直接下载 |
| 适用场景 | 对账、审计、自建分析 | 快速看某段时间的总花费 |
### 汇总账单：按账户时区汇总
汇总账单导出的数据**默认按你的账户时区设置来汇总**。如果账户时区被改成了 UTC+8，当天 **16:00 (UTC+8)** 之后的调用日志，在汇总账单里会被算进**次日**的账单数据，导致某一天的金额看起来不对。
遇到这种情况，**把账户时区改回 UTC+0 再导出汇总账单**即可，日期归属就正常了。
### 导出 → 后台异步导出（更推荐）
需要逐笔消费日志时，用**导出**按钮，并在弹窗里选择**后台异步导出**。
要点：
* **时区固定 UTC+0**，不受账户时区设置影响。因为导出的就是数据库日志本身，需要自己换算成本地时间（UTC+8 用户加 8 小时）
* **导出字段可选**：使用时间、请求 ID、令牌名称、模型名称等，按对账需要勾选
* **导出方式**：数据量大时选**后台异步导出**，任务在后台跑、不阻塞页面操作，官方建议**超过 1 万条记录时使用**
* **导出格式**：Excel（`.xlsx`，超大数据自动拆分并打包 zip）或 CSV（`.csv`，适合小数据量）
* **最大导出记录数**：填 `0` 表示不限制（服务端自动拆分多个 Excel 并打包 zip），上限 5000 万条
* **进度查看**：任务创建后在「任务管理」页面查看导出进度与状态，完成后直接下载
完整的导出操作步骤和归档建议见[调用日志保存多久？多久清理一次？](/faq/log-retention-policy)。
## 常见问题
因为后台的调用日志本身就是按 UTC 记录的数据库日志。账户时区保持 UTC+0，页面展示、统计图和导出文件三者口径一致，换算时统一加一个固定时差即可；改成本地时区后，各处的换算规则不再一致，反而更容易看错。
不会。时区只影响展示与汇总口径，不会改动任何已产生的调用记录和扣费数据。把账户时区改回 `London (UTC+0/+1)`，统计图与汇总账单的日期归属即恢复正常。
在导出文件的时间上**加 8 小时**就是北京时间。例如导出文件里的 `2026-08-09 08:00` 对应北京时间 **2026/8/9 16:00 (UTC+8)**。跨天对账时留意这个 8 小时的位移。
没有。导出的字段与后台日志展示一致——时间、请求 ID、令牌名称、模型、token 数、金额、状态等，不含任何 prompt 或模型输出内容。详见[调用日志保存多久？多久清理一次？](/faq/log-retention-policy)。
可以，见[日志查询 API](/api-capabilities/log-query)。该接口的 `start_timestamp` / `end_timestamp` / `created_at` 都是 **Unix 秒级时间戳**，与控制台的时区设置无关，程序侧自行按需转换即可，适合自动对账场景。
先在「任务管理」页面确认任务状态。数据量特别大时（例如几百万条）后台拆分和打包需要时间，建议缩小时间范围或设置合理的**最大导出记录数**，分批导出。
## 相关文档
* [如何查看我的调用记录？](/faq/call-logs)
* [怎么看懂日志里的计费金额？](/faq/log-billing-explained)
* [调用日志保存多久？多久清理一次？](/faq/log-retention-policy)
* [日志查询 API](/api-capabilities/log-query)
* [实时动态：控制台弹出时区切换建议时，请选择「暂时忽略」](/live/2026-08/timezone-switch-prompt-ignore)