現在のStudioではAPI連携の仕様が変わっています。旧Beta版の新規利用は2026年4月17日に終了しました。この記事では、日数表示だけが目的の場合のEmbed方式を先に紹介し、旧APIの手順は参考として区別しています。
こんにちは!会社員クリエイターのこばたです!
イベント当日までの残り日数を表示する方法を紹介します。新しく作る場合に使えるEmbedのコード例と、過去に掲載したAPI連携の作例を分けて説明します。
イベントやフェスなどのランディングページで、「イベント当日まで残り○日」のようなカウントダウン形式のセクションを見かけることがあります。
表示された日付により、特別な発表や当日までのドキドキ感を演出することができます。待ち時間は、イベントの重要性を引き出し、オーディエンスとの一体感を作り上げるのにも役立ちます。
イベントページの制作を依頼された際などに+αの要素として役に立つTipsなので是非覚えてみてください。
Embedで日数カウントダウンを表示する
日数の表示だけなら、外部APIを使わず、閲覧者のブラウザで開催日との差を計算できます。Studioの追加パネルで「基本」→「埋め込み」からBlankのEmbedボックスを配置し、コード編集を開いて次のコードを貼り付け、保存します。
targetDateの2027-01-01を開催日に置き換えてください。この例は日本時間の暦日で計算し、開催当日は「本日開催」、翌日以降は「イベントは終了しました」と表示します。イベント名や当日の扱いは用途に合わせて変更します。
<p id="countdown" aria-live="polite"
style="margin:0;font:700 32px/1.5 sans-serif">日数を確認しています</p>
<script>
(() => {
const targetDate = '2027-01-01'; // 開催日を YYYY-MM-DD で設定
const output = document.getElementById('countdown');
const formatter = new Intl.DateTimeFormat('en-US', {
timeZone: 'Asia/Tokyo', year: 'numeric',
month: '2-digit', day: '2-digit'
});
function update() {
const parts = formatter.formatToParts(new Date());
const value = type => parts.find(part => part.type === type).value;
const today = `${value('year')}-${value('month')}-${value('day')}`;
const days = Math.round(
(Date.parse(targetDate + 'T00:00:00+09:00') -
Date.parse(today + 'T00:00:00+09:00')) / 86400000
);
const text = !Number.isFinite(days) ? '開催日をご確認ください'
: days > 0 ? `開催まであと${days}日`
: days === 0 ? '本日開催' : 'イベントは終了しました';
if (output.textContent !== text) output.textContent = text;
}
update();
setInterval(update, 60000);
})();
</script>
コードを保存したら、プレビューと公開サイトで表示を確認します。Embedボックスの幅・高さを調整し、文字が欠けないようにしてください。端末の時計に基づく日数表示なので、決済期限や受付締切を厳密に判定する用途にはサーバー側の処理が必要です。
現在のData Connect APIを使う場合
APIから日数を取得して管理したい場合、現在はBusinessプラン以上が対象です。Businessでは一覧エンドポイント1つ、Business Plus・Enterpriseでは一覧と詳細エンドポイントを利用できます。旧Beta版の接続済みデータは継続利用できますが、将来の継続や新しい公開基盤での動作は保証されません。
一覧用APIは配列または配列を含むJSONが必要です。単一オブジェクトを返すURLを、そのまま一覧に登録しても表示できません。契約プランだけでなく、外部APIのレスポンス構造と表示先を確認してください。
「接続」→「API」からエンドポイントを作成し、URL・レスポンスタイプ・必要な認証情報を設定して接続を確認します。取得した配列を動的リストへ紐付けるなど、詳細は公式ヘルプの現行手順を参照してください。
参考:旧Beta版で使ったAPIのURL
まずはお好みでカウントダウンしたい日付を決めます。
以下のAPI画像は、当時「2024年1月1日」までの日数を表示するために作成したものです。現在は過去の日付なので、そのまま設定しないでください。
以下は旧作例で使用した外部APIのURLです。今回の確認では現在の応答を確認できていないため、新規制作でこのAPIが利用できるとは断定できません。先に提供元の稼働状況・利用条件を確認してください。
https://app.pentaprogram.tokyo/remaining_days/api?future_date=2023-06-10&timezone=Asia/Tokyo&repeat_annually=false
future_dateは対象日、timezoneはタイムゾーンの指定です。日付はYYYY-MM-DD形式で指定します。以下の2024年1月1日は旧作例として残している値です。
https://app.pentaprogram.tokyo/remaining_days/api?future_date=2024-1-1&timezone=Asia/Tokyo&repeat_annually=false
変更の際は必ず半角で入力してください。
参考:旧Beta版のエディタ操作
ここからの画像は旧API連携(Beta)の画面です。現在の新規設定は、左の「接続」→「API」から行うData Connect APIになっています。

旧作例では「カスタムAPI」を選択していました。現在はエンドポイントを作成し、レスポンスタイプや認証情報などを設定します。

旧作例ではURLを入力してAPIを確認していました。現行機能でも接続確認は必要ですが、レスポンス形式とプランが要件に合うかを先に確認してください。

日付データを紐付ける
旧Beta版では取得したデータのセクションをページに追加していました。新規のData Connect APIでは、取得データを動的リスト・動的ページなどに紐付けるため、下の旧画面の操作をそのまま再現することはできません。

旧作例ではNo Dataのテキストに、APIから取得した日数のプロパティを紐付けます。実際のプロパティ名は、接続先のレスポンスを確認して選んでください。
セクションをお好みにデザインする
あとは、不要な画像ボックスを削除したり、テキストボックスを追加したりしてお好みのデザインにすれば完成です。

旧APIのレスポンスにremaining_days_digitsが含まれている場合は、数字ごとにテキストへ紐付ける作例もありました。APIごとに同じ項目が返るとは限りません。

まとめ
以上が旧Beta版を使った作例です。新しく制作する際は、冒頭のEmbed方式か、現行Data Connect APIに合うデータ構造・プランを選んでください。
今回は、下記記事を参考に作成させていただきました。是非覗いてみてください。
旧API方式の作例は、ページを読み込んだときの日数を表示するため、開いたまま日付をまたいでも自動更新されません。冒頭のEmbed例は日本時間の日付を1分ごとに確認しますが、端末のスリープ中などはタイマーが遅れる場合があります。
頻繁に利用する機能ではないと思いますが、イベントページなどの+αの要素として使える機能のため、是非頭の片隅にでも入れておいてくれたら嬉しいです。
STUDIOでサイトの制作を依頼したい、STUDIOでWebサイト作りたいけど、何から始めていいか分からない…という方へ。
STUDIOにてサイトの制作依頼や講師等の依頼も承っておりますので、ぜひご連絡ください!
最後までお読みいただきありがとうございました。
参考:Data Connect API / Data Connect APIの正式提供 / Embedボックス(仕様確認:2026年11月15日)

