Merge pull request #442 from Moadong/feature/#441-add-string-to-date-unit-test-FE-123

[feature] stringToDate 유틸리티 함수 단위 테스트 추가

Author: seongwon030

frontend/src/pages/AdminPage/tabs/RecruitEditTab/RecruitEditTab.tsx

@@ -5,7 +5,7 @@ import Calendar from '@/pages/AdminPage/tabs/RecruitEditTab/components/Calendar/
 import Button from '@/components/common/Button/Button';
 import InputField from '@/components/common/InputField/InputField';
 import { useUpdateClubDescription } from '@/hooks/queries/club/useUpdateClubDescription';
-import { parseRecruitmentPeriod } from '@/utils/stringToDate';
+import { parseRecruitmentPeriod } from '@/utils/recruitmentPeriodParser.ts';
 import { ClubDetail } from '@/types/club';
 import { useQueryClient } from '@tanstack/react-query';
 import MarkdownEditor from '@/pages/AdminPage/tabs/RecruitEditTab/components/MarkdownEditor/MarkdownEditor';

frontend/src/pages/ClubDetailPage/components/ClubDetailFooter/ClubDetailFooter.tsx

@@ -1,7 +1,7 @@
 import * as Styled from './ClubDetailFooter.styles';
 import DeadlineBadge from '@/pages/ClubDetailPage/components/DeadlineBadge/DeadlineBadge';
 import ClubApplyButton from '@/pages/ClubDetailPage/components/ClubApplyButton/ClubApplyButton';
