如何编写适配任意时区的年末最后一天ISO格式日期获取代码？

你遇到的核心问题是时区转换导致本地日期被错误转换为下一年，这主要源于两个常见误区：一是使用24作为小时数（JavaScript的Date对象小时范围是0-23，24会自动进位到下一天），二是混淆了本地日期方法和UTC日期方法的差异。

问题根源分析 #

先拆解你之前方案的问题：

• 方案一：new Date(year, 11, 31, 24, 59, 59)中的24小时会让Date对象自动跳转到下一年1月1日，再调用toISOString()（基于UTC）自然会得到错误的日期。
• 方案二：同样因为创建的日期已经是下一年1月1日，getFullYear()返回的是year+1，最终拼接出错误结果。
• 中间尝试的new Date(year, 11, 31, 12, 0, 0)：如果依赖toISOString()，在GMT-12这类西时区，本地12月31日12点对应UTC的下一年1月1日，依然会出错；但如果用本地日期方法获取组件，结果是正确的——不过这个方案没必要，因为我们可以更直接地避免时区问题。

最优解决方案 #

根据你的需求（获取对应时区的年末最后一天YYYY-MM-DD字符串），分两种场景给出方案：

场景1：获取本地时区的年末最后一天

直接构造本地时区的12月31日，然后用本地日期方法提取年、月、日（这些方法完全基于本地时区，不受UTC转换影响）：

function getLocalYearEnd(year) {
  // 创建本地时区的当年12月31日0点（小时用0-23，避免日期进位）
  const endOfYear = new Date(year, 11, 31);
  // 提取本地日期组件
  const localYear = endOfYear.getFullYear();
  // getMonth()返回0-11，所以要+1后补零
  const localMonth = String(endOfYear.getMonth() + 1).padStart(2, '0');
  const localDay = String(endOfYear.getDate()).padStart(2, '0');
  return `${localYear}-${localMonth}-${localDay}`;
}

// 使用示例
console.log(getLocalYearEnd(2020)); // 输出本地时区的2020-12-31，不受UTC转换影响

这个方案的核心是：完全基于本地时区处理日期，不依赖UTC相关方法，所以无论你在GMT+12还是GMT-12时区，都能得到本地当年的最后一天。

场景2：获取UTC时区的年末最后一天

如果需要的是UTC标准下的年末最后一天，直接基于UTC构造日期，再用toISOString()提取前10位：

function getUTCYearEnd(year) {
  // 创建UTC时区的当年12月31日
  const endOfYearUTC = new Date(Date.UTC(year, 11, 31));
  // toISOString()返回UTC格式的字符串，截取前10位就是YYYY-MM-DD
  return endOfYearUTC.toISOString().slice(0, 10);
}

// 使用示例
console.log(getUTCYearEnd(2020)); // 始终输出2020-12-31，不受本地时区影响

额外提示 #

• 避免使用24作为小时数，JavaScript Date的小时范围是0-23，超过的数值会自动进位到下一天/月/年。
• 明确区分本地日期方法（getFullYear()、getMonth()、getDate()）和UTC日期方法（getUTCFullYear()、getUTCMonth()、getUTCDate()），根据需求选择对应的方法。

内容的提问来源于stack exchange，提问作者K. Weber