setWorkTime

设置甘特图的工作时间

void setWorkTime(object config);

config

object

时间段的配置对象

Example

gantt.config.work_time = true;
 
// 将工作日的工作时间从 ["8:00-17:00"] 更新为 ["9:00-18:00"]
gantt.setWorkTime({ hours:["9:00-18:00"] });
 
// 标记所有星期五为非工作日
gantt.setWorkTime({ day:5, hours:false });
 
// 调整星期五和星期六的工作时间
// 从 ["8:00-17:00"] 改为 ["8:00-12:00"]
gantt.setWorkTime({day : 5, hours : ["8:00-12:00"]});
gantt.setWorkTime({day : 6, hours : ["8:00-12:00"]});
 
// 指定3月31日为工作日
gantt.setWorkTime({date : new Date(2013, 2, 31)});
 
// 将1月1日设置为休息日
gantt.setWorkTime({date:new Date(2013,0,1), hours:false})
 
// 定义工作时间为两个时间段：8:30-12:00，13:00-17:00（允许午休时间）
gantt.setWorkTime({hours : ["8:30-12:00", "13:00-17:00"]})

Related samples

Calculate working hours

Details

此方法仅在启用 work_time 时生效，否则会被忽略。

如果未指定任务，该方法将应用于全局工作时间日历。
此外，也可以直接从日历对象调用。

默认情况下，工作时间设置如下：

工作日：周一至周五。
工作时间：08:00 - 17:00。

此方法允许您自定义这些默认设置。

配置对象属性

配置对象可以包含以下属性：

属性	描述
day	表示星期几的数字 [0 (星期日) - 6 (星期六)]. 注意一次只能设置一天。
day	`// 将所有星期一标记为非工作日 gantt.setWorkTime({ day:1, hours:false });`
date	指定某个具体日期作为工作日或休息日
date	`// 将某个具体日期标记为休息日 gantt.setWorkTime({date:new Date(2013,0,1), hours:false})`
hours	一个表示工作时间段的数组，格式为 '起始时间'-'结束时间'。 'false' 表示该日为休息日，'true'（默认）表示应用默认时间（["8:00-17:00"]）
hours	`// 设置星期五的工作时间为 8:00 到 12:00 gantt.setWorkTime({day : 5, hours : ["8:00-12:00"]});`
customWeeks	一个定义不同时间段工作时间规则的对象。该对象可以包含键值对，其中 key 是时间段名称，value 是包含以下属性的对象： from - (Date) 必需，时间段开始日期 to - (Date) 必需，时间段结束日期 hours - (array) 工作时间数组，格式为 '起始时间'-'结束时间'。 'false' 表示休息日，'true'（默认）应用默认时间（["8:00-17:00"]） days - (array) 长度为7的数组，表示一周七天（0 - 星期日到 6 - 星期六），1/true 表示工作日，0/false 表示非工作日。
customWeeks	`// 修改冬季月份的工作时间 gantt.setWorkTime({ customWeeks: { winter: { from: new Date(2018, 11, 1), // 2018年12月1日 to: new Date(2019, 2, 1), // 2019年3月1日 00:00 hours: ["9:00-13:00", "14:00-16:00"], days: [ 1, 1, 1, 1, 0, 0, 0] } } });`

设置夜班工作时间

在 setWorkTime 配置对象中指定 hours 属性时，时间段应按从早到晚的顺序列出。如果按降序提供，某些时间段可能会被忽略。例如，以下情况中 18:00 之后的时间段会被忽略：

// 错误的设置示例
gantt.setWorkTime({day : 5, hours : ["16:00-18:00", "14:00-15:00",  "08:00-10:00"]});
gantt.setWorkTime({day : 5, hours : ["16:00-18:00", "00:00-04:00",  "05:00-06:00"]});

要正确指定夜班时间，应将其拆分到两天：

第一天内的24小时范围
第二天内的24小时范围

例如：

gantt.setWorkTime({day : 5, hours : ["16:00-18:00"]});
gantt.setWorkTime({day : 6, hours : ["00:00-04:00",  "05:00-06:00"]});

重写工作时间规则

对同一日期多次调用此方法时，后一次调用会覆盖前一次的工作时间设置：

gantt.setWorkTime({hours:["8:00-12:00"]});
gantt.setWorkTime({hours:["13:00-17:00"]});
// 最终工作时间为 13:00-17:00，
// 不是两个时间段的合并

设置自定义工作日和休息日

不允许设置排除所有工作日或工作时间的工作时间规则。例如，以下设置无效：

gantt.setWorkTime({ day: 0, hours: [] });
gantt.setWorkTime({ day: 1, hours: [] });
gantt.setWorkTime({ day: 2, hours: [] });
gantt.setWorkTime({ day: 3, hours: [] });
gantt.setWorkTime({ day: 4, hours: [] });
gantt.setWorkTime({ day: 5, hours: [] });
gantt.setWorkTime({ day: 6, hours: [] });

在这种情况下，Gantt 会忽略其中某一天的设置，意味着该天仍有工作时间。

如果尝试基于这样的设置计算最近的工作时间或持续时间，将无法找到有效的日期或持续时间。实际上，这样的日历配置无效。即使某些具体日期有工作时间，计算也只会在包含工作日和工作时间的范围内正确工作。尝试在这些范围之外计算可能导致错误或无结果。

若要创建某些月份或年份完全为非工作日的日历，应使用 setWorkTime() 的 customWeeks 选项。要在所需范围内定义工作日和工作时间，应：

将时间线划分为无工作时间的时间段
明确为所需日期设置工作时间

示例：

gantt.setWorkTime({ date: new Date(2025, 3, 10), hours: ["8:00-12:00"] })
gantt.setWorkTime({ date: new Date(2025, 3, 11), hours: ["13:00-17:00"] })
 
gantt.setWorkTime({
    customWeeks: {
        period1: {
            from: new Date(2025, 3, 1),
            to: new Date(2025, 3, 10),
            hours: false,
        },
 
        period2: {
            from: new Date(2025, 3, 12),
            to: new Date(2025, 5, 1),
            hours: false,
        },
 
    }
});