@simplysm/core-common 13.0.100 → 14.0.4

package/src/types/date-only.ts

@@ -2,10 +2,10 @@ import { ArgumentError } from "../errors/argument-error";
 import { format, normalizeMonth } from "../utils/date-format";
 
 /**
- * Date class (without time: yyyy-MM-dd, immutable)
+ * 날짜 클래스 (시간 제외: yyyy-MM-dd, 불변)
  *
- * An immutable class that stores only the date without time information.
- * Operates based on local timezone.
+ * 시간 정보 없이 날짜만 저장하는 불변 클래스.
+ * 로컬 타임존 기준으로 동작함.
  *
  * @example
  * const today = new DateOnly();
@@ -17,13 +17,13 @@ export class DateOnly {
 
   readonly date: Date;
 
-  /** Current time */
+  /** 현재 시간 */
   constructor();
-  /** Initialize with year, month, day */
+  /** 년, 월, 일로 초기화 */
   constructor(year: number, month: number, day: number);
-  /** Create from tick (millisecond) */
+  /** tick (밀리초)으로 생성 */
   constructor(tick: number);
-  /** Create from Date type */
+  /** Date 타입으로 생성 */
   constructor(date: Date);
   constructor(arg1?: number | Date, arg2?: number, arg3?: number) {
     if (arg1 === undefined) {
@@ -42,26 +42,26 @@ export class DateOnly {
   }
 
   /**
-   * Parse a string into DateOnly
-   * @param str Date string
-   * @returns DateOnly instance
+   * 문자열을 DateOnly로 파싱
+   * @param str 날짜 문자열
+   * @returns DateOnly 인스턴스
    *
-   * Supported formats:
-   * - `yyyy-MM-dd` (e.g., '2024-01-15') - Extracted directly from string, timezone-independent
-   * - `yyyyMMdd` (e.g., '20240115') - Extracted directly from string, timezone-independent
-   * - ISO 8601 (e.g., '2024-01-15T00:00:00Z') - Interpreted as UTC, then converted to local timezone
+   * 지원 형식:
+   * - `yyyy-MM-dd` (예: '2024-01-15') - 문자열에서 직접 추출, 타임존 무관
+   * - `yyyyMMdd` (예: '20240115') - 문자열에서 직접 추출, 타임존 무관
+   * - ISO 8601 (예: '2024-01-15T00:00:00Z') - UTC로 해석 후 로컬 타임존으로 변환
    *
-   * @note For different server/client timezones, `yyyy-MM-dd` format is recommended
-   * @note For DST regions when parsing ISO 8601 format, the offset of the parsing target date is used.
+   * @note 서버/클라이언트 타임존이 다른 경우 `yyyy-MM-dd` 형식 권장
+   * @note DST 지역에서 ISO 8601 형식 파싱 시 파싱 대상 날짜의 오프셋이 사용됨.
    */
   static parse(str: string): DateOnly {
-    // yyyy-MM-dd format (timezone-independent)
+    // yyyy-MM-dd 형식 (타임존 무관)
     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]));
     }
 
