印刷可能な月間カレンダー生成ツール

レスポンスには構造化された週の行、ローテーションされた英語の曜日ヘッダー、パイプライン向けの安定したラベルが含まれます。

年・月・設定可能な週の開始曜日

サポートされるグレゴリオ暦範囲のyearと、1月を1、12月を12とするmonthです。任意のfirst_weekdayは0から6までの整数で、0は日曜日、1は月曜日、6は土曜日を意味します。yearのエイリアスyとyr、monthのmとmon、週の起点のweek_startやstart_weekdayは、ドキュメントに記載されている場合に受け付けられます。ネットワーク、乱数シード、システム時計を使わない純粋な整数ロジックの経路なので、同じ入力からは常に同じJSONが生成されます。フィールドの欠落、整数でない値、公開範囲外の年、0から6の範囲外のfirst_weekday、1未満または12を超える月はすべてinvalid_inputを発生させ、呼び出し側がリクエストを修正できるようにします。

週・ヘッダー・日付のパディングの読み方

weeks配列がこの契約の核心です。パディングは明示的なnullなので、レンダラーが列オフセットを自分で再計算する必要はありません。成功時のレスポンスには、正規化されたyearとmonth、タイトル用の英語のmonth_name文字列、その月の整数の長さであるdays_in_monthが含まれます。is_leap_yearフラグは、月が2月でなくても、その年がグレゴリオ暦のうるう年かどうかを示します。first_weekdayとfirst_weekday_nameはリクエストした週の起点を表し、first_of_month_weekdayとその名前は、日曜日から土曜日までの絶対的な尺度上で1日の位置を示すため、UIは推測せずに本当の開始位置を強調表示できます。weekday_headersは7要素の英語の曜日名の配列で、最初の列が指定したfirst_weekdayに一致するようローテーションされています。たとえばfirst_weekdayが1なら月曜日から日曜日までの順になります。各エントリーはweek_indexと長さ7のdays配列を持ち、各スロットは1からdays_in_monthまでの日付番号か、最初の前と最後の後の空のパディングを表すnullです。week_countは行数で、通常は4から6です。calendarは常にgregorian、methodは常にmonth_calendarで、テストで安定した分岐ができます。表の列タイトルにはweekday_headers、印刷用グリッドの本体セルにはweeks、月の長さを含むキャプションが必要な場合にはdays_in_monthをお使いください。

APIの使い方・料金・印刷ワークフロー・実用上の制限

必須の整数フィールドyearとmonthを含むJSONボディを送信し、月曜日始まりなど地域別のレイアウトが必要な場合は任意のfirst_weekdayを追加します。印刷パイプライン、教室向け生成ツール、スケジュール製品、マルチテナントのプランナーが安定した契約を必要とする場合は、KIT残高から成功した1件あたり$0.002のプリペイドAPIをご利用ください。エンジンがペイロードを拒否した検証失敗では残高は消費されません。SDKを配布する開発者は、weekday_headersをtheadのラベル、nullスロットを印刷CSS用の空セルとして、weeksを列ごとにHTMLテーブルやPDFセルへマッピングできます。