POST AI agent ready /v1/timezone

API Zona Waktu - Pencarian Waktu Saat Ini Gratis

Mengembalikan waktu saat ini, offset UTC, singkatan, dan status DST untuk zona waktu IANA tertentu. Defaultnya adalah UTC jika tidak ada zona waktu yang ditentukan.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/timezone \
  -H "Content-Type: application/json" \
  -d '{"timezone":"America/New_York"}'

When to use this API

Tampilkan jam yang dilokalkan di dasbor

Buat widget jam multi-zona waktu untuk dasbor tim. Panggil titik akhir ini untuk zona waktu masing-masing anggota tim (misalnya Amerika/New_York, Eropa/Berlin, Asia/Tokyo) dan render waktu lokal saat ini di samping nama mereka.

Jadwalkan pemberitahuan pada jam kerja lokal

Sebelum mengirim pemberitahuan push atau email, periksa zona waktu penerima untuk mengonfirmasi bahwa itu adalah antara jam 9 pagi dan 6 sore waktu setempat. Tunda pengiriman hingga jendela bisnis berikutnya untuk meningkatkan tarif buka dan menghindari gangguan di luar jam kerja.

Frequently asked questions

Format zona waktu apa yang diterima titik akhir ini?

Ia menerima pengidentifikasi zona waktu IANA seperti Amerika/New_York, Eropa/London, atau Asia/Tokyo. Daftar lengkapnya ada di iana.org/time-zones.

Apakah respons tersebut memperhitungkan waktu musim panas?

Ya. Bidang is_dst menunjukkan apakah DST aktif, dan utc_offset mencerminkan offset saat ini termasuk penyesuaian DST apa pun.

Apa yang terjadi jika saya melewati zona waktu yang tidak valid?

Titik akhir mengembalikan kesalahan 400 dengan pesan yang menjelaskan bahwa pengidentifikasi zona waktu tidak dikenali.

Bisakah saya menggunakan ini untuk mendapatkan waktu UTC saat ini?

Ya. Hilangkan parameter zona waktu (defaultnya UTC) atau teruskan "UTC" secara eksplisit untuk mendapatkan Waktu Universal Terkoordinasi saat ini.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.