Nest.js DTO：ISO8601字符串转Date及timestampz严格验证问题

1. 正确将ISO字符串转换为JavaScript Date类型 #

要解决转换失败的问题，需确保NestJS全局校验管道启用自动转换，并修正DTO中的装饰器写法：

步骤1：配置全局ValidationPipe #

在main.ts中开启请求体到DTO类型的自动转换：

import { ValidationPipe } from '@nestjs/common';
import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  app.useGlobalPipes(new ValidationPipe({
    transform: true, // 启用自动转换
    transformOptions: {
      enableImplicitConversion: true,
    },
  }));
  await app.listen(3000);
}
bootstrap();

步骤2：修正DTO装饰器 #

使用@Transform自定义转换逻辑（推荐），或正确搭配@Type：

import { ApiProperty } from '@nestjs/swagger';
import { IsISO8601, IsNotEmpty, Transform, Type } from 'class-validator';
import { ICreateBookingDto } from './your-interface-path';

export class CreateBookingDto implements ICreateBookingDto {
  @ApiProperty({ example: '2023-12-04T15:30:00Z' })
  @IsISO8601({ strict: true, strictSeparator: true })
  @Transform(({ value }) => new Date(value)) // 生成Date实例
  @IsNotEmpty()
  from_date: Date;

  @ApiProperty({ example: '2023-12-04T16:30:00Z' })
  @IsISO8601({ strict: true, strictSeparator: true })
  @Type(() => Date) // 告知class-transformer转换类型
  @IsNotEmpty()
  to_date: Date;
}

注意：@Transform回调必须返回new Date(value)，而非直接返回Date构造函数，否则无法生成有效Date实例。

2. 严格校验timestampz格式（仅接受带T和Z的完整格式） #

默认@IsISO8601会允许2023-12-04T15:30:00+00:00这类时区格式，若要仅接受Z结尾的UTC格式，需自定义校验器：

步骤1：创建自定义校验器 #

import { registerDecorator, ValidationOptions, ValidationArguments } from 'class-validator';

export function IsTimestampz(validationOptions?: ValidationOptions) {
  return function (object: Object, propertyName: string) {
    registerDecorator({
      name: 'isTimestampz',
      target: object.constructor,
      propertyName: propertyName,
      options: validationOptions,
      validator: {
        validate(value: any) {
          // 匹配严格格式：YYYY-MM-DDTHH:mm:ssZ
          const regex = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$/;
          return typeof value === 'string' && regex.test(value);
        },
        defaultMessage(args: ValidationArguments) {
          return `${args.property} 必须是有效的timestampz格式（示例："2023-12-04T15:30:00Z"）`;
        },
      },
    });
  };
}

步骤2：在DTO中使用自定义校验器 #

替换原@IsISO8601，确保仅接受指定格式：

import { ApiProperty } from '@nestjs/swagger';
import { IsNotEmpty, Transform, Type } from 'class-validator';
import { IsTimestampz } from './your-validator-path';
import { ICreateBookingDto } from './your-interface-path';

export class CreateBookingDto implements ICreateBookingDto {
  @ApiProperty({ example: '2023-12-04T15:30:00Z' })
  @IsTimestampz()
  @Transform(({ value }) => new Date(value))
  @IsNotEmpty()
  from_date: Date;

  @ApiProperty({ example: '2023-12-04T16:30:00Z' })
  @IsTimestampz()
  @Type(() => Date)
  @IsNotEmpty()
  to_date: Date;
}

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