POST AI agent ready /v1/timezone

タイムゾーン API - 無料の現在時刻検索

指定された IANA タイムゾーンの現在時刻、UTC オフセット、略語、および DST ステータスを返します。タイムゾーンが指定されていない場合は、デフォルトで UTC になります。

Endpoint

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

When to use this API

チームダッシュボード用のマルチタイムゾーンの時計ウィジェットを構築します。各チームメンバーのタイムゾーン (例: アメリカ/ニューヨーク、ヨーロッパ/ベルリン、アジア/東京) に対してこのエンドポイントを呼び出し、名前の横に現在の現地時間を表示します。

プッシュ通知または電子メールを送信する前に、受信者のタイムゾーンをチェックして、現地時間の午前 9 時から午後 6 時までの間にあることを確認してください。開封率を向上させ、営業時間外の中断を避けるために、次の営業時間まで配信を遅らせます。

このエンドポイントはどのタイムゾーン形式を受け入れますか?

America/New_York、Europe/London、Asia/Tokyo などの IANA タイムゾーン識別子を受け入れます。完全なリストは iana.org/time-zones に保管されています。

応答には夏時間が考慮されていますか?

はい。 is_dst フィールドは DST がアクティブかどうかを示し、utc_offset は DST 調整を含む現在のオフセットを反映します。

無効なタイムゾーンを渡すとどうなりますか?

エンドポイントは、タイムゾーン識別子が認識されないことを説明するメッセージを含む 400 エラーを返します。

これを使用して現在の UTC 時間を取得できますか?

はい。タイムゾーンパラメーター (デフォルトは UTC) を省略するか、明示的に「UTC」を渡して現在の協定世界時を取得します。

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