← 返回目录
📁 API Reference › Tools

获取时区列表

您可以使用本接口来查询时区列表,返回的列表中包含了每个时区对于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)

内容来源:TikTok API for Business 官方文档 · 本地归档

在接这个接口时卡住了?
Stuck wiring this API into production? We build ad-delivery tooling on these platforms — campaign automation, reporting pipelines, error-handling and migration between API versions.
联系我们 · Talk to us 每日平台更新简报 →