获取时区列表
您可以使用本接口来查询时区列表,返回的列表中包含了每个时区对于GMT的偏移。
需注意返回的偏移(gmt_offset)为固定值,不随夏令时或冬令时变化。例如,纽约(America/New_York)对应的偏移固定返回GMT-05:00,无论纽约当前是否使用夏令时。
v1.2与v1.3版本对比
以下表格概括了 v1.2与v1.3接口的变化。
``xtable
|变化内容{30%}|v1.2{35%}|v1.3{35%}|
|---|---|---|
|接口路径|/v1.2/tools/timezone/|/v1.3/tool/timezone/|
|请求参数类型|advertiser_id: number|advertiser_id: string|
|返回参数名称|time_zone_list|timezones`|
## 请求
**地址** <https://business-api.tiktok.com/open_api/v1.3/tool/timezone/>
**方法** GET
**header**
```xtable
|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
参数
|字段|类型|描述|
|---|---|---|
|advertiser_id {必填}|string| 广告主ID。|
示例
(code curl http)
curl --location --request GET https://business-api.tiktok.com/open_api/v1.3/tool/timezone/?advertiser_id={{advertiser_id}}
--header 'Access-Token: {{Access-Token}}'
--header 'Content-Type: application/json'
(/code)
返回
|字段|类型|描述|
|---|---|---|
|code |number|返回码。完整返回码列表及描述,可见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。 |
|message |string|返回信息。更多信息可见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。 |
|request_id |string|请求的日志ID,唯一标识一个请求。 |
|data |object|返回数据。|
#|timezones|object[]| 时区列表。|
##|timezone|string|时区名。例如, "Pacific/Auckland"。|
##|gmt_offset|string| 与GMT的偏移。例如, "GMT+12:00"。|
示例
(code JSON JSON)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "202107161139170102310210720317DD89",
"data": {
"timezones": [
{
"gmt_offset": "GMT+12:00",
"timezone": "Pacific/Auckland"
},
{
"gmt_offset": "GMT+12:00",
"timezone": "Pacific/Majuro"
},
{
"gmt_offset": "GMT+11:00",
"timezone": "Asia/Magadan"
},
{
"gmt_offset": "GMT+12:00",
"timezone": "Asia/Kamchatka"
},
{
"gmt_offset": "GMT+10:00",
"timezone": "Australia/Sydney"
},
{
"gmt_offset": "GMT+10:00",
"timezone": "Asia/Vladivostok"
},
{
"gmt_offset": "GMT+09:00",
"timezone": "Australia/Broken_Hill"
},
{
"gmt_offset": "GMT+09:00",
"timezone": "Asia/Jayapura"
},
{
"gmt_offset": "GMT+09:00",
"timezone": "Asia/Tokyo"
},
{
"gmt_offset": "GMT+09:00",
"timezone": "Asia/Seoul"
},
{
"gmt_offset": "GMT+09:00",
"timezone": "Asia/Yakutsk"
},
{
"gmt_offset": "GMT+08:00",
"timezone": "Australia/Perth"
},
{
"gmt_offset": "GMT+08:00",
"timezone": "Asia/Shanghai"
},
{
"gmt_offset": "GMT+08:00",
"timezone": "Asia/Hong_Kong"
},
{
"gmt_offset": "GMT+08:00",
"timezone": "Asia/Makassar"
},
{
"gmt_offset": "GMT+08:00",
"timezone": "Asia/Kuala_Lumpur"
},
{
"gmt_offset": "GMT+08:00",
"timezone": "Asia/Manila"
},
{
"gmt_offset": "GMT+08:00",
"timezone": "Asia/Irkutsk"
},
{
"gmt_offset": "GMT+08:00",
"timezone": "Asia/Singapore"
},
{
"gmt_offset": "GMT+08:00",
"timezone": "Asia/Taipei"
},
{
"gmt_offset": "GMT+07:00",
"timezone": "Asia/Jakarta"
},
{
"gmt_offset": "GMT+07:00",
"timezone": "Asia/Krasnoyarsk"
},
{
"gmt_offset": "GMT+07:00",
"timezone": "Asia/Bangkok"
},
{
"gmt_offset": "GMT+07:00",
"timezone": "Asia/Ho_Chi_Minh"
},
{
"gmt_offset": "GMT+06:00",
"timezone": "Asia/Dhaka"
},
{
"gmt_offset": "GMT+06:00",
"timezone": "Asia/Omsk"
},
{
"gmt_offset": "GMT+05:30",
"timezone": "Asia/Kolkata"
},
{
"gmt_offset": "GMT+05:30",
"timezone": "Asia/Colombo"
},
{
"gmt_offset": "GMT+05:00",
"timezone": "Indian/Maldives"
},
{
"gmt_offset": "GMT+05:00",
"timezone": "Asia/Karachi"
},
{
"gmt_offset": "GMT+05:00",
"timezone": "Asia/Yekaterinburg"
},
{
"gmt_offset": "GMT+04:00",
"timezone": "Asia/Dubai"
},
{
"gmt_offset": "GMT+04:00",
"timezone": "Indian/Mauritius"
},
{
"gmt_offset": "GMT+04:00",
"timezone": "Asia/Muscat"
},
{
"gmt_offset": "GMT+03:00",
"timezone": "Asia/Bahrain"
},
{
"gmt_offset": "GMT+03:00",
"timezone": "Asia/Baghdad"
},
{
"gmt_offset": "GMT+03:00",
"timezone": "Africa/Nairobi"
},
{
"gmt_offset": "GMT+03:00",
"timezone": "Asia/Kuwait"
},
{
"gmt_offset": "GMT+03:00",
"timezone": "Asia/Qatar"
},
{
"gmt_offset": "GMT+03:00",
"timezone": "Europe/Moscow"
},
{
"gmt_offset": "GMT+04:00",
"timezone": "Europe/Samara"
},
{
"gmt_offset": "GMT+03:00",
"timezone": "Asia/Riyadh"
},
{
"gmt_offset": "GMT+02:00",
"timezone": "Europe/Sofia"
},
{
"gmt_offset": "GMT+02:00",
"timezone": "Asia/Nicosia"
},
{
"gmt_offset": "GMT+02:00",
"timezone": "Europe/Tallinn"
},
{
"gmt_offset": "GMT+02:00",
"timezone": "Africa/Cairo"
},
{
"gmt_offset": "GMT+02:00",
"timezone": "Europe/Helsinki"
},
{
"gmt_offset": "GMT+02:00",
"timezone": "Europe/Athens"
},
{
"gmt_offset": "GMT+02:00",
"timezone": "Asia/Jerusalem"
},
{
"gmt_offset": "GMT+02:00",
"timezone": "Asia/Amman"
},
{
"gmt_offset": "GMT+02:00",
"timezone": "Asia/Beirut"
},
{
"gmt_offset": "GMT+02:00",
"timezone": "Europe/Vilnius"
},
{
"gmt_offset": "GMT+02:00",
"timezone": "Europe/Riga"
},
{
"gmt_offset": "GMT+02:00",
"timezone": "Asia/Gaza"
},
{
"gmt_offset": "GMT+02:00",
"timezone": "Europe/Bucharest"
},
{
"gmt_offset": "GMT+02:00",
"timezone": "Europe/Kaliningrad"
},
{
"gmt_offset": "GMT+03:00",
"timezone": "Europe/Istanbul"
},
{
"gmt_offset": "GMT+02:00",
"timezone": "Europe/Kiev"
},
{
"gmt_offset": "GMT+02:00",
"timezone": "Africa/Johannesburg"
},
{
"gmt_offset": "GMT+01:00",
"timezone": "Europe/Vienna"
},
{
"gmt_offset": "GMT+01:00",
"timezone": "Europe/Sarajevo"
},
{
"gmt_offset": "GMT+01:00",
"timezone": "Europe/Brussels"
},
{
"gmt_offset": "GMT+01:00",
"timezone": "Europe/Zurich"
},
{
"gmt_offset": "GMT+01:00",
"timezone": "Europe/Prague"
},
{
"gmt_offset": "GMT+01:00",
"timezone": "Europe/Berlin"
},
{
"gmt_offset": "GMT+01:00",
"timezone": "Europe/Copenhagen"
},
{
"gmt_offset": "GMT+01:00",
"timezone": "Europe/Madrid"
},
{
"gmt_offset": "GMT+01:00",
"timezone": "Europe/Paris"
},
{
"gmt_offset": "GMT+01:00",
"timezone": "Europe/Zagreb"
},
{
"gmt_offset": "GMT+01:00",
"timezone": "Europe/Budapest"
},
{
"gmt_offset": "GMT+01:00",
"timezone": "Europe/Rome"
},
{
"gmt_offset": "GMT+01:00",
"timezone": "Europe/Luxembourg"
},
{
"gmt_offset": "GMT+01:00",
"timezone": "Europe/Skopje"
},
{
"gmt_offset": "GMT+01:00",
"timezone": "Europe/Malta"
},
{
"gmt_offset": "GMT+01:00",
"timezone": "Africa/Lagos"
},
{
"gmt_offset": "GMT+01:00",
"timezone": "Europe/Amsterdam"
},
{
"gmt_offset": "GMT+01:00",
"timezone": "Europe/Oslo"
},
{
"gmt_offset": "GMT+01:00",
"timezone": "Europe/Warsaw"
},
{
"gmt_offset": "GMT+01:00",
"timezone": "Europe/Belgrade"
},
{
"gmt_offset": "GMT+01:00",
"timezone": "Europe/Stockholm"
},
{
"gmt_offset": "GMT+01:00",
"timezone": "Europe/Ljubljana"
},
{
"gmt_offset": "GMT+01:00",
"timezone": "Europe/Bratislava"
},
{
"gmt_offset": "GMT+01:00",
"timezone": "Africa/Tunis"
},
{
"gmt_offset": "GMT+00:00",
"timezone": "Atlantic/Canary"
},
{
"gmt_offset": "GMT+00:00",
"timezone": "Europe/London"
},
{
"gmt_offset": "GMT+00:00",
"timezone": "Africa/Accra"
},
{
"gmt_offset": "GMT+01:00",
"timezone": "Europe/Dublin"
},
{
"gmt_offset": "GMT+00:00",
"timezone": "Atlantic/Reykjavik"
},
{
"gmt_offset": "GMT+01:00",
"timezone": "Africa/Casablanca"
},
{
"gmt_offset": "GMT+00:00",
"timezone": "Europe/Lisbon"
},
{
"gmt_offset": "GMT-01:00",
"timezone": "Atlantic/Azores"
},
{
"gmt_offset": "GMT-02:00",
"timezone": "America/Noronha"
},
{
"gmt_offset": "GMT-03:00",
"timezone": "America/Argentina/San_Luis"
},
...
]
}
}
(/code)