-import { parseRecruitmentPeriod } from '@/utils/stringToDate';
+import { parseRecruitmentPeriod } from '@/utils/recruitmentPeriodParser.ts';
 import getDeadlineText from '@/utils/getDeadLineText';
 
 interface ClubDetailFooterProps {

frontend/src/pages/ClubDetailPage/components/ClubDetailHeader/ClubDetailHeader.tsx

@@ -1,7 +1,7 @@
 import * as Styled from './ClubDetailHeader.styles';
 import ClubProfile from '@/pages/ClubDetailPage/components/ClubProfile/ClubProfile';
 import ClubApplyButton from '@/pages/ClubDetailPage/components/ClubApplyButton/ClubApplyButton';
-import { parseRecruitmentPeriod } from '@/utils/stringToDate';
+import { parseRecruitmentPeriod } from '@/utils/recruitmentPeriodParser.ts';
 import getDeadlineText from '@/utils/getDeadLineText';
 interface ClubDetailHeaderProps {
   name: string;

frontend/src/utils/parseRecruitmentPeriod.test.ts

@@ -0,0 +1,35 @@
+import { parseRecruitmentPeriod } from './recruitmentPeriodParser.ts';
+
+describe('parseRecruitmentPeriod 함수 테스트', () => {
+  it('올바른 형식의 날짜를 파싱한다.', () => {
+    const input = '2024.03.20 14:00 ~ 2024.03.25 18:00';
+    const result = parseRecruitmentPeriod(input);
+
+    expect(result.recruitmentStart).toEqual(new Date('2024-03-20T14:00:00'));
+    expect(result.recruitmentEnd).toEqual(new Date('2024-03-25T18:00:00'));
+  });
+
+  it('날짜가 기간형식이 아닌 단일 날짜 형식인 경우 null을 반환한다.', () => {
+    const input = '2024.03.20 14:00';
+    const result = parseRecruitmentPeriod(input);
+
+    expect(result.recruitmentStart).toBeNull();
+    expect(result.recruitmentEnd).toBeNull();
+  });
+
+  it('빈 문자열이라면 null을 반환한다.', () => {
+    const input = '';
+    const result = parseRecruitmentPeriod(input);
+
+    expect(result.recruitmentStart).toBeNull();
+    expect(result.recruitmentEnd).toBeNull();
+  });
+
+  it('날짜 사이 ~가 없다면 null을 반환한다.', () => {
+    const input = '2024.03.20 14:00 - 2024.03.25 18:00';
+    const result = parseRecruitmentPeriod(input);
+
+    expect(result.recruitmentStart).toBeNull();
+    expect(result.recruitmentEnd).toBeNull();
+  });
+});

frontend/src/utils/recruitmentPeriodParser.test.ts

@@ -0,0 +1,50 @@
+import { parseRecruitmentDateString } from './recruitmentPeriodParser.ts';
+
+describe('parseRecruitmentPeriod 함수 테스트', () => {
+  it('날짜와 시간이 포함된 문자열을 Date 객체로 정확히 바꾼다', () => {
+    const input = '2025.05.25 13:45';
+    const result = new Date('2025-05-25T13:45:00');
+    expect(parseRecruitmentDateString(input)).toEqual(result);
+  });
+
+  it('자정 시간 "YYYY.MM.DD 00:00" 형식을 올바르게 Date 객체로 변환한다', () => {
+    const input = '2025.05.25 00:00';
+    const result = new Date('2025-05-25T00:00:00');
+    expect(parseRecruitmentDateString(input)).toEqual(result);
+  });
+
+  it('공백이 없는 문자열이라면 예외가 발생한다.', () => {
+    const input = '2025.05.2513:45';
+    expect(() => parseRecruitmentDateString(input)).toThrow(
+      '유효하지 않은 날짜 형식입니다. 형식은 "YYYY.MM.DD HH:mm" 이어야 합니다.',
+    );
+  });
+
+  it('시간 부분이 누락된 경우 예외가 발생한다', () => {
+    const input = '2025.05.25 ';
+    expect(() => parseRecruitmentDateString(input)).toThrow(
+      '유효하지 않은 날짜 형식입니다. 형식은 "YYYY.MM.DD HH:mm" 이어야 합니다.',
+    );
+  });
+
+  it('날짜 부분이 누락된 경우 예외가 발생한다', () => {
+    const input = ' 13:45';
+    expect(() => parseRecruitmentDateString(input)).toThrow(
+      '유효하지 않은 날짜 형식입니다. 형식은 "YYYY.MM.DD HH:mm" 이어야 합니다.',
+    );
+  });
+
+  it('빈 문자열이 주어지면 예외가 발생한다', () => {
+    const input = '';
+    expect(() => parseRecruitmentDateString(input)).toThrow(
+      '유효하지 않은 날짜 형식입니다. 형식은 "YYYY.MM.DD HH:mm" 이어야 합니다.',
+    );
+  });
+
+  it('YYYY.MM.DD HH:mm 형식이 아닌 입력에 대해 에러를 던진다', () => {
+    const input = '1.1.1 1:1';
+    expect(() => parseRecruitmentDateString(input)).toThrow(
+      '유효하지 않은 날짜 형식입니다. 형식은 "YYYY.MM.DD HH:mm" 이어야 합니다.',
+    );
+  });
+});

frontend/src/utils/recruitmentPeriodParser.ts.ts

@@ -0,0 +1,31 @@
+import { parse, isValid } from 'date-fns';
+
+export const parseRecruitmentDateString = (s: string): Date => {
+  const regex = /^\d{4}\.\d{2}\.\d{2} \d{2}:\d{2}$/;
+  if (!regex.test(s)) {
+    throw new Error(
+      '유효하지 않은 날짜 형식입니다. 형식은 "YYYY.MM.DD HH:mm" 이어야 합니다.',
+    );
+  }
+  const date = parse(s, 'yyyy.MM.dd HH:mm', new Date());
+  if (!isValid(date)) {
+    throw new Error(
+      '유효하지 않은 날짜 형식입니다. 형식은 "YYYY.MM.DD HH:mm" 이어야 합니다.',
+    );
+  }
+  return date;
+};
+
+export const parseRecruitmentPeriod = (
+  periodStr: string,
+): { recruitmentStart: Date | null; recruitmentEnd: Date | null } => {
+  const parts = periodStr.split('~').map((s) => s.trim());
+  if (parts.length !== 2) {
+    return { recruitmentStart: null, recruitmentEnd: null };
+  }
+
+  return {
+    recruitmentStart: parseRecruitmentDateString(parts[0]),
+    recruitmentEnd: parseRecruitmentDateString(parts[1]),
+  };
+};