GetNowDate simple API for date and time

GetNowDate simple API for date and time の紹介

GetNowDate は、アプリケーション間で日付、時刻、カウントダウン機能を標準化するエッジAPIです。SDK を必要とすることなく、一貫したフォーマット、タイムゾーンの処理、時間差の計算を提供します。このサービスはキャッシュ境界における信頼性に重点を置いており、異なる場所にいるユーザーでもタイマーや時計が正確に動作します。

本製品は、決定論的な日時出力、ローカライズされた文字列、カウントダウンのビジュアル表示を必要とするエンジニアリングチーム、プロダクトマネージャー、コンテンツチーム向けに設計されています。ワークスペースは承認されたオリジンまたはIPアドレスにロックされるため、トークンを公開せずにブラウザ上で安全に統合できます。

主なポイント

• ロケールおよびタイムゾーンの上書きオプションを備えた、日付・時刻・カウントダウン用のエッジAPI
• 秒、分、時間、日の境界直前に更新される精度に応じたキャッシュ制御
• ローカライズされたテキスト、JSON、YAML、署名付きSVGカウントダウン画像（PNG対応予定）など、複数の出力形式
• オリジンおよびIPアドレスのホワイトリストによるワークスペースのセキュリティ；タイマー用エンドポイントは署名付きリクエストを必要とする
• 単純なHTTP呼び出し；SDK不要；ライブデモエンドポイントは本番環境と同じ挙動
• ワークスペースごとのクォータおよびレート制限；キャッシュヒットでは同じクォータエントリを再利用
• 有料プランでは月間リクエスト数無制限で段階的なレート制限を提供；Unlimitedプランにはカウントダウン画像が含まれる
• Paddleによる課金；2026年1月1日まで有効な導入期価格（チェックアウト時に税金が追加されます）

GetNowDate simple API for date and time の仕組み

チームはワークスペースIDを申請し、許可するオリジンまたはIPアドレスを設定します。クライアントは /api/<workspace-id>/get/date.json などのHTTPエンドポイントを呼び出します。デフォルトでは、サービスはリクエストヘッダーからロケールとタイムゾーンを検出しますが、パラメーターで明示的に上書きすることも可能です。レスポンスはローカライズされたテキスト、JSON、YAML、またはカウントダウン用の署名付きSVG画像として返すことができます。

キャッシュと新鮮度は要求された精度に連動しています。日単位のレスポンスは現地の深夜0時に更新され、時間単位のレスポンスは次の時間に更新され、分および秒単位の精度は次の刻みの直前に更新されます。タイマー画像は60秒ごとに再描画されます。キャッシュヒットでは同じクォータエントリが再利用されるため、パフォーマンスと予測可能性が向上します。レート制限はCloudflareの各拠点で適用され、地域によって異なる場合があります。

タイマー用エンドポイントはプランによって制限されており、署名付きリクエストを必要とします。Unlimitedプランではすべてのリクエストで署名付きSVGカウントダウン画像をレンダリングでき、PNGサポートは今後実装予定です。この構成により、不正使用を防ぎつつ、公開可能なクライアントサイドの埋め込みを可能にしています。

主な利点と用途

• 地域をまたいで一貫した日時出力を実現し、重複するロジックやタイムゾーンのエラーを削減
• マーケティングページ、プロダクトローンチ、イベント、キャンペーンバナー向けの正確なカウントダウン
• ローカライズされた時刻文字列および機械可読形式（JSON/YAML）をサーバーレス環境で配信
• オリジン/IPのバインディングおよび署名付きエンドポイントにより、クライアントトークンを公開せずにブラウザ上で安全に統合
• 複数の展開環境（Webアプリ、スタティックサイト、埋め込み）で予測可能なクォータおよびレート制限

レスポンスの形式（例）

一般的なJSONレスポンスには value、iso、unix、datetime、locale、timezoneOffset、precision などのフィールドが含まれ、インターフェースやログに直接使用できます。

料金概要

その他の料金詳細：

注意事項：

• 導入期価格は2026年1月1日まで有効です。
• クォータおよびレート制限はワークスペースごとに適用されます。
• レート制限はCloudflareの各地域拠点内で適用され、地域によって異なる場合があります。