ガント棒の期間計算

このガントチャート棒期間計算機は、ISO形式の開始日・終了日と任意の working_days_only フラグを受け取り、包括的な暦日数、月曜日から金曜日までの稼働日数、棒内の週末日数、両端の曜日、選択モードに対応する単一の duration_days を返します。終了が開始より前の棒は invalid_input で拒否されます。

ガント棒の期間の数え方（包括的な暦日と稼働日）

暦日モードでは duration_days を開始と終了の間の包括的なグレゴリオ暦日数、すなわち終了の通し番号から開始を引き一を加えた値にします。calendar_days_inclusive、working_days_inclusive、その差である weekend_days_inclusive、および working_days_only で選ばれた指標に等しい duration_days です。

入力契約、応答フィールド、検証ルール

true、false、または yes と no などの一般的な文字列形式を送れます。年は一から九千九百九十九の範囲でなければなりません。end が start より厳密に前の場合、ハンドラはガント棒が開始前に終了できない旨の明確なメッセージで要求を拒否し、その失敗は課金されません。ピクセル幅が必要なら自前のチャート描画と組み合わせてください。必須の文字列フィールド start と end を厳密な YYYY-MM-DD 形式（例：2024-01-08 と 2024-01-19）で含む JSON オブジェクトを POST します。任意の working_days_only は既定で false です。start_date、from、begin、end_date、to、finish、workdays_only、business_days_only の別名も受け付けるため、表計算や PM エクスポートからの取り込みでフィールド名の付け替えが少なくて済みます。各日付は実在するグレゴリオ暦の日として検証され、2023-02-29 や 2024-04-31 のような不可能な値はフィールド名付きの invalid_input で失敗します。成功時の本体は正規化された start と end、英語の start_weekday と end_weekday、calendar_days_inclusive、working_days_inclusive、weekend_days_inclusive、真偽値 working_days_only、calendar または working の count_mode、選択された長さの duration_days、包括的 JDN 規則を記した短い formula 文字列を返します。例：start 2024-01-08 月曜から end 2024-01-19 金曜までで、暦日十二、稼働日十、週末二、暦日モードでは duration_days 十二、working_days_only が true なら十です。本エンドポイントは日数だけを計算し、SVG を描かずタスク名も出しません。

ガント棒期間 API が役立つ場面

Microsoft Project、Smartsheet、Jira のタイムライン CSV を取り込むポートフォリオダッシュボードは、容量ヒートマップを塗る前に棒の長さの二次確認をしばしば必要とします。契約チームは土曜・日曜を除外すべきマイルストーン文言を起草するとき、同じ棒の暦日区間と稼働日区間を比較します。無効な日付と逆転した範囲は残高を消費しません。リソース計画担当は working_days_only が true のとき duration_days を人日に換算し、図上の週末パディングが人員を膨らませないようにします。実装は parse ティア A のため、成功した呼び出しはモデルトークンも外向きネットワークもなく、公開されている基本価格 $0.002 です。入力を ISO カレンダー文字列に保ち、テストで duration_days と包括内訳を固定すれば、自前の大規模プロジェクト管理データベースを立てなくても、スケジュール監査・SEO ランディングデモ・エッジワーカー向けに再現可能な棒の長さが得られます。