Giờ & múi giờ API

Lấy giờ hiện tại ở mọi múi giờ, đổi giữa các múi giờ và Unix timestamp (giây hoặc mili giây), kèm độ lệch UTC và thứ trong tuần cho tối đa 30 múi giờ.

GEThttps://apibox.io.vn/v1/time

Tiện ích lập trình▶ Dùng thử online

API Time trả về thời điểm hiện tại – hoặc thời điểm time bạn truyền vào – theo UTC, dạng Unix giây và mili giây, cùng giờ địa phương ở tối đa 30 múi giờ IANA một lúc (timezones=UTC,Asia/Ho_Chi_Minh,America/New_York). Mỗi múi giờ kèm độ lệch UTC (có tính giờ mùa hè) và thứ trong tuần. Nếu không truyền múi giờ, API dùng múi giờ của người gọi do Cloudflare nhận diện, không có thì dùng UTC.

time nhận ngày ISO 8601 có offset hoặc Z, Unix giây (10 chữ số) hoặc mili giây (13 chữ số), hay giờ địa phương không có offset như 2026-11-10 09:00 – khi đó giờ được hiểu theo from_timezone (mặc định UTC). Nhờ vậy API thành công cụ đổi múi giờ nhanh: "9 giờ sáng ở Hà Nội là mấy giờ ở New York?"

Tên múi giờ sai không làm hỏng cả request; riêng múi giờ đó sẽ trả về trường error. Thêm list=true để lấy danh sách đầy đủ tên múi giờ IANA được hỗ trợ.

Tham số

Tên	Vị trí	Kiểu	Bắt buộc	Mặc định
`time`	query	string	không		Ngày ISO 8601, Unix giây hoặc mili giây, hoặc giờ địa phương không offset (mặc định: hiện tại).
`timezones`	query	string	không		Danh sách múi giờ IANA phân tách bằng dấu phẩy (tối đa 30; tên khác `timezone`). Mặc định: múi giờ người gọi, không có thì UTC.
`from_timezone`	query	string	không	`UTC`	Múi giờ của `time` khi không có offset.
`list`	query	boolean	không	`false`	Trả kèm danh sách mọi múi giờ được hỗ trợ.

Ví dụ

curl "https://apibox.io.vn/v1/time?time=2026-11-10T09:00:00&from_timezone=Asia/Ho_Chi_Minh&timezones=UTC,Asia/Ho_Chi_Minh,America/New_York" \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch('https://apibox.io.vn/v1/time?time=2026-11-10T09:00:00&from_timezone=Asia/Ho_Chi_Minh&timezones=UTC,Asia/Ho_Chi_Minh,America/New_York', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
  },
});
const data = await res.json();
console.log(data);

import requests

res = requests.get(
    "https://apibox.io.vn/v1/time?time=2026-11-10T09:00:00&from_timezone=Asia/Ho_Chi_Minh&timezones=UTC,Asia/Ho_Chi_Minh,America/New_York",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/time?time=2026-11-10T09:00:00&from_timezone=Asia/Ho_Chi_Minh&timezones=UTC,Asia/Ho_Chi_Minh,America/New_York');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Kết quả trả về

{
  "utc": "2026-11-10T02:00:00.000Z",
  "unix": 1794276000,
  "unix_ms": 1794276000000,
  "zones": [
    {
      "timezone": "UTC",
      "local": "2026-11-10T02:00:00+00:00",
      "offset": "+00:00",
      "weekday": "Tuesday"
    },
    {
      "timezone": "Asia/Ho_Chi_Minh",
      "local": "2026-11-10T09:00:00+07:00",
      "offset": "+07:00",
      "weekday": "Tuesday"
    },
    {
      "timezone": "America/New_York",
      "local": "2026-11-09T21:00:00-05:00",
      "offset": "-05:00",
      "weekday": "Monday"
    }
  ]
}

Ứng dụng

Đổi Unix timestamp trong log sang ngày giờ dễ đọc
Hẹn lịch họp giữa Việt Nam, châu Âu và Mỹ
Hiển thị đúng giờ địa phương cho người dùng ở nhiều quốc gia
Lấy giờ server chuẩn cho client bị lệch đồng hồ

Hỏi đáp

Đổi Unix timestamp sang ngày giờ thế nào?

Gọi /v1/time?time=1794000000&timezones=Asia/Ho_Chi_Minh. Giá trị 10 chữ số được hiểu là giây, 13 chữ số là mili giây.

Đổi giờ từ múi giờ này sang múi giờ khác thế nào?

Truyền giờ địa phương không có offset cùng múi giờ gốc: time=2026-11-10T09:00:00&from_timezone=Asia/Ho_Chi_Minh&timezones=America/New_York sẽ trả về 2026-11-09T21:00:00-05:00.

Có tính giờ mùa hè (DST) không?

Có. Độ lệch lấy từ cơ sở dữ liệu múi giờ IANA cho đúng ngày đó, nên Europe/Paris là +01:00 vào mùa đông và +02:00 vào mùa hè.

Giờ & múi giờ API

Tham số

Ví dụ

Kết quả trả về

Ứng dụng

Hỏi đáp

API liên quan

Tạo UUID

Phân tích biểu thức cron

Chuyển đổi màu