跳到主要内容

setWorkTime

Description​

为甘特图设置工作时间

setWorkTime: Calendar['setWorkTime']

Parameters​

  • config - (required) 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"]})

Details​

注释

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

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

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

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

配置对象属性​

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

属性

描述

day 表示星期几的数字 [0 (星期日) - 6 (星期六)]. 注意一次只能设置一天。
// 将所有星期一标记为非工作日
gantt.setWorkTime({ day:1, hours:false });
date 一个具体日期，用来设定为工作日或休息日
// 将某个具体日期标记为休息日
gantt.setWorkTime({date:new Date(2013,0,1), hours:false})
hours 将工作时段以 'from'-'to' 对表示的数组。
'false' 值表示休息日，'true'（默认值） 应用默认时段（["8:00-17:00"]）
// 设置星期五的工作时间为 8:00 到 12:00
gantt.setWorkTime({day : 5, hours : ["8:00-12:00"]});
customWeeks 一个对象，包含针对不同时间段的不同工作时间规则。
该对象可以包含一组 key:value 对，其中 key 是时间段的名称，value 是一个包含以下属性的对象：
  • from - (Date) 强制性，时间段开始的日期
  • to - (Date) 强制性，时间段结束的日期
  • hours - (array) 以 'from'-'to' 对表示的工作时段数组。
    'false' 值表示休息日，'true'（默认值） 应用默认时段（["8:00-17:00"]）
  • days - (array) 一周七天的数组（从 0 - 周日，到 6 - 周六），其中 1/true 表示工作日，0/false 表示非工作日。
// 修改冬季月份的工作时间
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,
        },

    }
});
注释

sample: Using customWeeks to make all days in the calendar days-off

Change log​

  • customWeeks 属性在 v7.1 中引入；
  • hours 属性的格式在 7.0 版本中更改。
Need help?
Got a question about the documentation? Reach out to our technical support team for help and guidance. For custom component solutions, visit the Services page.
Need more help?Contact Support