ユーザー固有の勤務制限

ID番号()　　　テンプレート
　機能　: 割当て予定のIDを返す
　書式　: ID番号()
　引数　: 無し
　戻り値: メンバーID

グループ番号()　　　テンプレート
　機能　: 割当て予定者のグループ番号を返す
　書式　: グループ番号()
　引数　: 無し
　戻り値: グループ番号

グループ所属()
　機能　: 割当て予定者が指定グループに所属しているかを返す
　書式　: グループ所属([Grp1][,Grp2][,Grp]…)
　引数　: 調べたいグループの番号をカンマ区切りで複数指定可
　戻り値: 指定のいずれかのグループに所属していたら True
　　　　　　いずれにも所属していない場合は False
　使用例: グループ所属(10,11,50)
　　　　　　10,11,50 のいずれかに所属していたらTrueが返る。

勤務番号()　　　テンプレート
　機能　: 割当て予定の勤務番号を返す
　書式　: 勤務番号([ID][,日にち])
　引数　: ID番号(省略可)
　　　　: 日にち(省略可)
　戻り値: 勤務番号を返す
　使用例　勤務番号()　　　割り当て予定の人／日の勤務番号
　　　　　勤務番号(340,5) 指定の人／指定日の勤務番号

日()　　　テンプレート
　機能　: 割当て予定の日にちを返す
　書式　: 日()
　引数　: 無し
　戻り値: 日にちを表す数値
　　例：　2020/10/5　がシフト割り当て予定日の場合、「５」が返る。

月()
　機能　: 割当て予定の月を返す
　書式　: 月()
　引数　: 無し
　戻り値: 月を表す数値
　　例：　2020/10/5　がシフト割り当て予定日の場合、「10」が返る。

年()
　機能　: 割当て予定の年を返す
　書式　: 年()
　引数　: 無し
　戻り値: 年を表す数値
　　例：　2020/10/5　がシフト割り当て予定日の場合、「2020」が返る。

月日数()
　機能　: 該当月の末日を返す
　書式　: 月日数()
　引数　: 無し
　戻り値: 日にち

予定休み数()
　機能　: 個人条件の予定休み数を返す
　書式　: 予定休み数([ID])
　引数　: ID番号　省略可（省略時は割り当て予定のID番号が対象）
　戻り値: 日数

曜日()　　　　テンプレート　実例集
　機能 : 曜日を返却
　書式 : 曜日()
　引数 : 無し
　戻り値: 曜日を表す数値　1〜7 → 日曜〜土曜 に対応

週番号()
　機能 : 月初から数えた週番号を返却
　書式 : 週番号([基準曜日])
　引数 : 基準曜日。省略,0,1：日曜基準　2：月曜基準　３：火曜　・・・・
　戻り値: １以上の数値

　注：週通番（1900/1/1 からの通番）を求めるには、週番号() の代わりに
　　　　Int( Dateserial(年(),月(),日()-1 )/7 ) とします。（日曜起点）
　　　　　月曜起点の場合は、赤字部分を -2 、火曜起点は -3 とします。)

休平日()　　　テンプレート
　機能　: 当日の休平日区分を返却
　書式　: 休平日([相対日])
　引数　: 相対日:省略可（既定:当日）
　　　　　　　-2:前々日 -1:前日
　　　　　　　0(省略):当日
　　　　　　　1:翌日 2:翌々日
　　　　　（参照可能範囲：前月初日〜翌月末日）
戻り値: 0-平日,1-祝日,2-固定休

前日勤務()　　　テンプレート　実例集
　機能　: 当日からｎ日前の勤務を返す
　書式　: 前日勤務( 相対日 [, ID] )
　引数　: 相対日 1-前日 2-前々日
　　　　　　　（参照可能範囲：前月下旬１０日、当月内）
　　　　　ID　調べたい人のID（省略時は割り当て予定）
　戻り値: 勤務番号

　注意：本関数を利用して連続する勤務を制限する場合は注意が必要。テンプレート参照

翌日勤務()　　　実例集
　機能　: 割り当て予定日のｎ日後の勤務を返す
　書式　: 翌日勤務( 相対日 [, ID] )
　引数　: 相対日 1-翌日 2-翌々日
　　　　　　　（参照可能範囲：当月内）
　　　　　ID　調べたい人のID（省略時は割り当て予定）
　戻り値: 勤務番号

