コンテンツへスキップ
POST AI agent ready /v1/timezone

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

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

Parameters

stringrequired

IANA timezone name (e.g. America/New_York, Europe/London).

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

ダッシュボードにローカライズされた時計を表示する

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

現地の営業時間に通知をスケジュールする

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

Frequently asked questions

このエンドポイントはどのタイムゾーン形式を受け入れますか?
America/New_York、Europe/London、Asia/Tokyo などの IANA タイムゾーン識別子を受け入れます。 完全なリストは iana.org/time-zones に保管されています。
応答には夏時間が考慮されていますか?
はい。 is_dst フィールドは DST がアクティブかどうかを示し、utc_offset は DST 調整を含む現在のオフセットを反映します。
無効なタイムゾーンを渡すとどうなりますか?
エンドポイントは、タイムゾーン識別子が認識されないことを説明するメッセージを含む 400 エラーを返します。
これを使用して現在の UTC 時間を取得できますか?
はい。 タイムゾーン パラメーター (デフォルトは UTC) を省略するか、明示的に「UTC」を渡して現在の協定世界時を取得します。

Get your API key

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