求助：Dayjs进行UTC偏移转换时出现结果异常问题

问题重现 #

原始时间为2024-06-13T23:59:59+05:00，转换为UTC偏移-03的时区时得到错误结果：

// DATE = 2024-06-13T23:59:59+05:00
let dateTime = dayjs(date, format, locale, strict);

// +05 UTC OFFSET
dateTime = dateTime.utcOffset(300);

console.log('1 - ', dateTime.format());
// 2024-06-13T23:59:59+05:00 | OK

// -03 UTC OFFSET
dateTime = dateTime.utcOffset(-180);

console.log('2 - ', dateTime.format());
// 2024-06-13T07:59:59-03:00 | WRONG! SHOULD BE 15:59:59-03:00

问题原因 #

dayjs.utcOffset()默认行为是保持当前本地时间不变，仅修改时区偏移量，而非真正的时区转换：

1. 第一次调用utcOffset(300)时，原始时间已是+05:00，操作无实际意义，但保留了本地时间23:59:59。
2. 第二次调用utcOffset(-180)时，默认保留本地时间23:59:59，仅将偏移改为-03:00，导致对应的UTC时间为23:59:59 + 03:00 = 02:59:59 UTC，与原始时间的UTC值（23:59:59 - 05:00 = 18:59:59 UTC）完全不符，最终输出错误结果。

解决方案 #

方案1：使用Dayjs时区插件（推荐） #

通过dayjs-plugin-utc和dayjs-plugin-timezone插件直接处理时区转换，逻辑更清晰：

1. 安装依赖：

npm install dayjs-plugin-utc dayjs-plugin-timezone

2. 代码实现：

import dayjs from 'dayjs';
import utc from 'dayjs-plugin-utc';
import timezone from 'dayjs-plugin-timezone';

dayjs.extend(utc);
dayjs.extend(timezone);

const date = '2024-06-13T23:59:59+05:00';
// 直接转换为目标时区（以America/Sao_Paulo为例，对应-03:00）
const targetDateTime = dayjs(date).tz('America/Sao_Paulo');
console.log(targetDateTime.format()); // 2024-06-13T15:59:59-03:00

方案2：不使用插件，通过UTC中转转换 #

利用utcOffset的第二个参数keepLocalTime，保持UTC时间不变修改偏移：

const date = '2024-06-13T23:59:59+05:00';
let dateTime = dayjs(date);

// 先转为UTC时间
const utcTime = dateTime.utc();
// 设置目标偏移，第二个参数true表示保持UTC时间不变
dateTime = utcTime.utcOffset(-180, true);

console.log(dateTime.format()); // 2024-06-13T15:59:59-03:00

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