ForHosting KIT · 日付・時間

2日付間の週数

2024年1月1日から2月15日までは45日で、6週と端数の3日です。2つの日付を入力すれば同じように週と日に分けられ、試用期間や予告期間、スプリント、研修の期間の把握に役立ちます。ブラウザで無料で使えます。

無料
ブラウザで動作
登録不要
データは端末の外に出ません

無料で実行 API仕様を見る

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

計算例

入力した場合

開始: 2024-01-01
終了: 2024-02-15

結果

開始JDN: 2,460,311
終了JDN: 2,460,356
符号付き日数: 45
総日数: 45

2つの暦日を隔てる完全な週数を知ることは、プロジェクト計画、給与サイクル、スポーツシーズン、学期、個人の節目において日常的なニーズです。2日付間の週数計算機を探す方は、手作業で割る生の合計ではなく、7日ブロックと日単位の余りへの明確な分割を望んでいます。本ツールは年-月-日の厳密なISO日付を2つ受け取り、うるう年の2月を含むグレゴリオ暦上で各日が実在するかを検証し、純整数式で天文ユリウス通日に変換したうえで、絶対区間を完全週と0〜6の端数日として報告します。入力の順序は主要な週数を変えません。同じ組であれば早い日を先にしても後にしても週数と端数は同一であり、符号付きの日方向は時系列パイプライン向けに残ります。平年の2月29日のような不可能な基準は黙って繰り越さず、明確な検証エラーで失敗します。

完全週と端数日の計算方法

国際ISO形式（ハイフン区切り・固定幅）で年・月・日を書いた2つの暦日文字列から始め、どのクライアントも同じ6整数で合意できるようにします。各文字列について、年が実用的なグレゴリオ範囲（1年から9999年）にあり、月が1〜12であり、グレゴリオうるう規則の下でその月に日が存在することを確認します。

うるう年は4で割り切れる年ですが、世紀年は400でも割り切れる場合に限ります。これにより2024年や2000年の2月29日は合法、2023年や1900年は非法になります。両方の三つ組が有効なら、日付ファミリで用いるFliegelとVan Flandernの整数式で各暦日を天文ユリウス通日に変換します。

2つの通日を引いて符号付き日デルタを得、絶対値を2つの暦真夜中の間の総暦日とし、7で整数床除算して完全週を、余りを0〜6の端数日として保ちます。

実務で週数計算機が使われる場面

プログラム責任者はスプリント容量とリリース列車を完全週で測り、余りは現行カレンダー枠に収めます。人事と給与は採用・終了のISO日付から試用期間・通知窓・研修コホートを週数で表し、完全なスケジューリングライブラリを引き込みません。コーチとリーグ運営は開幕から決勝を週と残日で変換し試合表に載せます。

データエンジニアは設定に保存した2本のISO文字列から、週表記の保持窓・コホート年齢・キャンペーン長の派生列を具体化します。週末と祝日を除く営業日数、単一基準への日加算、年内通日、生年月日から年齢だけが後で必要なら、本ページを過負荷にせず別の検索意図とランディングとして扱ってください。

活用例

プロジェクトとスプリント計画

開始・終了ISO日付を完全週と端数日に変換し、週ブロックで考える容量・リリース列車・関係者タイムラインに使います。

試用期間と通知窓（人事）

採用から終了、または通知期間を週数と残日で表し、タイムゾーンずれのない契約・オンボーディング・給与設定に使います。

シーズン長とキャンペーン期間

スポーツシーズン・学期・マーケティング期間を2本のISO暦文字列から週と端数日で測り、報告と試合表に使います。

よくある質問

2日付間の週数とは何ですか？

2つのグレゴリオ日付の間の絶対暦日区間を、7日の完全週と0〜6日の余りとして表したものです。営業日規則や壁時計は使いません。

必要な日付形式は？

start と end の両方に厳密ISO YYYY-MM-DD（年4桁・月日2桁）です。2024-1-1 や 2024/01/01 は拒否され、全クライアントが一致します。

2024年1月1日から2月15日までは何週ありますか？

完全な週が6週と、端数が3日で、合計45日です。2024-01-01と2024-02-15を入力すると両方の数が表示されるので、自分で7で割る必要はありません。

早い日付を後に入力しても週数は同じですか？

はい、同じです。どちらの日付を先に入力しても、週数と端数の日数は変わりません。変わるのは、前向きか後ろ向きかを示す向きの表示だけです。

端数の日数とは何ですか？

完全な1週間に満たない残りの日数で、常に0から6の間になります。ちょうど14日離れた日付なら、2週と端数0日になります。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/date/weeks-between

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

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

curl -X POST https://api.kit.forhosting.com/date/weeks-between \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start":"2024-01-01","end":"2024-02-15"}'

const res = await fetch("https://api.kit.forhosting.com/date/weeks-between", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "start": "2024-01-01",
    "end": "2024-02-15"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/weeks-between",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "start": "2024-01-01",
    "end": "2024-02-15"
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"start":"2024-01-01","end":"2024-02-15"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/weeks-between", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "start": "2024-01-01",
  "end": "2024-02-15"
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.weeks_between",
  "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`	リクエストが多すぎます。しばらく待ってから再度お試しください。

技術的な注記

送信内容と返却内容

古典的な検証例は、2024年1月1日から2月15日の45日で完全週6と端数3、ちょうど14日で2週と端数0、同一日付で週0・端数0かつ direction same です。必須文字列フィールド start と end を送ります。それぞれ 2024-01-01 や 2024-02-15 のような厳密なISO暦日です。欠落フィールド、非文字列、4-2-2桁パターンに合わない文字列、パターンは合うが実在しない日付はすべて invalid_input で失敗し課金されません。成功時は正規化済みの開始・終了ISO文字列、各側のユリウス通日、end − start の signed_days、絶対区間の total_days、総日数を7で割った床の weeks、7を法とする余り leftover_days、forward / backward / same の direction、JDN経路を示す短い formula を返します。成功したAPI呼び出しの料金は公開ベース $0.002 毎件で、検証失敗は前払い残高を消費しません。

実務で週数計算機が使われる場面

本能力は純 parse エンジンのため、API料金は成功1件あたり公開ベース $0.002 で、検証失敗は残高を消費しません。

技術的な質問

2日付の順序は重要ですか？

weeks と leftover_days には不要です。絶対日差を使います。signed_days と direction は end が start の後・前・同一かを示します。

2023-02-29 のような無効日では？

リクエストは invalid_input で失敗し課金されません。エラーは、その年・月のそのフィールドで日が無効だと説明します。

料金はいくらですか？

ブラウザツールは無料でローカル実行です。APIは成功1件あたり $0.002 のKIT前払い残高を使い、無効入力は課金されません。

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

2日付間の週数

無料で実行

計算例

完全週と端数日の計算方法

実務で週数計算機が使われる場面

活用例

プロジェクトとスプリント計画

試用期間と通知窓（人事）

シーズン長とキャンペーン期間

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

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

リクエスト例

レスポンス例

料金

エラー

技術的な注記

送信内容と返却内容

実務で週数計算機が使われる場面

技術的な質問

ありがとう