NestJS中DTO转换ISO8601字符串为Date时时间异常问题

问题原因 #

你遇到的时间偏移是JavaScript Date对象解析远古日期时的历史时区偏差导致的。

JavaScript的Date在处理公元1582年（格里高利历启用年份）之前的日期时，会考虑历史上的时区调整和天文时间差异。你输入的1001-01-01 00:00:00.000属于非常早期的日期，Date构造函数解析时会自动补上UTC与当时天文时间的差值（14分44秒），最终导致输出的时间变成1001-01-01T00:14:44.000Z。

解决方案 #

要绕过这个历史时区问题，你需要自定义日期解析逻辑，不依赖JavaScript Date的默认解析行为，直接按输入的字符串构造日期：

方案1：自定义class-transformer转换函数 #

替换默认的@Type(() => Date)，用@Transform手动处理日期字符串：

import { ApiProperty } from '@nestjs/swagger';
import { IsDate, Transform } from 'class-validator';
import { TransformFnParams } from 'class-transformer';

export class YourDto {
  @ApiProperty()
  @IsDate()
  @Transform(({ value }: TransformFnParams) => {
    // 将输入的空格替换为T，转为标准ISO格式
    const isoStr = value.replace(' ', 'T');
    // 用UTC方式构造Date，避免本地时区影响
    return new Date(Date.parse(isoStr + 'Z'));
  })
  lunMIni: Date;
}

方案2：手动拆分日期时间构造UTC日期 #

如果需要更严格的控制，可以直接拆分日期时间部分，用Date.UTC构造：

@Transform(({ value }: TransformFnParams) => {
  const [datePart, timePart] = value.split(' ');
  const [year, month, day] = datePart.split('-').map(Number);
  const [hour, minute, second] = timePart.split(':').map(part => Number(part.split('.')[0]));
  // 注意JavaScript月份是0-based，需要减1
  return new Date(Date.UTC(year, month - 1, day, hour, minute, second));
})

这两种方式都会强制按输入的日期时间值构造Date对象，避免历史时区偏差带来的时间偏移。

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