§４-４  休日マップ

１．『kt関数アドイン』における休日はパラメータ『休日Map』で指定します。

  kt関数では『休日Map』を指定する事で､下記のような多種多様なカレンダーに
基づいた日付処理が可能です。

      例）第２／４土曜日が休業日
          日曜営業で月曜が休業日
          年末年始／夏期休暇
          普通は土曜日が休業日だが､ある日だけ営業日にする　
          Ａ社にはＡ社のカレンダー／Ｂ社にはＢ社のカレンダーで日付処理する

  『休日Map』に指定する内容には「固定休日コード」と「休日マップデータ」の
２種類があります。

２．【固定休日コード】

  日曜〜土曜・祝日などに対して「休日」とするかどうかを【 0/1 】で指定します。
有効期間の制限が無く､マップデータの管理が必要ないので簡単に利用できます。

    各桁とも「１：休日とする」　「０：休日としない（営業日）」
    （ 0/1 以外を指定した場合は"0"と見故します）

  『祝日』を休日指定する場合でも､祝日テーブルなどを別個に用意する必要は
ありません。全て関数内で祝日日付を算出して判定しています。祝日情報に関
しては『§4-2 祝日』を参照して下さい。

      『年始』は【１月１日〜３日】を休日とします。
      『年末』は【１２月２９日〜３１日】を休日とします。
      『大晦日』は【１２月３１日】を休日とします。

各桁の休日指定を組み合わせると､下記のように定義する事ができます。
（カッコ内は､ＶＢＡ用に kt関数Addin.xla 内で用意してある定数名です）

	・休日なし	"00000000000@"	（kt_休日なし  ）
	・土日を休日	"10000010000@"	（kt_土日       ）
	・土日/祝日を休日	"10000011000@"	（kt_土日祝    ）
	・日/祝日を休日	"10000001000@"	（kt_日祝       ）
	・銀行休日	"10000011101@"	（kt_銀行休日 ）
	・官庁（日祝）	"10000001111@"	（kt_官庁1      ）
	・官庁（土日祝）	"10000011111@"	（kt_官庁2      ）

      ※ＶＢＡでの一括処理やシートに大量の式（1000行以上など）を記述する場合には､
          処理時間が多く掛かりますので注意が必要です。（cf：パフォーマンス上の注意）

  「固定休日コード」を「休日マップデータ」に変換するサブルーチン（ｋｔTemp休日Map）を
用意してありますので､「固定休日コード」を利用している環境で一括処理等を行なう場合は､
臨時に「休日マップデータ」を生成して処理の効率化を図ってください。

  ワークシート上の式で「固定休日コード」を使う場合は､メンテナンス性やミスの防止
の為にも､どこかのセルに「固定休日コード」を書き込み､そのセルに【名前】を付けて､
式の中では『セル名』で参照するようにして下さい。
  セルに「固定休日コード」を書き込む場合は､【HyperLink 】が付かないように事前に
書式設定を”文字列”にして下さい。


※ 『kt固定休日EX 』関数 , 『ktTemp休日Map 』サブルーチンの２つでのみ、固定休日
    コードの曜日部分（１〜７桁目）が拡張されて、第１〜第５曜日の組み合わせ指定が出来ます。

３．【休日マップデータ】

「固定休日コード」だけでは定義できない休業日パターンが必要な場合は､メニューにある
【休日Mapの作成】で休日マップデータ(２〜12年分)を自由にカスタマイズして作成します。
（作成したデータはセルに格納して､パラメータにはそのセルを指定します）


「休日マップデータ」では【第２／４土曜日】といった指定も可能です。夏期休暇など規則性の
無い休日は「１日ずつ」登録していきます。本来なら休日となる日だが､ある１日だけ特別に営
業日にすることも可能です（先に休日指定した日付に対して､【日付指定で解除】します）。

「休日マップデータ」には【有効期間】があります。パラメーターに指定した日付､または算出結果
となる日付が､この有効期間の範囲外となる場合には､ｋｔ関数はエラー値（#VALUE!）を返します。
詳しくは各関数のリファレンスを参照して下さい。

    休日マップデータ 【 圧 縮 】 ４年間 ⇒ ２５４文字


    休日マップデータ 【 ノーマル 】 ４年間 ⇒ １４７４文字

４．休日マップデータに圧縮を用意した理由

  休日マップデータは「１日を１文字」で表している為､最小の『４年間』でも軽く１０００文字
を越えてしまいます。エクセルでワークシート全体をコピーする場合
        個々のセルのデータは２５５文字まで
という制限がある為､圧縮していないデータをセルに収録した状態でワークシート全体を
コピーすると【２５６文字以降の欠落】によりマップデータが壊れてしまいます。

  これに対処する為に､圧縮データをサポートしています。圧縮するとサイズが〔１／６〕に
なるので､『４年間』の場合は【２５４文字】となり､上記の問題をクリアできます。『６〜１２年間』
の場合は､圧縮しても上記の制限に引っ掛かりますので､何らメリットはありません。

５．休日マップデータの管理について

  『ktMapLinker 関数』により､休日マップを､閉じたままのカレンダー管理ブックにて一元管理
できます。
  個々のブックでは､カレンダー管理ブック上に用意された「４(２)年/圧縮」の休日マップを引数
とした『ktMapLinker 関数』を記述する事により､管理ブックで定義されている休日マップを【ノー
マル】モードで展開できます。
  管理ブック上には「休日マップの作成」により､休日マップを作成してください。期間に応じて、
１〜３個の「４(or ２)年 圧縮」休日マップに分解出力されます。
  既に作成済みの休日マップから、[ktMapLinker 関数]用の分解休日マップを作成する場合は、
「休日マップの作成」で作成したシート上に書き込んである『休日条件』を【読み込み】ボタンに
より取り込み、そのままシートへ再度、カレンダー出力すればＯＫです。


-------------------------------------------------------------------------
  『kt固定休日EX』関数によって、「休日マップの作成」フォームによるものと全く同レベルの定義
が可能になり、ワークシート上で簡単に【休日マップ】を作成できるようになりました。
  この関数を設けた理由は「ある週の休業日が決定するのが２週間前」といった短期間ごとの
営業カレンダーに簡単に対応出来るようにする為です。予定が決まった段階でワークシート上
の『任意休日/休日解除』一覧に日付を追加していけば、それだけで【休日マップ】が即座に
更新されます。
  ただ、この運用方法であれば、当然の事として、設定情報がワークシート上に誰にでも見れる
状態で置かれている事になる訳ですから、誤って更新してしまう危険性もありますので注意して
下さい。「休日マップの作成」で作ったものならば、基本の休日管理用ブックで管理して、個々の
ブックでは「外部参照式」でその管理ブックから取り込むように運用できますから、誤って更新して
しまう危険性はありません。
  したがって、出来る限り『休日マップの作成』フォームで作るようにして下さい。