@simplysm/core-common 13.0.0-beta.1

package/dist/types/date-only.js

@@ -0,0 +1,251 @@
+import { ArgumentError } from "../errors/argument-error";
+import { formatDate, normalizeMonth } from "../utils/date-format";
+class DateOnly {
+  static MS_PER_DAY = 24 * 60 * 60 * 1e3;
+  date;
+  constructor(arg1, arg2, arg3) {
+    if (arg1 === void 0) {
+      const tick = Date.now();
+      const date = new Date(tick);
+      this.date = new Date(date.getFullYear(), date.getMonth(), date.getDate());
+    } else if (arg2 !== void 0 && arg3 !== void 0) {
+      this.date = new Date(arg1, arg2 - 1, arg3);
+    } else if (arg1 instanceof Date) {
+      const date = arg1;
+      this.date = new Date(date.getFullYear(), date.getMonth(), date.getDate());
+    } else {
+      const date = new Date(arg1);
+      this.date = new Date(date.getFullYear(), date.getMonth(), date.getDate());
+    }
+  }
+  /**
+   * 문자열을 DateOnly로 파싱
+   * @param str 날짜 문자열
+   * @returns DateOnly 인스턴스
+   *
+   * 지원 형식:
+   * - `yyyy-MM-dd` (예: '2024-01-15') - 문자열에서 직접 추출, 타임존 영향 없음
+   * - `yyyyMMdd` (예: '20240115') - 문자열에서 직접 추출, 타임존 영향 없음
+   * - ISO 8601 (예: '2024-01-15T00:00:00Z') - UTC로 해석 후 로컬 타임존 변환
+   *
+   * @note 서버/클라이언트 타임존이 다른 경우 `yyyy-MM-dd` 형식 사용 권장
+   * @note DST(일광절약시간) 지역에서 ISO 8601 형식 파싱 시, 파싱 대상 날짜의 오프셋을 사용합니다.
+   */
+  static parse(str) {
+    const matchYMD = /^(\d{4})-(\d{2})-(\d{2})$/.exec(str);
+    if (matchYMD != null) {
+      return new DateOnly(Number(matchYMD[1]), Number(matchYMD[2]), Number(matchYMD[3]));
+    }
+    const matchCompact = /^(\d{4})(\d{2})(\d{2})$/.exec(str);
+    if (matchCompact != null) {
+      return new DateOnly(Number(matchCompact[1]), Number(matchCompact[2]), Number(matchCompact[3]));
+    }
+    const utcTick = Date.parse(str);
+    if (!Number.isNaN(utcTick)) {
+      const tempDate = new Date(utcTick);
+      const offsetMinutes = tempDate.getTimezoneOffset();
+      const localTick = utcTick - offsetMinutes * 60 * 1e3;
+      return new DateOnly(localTick);
+    }
+    throw new ArgumentError(`\uB0A0\uC9DC \uD615\uC2DD\uC744 \uD30C\uC2F1\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uC9C0\uC6D0 \uD615\uC2DD: 'yyyy-MM-dd', 'yyyyMMdd', ISO 8601 \uB0A0\uC9DC`, {
+      input: str
+    });
+  }
+  //#region 주차 계산
+  /**
+   * 기준 연도와 월을 주차 정보를 기반으로 반환
+   * @param weekStartDay 주의 시작 요일 (0=일요일, 1=월요일, ..., 6=토요일). 기본값: 1(월요일)
+   * @param minDaysInFirstWeek 첫 주로 간주할 최소 일수 (1~7). 기본값: 4 (ISO 8601 표준)
+   * @returns 해당 날짜가 속한 주차의 기준 연도와 월
+   *
+   * @example
+   * // ISO 8601 표준 (월요일 시작, 첫 주 최소 4일)
+   * new DateOnly(2024, 1, 1).getBaseYearMonthSeqForWeekSeq(1, 4)
+   * // 미국식 (일요일 시작, 첫 주 최소 1일)
+   * new DateOnly(2024, 1, 1).getBaseYearMonthSeqForWeekSeq(0, 1)
+   */
+  getBaseYearMonthSeqForWeekSeq(weekStartDay = 1, minDaysInFirstWeek = 4) {
+    const dayOfWeek = (this.dayOfWeek + 7 - weekStartDay) % 7;
+    const daysInWeek = 7 - dayOfWeek;
+    if (daysInWeek < minDaysInFirstWeek) {
+      const prevWeek = this.addDays(-7);
+      return { year: prevWeek.year, monthSeq: prevWeek.month };
+    } else {
+      const nextMonthDate = this.addMonths(1).setDay(1);
+      const remainedDays = (nextMonthDate.tick - this.tick) / DateOnly.MS_PER_DAY;
+      const realDaysInWeek = Math.min(daysInWeek, remainedDays);
+      if (realDaysInWeek < minDaysInFirstWeek) {
+        const nextWeek = this.addDays(7);
+        return { year: nextWeek.year, monthSeq: nextWeek.month };
+      } else {
+        return { year: this.year, monthSeq: this.month };
+      }
+    }
+  }
+  /**
+   * 주차 정보를 기반으로 해당 주의 시작 날짜 계산
+   * @param weekStartDay 주의 시작 요일 (0=일요일, 1=월요일, ..., 6=토요일). 기본값: 1(월요일)
+   * @param minDaysInFirstWeek 첫 주로 간주할 최소 일수 (1~7). 기본값: 4 (ISO 8601 표준)
+   * @returns 해당 날짜가 속한 주의 시작 날짜
+   */
+  getWeekSeqStartDate(weekStartDay = 1, minDaysInFirstWeek = 4) {
+    const dayOfWeek = (this.dayOfWeek + 7 - weekStartDay) % 7;
+    const daysInFirstWeek = 7 - dayOfWeek;
+    if (daysInFirstWeek < minDaysInFirstWeek) {
+      return this.addDays(-dayOfWeek + 7);
+    } else {
+      return this.addDays(-dayOfWeek);
+    }
+  }
+  /**
+   * 연도 및 주차 순서 정보를 반환
+   * @param weekStartDay 주의 시작 요일 (0=일요일, 1=월요일, ..., 6=토요일). 기본값: 1(월요일)
+   * @param minDaysInFirstWeek 첫 주로 간주할 최소 일수 (1~7). 기본값: 4 (ISO 8601 표준)
+   * @returns 연도와 해당 연도 기준 주차 번호
+   *
+   * @example
+   * // ISO 8601 표준 (월요일 시작, 첫 주 4일 이상)
+   * new DateOnly(2025, 1, 6).getWeekSeqOfYear(); // { year: 2025, weekSeq: 2 }
+   *
+   * // 미국식 (일요일 시작, 첫 주 1일 이상)
+   * new DateOnly(2025, 1, 1).getWeekSeqOfYear(0, 1); // { year: 2025, weekSeq: 1 }
+   */
+  getWeekSeqOfYear(weekStartDay = 1, minDaysInFirstWeek = 4) {
+    const base = this.getBaseYearMonthSeqForWeekSeq(weekStartDay, minDaysInFirstWeek);
+    const firstWeekStart = new DateOnly(base.year, 1, 1).getWeekSeqStartDate(weekStartDay, minDaysInFirstWeek);
+    const diffDays = (this.tick - firstWeekStart.tick) / DateOnly.MS_PER_DAY;
+    return {
+      year: base.year,
+      weekSeq: Math.floor(diffDays / 7) + 1
+    };
+  }
+  /**
+   * 해당 날짜의 연도, 월 및 주차(weekSeq) 정보를 반환
+   * @param weekStartDay 주의 시작 요일 (0=일요일, 1=월요일, ..., 6=토요일). 기본값: 1(월요일)
+   * @param minDaysInFirstWeek 첫 주로 간주할 최소 일수 (1~7). 기본값: 4 (ISO 8601 표준)
+   * @returns 연도, 월 및 해당 월 기준 주차 번호
+   *
+   * @example
+   * // ISO 8601 표준 (월요일 시작, 첫 주 4일 이상)
+   * new DateOnly(2025, 1, 15).getWeekSeqOfMonth(); // { year: 2025, monthSeq: 1, weekSeq: 3 }
+   *
+   * // 미국식 (일요일 시작, 첫 주 1일 이상)
+   * new DateOnly(2025, 1, 15).getWeekSeqOfMonth(0, 1); // { year: 2025, monthSeq: 1, weekSeq: 3 }
+   */
+  getWeekSeqOfMonth(weekStartDay = 1, minDaysInFirstWeek = 4) {
+    const base = this.getBaseYearMonthSeqForWeekSeq(weekStartDay, minDaysInFirstWeek);
+    const firstWeekStart = new DateOnly(base.year, base.monthSeq, 1).getWeekSeqStartDate(
+      weekStartDay,
+      minDaysInFirstWeek
+    );
+    const diffDays = (this.tick - firstWeekStart.tick) / DateOnly.MS_PER_DAY;
+    return {
+      year: base.year,
+      monthSeq: base.monthSeq,
+      weekSeq: Math.floor(diffDays / 7) + 1
+    };
+  }
+  /**
+   * 주차 정보를 기반으로 해당 주의 시작 날짜 가져오기
+   * @param arg 연도, 선택적 월, 주차 번호
+   * @param weekStartDay 주의 시작 요일 (0=일요일, 1=월요일, ..., 6=토요일). 기본값: 1(월요일)
+   * @param minDaysInFirstWeek 첫 주로 간주할 최소 일수 (1~7). 기본값: 4 (ISO 8601 표준)
+   * @returns 해당 주차의 시작 날짜
+   *
+   * @example
+   * // 2025년 2주차의 시작일 (ISO 8601 표준)
+   * DateOnly.getDateByYearWeekSeq({ year: 2025, weekSeq: 2 }); // 2025-01-06 (월요일)
+   *
+   * // 2025년 1월 3주차의 시작일
+   * DateOnly.getDateByYearWeekSeq({ year: 2025, month: 1, weekSeq: 3 }); // 2025-01-13 (월요일)
+   */
+  static getDateByYearWeekSeq(arg, weekStartDay = 1, minDaysInFirstWeek = 4) {
+    return new DateOnly(arg.year, arg.month ?? 1, (arg.weekSeq - 1) * 7 + 1).getWeekSeqStartDate(
+      weekStartDay,
+      minDaysInFirstWeek
+    );
+  }
+  //#endregion
+  //#region Getters (읽기 전용)
+  /** 날짜 세팅이 제대로 되었는지 여부 */
+  get isValid() {
+    return this.date instanceof Date && !Number.isNaN(this.date.getTime());
+  }
+  get year() {
+    return this.date.getFullYear();
+  }
+  get month() {
+    return this.date.getMonth() + 1;
+  }
+  get day() {
+    return this.date.getDate();
+  }
+  get tick() {
+    return this.date.getTime();
+  }
+  /** 요일 (일~토: 0~6) */
+  get dayOfWeek() {
+    return this.date.getDay();
+  }
+  //#endregion
+  //#region 불변 변환 메서드 (새 인스턴스 반환)
+  /** 지정된 연도로 새 인스턴스 반환 */
+  setYear(year) {
+    return new DateOnly(year, this.month, this.day);
+  }
+  /**
+   * 지정된 월로 새 DateOnly 인스턴스를 반환
+   * @param month 설정할 월 (1-12, 범위 외 값은 연도 조정)
+   * @note 대상 월의 일수보다 현재 일자가 크면 해당 월의 마지막 날로 조정됨
+   *       (예: 1월 31일에서 setMonth(2) → 2월 28일 또는 29일)
+   */
+  setMonth(month) {
+    const normalized = normalizeMonth(this.year, month, this.day);
+    return new DateOnly(normalized.year, normalized.month, normalized.day);
+  }
+  /**
+   * 지정된 일자로 새 DateOnly 인스턴스를 반환
+   * @param day 설정할 일자
+   * @note 해당 월의 유효 범위를 벗어나는 일자는 JavaScript Date 기본 동작에 따라
+   *       자동으로 다음/이전 달로 조정됨 (예: 1월에 day=32 → 2월 1일)
+   */
+  setDay(day) {
+    return new DateOnly(this.year, this.month, day);
+  }
+  //#endregion
+  //#region 산술 메서드 (새 인스턴스 반환)
+  /** 지정된 연수를 더한 새 인스턴스 반환 */
+  addYears(years) {
+    return this.setYear(this.year + years);
+  }
+  /** 지정된 월수를 더한 새 인스턴스 반환 */
+  addMonths(months) {
+    return this.setMonth(this.month + months);
+  }
+  /** 지정된 일수를 더한 새 인스턴스 반환 */
+  addDays(days) {
+    return new DateOnly(this.tick + days * DateOnly.MS_PER_DAY);
+  }
+  //#endregion
+  //#region 포맷팅
+  /**
+   * 지정된 포맷으로 문자열 변환
+   * @param format 포맷 문자열
+   * @see dtFormat 지원 포맷 문자열 참조
+   */
+  toFormatString(formatStr) {
+    return formatDate(formatStr, {
+      year: this.year,
+      month: this.month,
+      day: this.day
+    });
+  }
+  toString() {
+    return this.toFormatString("yyyy-MM-dd");
+  }
+  //#endregion
+}
+export {
+  DateOnly
+};
+//# sourceMappingURL=date-only.js.map

