Bitbucket流水线日期转换测试失败，寻求解决方案

问题核心 #

你编写的日期转换函数在本地能正确将无时区的ISO字符串转为圣保罗时区对应的UTC时间，但在Bitbucket流水线中，转换结果直接沿用输入ISO的UTC时间，与预期不符。

原因分析 #

Luxon的DateTime.fromISO(date)处理无时区的ISO字符串时，默认会用当前运行环境的本地时区解析该时间：

• 本地环境时区为圣保罗，因此解析时把2000-01-01T00:00:00当作圣保罗时间，转成UTC就是2000-01-01T02:00:00.000Z，符合预期；
• Bitbucket流水线默认时区为UTC，解析时直接把输入当作UTC时间，转成JS Date自然就是2000-01-01T00:00:00.000Z，导致测试失败。

你设置process.env.TZ未生效，大概率是设置时机过晚（比如函数执行时才设置，Luxon已完成初始化），或是流水线容器环境未正确读取该环境变量。

解决方案 #

1. 修复转换函数（推荐） #

直接在解析ISO字符串时明确指定输入时间属于目标时区，彻底摆脱对环境时区的依赖：

import { DateTime } from 'luxon';

export const date = {
  now: (timezone = 'America/Sao_Paulo'): DateTime => DateTime.now().setZone(timezone),
  convertISODateToJSDateWithTimezone: (date: string, timezone = 'America/Sao_Paulo') =>
    // 关键：添加{ zone: timezone }参数，告知Luxon输入的ISO属于目标时区
    DateTime.fromISO(date, { zone: timezone }).toJSDate(),
};

2. 确保测试环境时区生效（辅助方案） #

若仍想依赖环境时区，需在测试进程启动时就设置时区：

• 在测试文件最顶部添加（必须在导入Luxon之前）：

process.env.TZ = 'America/Sao_Paulo';

import { date } from '../date';
// ... 测试代码

• 或通过Jest配置全局设置：
  在jest.config.js中添加：

module.exports = {
  setupFiles: ['<rootDir>/src/setup-timezone.js'],
};

创建setup-timezone.js文件：

process.env.TZ = 'America/Sao_Paulo';

验证逻辑 #

修改后，输入的2000-01-01T00:00:00会被强制解析为圣保罗时区的时间，转成UTC就是2000-01-01T02:00:00.000Z，无论运行环境时区如何，结果都一致，测试即可通过。

内容的提问来源于stack exchange，提问作者Caio Pereira