　注意：本関数を利用して連続する勤務を制限する場合は注意が必要。テンプレート参照

前日勤務()
　機能　: 一番近い日の勤務番号を返す
　書式　: 直近勤務( ID [,方向])
　引数　: 引数　：ID：調べたい人のID（省略時は割り当て予定） 省略可
　　　　　方向：調べる方向(0または省略：前日方向　1：後日方向) 省略可
　戻り値: 勤務番号

開始時刻()
　機能　: 指定勤務の開始時刻を"時"単位の小数形式で返す
　書式　: 開始時刻( [勤務番号] )
　引数　: 勤務番号:省略時は割り当てようとしている勤務（開始時刻(勤務番号())と同一）
　戻り値: 小数形式で表した時
　　　　　"8:00" → 8　"8:30" → 8.5　"8:15" → 8.25

例：割り当てようとしている勤務の開始時刻が１２時より後の場合は「割り当て不可」

終了時刻()
　機能　: 指定勤務の終了時刻を"時"単位の小数形式で返す
　書式　: 終了時刻( 勤務番号 )
　引数　: 勤務番号:省略時は割り当てようとしている勤務
　戻り値: 小数形式で表した時
　　　　　"8:00" → 8　"8:30" → 8.5　"8:15" → 8.25

勤務回数()
　機能　: 指定期日内での勤務割り当て回数を返す
　書式　: 勤務日数( 勤務番号[,開始日] [,終了日] [,ID] )
　引数　: 勤務番号:調査する勤務番号 省略時は全勤務が対象
　　　　　開始日：調査期間の開始日　省略時は期間初日
　　　　　終了日：同、終了日　　　　省略時は期間末日
　　　　　ID ： 調査対象者のID　省略時は割り当て予定者のID
　戻り値: 勤務回数

　注意　：下旬で回数制限すると、確保不可の可能性増大

使用例

勤務の分散化

勤務日数()　　　テンプレート
　機能　: 指定勤務の総日数
　書式　: 勤務日数( 勤務番号 [, 集計区分] [, ID])
　引数　: 勤務番号:カウントする勤務番号 省略時は全勤務が対象
　　　　　集計区分： 1〜7 日曜〜土曜　10 休日　11 平日
　　　　　　　　　　　省略時は全ての日が対象
　　　　　ID ： 調べたい人のID　省略時は割り当て予定ID
　戻り値: 総勤務日数

勤務時間()　　　テンプレート
　機能　: 指定勤務の総時間を返す
　書式　: 勤務時間( [勤務番号] )
　引数　: 勤務番号:集計する勤務番号
　　　　　　省略時は全勤務が対象
　戻り値: 総勤務時間

週間勤務日数()　　　テンプレート　実例集
　機能　: 当日を含む週内の勤務日数を返す
　書式　: 週間勤務日数( 勤務番号 [, 基点曜日] )
　引数　: 勤務番号: カウントする勤務番号
　　　　　　省略時は全勤務が対象
　　　　　基点　: 起点曜日を表す数値（省略時は0）
　　　　　　　　　0：日曜　1〜7：日曜〜土曜
　戻り値: 日数

　★「週刊勤務日数一覧」（シフト表解析）を使用して、作成済みのシフト表から解析可

---

記述例

連続勤務日数()　　　テンプレート　実例集
　機能　: 当日が勤務の場合に、前後の連続する勤務日数を返す
　書式　: 連続勤務日数( [ID] )
　引数　: ID番号 　省略可（省略時は割り当て予定のID）
　戻り値: 日数

連続勤務日数()
　機能　: 当日が休みの場合に、前後の連続する休み日数を返す
　書式　: 連続休み日数( [ID] )
　引数　: ID番号 　省略可（省略時は割り当て予定のID）
　戻り値: 日数

連続勤務日数()
　機能　: 休日（定休日＋祝日）における勤務日数を返す
　書式　: 休日勤務日数( [ID] )
　引数　: ID番号 　省略可（省略時は割り当て予定のID）
　戻り値: 日数

　使用例

過去指定勤務連続数()　　実例集　夜勤3,4連続必須(翌日を休み)
　機能　: 前日以前の連続する勤務日数を返す
　書式　: 過去指定勤務連続数( [勤務番号] )
　引数　: 勤務番号 　省略可（省略時は割り当て予定の勤務が対象）
　戻り値: 日数（当日は含まない）

