ForHosting KIT · 開発者向けツール

年ごとのブラックフライデー日付計算

ブラックフライデー日付計算は、指定された年について、米国の感謝祭の翌日に当たる金曜日を返します。保存済みの祝日一覧やオンラインカレンダーには依存しません。グレゴリオ暦上で11月の第4木曜日を特定し、そこから1日進めて算出します。結果にはブラックフライデーの日付、金曜日であることを示す項目、計算基準となった感謝祭の日付が含まれます。そのため、回答を簡単に検算でき、予定表、レポート、小売計画、自動処理にそのまま活用できます。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

ブラックフライデーの日付を求める方法

米国のブラックフライデーは、感謝祭の翌日です。米国の感謝祭は11月の第4木曜日に行われるため、まず指定されたグレゴリオ暦年の11月1日が何曜日かを求めます。次に最初の木曜日を特定し、そこから3週間進めて第4木曜日に到達した後、暦日を1日進めます。この規則により、ブラックフライデーは必ず11月23日から29日までの間になります。この機能は両方の日付を返すため、根拠の分からない値だけではなく、回答の基準となる祝日も確認できます。祝日データベースを参照しないので、一覧の更新状況によって結果が変わることはありません。同じ年を入力すれば、常に同じ回答が得られます。将来の計画、過去の年との比較、手作業で管理する日付表ではなく安定した暦規則を必要とするシステムに適しています。なお、米国の祝日との関係を計算するものであり、別の日程で同名のセールを行う他国の商習慣までは表しません。

決定論的なグレゴリオ暦の計算

計算には、先発グレゴリオ暦に基づく整数演算だけを使います。完了した年数を数え、うるう年の規則を適用し、11月までの曜日のずれを算出します。通常、4で割り切れる年はうるう年ですが、世紀の年は除外され、さらに400で割り切れる場合だけ再びうるう年になります。対象月は2月より後ですが、この規則は11月1日の曜日に影響します。実装は現在時刻を読み取らず、利用者の現地時間帯を推測せず、ネットワークサービスへ接続せず、端末の地域設定にも依存しません。そのため、UTC、ニューヨーク、東京、その他のどの時間帯から実行しても、同じISO形式の日付が返ります。入力できる年は1から9999までで、古い年も先頭にゼロを付けた4桁で表示します。この範囲は一般的な4桁のISO日付表現と互換性を保ちながら、広い過去と未来を扱えます。グレゴリオ暦が正式に採用される以前の時代にも、同じ規則を一貫して遡及適用します。

計画と自動化で結果を利用する方法

yearフィールドに整数を入力すると、毎年の安定した小売基準日として返された日付を利用できます。マーケティング担当者は結果を基準にキャンペーンの締切を設定でき、販売担当者は商品カタログの確定日や人員計画を準備でき、分析担当者は各年のレポートを比較可能な祝日期間にそろえられます。応答にはthanksgiving_dateも含まれるため、連携システムは1日の間隔を検証したり、別の祝日検索を行わずに両方の日付を表示したりできます。day_of_weekは読者や後続画面に曜日を明示し、dateは並べ替えや保存に使う主要なISO形式の値です。APIによる自動処理は1回$0.002で、ブラウザー版でも同じ純粋な計算を端末内で実行できます。結果は営業時間、セール開始時刻、配送期限、市場動向の予測ではなく、暦上の日付としてお使いください。企業によっては早く販促を始め、米国外では異なる祝日が採用されます。実際の営業予定には、信頼できる事業者のスケジュールを併用してください。

活用例

小売キャンペーン予定表の作成

制作物の確認、商品発売、販促通知を組む前に、毎年の基準日を算出します。

祝日商戦期間の年次比較

11月の固定日ではなく、各年の実際のブラックフライデーを基準にレポートをそろえます。

将来計画の日付を一括生成

祝日表を保守せずに、多年分の予定表やワークフローの節目を設定します。

よくある質問

ブラックフライデーはどのように計算しますか？

米国の感謝祭に当たる11月の第4木曜日を特定し、その翌日を返します。

APIの利用料金はいくらですか？

APIリクエスト1回の料金は$0.002です。同じ決定論的な計算をブラウザー内でも実行できます。

計算結果は時間帯によって変わりますか？

変わりません。暦の算術を用いるため、場所や時間帯にかかわらず同じISO形式の日付を返します。

指定できる年の範囲はどこまでですか？

先発グレゴリオ暦における1から9999までの整数を指定できます。

ブラックフライデーは必ず11月ですか？

この米国の定義では必ず11月です。第4木曜日の翌日なので、11月23日から29日までの間になります。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/date/black-friday

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/date/black-friday \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2026}'

const res = await fetch("https://api.kit.forhosting.com/date/black-friday", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "year": 2026
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/black-friday",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "year": 2026
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/black-friday", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"year":2026}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"year":2026}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/black-friday", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "year": 2026
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.black_friday",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

KITの完全なドキュメントを見る →