JS小技巧：如何优雅地判断某天是否是节假日（支持周末和调休）

从硬编码到动态服务：构建一个面向未来的节假日判断方案

最近在做一个活动运营后台，产品经理提了个需求：要在用户参与活动的页面上，根据当前日期动态显示不同的活动状态。如果是节假日，就展示一套更活泼、更具节日氛围的UI和文案；如果是工作日，则保持常规样式。听起来很简单，对吧？不就是判断一下是不是周六日或者法定假日嘛。

但实际一上手，坑就来了。2024年国庆节后的那个周六（10月12日）要上班，但系统如果只判断周末，就会错误地把它标记为“节假日”。同样，清明节前的周日（4月7日）也要补班。这种“调休”机制，让一个看似简单的日期判断，变成了需要维护一套复杂规则的系统问题。

网上搜了一圈，发现很多方案都是把节假日和调休日硬编码在数组里，就像下面这样：

const holidays = ['2024-10-1', '2024-10-2', '2024-10-3']; // 国庆节
const workWeekends = ['2024-10-12']; // 国庆调休上班的周六

这种方法对于一次性、小范围的项目或许可行，但一旦涉及到跨年度、需要长期维护的系统，它的弊端就非常明显了：每年都需要手动更新数据，极易出错，且毫无扩展性。今天，我们就来聊聊，如何超越这种“一次性”的脚本思路，构建一个更优雅、更健壮、面向未来的节假日判断方案。

1. 理解核心问题：为什么简单的日期判断会变得复杂？

在开始写代码之前，我们得先搞清楚我们要解决的是什么问题。在中国，一个日期是否属于“休息日”，由三个核心因素决定：

1. 公历周末：通常是周六和周日。
2. 法定节假日：国家规定的放假日期，如春节、国庆等。这些日期每年由国务院办公厅发布。
3. 调休安排：为了凑出连续假期，会将邻近的周末调整为工作日，或将工作日调整为休息日。这是整个逻辑中最容易出错的部分。

这三者之间的关系是动态且存在交集的。一个日期可能同时是周末和法定假日（如国庆节当天是周二），也可能本是周末却被调休为工作日（如补班的周日）。因此，我们的判断逻辑必须能处理这些重叠和例外情况。

一个基础的、正确的逻辑判断顺序应该是：

提示：判断节假日的核心是处理“例外”。优先处理最特殊的规则（调休），再处理一般规则（法定假和周末）。

用伪代码可以表示为：

function isHoliday(date) {
  // 1. 优先级最高：是否是调休工作日（周末上班）？
  if (是调休工作日(date)) return false;

  // 2. 是否是法定节假日？
  if (是法定节假日(date)) return true;

  // 3. 是否是常规周末？
  if (是周六或周日(date)) return true;

  // 4. 以上都不是，则是工作日
  return false;
}

这个逻辑清晰地将“调休上班”作为最高优先级的否决项，确保了准确性。接下来，我们要思考如何实现这里的 是调休工作日、是法定节假日 等函数。

2. 告别硬编码：设计可维护的数据层

直接将日期数组写在业务代码里是维护的噩梦。我们需要将“数据”与“逻辑”分离。这里提供几种进阶的数据管理思路。

2.1 方案一：使用静态JSON文件

这是从硬编码迈向可维护的第一步。我们将节假日数据抽取到一个独立的JSON配置文件中。

holiday-config.json:

{
  "year": 2024,
  "holidays": [
    {"date": "2024-01-01", "name": "元旦"},
    {"date": "2024-02-10", "name": "春节", "duration": 8}
  ],
  "workWeekends": [
    {"date": "2024-02-04", "name": "春节前补班"},
    {"date": "2024-04-28", "name": "劳动节前补班"}
  ]
}

在JavaScript中，我们可以这样加载和使用：

// 假设我们通过构建工具或异步请求加载了配置
import holidayConfig from './config/holiday-config.json';

function isHoliday(date, config = holidayConfig) {
  const dateStr = formatDate(date); // 格式化为'YYYY-MM-DD'
  const { holidays, workWeekends } = config;

  // 1. 检查是否为调休工作日
  if (workWeekends.some(item => item.date === dateStr)) {
    return false;
  }

  // 2. 检查是否为法定假日
  if (holidays.some(item => item.date === dateStr)) {
    return true;
  }

  // 3. 检查是否为周末
  const day = date.getDay();
  return day === 0 || day === 6;
}

优点：数据与代码分离，便于非开发者（如运营）在指导下更新。支持添加额外字段（如节日名称name、假期长度duration），增强了信息的丰富性。 缺点：每年仍需手动更新JSON文件，且前端项目需要重新构建或部署才能生效。

2.2 方案二：引入第三方API服务

对于追求零维护、高可靠性的项目，使用专业的节假日API服务是最佳选择。这些服务商会每年及时更新全球各地的节假日数据。

以下是一个模拟调用第三方API的示例：

// 使用一个假设的节假日API服务
const HOLIDAY_API_BAS