最小勤務間隔()
　機能　: 当日を起点として指定された勤務日までの日数を算出
　書式　: 連最小勤務間隔( 勤務番号 [, ID] )
　引数　: 勤務番号
　　　　　ID:省略可（省略時はすべての人が対象）
　戻り値: 日数（当日を０とする）

---

記述例

勤務人数()
　機能　: 当日の指定勤務が割り当てられている人数を返却
　書式　: 勤務人数( 勤務番号 [, グループ番号] )
　引数　: 勤務番号　　　 勤務番号を表す数値
　　　　　グループ番号　グループ番号を表す数値（省略可）
　戻り値: 人数

---

記述例

勤務ID()　　実例集「同じ人と同じ勤務での２連続禁止」
　機能　: 指定勤務が割り当てられている人のIDを返却
　書式　: 勤務ID( 勤務番号 )
　引数　: 勤務番号　検索したい勤務の番号
　戻り値: 最初に見つかった人のID（見つからなかったら0）

　機能　：指定勤務で指定ID間の組合せ回数を返す
　書式　：組合せ回数 勤務番号 , ID1 , ID2 )
　引数　：勤務番号
　　　　　ID1　ID番号１
　　　　　ID2　ID番号２
　戻り値：回数

　★「組合せ回数一覧」（シフト表解析）を使用して、作成済みのシフト表から解析可

---

　例１：同一日に３４０と３４１が勤務１となる組合せ回数を１まで

　例2：同一日に３４０と３４１の組合せで、勤務２と勤務３の回数合計を３まで

　例３：下図は青枠内のメンバーで、「日勤」の組合せを期間内に１回までとして制限

　　・作成結果


　　・スクリプト：（340〜344での２人の組み合わせを全て記述）

Option Explicit
function JudgeKinmu()'勤務可能判定

	if 組合せ回数(1,340,341)>1 then JudgeKinmu=-1
	if 組合せ回数(1,340,342)>1 then JudgeKinmu=-1
	if 組合せ回数(1,340,343)>1 then JudgeKinmu=-1
	if 組合せ回数(1,340,344)>1 then JudgeKinmu=-1

	if 組合せ回数(1,341,342)>1 then JudgeKinmu=-1
	if 組合せ回数(1,341,343)>1 then JudgeKinmu=-1
	if 組合せ回数(1,341,344)>1 then JudgeKinmu=-1

	if 組合せ回数(1,342,343)>1 then JudgeKinmu=-1
	if 組合せ回数(1,342,344)>1 then JudgeKinmu=-1

	if 組合せ回数(1,343,344)>1 then JudgeKinmu=-1

end function

必要人数()
　機能　: 要員設定で入力した勤務ごとの必要人数を返却
　書式　: 必要人数( 勤務番号 )
　引数　: 勤務番号を表す数値
　戻り値: 引数の勤務に必要な人数

割当済人数()
　機能　: 指定勤務に割当済みの人数を返す
　書式　: 割当済人数( 勤務番号 )
　引数　: 勤務番号を表す数値
　戻り値: 引数の勤務に割当済の人数

例：下記は、全メンバーで勤務番号（=7）の割り当てを１名以下にする

出勤判定()　　　実例集
　機能　: 指定勤務が出勤勤務か公休などの休みかを返す
　書式　: 出勤判定( 勤務番号 )
　引数　: 勤務番号
　戻り値: true-出勤 false-休み

試行回数()
　機能　: 全確保処理中の試行回数を返す
　書式　: 試行回数()
　引数　: 無し
　戻り値: 確保処理中 -　試行回数を返す（ >0 ）
　 　　　　 確保済み - ０

全員確保成功()
　機能　: 全員の確保が成功したかを判定
　書式　: 全要員確保成功()
　引数　: 無し
　戻り値: true: 確保成功 false: 未

旧暦変換()　　　テンプレート
　機能 : 当日の日付を旧暦に変換
　書式 : 旧暦変換( 変換種別 ）
　引数 : 変換種別 0:旧暦日付 1:六曜 2:閏 3:干支
　戻り値: 変換種別により戻り値が異なる
　　　　　　0:旧暦日付 - yyyymmdd の文字列形式
　　　　　　1:六曜　　 - "先勝" "友引" "先負" "大安" "仏滅" "赤口"
　　　　　　2:閏月　　 - ""(平月)　"閏"(閏月)
　　　　　　3:干支 　　- "甲子"〜"癸亥"