时区

时区、账号和计费

日期时间值始终以 UTC 时间(如日期时间值结尾的 Z 所示)返回。 可在 POST 或 PUT 命令中使用时区的 ISO 8601 标准格式指定任何时区的日期时间。时间将使用 ISO-8601 的子集来表示。具体而言,我们日期格式的 strptime 字符串为“%Y-%m-%dT%l:%M:%S%z”。广告商账号的时区决定冻结正式计费编号的实际时间。

在账号级别 (GET accounts) 查询 API 时,会获得类似以下内容的时区信息:

{
  "request": {
    "params": {
      "account_id": "18ce54d4x5t"
    }
  },
  "data": {
    "name": "API McTestface",
    "business_name": null,
    "timezone": "America/Los_Angeles",
    "timezone_switch_at": "2016-07-21T07:00:00Z",
    "id": "18ce54d4x5t",
    "created_at": "2016-07-21T22:42:09Z",
    "salt": "54cb7b5a34183f77d82dd6d0f4329691",
    "updated_at": "2017-09-09T06:42:14Z",
    "business_id": null,
    "approval_status": "ACCEPTED",
    "deleted": false
  }
}







其中包括两个时区值:timezone(请参见维基百科上关于时区的信息进行总体了解)和 timezone_switch_at。请注意,timezone_switch_at 是以 UTC 时区 (+00:00) 表示,但此值始终表示给定时区的午夜。

广告商的时区无法通过 API 进行编辑。此属性由 Twitter 服务于广告商的客户经理在合约/计费级别上设置。

由于账号从 America/Los_Angeles 时区切换为新的本地时区的当日存在时间差,因此,请在创建报告并查询我们的分析端点时注意 timezone_switch_at 值。

使用时区指定日期时间值

日期时间值始终以 UTC 时间返回(如日期时间值末尾的 Z 所指示)。可使用适用于时区的 ISO 8601 标准格式在 POST 或 PUT 命令中以任何时区指定日期时间。例如,2017-07-10T08:00:00-0800 是可接受的输入值,其会自动转换为 UTC 值 2017-07-10T16:00:00Z

将分析端点与 DAYTOTALgranularity 结合使用时,start_time 值必须指定为账号持有者本地时区中所需日期的午夜。将采用的时区偏移量是当前日的偏移量,而不是所讨论日期的偏移量。例如,对于 America/Los_Angeles 时区中采用太平洋夏令时间的广告账号,UTC 偏移量为 -0700。因此,在分析请求中,时间应指定为:start_time=2017-05-21T07:00:00Zstart_time=2017-05-21T00:00:00-0700。如果广告账号处于 Asia/Tokyo 时区(时区偏移量始终为 +09:00),值应指定为:start_time=2017-05-20T15:00:00Zstart_time=2017-05-21T00:00:00+0900

接受的 UTC 偏移量格式

请参见 ISO 8601 时区指示符

支持:Z、-HHMM、+HHMM、-HH:MM、+HH:MM、-HH、+HH

Was this document helpful?

感谢

谢谢你的反馈。我们真的很高兴能帮上忙!

Thank you for the feedback. How could we improve this document?

Thank you for the feedback. Your comments will help us improve our documents in the future.