-    // yyyyMMdd format (timezone-independent)
+    // yyyyMMdd 형식 (타임존 무관)
     const matchCompact = /^(\d{4})(\d{2})(\d{2})$/.exec(str);
     if (matchCompact != null) {
       return new DateOnly(
@@ -71,11 +71,11 @@ export class DateOnly {
       );
     }
 
-    // ISO 8601 and other formats (using Date.parse, timezone conversion applied)
-    // Date.parse() returns UTC tick for ISO 8601 with 'Z' suffix
-    // getTimezoneOffset() returns "minutes to add when converting from local to UTC" (KST is -540 = UTC+9)
-    // Here we do "UTC → local" conversion, so apply opposite sign (subtraction)
-    // Use the offset of the parsing target date for accurate conversion in DST regions
+    // ISO 8601 및 기타 형식 (Date.parse 사용, 타임존 변환 적용)
+    // Date.parse()는 'Z' 접미사가 있는 ISO 8601에 대해 UTC tick을 반환
+    // getTimezoneOffset()은 "로컬에서 UTC로 변환할 때 더해야 하는 분"을 반환 (KST는 -540 = UTC+9)
+    // 여기서는 "UTC → 로컬" 변환이므로 반대 부호 적용 (빼기)
+    // DST 지역에서 정확한 변환을 위해 파싱 대상 날짜의 오프셋 사용
     const utcTick = Date.parse(str);
     if (!Number.isNaN(utcTick)) {
       const tempDate = new Date(utcTick);
@@ -85,45 +85,45 @@ export class DateOnly {
     }
 
     throw new ArgumentError(
-      `Failed to parse date format. Supported formats: 'yyyy-MM-dd', 'yyyyMMdd', ISO 8601 date`,
+      `날짜 형식 파싱 실패. 지원 형식: 'yyyy-MM-dd', 'yyyyMMdd', ISO 8601 date`,
       {
         input: str,
       },
     );
   }
 
-  //#region Week calculation
+  //#region 주차 계산
 
   /**
-   * Return the base year and month based on week information
-   * @param weekStartDay Week start day (0=Sunday, 1=Monday, ..., 6=Saturday). Default: 1(Monday)
-   * @param minDaysInFirstWeek Minimum days to be considered the first week (1~7). Default: 4 (ISO 8601 standard)
-   * @returns Base year and month of the week containing this date
+   * 주차 정보 기반으로 기준 연도와 월 반환
+   * @param weekStartDay 주 시작 요일 (0=일요일, 1=월요일, ..., 6=토요일). 기본값: 1(월요일)
+   * @param minDaysInFirstWeek 첫 번째 주로 간주되기 위한 최소 일수 (1~7). 기본값: 4 (ISO 8601 표준)
+   * @returns 이 날짜가 포함된 주의 기준 연도와 월
    *
    * @example
-   * // ISO 8601 standard (Monday start, first week minimum 4 days)
+   * // ISO 8601 표준 (월요일 시작, 첫 주 최소 4일)
    * new DateOnly(2024, 1, 1).getBaseYearMonthSeqForWeekSeq(1, 4)
-   * // US style (Sunday start, first week minimum 1 day)
+   * // 미국식 (일요일 시작, 첫 주 최소 1일)
    * new DateOnly(2024, 1, 1).getBaseYearMonthSeqForWeekSeq(0, 1)
    */
   getBaseYearMonthSeqForWeekSeq(weekStartDay: number = 1, minDaysInFirstWeek: number = 4) {
-    // Calculate day of week index based on week start day (0 = week start day)
+    // 주 시작 요일 기준 요일 인덱스 계산 (0 = 주 시작 요일)
     const dayOfWeek = (this.dayOfWeek + 7 - weekStartDay) % 7;
-    // Remaining days in the current week (including current date)
+    // 현재 주의 남은 일수 (현재 날짜 포함)
     const daysInWeek = 7 - dayOfWeek;
 
-    // If remaining days in current week is less than minimum, consider as previous week
+    // 현재 주의 남은 일수가 최소 일수보다 적으면 이전 주로 간주
     if (daysInWeek < minDaysInFirstWeek) {
       const prevWeek = this.addDays(-7);
       return { year: prevWeek.year, monthSeq: prevWeek.month };
     } else {
-      // Calculate actual remaining days of the week considering month boundary
+      // 월 경계를 고려한 실제 남은 일수 계산
       const nextMonthDate = this.addMonths(1).setDay(1);
       const remainedDays = (nextMonthDate.tick - this.tick) / DateOnly.MS_PER_DAY;
 
-      // Take the smaller of actual days to month boundary and week remaining days
+      // 월 경계까지의 실제 일수와 주 남은 일수 중 작은 값 사용
       const realDaysInWeek = Math.min(daysInWeek, remainedDays);
-      // If still less than minimum when considering month boundary, consider as next week
+      // 월 경계를 고려했을 때도 최소 일수보다 적으면 다음 주로 간주
       if (realDaysInWeek < minDaysInFirstWeek) {
         const nextWeek = this.addDays(7);
         return { year: nextWeek.year, monthSeq: nextWeek.month };
@@ -134,10 +134,10 @@ export class DateOnly {
   }
 
   /**
-   * Calculate the start date of the week based on week information
-   * @param weekStartDay Week start day (0=Sunday, 1=Monday, ..., 6=Saturday). Default: 1(Monday)
-   * @param minDaysInFirstWeek Minimum days to be considered the first week (1~7). Default: 4 (ISO 8601 standard)
-   * @returns Start date of the week containing this date
+   * 주차 정보 기반으로 해당 주의 시작 날짜 계산
+   * @param weekStartDay 주 시작 요일 (0=일요일, 1=월요일, ..., 6=토요일). 기본값: 1(월요일)
+   * @param minDaysInFirstWeek 첫 번째 주로 간주되기 위한 최소 일수 (1~7). 기본값: 4 (ISO 8601 표준)
+   * @returns 이 날짜가 포함된 주의 시작 날짜
    */
   getWeekSeqStartDate(weekStartDay: number = 1, minDaysInFirstWeek: number = 4) {
     const dayOfWeek = (this.dayOfWeek + 7 - weekStartDay) % 7;
@@ -151,16 +151,16 @@ export class DateOnly {
   }
 
   /**
-   * Return year and week sequence information
-   * @param weekStartDay Week start day (0=Sunday, 1=Monday, ..., 6=Saturday). Default: 1(Monday)
-   * @param minDaysInFirstWeek Minimum days to be considered the first week (1~7). Default: 4 (ISO 8601 standard)
-   * @returns Year and week number within that year
+   * 연도와 주차 정보 반환
+   * @param weekStartDay 주 시작 요일 (0=일요일, 1=월요일, ..., 6=토요일). 기본값: 1(월요일)
+   * @param minDaysInFirstWeek 첫 번째 주로 간주되기 위한 최소 일수 (1~7). 기본값: 4 (ISO 8601 표준)
+   * @returns 해당 연도와 그 연도 내의 주차 번호
    *
    * @example
-   * // ISO 8601 standard (Monday start, first week minimum 4 days)
+   * // ISO 8601 표준 (월요일 시작, 첫 주 최소 4일)
    * new DateOnly(2025, 1, 6).getWeekSeqOfYear(); // { year: 2025, weekSeq: 2 }
    *
-   * // US style (Sunday start, first week minimum 1 day)
+   * // 미국식 (일요일 시작, 첫 주 최소 1일)
    * new DateOnly(2025, 1, 1).getWeekSeqOfYear(0, 1); // { year: 2025, weekSeq: 1 }
    */
   getWeekSeqOfYear(
@@ -182,16 +182,16 @@ export class DateOnly {
   }
 
   /**
-   * Return year, month and week sequence information for the given date
-   * @param weekStartDay Week start day (0=Sunday, 1=Monday, ..., 6=Saturday). Default: 1(Monday)
-   * @param minDaysInFirstWeek Minimum days to be considered the first week (1~7). Default: 4 (ISO 8601 standard)
-   * @returns Year, month and week number within that month
+   * 해당 날짜의 연도, 월, 주차 정보 반환
+   * @param weekStartDay 주 시작 요일 (0=일요일, 1=월요일, ..., 6=토요일). 기본값: 1(월요일)
+   * @param minDaysInFirstWeek 첫 번째 주로 간주되기 위한 최소 일수 (1~7). 기본값: 4 (ISO 8601 표준)
+   * @returns 연도, 월, 해당 월 내의 주차 번호
    *
    * @example
-   * // ISO 8601 standard (Monday start, first week minimum 4 days)
+   * // ISO 8601 표준 (월요일 시작, 첫 주 최소 4일)
    * new DateOnly(2025, 1, 15).getWeekSeqOfMonth(); // { year: 2025, monthSeq: 1, weekSeq: 3 }
    *
-   * // US style (Sunday start, first week minimum 1 day)
+   * // 미국식 (일요일 시작, 첫 주 최소 1일)
    * new DateOnly(2025, 1, 15).getWeekSeqOfMonth(0, 1); // { year: 2025, monthSeq: 1, weekSeq: 3 }
    */
   getWeekSeqOfMonth(
@@ -214,18 +214,18 @@ export class DateOnly {
   }
 
   /**
-   * Get the start date of a week based on week information
-   * @param arg Year, optional month, and week number
-   * @param weekStartDay Week start day (0=Sunday, 1=Monday, ..., 6=Saturday). Default: 1(Monday)
-   * @param minDaysInFirstWeek Minimum days to be considered the first week (1~7). Default: 4 (ISO 8601 standard)
-   * @returns Start date of the specified week
+   * 주차 정보 기반으로 해당 주의 시작 날짜 반환
+   * @param arg 연도, 선택적 월, 주차 번호
+   * @param weekStartDay 주 시작 요일 (0=일요일, 1=월요일, ..., 6=토요일). 기본값: 1(월요일)
+   * @param minDaysInFirstWeek 첫 번째 주로 간주되기 위한 최소 일수 (1~7). 기본값: 4 (ISO 8601 표준)
+   * @returns 지정된 주의 시작 날짜
    *
    * @example
-   * // Start date of week 2 in 2025 (ISO 8601 standard)
-   * DateOnly.getDateByYearWeekSeq({ year: 2025, weekSeq: 2 }); // 2025-01-06 (Monday)
+   * // 2025년 2주차 시작 날짜 (ISO 8601 표준)
+   * DateOnly.getDateByYearWeekSeq({ year: 2025, weekSeq: 2 }); // 2025-01-06 (월요일)
    *
-   * // Start date of week 3 in January 2025
-   * DateOnly.getDateByYearWeekSeq({ year: 2025, month: 1, weekSeq: 3 }); // 2025-01-13 (Monday)
+   * // 2025년 1월 3주차 시작 날짜
+   * DateOnly.getDateByYearWeekSeq({ year: 2025, month: 1, weekSeq: 3 }); // 2025-01-13 (월요일)
    */
   static getDateByYearWeekSeq(
     arg: { year: number; month?: number; weekSeq: number },
@@ -240,9 +240,9 @@ export class DateOnly {
 
   //#endregion
 
-  //#region Getters (read-only)
+  //#region Getters (읽기 전용)
 
-  /** Whether the date is set correctly */
+  /** 날짜가 올바르게 설정되었는지 여부 */
   get isValid(): boolean {
     return this.date instanceof Date && !Number.isNaN(this.date.getTime());
   }
@@ -263,25 +263,26 @@ export class DateOnly {
     return this.date.getTime();
   }
 
-  /** Day of week (Sunday~Saturday: 0~6) */
+  /** 요일 (일요일~토요일: 0~6) */
   get dayOfWeek(): number {
     return this.date.getDay();
   }
 
   //#endregion
 
-  //#region Immutable transformation methods (returns new instance)
+  //#region 불변 변환 메서드 (새 인스턴스 반환)
 
-  /** Return new instance with specified year */
+  /** 지정된 연도로 새 인스턴스 반환 */
   setYear(year: number): DateOnly {
-    return new DateOnly(year, this.month, this.day);
+    const lastDay = new Date(year, this.month, 0).getDate();
+    return new DateOnly(year, this.month, Math.min(this.day, lastDay));
   }
 
   /**
-   * Return new DateOnly instance with specified month
-   * @param month Month to set (1-12, out-of-range values are adjusted in year)
-   * @note If current day is greater than target month's day count, it will be adjusted to last day of month
-   *       (e.g., setMonth(2) on Jan 31 → Feb 28 or 29)
+   * 지정된 월로 새 DateOnly 인스턴스 반환
+   * @param month 설정할 월 (1-12, 범위 밖의 값은 연도에서 조정됨)
+   * @note 현재 일이 대상 월의 일수보다 크면 해당 월의 마지막 일로 조정됨
+   *       (예: 1월 31일에서 setMonth(2) → 2월 28일 또는 29일)
    */
   setMonth(month: number): DateOnly {
     const normalized = normalizeMonth(this.year, month, this.day);
@@ -289,10 +290,10 @@ export class DateOnly {
   }
 
   /**
-   * Return new DateOnly instance with specified day
-   * @param day Day to set
-   * @note Days outside valid month range are automatically adjusted to next/previous month per JavaScript Date behavior
-   *       (e.g., day=32 in January → February 1)
+   * 지정된 일로 새 DateOnly 인스턴스 반환
+   * @param day 설정할 일
+   * @note 유효한 월 범위를 벗어나는 일은 JavaScript Date 동작에 따라 자동으로 다음/이전 월로 조정됨
+   *       (예: 1월에 day=32 → 2월 1일)
    */
   setDay(day: number): DateOnly {
     return new DateOnly(this.year, this.month, day);
@@ -300,19 +301,19 @@ export class DateOnly {
 
   //#endregion
 
-  //#region Arithmetic methods (returns new instance)
+  //#region 산술 메서드 (새 인스턴스 반환)
 
-  /** Return new instance with specified years added */
+  /** 지정된 연수를 더한 새 인스턴스 반환 */
   addYears(years: number): DateOnly {
     return this.setYear(this.year + years);
   }
 
-  /** Return new instance with specified months added */
+  /** 지정된 월수를 더한 새 인스턴스 반환 */
   addMonths(months: number): DateOnly {
     return this.setMonth(this.month + months);
   }
 
-  /** Return new instance with specified days added */
+  /** 지정된 일수를 더한 새 인스턴스 반환 */
   addDays(days: number): DateOnly {
     return new DateOnly(this.tick + days * DateOnly.MS_PER_DAY);
   }
@@ -322,9 +323,9 @@ export class DateOnly {
   //#region Formatting
 
   /**
-   * Convert to string with specified format
-   * @param format Format string
-   * @see dtFormat for supported format strings
+   * 지정된 형식으로 문자열 변환
+   * @param format 형식 문자열
+   * @see dtFormat 지원되는 형식 문자열 참조
    */
   toFormatString(formatStr: string): string {
     return format(formatStr, {

package/src/types/date-time.ts

@@ -2,10 +2,10 @@ import { ArgumentError } from "../errors/argument-error";
 import { convert12To24, format, normalizeMonth } from "../utils/date-format";
 
 /**
- * DateTime class (immutable)
+ * DateTime 클래스 (불변)
  *
- * Wraps JavaScript Date object to provide immutability and convenient API.
- * Supports millisecond precision and operates based on local timezone.
+ * JavaScript Date 객체를 래핑하여 불변성과 편리한 API를 제공.
+ * 밀리초 정밀도를 지원하고 로컬 타임존 기준으로 동작함.
  *
  * @example
  * const now = new DateTime();
@@ -15,9 +15,9 @@ import { convert12To24, format, normalizeMonth } from "../utils/date-format";
 export class DateTime {
   readonly date: Date;
 
-  /** Create with current time */
+  /** 현재 시간으로 생성 */
   constructor();
-  /** Create with year, month, day, hour, minute, second, millisecond */
+  /** 년, 월, 일, 시, 분, 초, 밀리초로 생성 */
   constructor(
     year: number,
     month: number,
@@ -27,9 +27,9 @@ export class DateTime {
     second?: number,
     millisecond?: number,
   );
-  /** Create from tick (millisecond) */
+  /** tick (밀리초)으로 생성 */
   constructor(tick: number);
-  /** Create from Date object */
+  /** Date 객체로 생성 */
   constructor(date: Date);
   constructor(
     arg1?: number | Date,
@@ -60,11 +60,11 @@ export class DateTime {
   }
 
   /**
-   * Parse a string to create DateTime instance
+   * 문자열을 파싱하여 DateTime 인스턴스 생성
    *
-   * @param str DateTime string
-   * @returns Parsed DateTime instance
-   * @throws ArgumentError If unsupported format
+   * @param str DateTime 문자열
+   * @returns 파싱된 DateTime 인스턴스
+   * @throws ArgumentError 지원하지 않는 형식인 경우
    *
    * @example
    * DateTime.parse("2025-01-15 10:30:00")     // yyyy-MM-dd HH:mm:ss
@@ -98,7 +98,7 @@ export class DateTime {
       );
     }
 
-    // Korean AM/PM format (오전/오후)
+    // 한국어 오전/오후 형식
     const matchKorean =
       /^([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,
@@ -147,12 +147,12 @@ export class DateTime {
     }
 
     throw new ArgumentError(
-      `Failed to parse datetime format. Supported formats: 'yyyy-MM-dd HH:mm:ss', 'yyyyMMddHHmmss', 'yyyy-MM-dd AM/PM HH:mm:ss', ISO 8601`,
+      `날짜시간 형식 파싱 실패. 지원 형식: 'yyyy-MM-dd HH:mm:ss', 'yyyyMMddHHmmss', 'yyyy-MM-dd AM/PM HH:mm:ss', ISO 8601`,
       { input: str },
     );
   }
 
-  //#region Getters (read-only)
+  //#region Getters (읽기 전용)
 
   get year(): number {
     return this.date.getFullYear();
@@ -186,7 +186,7 @@ export class DateTime {
     return this.date.getTime();
   }
 
-  /** Day of week (Sunday~Saturday: 0~6) */
+  /** 요일 (일요일~토요일: 0~6) */
   get dayOfWeek(): number {
     return this.date.getDay();
   }
@@ -195,21 +195,22 @@ export class DateTime {
     return -this.date.getTimezoneOffset();
   }
 
-  /** Whether the datetime is set correctly */
+  /** 날짜시간이 올바르게 설정되었는지 여부 */
   get isValid(): boolean {
     return this.date instanceof Date && !Number.isNaN(this.date.getTime());
   }
 
   //#endregion
 
-  //#region Immutable transformation methods (returns new instance)
+  //#region 불변 변환 메서드 (새 인스턴스 반환)
 
-  /** Return new instance with specified year */
+  /** 지정된 연도로 새 인스턴스 반환 */
   setYear(year: number): DateTime {
+    const lastDay = new Date(year, this.month, 0).getDate();
     return new DateTime(
       year,
       this.month,
-      this.day,
+      Math.min(this.day, lastDay),
       this.hour,
       this.minute,
       this.second,
@@ -218,10 +219,10 @@ export class DateTime {
   }
 
   /**
-   * Return new DateTime instance with specified month
-   * @param month Month to set (1-12, out-of-range values are adjusted in year)
-   * @note If current day is greater than target month's day count, it will be adjusted to last day of month
-   *       (e.g., setMonth(2) on Jan 31 → Feb 28 or 29)
+   * 지정된 월로 새 DateTime 인스턴스 반환
+   * @param month 설정할 월 (1-12, 범위 밖의 값은 연도에서 조정됨)
+   * @note 현재 일이 대상 월의 일수보다 크면 해당 월의 마지막 일로 조정됨
+   *       (예: 1월 31일에서 setMonth(2) → 2월 28일 또는 29일)
    */
   setMonth(month: number): DateTime {
     const normalized = normalizeMonth(this.year, month, this.day);
@@ -237,10 +238,10 @@ export class DateTime {
   }
 
   /**
-   * Return new DateTime instance with specified day
-   * @param day Day to set
-   * @note Days outside valid month range are automatically adjusted to next/previous month per JavaScript Date behavior
-   *       (e.g., day=32 in January → February 1)
+   * 지정된 일로 새 DateTime 인스턴스 반환
+   * @param day 설정할 일
+   * @note 유효한 월 범위를 벗어나는 일은 JavaScript Date 동작에 따라 자동으로 다음/이전 월로 조정됨
+   *       (예: 1월에 day=32 → 2월 1일)
    */
   setDay(day: number): DateTime {
     return new DateTime(
@@ -254,7 +255,7 @@ export class DateTime {
     );
   }
 
-  /** Return new instance with specified hour */
+  /** 지정된 시로 새 인스턴스 반환 */
   setHour(hour: number): DateTime {
     return new DateTime(
       this.year,
@@ -267,7 +268,7 @@ export class DateTime {
     );
   }
 
-  /** Return new instance with specified minute */
+  /** 지정된 분으로 새 인스턴스 반환 */
   setMinute(minute: number): DateTime {
     return new DateTime(
       this.year,
@@ -280,7 +281,7 @@ export class DateTime {
     );
   }
 
-  /** Return new instance with specified second */
+  /** 지정된 초로 새 인스턴스 반환 */
   setSecond(second: number): DateTime {
     return new DateTime(
       this.year,
@@ -293,7 +294,7 @@ export class DateTime {
     );
   }
 
-  /** Return new instance with specified millisecond */
+  /** 지정된 밀리초로 새 인스턴스 반환 */
   setMillisecond(millisecond: number): DateTime {
     return new DateTime(
       this.year,
@@ -308,39 +309,39 @@ export class DateTime {
 
   //#endregion
 
-  //#region Arithmetic methods (returns new instance)
+  //#region 산술 메서드 (새 인스턴스 반환)
 
-  /** Return new instance with specified years added */
+  /** 지정된 연수를 더한 새 인스턴스 반환 */
   addYears(years: number): DateTime {
     return this.setYear(this.year + years);
   }
 
-  /** Return new instance with specified months added */
+  /** 지정된 월수를 더한 새 인스턴스 반환 */
   addMonths(months: number): DateTime {
     return this.setMonth(this.month + months);
   }
 
-  /** Return new instance with specified days added */
+  /** 지정된 일수를 더한 새 인스턴스 반환 */
   addDays(days: number): DateTime {
     return new DateTime(this.tick + days * 24 * 60 * 60 * 1000);
   }
 
-  /** Return new instance with specified hours added */
+  /** 지정된 시간을 더한 새 인스턴스 반환 */
   addHours(hours: number): DateTime {
     return new DateTime(this.tick + hours * 60 * 60 * 1000);
   }
 
-  /** Return new instance with specified minutes added */
+  /** 지정된 분을 더한 새 인스턴스 반환 */
   addMinutes(minutes: number): DateTime {
     return new DateTime(this.tick + minutes * 60 * 1000);
   }
 
-  /** Return new instance with specified seconds added */
+  /** 지정된 초를 더한 새 인스턴스 반환 */
   addSeconds(seconds: number): DateTime {
     return new DateTime(this.tick + seconds * 1000);
   }
 
-  /** Return new instance with specified milliseconds added */
+  /** 지정된 밀리초를 더한 새 인스턴스 반환 */
   addMilliseconds(milliseconds: number): DateTime {
     return new DateTime(this.tick + milliseconds);
   }
@@ -350,9 +351,9 @@ export class DateTime {
   //#region Formatting
 
   /**
-   * Convert to string with specified format
-   * @param format Format string
-   * @see dtFormat for supported format strings
+   * 지정된 형식으로 문자열 변환
+   * @param format 형식 문자열
+   * @see dtFormat 지원되는 형식 문자열 참조
    */
   toFormatString(formatStr: string): string {
     return format(formatStr, {