package/dist/types/date-only.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/types/date-only.ts"],
+  "sourcesContent": ["import { ArgumentError } from \"../errors/argument-error\";\nimport { formatDate, normalizeMonth } from \"../utils/date-format\";\n\n/**\n * \uB0A0\uC9DC \uD074\uB798\uC2A4 (\uC2DC\uAC04\uC81C\uC678: yyyy-MM-dd, \uBD88\uBCC0)\n *\n * \uC2DC\uAC04 \uC815\uBCF4 \uC5C6\uC774 \uB0A0\uC9DC\uB9CC \uC800\uC7A5\uD558\uB294 \uBD88\uBCC0 \uD074\uB798\uC2A4\uC774\uB2E4.\n * \uB85C\uCEEC \uD0C0\uC784\uC874\uC744 \uAE30\uC900\uC73C\uB85C \uB3D9\uC791\uD55C\uB2E4.\n *\n * @example\n * const today = new DateOnly();\n * const specific = new DateOnly(2025, 1, 15);\n * const parsed = DateOnly.parse(\"2025-01-15\");\n */\nexport class DateOnly {\n  private static readonly MS_PER_DAY = 24 * 60 * 60 * 1000;\n\n  readonly date: Date;\n\n  /** \uD604\uC7AC\uC2DC\uAC04 */\n  constructor();\n  /** \uC5F0\uC6D4\uC77C\uB85C \uCD08\uAE30\uD654 */\n  constructor(year: number, month: number, day: number);\n  /** tick (millisecond)\uC73C\uB85C \uC0DD\uC131 */\n  constructor(tick: number);\n  /** Date \uD0C0\uC785\uC73C\uB85C \uC0DD\uC131 */\n  constructor(date: Date);\n  constructor(arg1?: number | Date, arg2?: number, arg3?: number) {\n    if (arg1 === undefined) {\n      const tick = Date.now();\n      const date = new Date(tick);\n      this.date = new Date(date.getFullYear(), date.getMonth(), date.getDate());\n    } else if (arg2 !== undefined && arg3 !== undefined) {\n      this.date = new Date(arg1 as number, arg2 - 1, arg3);\n    } else if (arg1 instanceof Date) {\n      const date = arg1;\n      this.date = new Date(date.getFullYear(), date.getMonth(), date.getDate());\n    } else {\n      const date = new Date(arg1);\n      this.date = new Date(date.getFullYear(), date.getMonth(), date.getDate());\n    }\n  }\n\n  /**\n   * \uBB38\uC790\uC5F4\uC744 DateOnly\uB85C \uD30C\uC2F1\n   * @param str \uB0A0\uC9DC \uBB38\uC790\uC5F4\n   * @returns DateOnly \uC778\uC2A4\uD134\uC2A4\n   *\n   * \uC9C0\uC6D0 \uD615\uC2DD:\n   * - `yyyy-MM-dd` (\uC608: '2024-01-15') - \uBB38\uC790\uC5F4\uC5D0\uC11C \uC9C1\uC811 \uCD94\uCD9C, \uD0C0\uC784\uC874 \uC601\uD5A5 \uC5C6\uC74C\n   * - `yyyyMMdd` (\uC608: '20240115') - \uBB38\uC790\uC5F4\uC5D0\uC11C \uC9C1\uC811 \uCD94\uCD9C, \uD0C0\uC784\uC874 \uC601\uD5A5 \uC5C6\uC74C\n   * - ISO 8601 (\uC608: '2024-01-15T00:00:00Z') - UTC\uB85C \uD574\uC11D \uD6C4 \uB85C\uCEEC \uD0C0\uC784\uC874 \uBCC0\uD658\n   *\n   * @note \uC11C\uBC84/\uD074\uB77C\uC774\uC5B8\uD2B8 \uD0C0\uC784\uC874\uC774 \uB2E4\uB978 \uACBD\uC6B0 `yyyy-MM-dd` \uD615\uC2DD \uC0AC\uC6A9 \uAD8C\uC7A5\n   * @note DST(\uC77C\uAD11\uC808\uC57D\uC2DC\uAC04) \uC9C0\uC5ED\uC5D0\uC11C ISO 8601 \uD615\uC2DD \uD30C\uC2F1 \uC2DC, \uD30C\uC2F1 \uB300\uC0C1 \uB0A0\uC9DC\uC758 \uC624\uD504\uC14B\uC744 \uC0AC\uC6A9\uD569\uB2C8\uB2E4.\n   */\n  static parse(str: string): DateOnly {\n    // yyyy-MM-dd \uD615\uC2DD (\uD0C0\uC784\uC874 \uC601\uD5A5 \uC5C6\uC74C)\n    const matchYMD = /^(\\d{4})-(\\d{2})-(\\d{2})$/.exec(str);\n    if (matchYMD != null) {\n      return new DateOnly(Number(matchYMD[1]), Number(matchYMD[2]), Number(matchYMD[3]));\n    }\n\n    // yyyyMMdd \uD615\uC2DD (\uD0C0\uC784\uC874 \uC601\uD5A5 \uC5C6\uC74C)\n    const matchCompact = /^(\\d{4})(\\d{2})(\\d{2})$/.exec(str);\n    if (matchCompact != null) {\n      return new DateOnly(Number(matchCompact[1]), Number(matchCompact[2]), Number(matchCompact[3]));\n    }\n\n    // ISO 8601 \uB4F1 \uAE30\uD0C0 \uD615\uC2DD (Date.parse \uC0AC\uC6A9, \uD0C0\uC784\uC874 \uBCC0\uD658 \uC801\uC6A9)\n    // Date.parse()\uB294 'Z' \uC811\uBBF8\uC0AC\uAC00 \uC788\uB294 ISO 8601\uC744 UTC tick\uC73C\uB85C \uBC18\uD658\n    // getTimezoneOffset()\uC740 \"\uB85C\uCEEC\uC5D0\uC11C UTC\uB85C \uBCC0\uD658\uD560 \uB54C \uB354\uD560 \uBD84\"\uC744 \uBC18\uD658 (KST\uB294 -540\uBD84 = UTC+9)\n    // \uC5EC\uAE30\uC11C\uB294 \"UTC \u2192 \uB85C\uCEEC\" \uBCC0\uD658\uC774\uBBC0\uB85C \uBD80\uD638\uB97C \uBC18\uB300\uB85C \uC801\uC6A9 (\uBE84\uC148)\n    // \uD30C\uC2F1 \uB300\uC0C1 \uB0A0\uC9DC\uC758 \uC624\uD504\uC14B\uC744 \uC0AC\uC6A9\uD558\uC5EC DST \uC9C0\uC5ED\uC5D0\uC11C\uB3C4 \uC815\uD655\uD55C \uBCC0\uD658\n    const utcTick = Date.parse(str);\n    if (!Number.isNaN(utcTick)) {\n      const tempDate = new Date(utcTick);\n      const offsetMinutes = tempDate.getTimezoneOffset();\n      const localTick = utcTick - offsetMinutes * 60 * 1000;\n      return new DateOnly(localTick);\n    }\n\n    throw new ArgumentError(`\uB0A0\uC9DC \uD615\uC2DD\uC744 \uD30C\uC2F1\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uC9C0\uC6D0 \uD615\uC2DD: 'yyyy-MM-dd', 'yyyyMMdd', ISO 8601 \uB0A0\uC9DC`, {\n      input: str,\n    });\n  }\n\n  //#region \uC8FC\uCC28 \uACC4\uC0B0\n\n  /**\n   * \uAE30\uC900 \uC5F0\uB3C4\uC640 \uC6D4\uC744 \uC8FC\uCC28 \uC815\uBCF4\uB97C \uAE30\uBC18\uC73C\uB85C \uBC18\uD658\n   * @param weekStartDay \uC8FC\uC758 \uC2DC\uC791 \uC694\uC77C (0=\uC77C\uC694\uC77C, 1=\uC6D4\uC694\uC77C, ..., 6=\uD1A0\uC694\uC77C). \uAE30\uBCF8\uAC12: 1(\uC6D4\uC694\uC77C)\n   * @param minDaysInFirstWeek \uCCAB \uC8FC\uB85C \uAC04\uC8FC\uD560 \uCD5C\uC18C \uC77C\uC218 (1~7). \uAE30\uBCF8\uAC12: 4 (ISO 8601 \uD45C\uC900)\n   * @returns \uD574\uB2F9 \uB0A0\uC9DC\uAC00 \uC18D\uD55C \uC8FC\uCC28\uC758 \uAE30\uC900 \uC5F0\uB3C4\uC640 \uC6D4\n   *\n   * @example\n   * // ISO 8601 \uD45C\uC900 (\uC6D4\uC694\uC77C \uC2DC\uC791, \uCCAB \uC8FC \uCD5C\uC18C 4\uC77C)\n   * new DateOnly(2024, 1, 1).getBaseYearMonthSeqForWeekSeq(1, 4)\n   * // \uBBF8\uAD6D\uC2DD (\uC77C\uC694\uC77C \uC2DC\uC791, \uCCAB \uC8FC \uCD5C\uC18C 1\uC77C)\n   * new DateOnly(2024, 1, 1).getBaseYearMonthSeqForWeekSeq(0, 1)\n   */\n  getBaseYearMonthSeqForWeekSeq(weekStartDay: number = 1, minDaysInFirstWeek: number = 4) {\n    // \uC8FC\uC758 \uC2DC\uC791 \uC694\uC77C \uAE30\uC900\uC73C\uB85C \uD604\uC7AC \uB0A0\uC9DC\uC758 \uC694\uC77C \uC778\uB371\uC2A4 \uACC4\uC0B0 (0 = \uC8FC \uC2DC\uC791\uC77C)\n    const dayOfWeek = (this.dayOfWeek + 7 - weekStartDay) % 7;\n    // \uD604\uC7AC \uC8FC\uC758 \uB0A8\uC740 \uC77C\uC218 (\uD604\uC7AC \uB0A0\uC9DC \uD3EC\uD568)\n    const daysInWeek = 7 - dayOfWeek;\n\n    // \uD604\uC7AC \uC8FC\uC758 \uB0A8\uC740 \uC77C\uC218\uAC00 \uCCAB \uC8FC \uCD5C\uC18C \uC77C\uC218 \uBBF8\uB9CC\uC774\uBA74 \uC774\uC804 \uC8FC\uB85C \uAC04\uC8FC\n    if (daysInWeek < minDaysInFirstWeek) {\n      const prevWeek = this.addDays(-7);\n      return { year: prevWeek.year, monthSeq: prevWeek.month };\n    } else {\n      // \uC6D4 \uACBD\uACC4\uB97C \uACE0\uB824\uD55C \uC2E4\uC81C \uC8FC\uC758 \uB0A8\uC740 \uC77C\uC218 \uACC4\uC0B0\n      const nextMonthDate = this.addMonths(1).setDay(1);\n      const remainedDays = (nextMonthDate.tick - this.tick) / DateOnly.MS_PER_DAY;\n\n      // \uC6D4 \uACBD\uACC4\uAE4C\uC9C0\uC758 \uC2E4\uC81C \uC77C\uC218\uC640 \uC8FC\uC758 \uB0A8\uC740 \uC77C\uC218 \uC911 \uC791\uC740 \uAC12\n      const realDaysInWeek = Math.min(daysInWeek, remainedDays);\n      // \uC6D4 \uACBD\uACC4 \uACE0\uB824 \uC2DC\uC5D0\uB3C4 \uCCAB \uC8FC \uCD5C\uC18C \uC77C\uC218 \uBBF8\uB9CC\uC774\uBA74 \uB2E4\uC74C \uC8FC\uB85C \uAC04\uC8FC\n      if (realDaysInWeek < minDaysInFirstWeek) {\n        const nextWeek = this.addDays(7);\n        return { year: nextWeek.year, monthSeq: nextWeek.month };\n      } else {\n        return { year: this.year, monthSeq: this.month };\n      }\n    }\n  }\n\n  /**\n   * \uC8FC\uCC28 \uC815\uBCF4\uB97C \uAE30\uBC18\uC73C\uB85C \uD574\uB2F9 \uC8FC\uC758 \uC2DC\uC791 \uB0A0\uC9DC \uACC4\uC0B0\n   * @param weekStartDay \uC8FC\uC758 \uC2DC\uC791 \uC694\uC77C (0=\uC77C\uC694\uC77C, 1=\uC6D4\uC694\uC77C, ..., 6=\uD1A0\uC694\uC77C). \uAE30\uBCF8\uAC12: 1(\uC6D4\uC694\uC77C)\n   * @param minDaysInFirstWeek \uCCAB \uC8FC\uB85C \uAC04\uC8FC\uD560 \uCD5C\uC18C \uC77C\uC218 (1~7). \uAE30\uBCF8\uAC12: 4 (ISO 8601 \uD45C\uC900)\n   * @returns \uD574\uB2F9 \uB0A0\uC9DC\uAC00 \uC18D\uD55C \uC8FC\uC758 \uC2DC\uC791 \uB0A0\uC9DC\n   */\n  getWeekSeqStartDate(weekStartDay: number = 1, minDaysInFirstWeek: number = 4) {\n    const dayOfWeek = (this.dayOfWeek + 7 - weekStartDay) % 7;\n    const daysInFirstWeek = 7 - dayOfWeek;\n\n    if (daysInFirstWeek < minDaysInFirstWeek) {\n      return this.addDays(-dayOfWeek + 7);\n    } else {\n      return this.addDays(-dayOfWeek);\n    }\n  }\n\n  /**\n   * \uC5F0\uB3C4 \uBC0F \uC8FC\uCC28 \uC21C\uC11C \uC815\uBCF4\uB97C \uBC18\uD658\n   * @param weekStartDay \uC8FC\uC758 \uC2DC\uC791 \uC694\uC77C (0=\uC77C\uC694\uC77C, 1=\uC6D4\uC694\uC77C, ..., 6=\uD1A0\uC694\uC77C). \uAE30\uBCF8\uAC12: 1(\uC6D4\uC694\uC77C)\n   * @param minDaysInFirstWeek \uCCAB \uC8FC\uB85C \uAC04\uC8FC\uD560 \uCD5C\uC18C \uC77C\uC218 (1~7). \uAE30\uBCF8\uAC12: 4 (ISO 8601 \uD45C\uC900)\n   * @returns \uC5F0\uB3C4\uC640 \uD574\uB2F9 \uC5F0\uB3C4 \uAE30\uC900 \uC8FC\uCC28 \uBC88\uD638\n   *\n   * @example\n   * // ISO 8601 \uD45C\uC900 (\uC6D4\uC694\uC77C \uC2DC\uC791, \uCCAB \uC8FC 4\uC77C \uC774\uC0C1)\n   * new DateOnly(2025, 1, 6).getWeekSeqOfYear(); // { year: 2025, weekSeq: 2 }\n   *\n   * // \uBBF8\uAD6D\uC2DD (\uC77C\uC694\uC77C \uC2DC\uC791, \uCCAB \uC8FC 1\uC77C \uC774\uC0C1)\n   * new DateOnly(2025, 1, 1).getWeekSeqOfYear(0, 1); // { year: 2025, weekSeq: 1 }\n   */\n  getWeekSeqOfYear(weekStartDay: number = 1, minDaysInFirstWeek: number = 4): { year: number; weekSeq: number } {\n    const base = this.getBaseYearMonthSeqForWeekSeq(weekStartDay, minDaysInFirstWeek);\n\n    const firstWeekStart = new DateOnly(base.year, 1, 1).getWeekSeqStartDate(weekStartDay, minDaysInFirstWeek);\n\n    const diffDays = (this.tick - firstWeekStart.tick) / DateOnly.MS_PER_DAY;\n    return {\n      year: base.year,\n      weekSeq: Math.floor(diffDays / 7) + 1,\n    };\n  }\n\n  /**\n   * \uD574\uB2F9 \uB0A0\uC9DC\uC758 \uC5F0\uB3C4, \uC6D4 \uBC0F \uC8FC\uCC28(weekSeq) \uC815\uBCF4\uB97C \uBC18\uD658\n   * @param weekStartDay \uC8FC\uC758 \uC2DC\uC791 \uC694\uC77C (0=\uC77C\uC694\uC77C, 1=\uC6D4\uC694\uC77C, ..., 6=\uD1A0\uC694\uC77C). \uAE30\uBCF8\uAC12: 1(\uC6D4\uC694\uC77C)\n   * @param minDaysInFirstWeek \uCCAB \uC8FC\uB85C \uAC04\uC8FC\uD560 \uCD5C\uC18C \uC77C\uC218 (1~7). \uAE30\uBCF8\uAC12: 4 (ISO 8601 \uD45C\uC900)\n   * @returns \uC5F0\uB3C4, \uC6D4 \uBC0F \uD574\uB2F9 \uC6D4 \uAE30\uC900 \uC8FC\uCC28 \uBC88\uD638\n   *\n   * @example\n   * // ISO 8601 \uD45C\uC900 (\uC6D4\uC694\uC77C \uC2DC\uC791, \uCCAB \uC8FC 4\uC77C \uC774\uC0C1)\n   * new DateOnly(2025, 1, 15).getWeekSeqOfMonth(); // { year: 2025, monthSeq: 1, weekSeq: 3 }\n   *\n   * // \uBBF8\uAD6D\uC2DD (\uC77C\uC694\uC77C \uC2DC\uC791, \uCCAB \uC8FC 1\uC77C \uC774\uC0C1)\n   * new DateOnly(2025, 1, 15).getWeekSeqOfMonth(0, 1); // { year: 2025, monthSeq: 1, weekSeq: 3 }\n   */\n  getWeekSeqOfMonth(\n    weekStartDay: number = 1,\n    minDaysInFirstWeek: number = 4,\n  ): { year: number; monthSeq: number; weekSeq: number } {\n    const base = this.getBaseYearMonthSeqForWeekSeq(weekStartDay, minDaysInFirstWeek);\n\n    const firstWeekStart = new DateOnly(base.year, base.monthSeq, 1).getWeekSeqStartDate(\n      weekStartDay,\n      minDaysInFirstWeek,\n    );\n\n    const diffDays = (this.tick - firstWeekStart.tick) / DateOnly.MS_PER_DAY;\n    return {\n      year: base.year,\n      monthSeq: base.monthSeq,\n      weekSeq: Math.floor(diffDays / 7) + 1,\n    };\n  }\n\n  /**\n   * \uC8FC\uCC28 \uC815\uBCF4\uB97C \uAE30\uBC18\uC73C\uB85C \uD574\uB2F9 \uC8FC\uC758 \uC2DC\uC791 \uB0A0\uC9DC \uAC00\uC838\uC624\uAE30\n   * @param arg \uC5F0\uB3C4, \uC120\uD0DD\uC801 \uC6D4, \uC8FC\uCC28 \uBC88\uD638\n   * @param weekStartDay \uC8FC\uC758 \uC2DC\uC791 \uC694\uC77C (0=\uC77C\uC694\uC77C, 1=\uC6D4\uC694\uC77C, ..., 6=\uD1A0\uC694\uC77C). \uAE30\uBCF8\uAC12: 1(\uC6D4\uC694\uC77C)\n   * @param minDaysInFirstWeek \uCCAB \uC8FC\uB85C \uAC04\uC8FC\uD560 \uCD5C\uC18C \uC77C\uC218 (1~7). \uAE30\uBCF8\uAC12: 4 (ISO 8601 \uD45C\uC900)\n   * @returns \uD574\uB2F9 \uC8FC\uCC28\uC758 \uC2DC\uC791 \uB0A0\uC9DC\n   *\n   * @example\n   * // 2025\uB144 2\uC8FC\uCC28\uC758 \uC2DC\uC791\uC77C (ISO 8601 \uD45C\uC900)\n   * DateOnly.getDateByYearWeekSeq({ year: 2025, weekSeq: 2 }); // 2025-01-06 (\uC6D4\uC694\uC77C)\n   *\n   * // 2025\uB144 1\uC6D4 3\uC8FC\uCC28\uC758 \uC2DC\uC791\uC77C\n   * DateOnly.getDateByYearWeekSeq({ year: 2025, month: 1, weekSeq: 3 }); // 2025-01-13 (\uC6D4\uC694\uC77C)\n   */\n  static getDateByYearWeekSeq(\n    arg: { year: number; month?: number; weekSeq: number },\n    weekStartDay: number = 1,\n    minDaysInFirstWeek: number = 4,\n  ) {\n    return new DateOnly(arg.year, arg.month ?? 1, (arg.weekSeq - 1) * 7 + 1).getWeekSeqStartDate(\n      weekStartDay,\n      minDaysInFirstWeek,\n    );\n  }\n\n  //#endregion\n\n  //#region Getters (\uC77D\uAE30 \uC804\uC6A9)\n\n  /** \uB0A0\uC9DC \uC138\uD305\uC774 \uC81C\uB300\uB85C \uB418\uC5C8\uB294\uC9C0 \uC5EC\uBD80 */\n  get isValid(): boolean {\n    return this.date instanceof Date && !Number.isNaN(this.date.getTime());\n  }\n\n  get year(): number {\n    return this.date.getFullYear();\n  }\n\n  get month(): number {\n    return this.date.getMonth() + 1;\n  }\n\n  get day(): number {\n    return this.date.getDate();\n  }\n\n  get tick(): number {\n    return this.date.getTime();\n  }\n\n  /** \uC694\uC77C (\uC77C~\uD1A0: 0~6) */\n  get dayOfWeek(): number {\n    return this.date.getDay();\n  }\n\n  //#endregion\n\n  //#region \uBD88\uBCC0 \uBCC0\uD658 \uBA54\uC11C\uB4DC (\uC0C8 \uC778\uC2A4\uD134\uC2A4 \uBC18\uD658)\n\n  /** \uC9C0\uC815\uB41C \uC5F0\uB3C4\uB85C \uC0C8 \uC778\uC2A4\uD134\uC2A4 \uBC18\uD658 */\n  setYear(year: number): DateOnly {\n    return new DateOnly(year, this.month, this.day);\n  }\n\n  /**\n   * \uC9C0\uC815\uB41C \uC6D4\uB85C \uC0C8 DateOnly \uC778\uC2A4\uD134\uC2A4\uB97C \uBC18\uD658\n   * @param month \uC124\uC815\uD560 \uC6D4 (1-12, \uBC94\uC704 \uC678 \uAC12\uC740 \uC5F0\uB3C4 \uC870\uC815)\n   * @note \uB300\uC0C1 \uC6D4\uC758 \uC77C\uC218\uBCF4\uB2E4 \uD604\uC7AC \uC77C\uC790\uAC00 \uD06C\uBA74 \uD574\uB2F9 \uC6D4\uC758 \uB9C8\uC9C0\uB9C9 \uB0A0\uB85C \uC870\uC815\uB428\n   *       (\uC608: 1\uC6D4 31\uC77C\uC5D0\uC11C setMonth(2) \u2192 2\uC6D4 28\uC77C \uB610\uB294 29\uC77C)\n   */\n  setMonth(month: number): DateOnly {\n    const normalized = normalizeMonth(this.year, month, this.day);\n    return new DateOnly(normalized.year, normalized.month, normalized.day);\n  }\n\n  /**\n   * \uC9C0\uC815\uB41C \uC77C\uC790\uB85C \uC0C8 DateOnly \uC778\uC2A4\uD134\uC2A4\uB97C \uBC18\uD658\n   * @param day \uC124\uC815\uD560 \uC77C\uC790\n   * @note \uD574\uB2F9 \uC6D4\uC758 \uC720\uD6A8 \uBC94\uC704\uB97C \uBC97\uC5B4\uB098\uB294 \uC77C\uC790\uB294 JavaScript Date \uAE30\uBCF8 \uB3D9\uC791\uC5D0 \uB530\uB77C\n   *       \uC790\uB3D9\uC73C\uB85C \uB2E4\uC74C/\uC774\uC804 \uB2EC\uB85C \uC870\uC815\uB428 (\uC608: 1\uC6D4\uC5D0 day=32 \u2192 2\uC6D4 1\uC77C)\n   */\n  setDay(day: number): DateOnly {\n    return new DateOnly(this.year, this.month, day);\n  }\n\n  //#endregion\n\n  //#region \uC0B0\uC220 \uBA54\uC11C\uB4DC (\uC0C8 \uC778\uC2A4\uD134\uC2A4 \uBC18\uD658)\n\n  /** \uC9C0\uC815\uB41C \uC5F0\uC218\uB97C \uB354\uD55C \uC0C8 \uC778\uC2A4\uD134\uC2A4 \uBC18\uD658 */\n  addYears(years: number): DateOnly {\n    return this.setYear(this.year + years);\n  }\n\n  /** \uC9C0\uC815\uB41C \uC6D4\uC218\uB97C \uB354\uD55C \uC0C8 \uC778\uC2A4\uD134\uC2A4 \uBC18\uD658 */\n  addMonths(months: number): DateOnly {\n    return this.setMonth(this.month + months);\n  }\n\n  /** \uC9C0\uC815\uB41C \uC77C\uC218\uB97C \uB354\uD55C \uC0C8 \uC778\uC2A4\uD134\uC2A4 \uBC18\uD658 */\n  addDays(days: number): DateOnly {\n    return new DateOnly(this.tick + days * DateOnly.MS_PER_DAY);\n  }\n\n  //#endregion\n\n  //#region \uD3EC\uB9F7\uD305\n\n  /**\n   * \uC9C0\uC815\uB41C \uD3EC\uB9F7\uC73C\uB85C \uBB38\uC790\uC5F4 \uBCC0\uD658\n   * @param format \uD3EC\uB9F7 \uBB38\uC790\uC5F4\n   * @see dtFormat \uC9C0\uC6D0 \uD3EC\uB9F7 \uBB38\uC790\uC5F4 \uCC38\uC870\n   */\n  toFormatString(formatStr: string): string {\n    return formatDate(formatStr, {\n      year: this.year,\n      month: this.month,\n      day: this.day,\n    });\n  }\n\n  toString(): string {\n    return this.toFormatString(\"yyyy-MM-dd\");\n  }\n\n  //#endregion\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/types/date-time.d.ts

@@ -0,0 +1,96 @@
+/**
+ * 날짜시간 클래스 (불변)
+ *
+ * JavaScript Date 객체를 래핑하여 불변성과 편리한 API를 제공한다.
+ * 밀리초 단위까지 지원하며, 로컬 타임존을 기준으로 동작한다.
+ *
+ * @example
+ * const now = new DateTime();
+ * const specific = new DateTime(2025, 1, 15, 10, 30, 0);
+ * const parsed = DateTime.parse("2025-01-15 10:30:00");
+ */
+export declare class DateTime {
+    readonly date: Date;
+    /** 현재 시간으로 생성 */
+    constructor();
+    /** 연월일시분초밀리초로 생성 */
+    constructor(year: number, month: number, day: number, hour?: number, minute?: number, second?: number, millisecond?: number);
+    /** tick (밀리초)으로 생성 */
+    constructor(tick: number);
+    /** Date 객체로 생성 */
+    constructor(date: Date);
+    /**
+     * 문자열을 파싱하여 DateTime 인스턴스를 생성
+     *
+     * @param str 날짜시간 문자열
+     * @returns 파싱된 DateTime 인스턴스
+     * @throws ArgumentError 지원하지 않는 형식인 경우
+     *
+     * @example
+     * DateTime.parse("2025-01-15 10:30:00")     // yyyy-MM-dd HH:mm:ss
+     * DateTime.parse("2025-01-15 10:30:00.123") // yyyy-MM-dd HH:mm:ss.fff
+     * DateTime.parse("20250115103000")          // yyyyMMddHHmmss
+     * DateTime.parse("2025-01-15 오전 10:30:00") // yyyy-MM-dd 오전/오후 HH:mm:ss
+     * DateTime.parse("2025-01-15T10:30:00Z")    // ISO 8601
+     */
+    static parse(str: string): DateTime;
+    get year(): number;
+    get month(): number;
+    get day(): number;
+    get hour(): number;
+    get minute(): number;
+    get second(): number;
+    get millisecond(): number;
+    get tick(): number;
+    /** 요일 (일~토: 0~6) */
+    get dayOfWeek(): number;
+    get timezoneOffsetMinutes(): number;
+    /** 날짜시간 세팅이 제대로 되었는지 여부 */
+    get isValid(): boolean;
+    /** 지정된 연도로 새 인스턴스 반환 */
+    setYear(year: number): DateTime;
+    /**
+     * 지정된 월로 새 DateTime 인스턴스를 반환
+     * @param month 설정할 월 (1-12, 범위 외 값은 연도 조정)
+     * @note 대상 월의 일수보다 현재 일자가 크면 해당 월의 마지막 날로 조정됨
+     *       (예: 1월 31일에서 setMonth(2) → 2월 28일 또는 29일)
+     */
+    setMonth(month: number): DateTime;
+    /**
+     * 지정된 일자로 새 DateTime 인스턴스를 반환
+     * @param day 설정할 일자
+     * @note 해당 월의 유효 범위를 벗어나는 일자는 JavaScript Date 기본 동작에 따라
+     *       자동으로 다음/이전 달로 조정됨 (예: 1월에 day=32 → 2월 1일)
+     */
+    setDay(day: number): DateTime;
+    /** 지정된 시로 새 인스턴스 반환 */
+    setHour(hour: number): DateTime;
+    /** 지정된 분으로 새 인스턴스 반환 */
+    setMinute(minute: number): DateTime;
+    /** 지정된 초로 새 인스턴스 반환 */
+    setSecond(second: number): DateTime;
+    /** 지정된 밀리초로 새 인스턴스 반환 */
+    setMillisecond(millisecond: number): DateTime;
+    /** 지정된 연수를 더한 새 인스턴스 반환 */
+    addYears(years: number): DateTime;
+    /** 지정된 월수를 더한 새 인스턴스 반환 */
+    addMonths(months: number): DateTime;
+    /** 지정된 일수를 더한 새 인스턴스 반환 */
+    addDays(days: number): DateTime;
+    /** 지정된 시간을 더한 새 인스턴스 반환 */
+    addHours(hours: number): DateTime;
+    /** 지정된 분을 더한 새 인스턴스 반환 */
+    addMinutes(minutes: number): DateTime;
+    /** 지정된 초를 더한 새 인스턴스 반환 */
+    addSeconds(seconds: number): DateTime;
+    /** 지정된 밀리초를 더한 새 인스턴스 반환 */
+    addMilliseconds(milliseconds: number): DateTime;
+    /**
+     * 지정된 포맷으로 문자열 변환
+     * @param format 포맷 문자열
+     * @see dtFormat 지원 포맷 문자열 참조
+     */
+    toFormatString(formatStr: string): string;
+    toString(): string;
+}
+//# sourceMappingURL=date-time.d.ts.map

package/dist/types/date-time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-time.d.ts","sourceRoot":"","sources":["../../src/types/date-time.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,qBAAa,QAAQ;IACnB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAEpB,iBAAiB;;IAEjB,oBAAoB;gBAElB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM;IAEtB,sBAAsB;gBACV,IAAI,EAAE,MAAM;IACxB,kBAAkB;gBACN,IAAI,EAAE,IAAI;IAqBtB;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ;IAwDnC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,oBAAoB;IACpB,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,qBAAqB,IAAI,MAAM,CAElC;IAED,2BAA2B;IAC3B,IAAI,OAAO,IAAI,OAAO,CAErB;IAMD,wBAAwB;IACxB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAI/B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ;IAajC;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ;IAI7B,uBAAuB;IACvB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAI/B,wBAAwB;IACxB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ;IAInC,uBAAuB;IACvB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ;IAInC,yBAAyB;IACzB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ;IAQ7C,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ;IAIjC,2BAA2B;IAC3B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ;IAInC,2BAA2B;IAC3B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAI/B,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ;IAIjC,0BAA0B;IAC1B,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ;IAIrC,0BAA0B;IAC1B,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ;IAIrC,4BAA4B;IAC5B,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,QAAQ;IAQ/C;;;;OAIG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAazC,QAAQ,IAAI,MAAM;CAKnB"}

package/dist/types/date-time.js

@@ -0,0 +1,220 @@
+import { ArgumentError } from "../errors/argument-error";
+import { convert12To24, formatDate, normalizeMonth } from "../utils/date-format";
+class DateTime {
+  date;
+  constructor(arg1, arg2, arg3, arg4, arg5, arg6, arg7) {
+    if (arg1 === void 0) {
+      this.date = /* @__PURE__ */ new Date();
+    } else if (arg2 !== void 0 && arg3 !== void 0) {
+      this.date = new Date(arg1, arg2 - 1, arg3, arg4 ?? 0, arg5 ?? 0, arg6 ?? 0, arg7 ?? 0);
+    } else if (arg1 instanceof Date) {
+      this.date = new Date(arg1.getTime());
+    } else {
+      this.date = new Date(arg1);
+    }
+  }
+  /**
+   * 문자열을 파싱하여 DateTime 인스턴스를 생성
+   *
+   * @param str 날짜시간 문자열
+   * @returns 파싱된 DateTime 인스턴스
+   * @throws ArgumentError 지원하지 않는 형식인 경우
+   *
+   * @example
+   * DateTime.parse("2025-01-15 10:30:00")     // yyyy-MM-dd HH:mm:ss
+   * DateTime.parse("2025-01-15 10:30:00.123") // yyyy-MM-dd HH:mm:ss.fff
+   * DateTime.parse("20250115103000")          // yyyyMMddHHmmss
+   * DateTime.parse("2025-01-15 오전 10:30:00") // yyyy-MM-dd 오전/오후 HH:mm:ss
+   * DateTime.parse("2025-01-15T10:30:00Z")    // ISO 8601
+   */
+  static parse(str) {
+    const parsedTick = Date.parse(str);
+    if (!Number.isNaN(parsedTick)) {
+      return new DateTime(parsedTick);
+    }
+    const match1 = /^([0-9]{4})-([0-9]{2})-([0-9]{2}) (오전|오후) ([0-9]{1,2}):([0-9]{2}):([0-9]{2})(\.([0-9]{1,3}))?$/.exec(str);
+    if (match1 != null) {
+      const rawHour = Number(match1[5]);
+      const isPM = match1[4] === "\uC624\uD6C4";
+      const hour = convert12To24(rawHour, isPM);
+      return new DateTime(
+        Number(match1[1]),
+        Number(match1[2]),
+        Number(match1[3]),
+        hour,
+        Number(match1[6]),
+        Number(match1[7]),
+        match1[9] ? Number(match1[9].padEnd(3, "0")) : void 0
+      );
+    }
+    const match2 = /^[0-9]{14}$/.exec(str);
+    if (match2 != null) {
+      return new DateTime(
+        Number(str.substring(0, 4)),
+        Number(str.substring(4, 6)),
+        Number(str.substring(6, 8)),
+        Number(str.substring(8, 10)),
+        Number(str.substring(10, 12)),
+        Number(str.substring(12, 14))
+      );
+    }
+    const match3 = /^([0-9]{4})-([0-9]{2})-([0-9]{2}) ([0-9]{2}):([0-9]{2}):([0-9]{2})(\.([0-9]{1,3}))?$/.exec(str);
+    if (match3 != null) {
+      return new DateTime(
+        Number(match3[1]),
+        Number(match3[2]),
+        Number(match3[3]),
+        Number(match3[4]),
+        Number(match3[5]),
+        Number(match3[6]),
+        match3[8] ? Number(match3[8].padEnd(3, "0")) : void 0
+      );
+    }
+    throw new ArgumentError(
+      `\uB0A0\uC9DC\uC2DC\uAC04 \uD615\uC2DD\uC744 \uD30C\uC2F1\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uC9C0\uC6D0 \uD615\uC2DD: 'yyyy-MM-dd HH:mm:ss', 'yyyyMMddHHmmss', 'yyyy-MM-dd \uC624\uC804/\uC624\uD6C4 HH:mm:ss', ISO 8601`,
+      { input: str }
+    );
+  }
+  //#region Getters (읽기 전용)
+  get year() {
+    return this.date.getFullYear();
+  }
+  get month() {
+    return this.date.getMonth() + 1;
+  }
+  get day() {
+    return this.date.getDate();
+  }
+  get hour() {
+    return this.date.getHours();
+  }
+  get minute() {
+    return this.date.getMinutes();
+  }
+  get second() {
+    return this.date.getSeconds();
+  }
+  get millisecond() {
+    return this.date.getMilliseconds();
+  }
+  get tick() {
+    return this.date.getTime();
+  }
+  /** 요일 (일~토: 0~6) */
+  get dayOfWeek() {
+    return this.date.getDay();
+  }
+  get timezoneOffsetMinutes() {
+    return -this.date.getTimezoneOffset();
+  }
+  /** 날짜시간 세팅이 제대로 되었는지 여부 */
+  get isValid() {
+    return this.date instanceof Date && !Number.isNaN(this.date.getTime());
+  }
+  //#endregion
+  //#region 불변 변환 메서드 (새 인스턴스 반환)
+  /** 지정된 연도로 새 인스턴스 반환 */
+  setYear(year) {
+    return new DateTime(year, this.month, this.day, this.hour, this.minute, this.second, this.millisecond);
+  }
+  /**
+   * 지정된 월로 새 DateTime 인스턴스를 반환
+   * @param month 설정할 월 (1-12, 범위 외 값은 연도 조정)
+   * @note 대상 월의 일수보다 현재 일자가 크면 해당 월의 마지막 날로 조정됨
+   *       (예: 1월 31일에서 setMonth(2) → 2월 28일 또는 29일)
+   */
+  setMonth(month) {
+    const normalized = normalizeMonth(this.year, month, this.day);
+    return new DateTime(
+      normalized.year,
+      normalized.month,
+      normalized.day,
+      this.hour,
+      this.minute,
+      this.second,
+      this.millisecond
+    );
+  }
+  /**
+   * 지정된 일자로 새 DateTime 인스턴스를 반환
+   * @param day 설정할 일자
+   * @note 해당 월의 유효 범위를 벗어나는 일자는 JavaScript Date 기본 동작에 따라
+   *       자동으로 다음/이전 달로 조정됨 (예: 1월에 day=32 → 2월 1일)
+   */
+  setDay(day) {
+    return new DateTime(this.year, this.month, day, this.hour, this.minute, this.second, this.millisecond);
+  }
+  /** 지정된 시로 새 인스턴스 반환 */
+  setHour(hour) {
+    return new DateTime(this.year, this.month, this.day, hour, this.minute, this.second, this.millisecond);
+  }
+  /** 지정된 분으로 새 인스턴스 반환 */
+  setMinute(minute) {
+    return new DateTime(this.year, this.month, this.day, this.hour, minute, this.second, this.millisecond);
+  }
+  /** 지정된 초로 새 인스턴스 반환 */
+  setSecond(second) {
+    return new DateTime(this.year, this.month, this.day, this.hour, this.minute, second, this.millisecond);
+  }
+  /** 지정된 밀리초로 새 인스턴스 반환 */
+  setMillisecond(millisecond) {
+    return new DateTime(this.year, this.month, this.day, this.hour, this.minute, this.second, millisecond);
+  }
+  //#endregion
+  //#region 산술 메서드 (새 인스턴스 반환)
+  /** 지정된 연수를 더한 새 인스턴스 반환 */
+  addYears(years) {
+    return this.setYear(this.year + years);
+  }
+  /** 지정된 월수를 더한 새 인스턴스 반환 */
+  addMonths(months) {
+    return this.setMonth(this.month + months);
+  }
+  /** 지정된 일수를 더한 새 인스턴스 반환 */
+  addDays(days) {
+    return new DateTime(this.tick + days * 24 * 60 * 60 * 1e3);
+  }
+  /** 지정된 시간을 더한 새 인스턴스 반환 */
+  addHours(hours) {
+    return new DateTime(this.tick + hours * 60 * 60 * 1e3);
+  }
+  /** 지정된 분을 더한 새 인스턴스 반환 */
+  addMinutes(minutes) {
+    return new DateTime(this.tick + minutes * 60 * 1e3);
+  }
+  /** 지정된 초를 더한 새 인스턴스 반환 */
+  addSeconds(seconds) {
+    return new DateTime(this.tick + seconds * 1e3);
+  }
+  /** 지정된 밀리초를 더한 새 인스턴스 반환 */
+  addMilliseconds(milliseconds) {
+    return new DateTime(this.tick + milliseconds);
+  }
+  //#endregion
+  //#region 포맷팅
+  /**
+   * 지정된 포맷으로 문자열 변환
+   * @param format 포맷 문자열
+   * @see dtFormat 지원 포맷 문자열 참조
+   */
+  toFormatString(formatStr) {
+    return formatDate(formatStr, {
+      year: this.year,
+      month: this.month,
+      day: this.day,
+      hour: this.hour,
+      minute: this.minute,
+      second: this.second,
+      millisecond: this.millisecond,
+      timezoneOffsetMinutes: this.timezoneOffsetMinutes
+    });
+  }
+  toString() {
+    return this.toFormatString("yyyy-MM-ddTHH:mm:ss.fffzzz");
+  }
+  //#endregion
+}
+export {
+  DateTime
+};
+//# sourceMappingURL=date-time.js.map

package/dist/types/date-time.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/types/date-time.ts"],
+  "sourcesContent": ["import { ArgumentError } from \"../errors/argument-error\";\nimport { convert12To24, formatDate, normalizeMonth } from \"../utils/date-format\";\n\n/**\n * \uB0A0\uC9DC\uC2DC\uAC04 \uD074\uB798\uC2A4 (\uBD88\uBCC0)\n *\n * JavaScript Date \uAC1D\uCCB4\uB97C \uB798\uD551\uD558\uC5EC \uBD88\uBCC0\uC131\uACFC \uD3B8\uB9AC\uD55C API\uB97C \uC81C\uACF5\uD55C\uB2E4.\n * \uBC00\uB9AC\uCD08 \uB2E8\uC704\uAE4C\uC9C0 \uC9C0\uC6D0\uD558\uBA70, \uB85C\uCEEC \uD0C0\uC784\uC874\uC744 \uAE30\uC900\uC73C\uB85C \uB3D9\uC791\uD55C\uB2E4.\n *\n * @example\n * const now = new DateTime();\n * const specific = new DateTime(2025, 1, 15, 10, 30, 0);\n * const parsed = DateTime.parse(\"2025-01-15 10:30:00\");\n */\nexport class DateTime {\n  readonly date: Date;\n\n  /** \uD604\uC7AC \uC2DC\uAC04\uC73C\uB85C \uC0DD\uC131 */\n  constructor();\n  /** \uC5F0\uC6D4\uC77C\uC2DC\uBD84\uCD08\uBC00\uB9AC\uCD08\uB85C \uC0DD\uC131 */\n  constructor(\n    year: number,\n    month: number,\n    day: number,\n    hour?: number,\n    minute?: number,\n    second?: number,\n    millisecond?: number,\n  );\n  /** tick (\uBC00\uB9AC\uCD08)\uC73C\uB85C \uC0DD\uC131 */\n  constructor(tick: number);\n  /** Date \uAC1D\uCCB4\uB85C \uC0DD\uC131 */\n  constructor(date: Date);\n  constructor(\n    arg1?: number | Date,\n    arg2?: number,\n    arg3?: number,\n    arg4?: number,\n    arg5?: number,\n    arg6?: number,\n    arg7?: number,\n  ) {\n    if (arg1 === undefined) {\n      this.date = new Date();\n    } else if (arg2 !== undefined && arg3 !== undefined) {\n      this.date = new Date(arg1 as number, arg2 - 1, arg3, arg4 ?? 0, arg5 ?? 0, arg6 ?? 0, arg7 ?? 0);\n    } else if (arg1 instanceof Date) {\n      this.date = new Date(arg1.getTime());\n    } else {\n      this.date = new Date(arg1);\n    }\n  }\n\n  /**\n   * \uBB38\uC790\uC5F4\uC744 \uD30C\uC2F1\uD558\uC5EC DateTime \uC778\uC2A4\uD134\uC2A4\uB97C \uC0DD\uC131\n   *\n   * @param str \uB0A0\uC9DC\uC2DC\uAC04 \uBB38\uC790\uC5F4\n   * @returns \uD30C\uC2F1\uB41C DateTime \uC778\uC2A4\uD134\uC2A4\n   * @throws ArgumentError \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uD615\uC2DD\uC778 \uACBD\uC6B0\n   *\n   * @example\n   * DateTime.parse(\"2025-01-15 10:30:00\")     // yyyy-MM-dd HH:mm:ss\n   * DateTime.parse(\"2025-01-15 10:30:00.123\") // yyyy-MM-dd HH:mm:ss.fff\n   * DateTime.parse(\"20250115103000\")          // yyyyMMddHHmmss\n   * DateTime.parse(\"2025-01-15 \uC624\uC804 10:30:00\") // yyyy-MM-dd \uC624\uC804/\uC624\uD6C4 HH:mm:ss\n   * DateTime.parse(\"2025-01-15T10:30:00Z\")    // ISO 8601\n   */\n  static parse(str: string): DateTime {\n    const parsedTick = Date.parse(str);\n    if (!Number.isNaN(parsedTick)) {\n      return new DateTime(parsedTick);\n    }\n\n    const match1 =\n      /^([0-9]{4})-([0-9]{2})-([0-9]{2}) (\uC624\uC804|\uC624\uD6C4) ([0-9]{1,2}):([0-9]{2}):([0-9]{2})(\\.([0-9]{1,3}))?$/.exec(str);\n    if (match1 != null) {\n      const rawHour = Number(match1[5]);\n      const isPM = match1[4] === \"\uC624\uD6C4\";\n      const hour = convert12To24(rawHour, isPM);\n      return new DateTime(\n        Number(match1[1]),\n        Number(match1[2]),\n        Number(match1[3]),\n        hour,\n        Number(match1[6]),\n        Number(match1[7]),\n        match1[9] ? Number(match1[9].padEnd(3, \"0\")) : undefined,\n      );\n    }\n\n    const match2 = /^[0-9]{14}$/.exec(str);\n    if (match2 != null) {\n      return new DateTime(\n        Number(str.substring(0, 4)),\n        Number(str.substring(4, 6)),\n        Number(str.substring(6, 8)),\n        Number(str.substring(8, 10)),\n        Number(str.substring(10, 12)),\n        Number(str.substring(12, 14)),\n      );\n    }\n\n    const match3 = /^([0-9]{4})-([0-9]{2})-([0-9]{2}) ([0-9]{2}):([0-9]{2}):([0-9]{2})(\\.([0-9]{1,3}))?$/.exec(str);\n    if (match3 != null) {\n      return new DateTime(\n        Number(match3[1]),\n        Number(match3[2]),\n        Number(match3[3]),\n        Number(match3[4]),\n        Number(match3[5]),\n        Number(match3[6]),\n        match3[8] ? Number(match3[8].padEnd(3, \"0\")) : undefined,\n      );\n    }\n\n    throw new ArgumentError(\n      `\uB0A0\uC9DC\uC2DC\uAC04 \uD615\uC2DD\uC744 \uD30C\uC2F1\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uC9C0\uC6D0 \uD615\uC2DD: 'yyyy-MM-dd HH:mm:ss', 'yyyyMMddHHmmss', 'yyyy-MM-dd \uC624\uC804/\uC624\uD6C4 HH:mm:ss', ISO 8601`,\n      { input: str },\n    );\n  }\n\n  //#region Getters (\uC77D\uAE30 \uC804\uC6A9)\n\n  get year(): number {\n    return this.date.getFullYear();\n  }\n\n  get month(): number {\n    return this.date.getMonth() + 1;\n  }\n\n  get day(): number {\n    return this.date.getDate();\n  }\n\n  get hour(): number {\n    return this.date.getHours();\n  }\n\n  get minute(): number {\n    return this.date.getMinutes();\n  }\n\n  get second(): number {\n    return this.date.getSeconds();\n  }\n\n  get millisecond(): number {\n    return this.date.getMilliseconds();\n  }\n\n  get tick(): number {\n    return this.date.getTime();\n  }\n\n  /** \uC694\uC77C (\uC77C~\uD1A0: 0~6) */\n  get dayOfWeek(): number {\n    return this.date.getDay();\n  }\n\n  get timezoneOffsetMinutes(): number {\n    return -this.date.getTimezoneOffset();\n  }\n\n  /** \uB0A0\uC9DC\uC2DC\uAC04 \uC138\uD305\uC774 \uC81C\uB300\uB85C \uB418\uC5C8\uB294\uC9C0 \uC5EC\uBD80 */\n  get isValid(): boolean {\n    return this.date instanceof Date && !Number.isNaN(this.date.getTime());\n  }\n\n  //#endregion\n\n  //#region \uBD88\uBCC0 \uBCC0\uD658 \uBA54\uC11C\uB4DC (\uC0C8 \uC778\uC2A4\uD134\uC2A4 \uBC18\uD658)\n\n  /** \uC9C0\uC815\uB41C \uC5F0\uB3C4\uB85C \uC0C8 \uC778\uC2A4\uD134\uC2A4 \uBC18\uD658 */\n  setYear(year: number): DateTime {\n    return new DateTime(year, this.month, this.day, this.hour, this.minute, this.second, this.millisecond);\n  }\n\n  /**\n   * \uC9C0\uC815\uB41C \uC6D4\uB85C \uC0C8 DateTime \uC778\uC2A4\uD134\uC2A4\uB97C \uBC18\uD658\n   * @param month \uC124\uC815\uD560 \uC6D4 (1-12, \uBC94\uC704 \uC678 \uAC12\uC740 \uC5F0\uB3C4 \uC870\uC815)\n   * @note \uB300\uC0C1 \uC6D4\uC758 \uC77C\uC218\uBCF4\uB2E4 \uD604\uC7AC \uC77C\uC790\uAC00 \uD06C\uBA74 \uD574\uB2F9 \uC6D4\uC758 \uB9C8\uC9C0\uB9C9 \uB0A0\uB85C \uC870\uC815\uB428\n   *       (\uC608: 1\uC6D4 31\uC77C\uC5D0\uC11C setMonth(2) \u2192 2\uC6D4 28\uC77C \uB610\uB294 29\uC77C)\n   */\n  setMonth(month: number): DateTime {\n    const normalized = normalizeMonth(this.year, month, this.day);\n    return new DateTime(\n      normalized.year,\n      normalized.month,\n      normalized.day,\n      this.hour,\n      this.minute,\n      this.second,\n      this.millisecond,\n    );\n  }\n\n  /**\n   * \uC9C0\uC815\uB41C \uC77C\uC790\uB85C \uC0C8 DateTime \uC778\uC2A4\uD134\uC2A4\uB97C \uBC18\uD658\n   * @param day \uC124\uC815\uD560 \uC77C\uC790\n   * @note \uD574\uB2F9 \uC6D4\uC758 \uC720\uD6A8 \uBC94\uC704\uB97C \uBC97\uC5B4\uB098\uB294 \uC77C\uC790\uB294 JavaScript Date \uAE30\uBCF8 \uB3D9\uC791\uC5D0 \uB530\uB77C\n   *       \uC790\uB3D9\uC73C\uB85C \uB2E4\uC74C/\uC774\uC804 \uB2EC\uB85C \uC870\uC815\uB428 (\uC608: 1\uC6D4\uC5D0 day=32 \u2192 2\uC6D4 1\uC77C)\n   */\n  setDay(day: number): DateTime {\n    return new DateTime(this.year, this.month, day, this.hour, this.minute, this.second, this.millisecond);\n  }\n\n  /** \uC9C0\uC815\uB41C \uC2DC\uB85C \uC0C8 \uC778\uC2A4\uD134\uC2A4 \uBC18\uD658 */\n  setHour(hour: number): DateTime {\n    return new DateTime(this.year, this.month, this.day, hour, this.minute, this.second, this.millisecond);\n  }\n\n  /** \uC9C0\uC815\uB41C \uBD84\uC73C\uB85C \uC0C8 \uC778\uC2A4\uD134\uC2A4 \uBC18\uD658 */\n  setMinute(minute: number): DateTime {\n    return new DateTime(this.year, this.month, this.day, this.hour, minute, this.second, this.millisecond);\n  }\n\n  /** \uC9C0\uC815\uB41C \uCD08\uB85C \uC0C8 \uC778\uC2A4\uD134\uC2A4 \uBC18\uD658 */\n  setSecond(second: number): DateTime {\n    return new DateTime(this.year, this.month, this.day, this.hour, this.minute, second, this.millisecond);\n  }\n\n  /** \uC9C0\uC815\uB41C \uBC00\uB9AC\uCD08\uB85C \uC0C8 \uC778\uC2A4\uD134\uC2A4 \uBC18\uD658 */\n  setMillisecond(millisecond: number): DateTime {\n    return new DateTime(this.year, this.month, this.day, this.hour, this.minute, this.second, millisecond);\n  }\n\n  //#endregion\n\n  //#region \uC0B0\uC220 \uBA54\uC11C\uB4DC (\uC0C8 \uC778\uC2A4\uD134\uC2A4 \uBC18\uD658)\n\n  /** \uC9C0\uC815\uB41C \uC5F0\uC218\uB97C \uB354\uD55C \uC0C8 \uC778\uC2A4\uD134\uC2A4 \uBC18\uD658 */\n  addYears(years: number): DateTime {\n    return this.setYear(this.year + years);\n  }\n\n  /** \uC9C0\uC815\uB41C \uC6D4\uC218\uB97C \uB354\uD55C \uC0C8 \uC778\uC2A4\uD134\uC2A4 \uBC18\uD658 */\n  addMonths(months: number): DateTime {\n    return this.setMonth(this.month + months);\n  }\n\n  /** \uC9C0\uC815\uB41C \uC77C\uC218\uB97C \uB354\uD55C \uC0C8 \uC778\uC2A4\uD134\uC2A4 \uBC18\uD658 */\n  addDays(days: number): DateTime {\n    return new DateTime(this.tick + days * 24 * 60 * 60 * 1000);\n  }\n\n  /** \uC9C0\uC815\uB41C \uC2DC\uAC04\uC744 \uB354\uD55C \uC0C8 \uC778\uC2A4\uD134\uC2A4 \uBC18\uD658 */\n  addHours(hours: number): DateTime {\n    return new DateTime(this.tick + hours * 60 * 60 * 1000);\n  }\n\n  /** \uC9C0\uC815\uB41C \uBD84\uC744 \uB354\uD55C \uC0C8 \uC778\uC2A4\uD134\uC2A4 \uBC18\uD658 */\n  addMinutes(minutes: number): DateTime {\n    return new DateTime(this.tick + minutes * 60 * 1000);\n  }\n\n  /** \uC9C0\uC815\uB41C \uCD08\uB97C \uB354\uD55C \uC0C8 \uC778\uC2A4\uD134\uC2A4 \uBC18\uD658 */\n  addSeconds(seconds: number): DateTime {\n    return new DateTime(this.tick + seconds * 1000);\n  }\n\n  /** \uC9C0\uC815\uB41C \uBC00\uB9AC\uCD08\uB97C \uB354\uD55C \uC0C8 \uC778\uC2A4\uD134\uC2A4 \uBC18\uD658 */\n  addMilliseconds(milliseconds: number): DateTime {\n    return new DateTime(this.tick + milliseconds);\n  }\n\n  //#endregion\n\n  //#region \uD3EC\uB9F7\uD305\n\n  /**\n   * \uC9C0\uC815\uB41C \uD3EC\uB9F7\uC73C\uB85C \uBB38\uC790\uC5F4 \uBCC0\uD658\n   * @param format \uD3EC\uB9F7 \uBB38\uC790\uC5F4\n   * @see dtFormat \uC9C0\uC6D0 \uD3EC\uB9F7 \uBB38\uC790\uC5F4 \uCC38\uC870\n   */\n  toFormatString(formatStr: string): string {\n    return formatDate(formatStr, {\n      year: this.year,\n      month: this.month,\n      day: this.day,\n      hour: this.hour,\n      minute: this.minute,\n      second: this.second,\n      millisecond: this.millisecond,\n      timezoneOffsetMinutes: this.timezoneOffsetMinutes,\n    });\n  }\n\n  toString(): string {\n    return this.toFormatString(\"yyyy-MM-ddTHH:mm:ss.fffzzz\");\n  }\n\n  //#endregion\n}\n"],
+  "mappings": "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",
+  "names": []
+}