@simplysm/core-common 13.0.69 → 13.0.71

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

@@ -1,8 +1,8 @@
 /**
- * 날짜 클래스 (시간제외: yyyy-MM-dd, 불변)
+ * Date class (without time: yyyy-MM-dd, immutable)
  *
- * 시간 정보 없이 날짜만 저장하는 불변 클래스이다.
- * 로컬 타임존을 기준으로 동작한다.
+ * An immutable class that stores only the date without time information.
+ * Operates based on local timezone.
  *
  * @example
  * const today = new DateOnly();
@@ -12,38 +12,38 @@
 export declare class DateOnly {
     private static readonly MS_PER_DAY;
     readonly date: Date;
-    /** 현재시간 */
+    /** Current time */
     constructor();
-    /** 연월일로 초기화 */
+    /** Initialize with year, month, day */
     constructor(year: number, month: number, day: number);
-    /** tick (millisecond)으로 생성 */
+    /** Create from tick (millisecond) */
     constructor(tick: number);
-    /** Date 타입으로 생성 */
+    /** Create from Date type */
     constructor(date: Date);
     /**
-     * 문자열을 DateOnly로 파싱
-     * @param str 날짜 문자열
-     * @returns DateOnly 인스턴스
+     * Parse a string into DateOnly
+     * @param str Date string
+     * @returns DateOnly instance
      *
-     * 지원 형식:
-     * - `yyyy-MM-dd` (예: '2024-01-15') - 문자열에서 직접 추출, 타임존 영향 없음
-     * - `yyyyMMdd` (예: '20240115') - 문자열에서 직접 추출, 타임존 영향 없음
-     * - ISO 8601 (예: '2024-01-15T00:00:00Z') - UTC로 해석 후 로컬 타임존 변환
+     * 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
      *
-     * @note 서버/클라이언트 타임존이 다른 경우 `yyyy-MM-dd` 형식 사용 권장
-     * @note DST(일광절약시간) 지역에서 ISO 8601 형식 파싱 시, 파싱 대상 날짜의 오프셋을 사용합니다.
+     * @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.
      */
     static parse(str: string): DateOnly;
     /**
-     * 기준 연도와 월을 주차 정보를 기반으로 반환
-     * @param weekStartDay 주의 시작 요일 (0=일요일, 1=월요일, ..., 6=토요일). 기본값: 1(월요일)
-     * @param minDaysInFirstWeek 첫 주로 간주할 최소 일수 (1~7). 기본값: 4 (ISO 8601 표준)
-     * @returns 해당 날짜가 속한 주차의 기준 연도와 월
+     * 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
      *
      * @example
-     * // ISO 8601 표준 (월요일 시작, 첫 주 최소 4일)
+     * // ISO 8601 standard (Monday start, first week minimum 4 days)
      * new DateOnly(2024, 1, 1).getBaseYearMonthSeqForWeekSeq(1, 4)
-     * // 미국식 (일요일 시작, 첫 주 최소 1일)
+     * // US style (Sunday start, first week minimum 1 day)
      * new DateOnly(2024, 1, 1).getBaseYearMonthSeqForWeekSeq(0, 1)
      */
     getBaseYearMonthSeqForWeekSeq(weekStartDay?: number, minDaysInFirstWeek?: number): {
@@ -51,23 +51,23 @@ export declare class DateOnly {
         monthSeq: number;
     };
     /**
-     * 주차 정보를 기반으로 해당 주의 시작 날짜 계산
-     * @param weekStartDay 주의 시작 요일 (0=일요일, 1=월요일, ..., 6=토요일). 기본값: 1(월요일)
-     * @param minDaysInFirstWeek 첫 주로 간주할 최소 일수 (1~7). 기본값: 4 (ISO 8601 표준)
-     * @returns 해당 날짜가 속한 주의 시작 날짜
+     * 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
      */
     getWeekSeqStartDate(weekStartDay?: number, minDaysInFirstWeek?: number): DateOnly;
     /**
-     * 연도 및 주차 순서 정보를 반환
-     * @param weekStartDay 주의 시작 요일 (0=일요일, 1=월요일, ..., 6=토요일). 기본값: 1(월요일)
-     * @param minDaysInFirstWeek 첫 주로 간주할 최소 일수 (1~7). 기본값: 4 (ISO 8601 표준)
-     * @returns 연도와 해당 연도 기준 주차 번호
+     * 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
      *
      * @example
-     * // ISO 8601 표준 (월요일 시작, 첫 주 4일 이상)
+     * // ISO 8601 standard (Monday start, first week minimum 4 days)
      * new DateOnly(2025, 1, 6).getWeekSeqOfYear(); // { year: 2025, weekSeq: 2 }
      *
-     * // 미국식 (일요일 시작, 첫 주 1일 이상)
+     * // US style (Sunday start, first week minimum 1 day)
      * new DateOnly(2025, 1, 1).getWeekSeqOfYear(0, 1); // { year: 2025, weekSeq: 1 }
      */
     getWeekSeqOfYear(weekStartDay?: number, minDaysInFirstWeek?: number): {
@@ -75,16 +75,16 @@ export declare class DateOnly {
         weekSeq: number;
     };
     /**
-     * 해당 날짜의 연도, 월 및 주차(weekSeq) 정보를 반환
-     * @param weekStartDay 주의 시작 요일 (0=일요일, 1=월요일, ..., 6=토요일). 기본값: 1(월요일)
-     * @param minDaysInFirstWeek 첫 주로 간주할 최소 일수 (1~7). 기본값: 4 (ISO 8601 표준)
-     * @returns 연도, 월 및 해당 월 기준 주차 번호
+     * 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
      *
      * @example
-     * // ISO 8601 표준 (월요일 시작, 첫 주 4일 이상)
+     * // ISO 8601 standard (Monday start, first week minimum 4 days)
      * new DateOnly(2025, 1, 15).getWeekSeqOfMonth(); // { year: 2025, monthSeq: 1, weekSeq: 3 }
      *
-     * // 미국식 (일요일 시작, 첫 주 1일 이상)
+     * // US style (Sunday start, first week minimum 1 day)
      * new DateOnly(2025, 1, 15).getWeekSeqOfMonth(0, 1); // { year: 2025, monthSeq: 1, weekSeq: 3 }
      */
     getWeekSeqOfMonth(weekStartDay?: number, minDaysInFirstWeek?: number): {
@@ -93,58 +93,58 @@ export declare class DateOnly {
         weekSeq: number;
     };
     /**
-     * 주차 정보를 기반으로 해당 주의 시작 날짜 가져오기
-     * @param arg 연도, 선택적 월, 주차 번호
-     * @param weekStartDay 주의 시작 요일 (0=일요일, 1=월요일, ..., 6=토요일). 기본값: 1(월요일)
-     * @param minDaysInFirstWeek 첫 주로 간주할 최소 일수 (1~7). 기본값: 4 (ISO 8601 표준)
-     * @returns 해당 주차의 시작 날짜
+     * 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
      *
      * @example
-     * // 2025년 2주차의 시작일 (ISO 8601 표준)
-     * DateOnly.getDateByYearWeekSeq({ year: 2025, weekSeq: 2 }); // 2025-01-06 (월요일)
+     * // Start date of week 2 in 2025 (ISO 8601 standard)
+     * DateOnly.getDateByYearWeekSeq({ year: 2025, weekSeq: 2 }); // 2025-01-06 (Monday)
      *
-     * // 2025년 1월 3주차의 시작일
-     * DateOnly.getDateByYearWeekSeq({ year: 2025, month: 1, weekSeq: 3 }); // 2025-01-13 (월요일)
+     * // Start date of week 3 in January 2025
+     * DateOnly.getDateByYearWeekSeq({ year: 2025, month: 1, weekSeq: 3 }); // 2025-01-13 (Monday)
      */
     static getDateByYearWeekSeq(arg: {
         year: number;
         month?: number;
         weekSeq: number;
     }, weekStartDay?: number, minDaysInFirstWeek?: number): DateOnly;
-    /** 날짜 세팅이 제대로 되었는지 여부 */
+    /** Whether the date is set correctly */
     get isValid(): boolean;
     get year(): number;
     get month(): number;
     get day(): number;
     get tick(): number;
-    /** 요일 (일~토: 0~6) */
+    /** Day of week (Sunday~Saturday: 0~6) */
     get dayOfWeek(): number;
-    /** 지정된 연도로 새 인스턴스 반환 */
+    /** Return new instance with specified year */
     setYear(year: number): DateOnly;
     /**
-     * 지정된 월로 새 DateOnly 인스턴스를 반환
-     * @param month 설정할 월 (1-12, 범위 외 값은 연도 조정)
-     * @note 대상 월의 일수보다 현재 일자가 크면 해당 월의 마지막 날로 조정됨
-     *       (예: 1월 31일에서 setMonth(2) → 2월 28일 또는 29일)
+     * 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)
      */
     setMonth(month: number): DateOnly;
     /**
-     * 지정된 일자로 새 DateOnly 인스턴스를 반환
-     * @param day 설정할 일자
-     * @note 해당 월의 유효 범위를 벗어나는 일자는 JavaScript Date 기본 동작에 따라
-     *       자동으로 다음/이전 달로 조정됨 (예: 1월에 day=32 → 2월 1일)
+     * 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)
      */
     setDay(day: number): DateOnly;
-    /** 지정된 연수를 더한 새 인스턴스 반환 */
+    /** Return new instance with specified years added */
     addYears(years: number): DateOnly;
-    /** 지정된 월수를 더한 새 인스턴스 반환 */
+    /** Return new instance with specified months added */
     addMonths(months: number): DateOnly;
-    /** 지정된 일수를 더한 새 인스턴스 반환 */
+    /** Return new instance with specified days added */
     addDays(days: number): DateOnly;
     /**
-     * 지정된 포맷으로 문자열 변환
-     * @param format 포맷 문자열
-     * @see dtFormat 지원 포맷 문자열 참조
+     * Convert to string with specified format
+     * @param format Format string
+     * @see dtFormat for supported format strings
      */
     toFormatString(formatStr: string): string;
     toString(): string;

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

@@ -1 +1 @@
-{"version":3,"file":"date-only.d.ts","sourceRoot":"","sources":["../../src/types/date-only.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAuB;IAEzD,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAEpB,WAAW;;IAEX,eAAe;gBACH,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;IACpD,8BAA8B;gBAClB,IAAI,EAAE,MAAM;IACxB,mBAAmB;gBACP,IAAI,EAAE,IAAI;IAiBtB;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ;IAwCnC;;;;;;;;;;;OAWG;IACH,6BAA6B,CAAC,YAAY,GAAE,MAAU,EAAE,kBAAkB,GAAE,MAAU;;;;IA2BtF;;;;;OAKG;IACH,mBAAmB,CAAC,YAAY,GAAE,MAAU,EAAE,kBAAkB,GAAE,MAAU;IAW5E;;;;;;;;;;;;OAYG;IACH,gBAAgB,CACd,YAAY,GAAE,MAAU,EACxB,kBAAkB,GAAE,MAAU,GAC7B;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAepC;;;;;;;;;;;;OAYG;IACH,iBAAiB,CACf,YAAY,GAAE,MAAU,EACxB,kBAAkB,GAAE,MAAU,GAC7B;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAgBtD;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,oBAAoB,CACzB,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EACtD,YAAY,GAAE,MAAU,EACxB,kBAAkB,GAAE,MAAU;IAYhC,yBAAyB;IACzB,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,oBAAoB;IACpB,IAAI,SAAS,IAAI,MAAM,CAEtB;IAMD,wBAAwB;IACxB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAI/B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ;IAKjC;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ;IAQ7B,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;IAQ/B;;;;OAIG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAQzC,QAAQ,IAAI,MAAM;CAKnB"}
+{"version":3,"file":"date-only.d.ts","sourceRoot":"","sources":["../../src/types/date-only.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAuB;IAEzD,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAEpB,mBAAmB;;IAEnB,uCAAuC;gBAC3B,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;IACpD,qCAAqC;gBACzB,IAAI,EAAE,MAAM;IACxB,4BAA4B;gBAChB,IAAI,EAAE,IAAI;IAiBtB;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ;IAwCnC;;;;;;;;;;;OAWG;IACH,6BAA6B,CAAC,YAAY,GAAE,MAAU,EAAE,kBAAkB,GAAE,MAAU;;;;IA2BtF;;;;;OAKG;IACH,mBAAmB,CAAC,YAAY,GAAE,MAAU,EAAE,kBAAkB,GAAE,MAAU;IAW5E;;;;;;;;;;;;OAYG;IACH,gBAAgB,CACd,YAAY,GAAE,MAAU,EACxB,kBAAkB,GAAE,MAAU,GAC7B;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAepC;;;;;;;;;;;;OAYG;IACH,iBAAiB,CACf,YAAY,GAAE,MAAU,EACxB,kBAAkB,GAAE,MAAU,GAC7B;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAgBtD;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,oBAAoB,CACzB,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EACtD,YAAY,GAAE,MAAU,EACxB,kBAAkB,GAAE,MAAU;IAYhC,wCAAwC;IACxC,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,yCAAyC;IACzC,IAAI,SAAS,IAAI,MAAM,CAEtB;IAMD,8CAA8C;IAC9C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAI/B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ;IAKjC;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ;IAQ7B,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ;IAIjC,sDAAsD;IACtD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ;IAInC,oDAAoD;IACpD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAQ/B;;;;OAIG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAQzC,QAAQ,IAAI,MAAM;CAKnB"}

package/dist/types/date-only.js

@@ -19,17 +19,17 @@ class DateOnly {
     }
   }
   /**
-   * 문자열을 DateOnly로 파싱
-   * @param str 날짜 문자열
-   * @returns DateOnly 인스턴스
+   * Parse a string into DateOnly
+   * @param str Date string
+   * @returns DateOnly instance
    *
-   * 지원 형식:
-   * - `yyyy-MM-dd` (예: '2024-01-15') - 문자열에서 직접 추출, 타임존 영향 없음
-   * - `yyyyMMdd` (예: '20240115') - 문자열에서 직접 추출, 타임존 영향 없음
-   * - ISO 8601 (예: '2024-01-15T00:00:00Z') - UTC로 해석 후 로컬 타임존 변환
+   * 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
    *
-   * @note 서버/클라이언트 타임존이 다른 경우 `yyyy-MM-dd` 형식 사용 권장
-   * @note DST(일광절약시간) 지역에서 ISO 8601 형식 파싱 시, 파싱 대상 날짜의 오프셋을 사용합니다.
+   * @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.
    */
   static parse(str) {
     const matchYMD = /^(\d{4})-(\d{2})-(\d{2})$/.exec(str);
@@ -52,23 +52,23 @@ class DateOnly {
       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`,
+      `Failed to parse date format. Supported formats: 'yyyy-MM-dd', 'yyyyMMdd', ISO 8601 date`,
       {
         input: str
       }
     );
   }
-  //#region 주차 계산
+  //#region Week calculation
   /**
-   * 기준 연도와 월을 주차 정보를 기반으로 반환
-   * @param weekStartDay 주의 시작 요일 (0=일요일, 1=월요일, ..., 6=토요일). 기본값: 1(월요일)
-   * @param minDaysInFirstWeek 첫 주로 간주할 최소 일수 (1~7). 기본값: 4 (ISO 8601 표준)
-   * @returns 해당 날짜가 속한 주차의 기준 연도와 월
+   * 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
    *
    * @example
-   * // ISO 8601 표준 (월요일 시작, 첫 주 최소 4일)
+   * // ISO 8601 standard (Monday start, first week minimum 4 days)
    * new DateOnly(2024, 1, 1).getBaseYearMonthSeqForWeekSeq(1, 4)
-   * // 미국식 (일요일 시작, 첫 주 최소 1일)
+   * // US style (Sunday start, first week minimum 1 day)
    * new DateOnly(2024, 1, 1).getBaseYearMonthSeqForWeekSeq(0, 1)
    */
   getBaseYearMonthSeqForWeekSeq(weekStartDay = 1, minDaysInFirstWeek = 4) {
@@ -90,10 +90,10 @@ class DateOnly {
     }
   }
   /**
-   * 주차 정보를 기반으로 해당 주의 시작 날짜 계산
-   * @param weekStartDay 주의 시작 요일 (0=일요일, 1=월요일, ..., 6=토요일). 기본값: 1(월요일)
-   * @param minDaysInFirstWeek 첫 주로 간주할 최소 일수 (1~7). 기본값: 4 (ISO 8601 표준)
-   * @returns 해당 날짜가 속한 주의 시작 날짜
+   * 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
    */
   getWeekSeqStartDate(weekStartDay = 1, minDaysInFirstWeek = 4) {
     const dayOfWeek = (this.dayOfWeek + 7 - weekStartDay) % 7;
@@ -105,16 +105,16 @@ class DateOnly {
     }
   }
   /**
-   * 연도 및 주차 순서 정보를 반환
-   * @param weekStartDay 주의 시작 요일 (0=일요일, 1=월요일, ..., 6=토요일). 기본값: 1(월요일)
-   * @param minDaysInFirstWeek 첫 주로 간주할 최소 일수 (1~7). 기본값: 4 (ISO 8601 표준)
-   * @returns 연도와 해당 연도 기준 주차 번호
+   * 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
    *
    * @example
-   * // ISO 8601 표준 (월요일 시작, 첫 주 4일 이상)
+   * // ISO 8601 standard (Monday start, first week minimum 4 days)
    * new DateOnly(2025, 1, 6).getWeekSeqOfYear(); // { year: 2025, weekSeq: 2 }
    *
-   * // 미국식 (일요일 시작, 첫 주 1일 이상)
+   * // US style (Sunday start, first week minimum 1 day)
    * new DateOnly(2025, 1, 1).getWeekSeqOfYear(0, 1); // { year: 2025, weekSeq: 1 }
    */
   getWeekSeqOfYear(weekStartDay = 1, minDaysInFirstWeek = 4) {
@@ -130,16 +130,16 @@ class DateOnly {
     };
   }
   /**
-   * 해당 날짜의 연도, 월 및 주차(weekSeq) 정보를 반환
-   * @param weekStartDay 주의 시작 요일 (0=일요일, 1=월요일, ..., 6=토요일). 기본값: 1(월요일)
-   * @param minDaysInFirstWeek 첫 주로 간주할 최소 일수 (1~7). 기본값: 4 (ISO 8601 표준)
-   * @returns 연도, 월 및 해당 월 기준 주차 번호
+   * 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
    *
    * @example
-   * // ISO 8601 표준 (월요일 시작, 첫 주 4일 이상)
+   * // ISO 8601 standard (Monday start, first week minimum 4 days)
    * new DateOnly(2025, 1, 15).getWeekSeqOfMonth(); // { year: 2025, monthSeq: 1, weekSeq: 3 }
    *
-   * // 미국식 (일요일 시작, 첫 주 1일 이상)
+   * // US style (Sunday start, first week minimum 1 day)
    * new DateOnly(2025, 1, 15).getWeekSeqOfMonth(0, 1); // { year: 2025, monthSeq: 1, weekSeq: 3 }
    */
   getWeekSeqOfMonth(weekStartDay = 1, minDaysInFirstWeek = 4) {
@@ -156,18 +156,18 @@ class DateOnly {
     };
   }
   /**
-   * 주차 정보를 기반으로 해당 주의 시작 날짜 가져오기
-   * @param arg 연도, 선택적 월, 주차 번호
-   * @param weekStartDay 주의 시작 요일 (0=일요일, 1=월요일, ..., 6=토요일). 기본값: 1(월요일)
-   * @param minDaysInFirstWeek 첫 주로 간주할 최소 일수 (1~7). 기본값: 4 (ISO 8601 표준)
-   * @returns 해당 주차의 시작 날짜
+   * 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
    *
    * @example
-   * // 2025년 2주차의 시작일 (ISO 8601 표준)
-   * DateOnly.getDateByYearWeekSeq({ year: 2025, weekSeq: 2 }); // 2025-01-06 (월요일)
+   * // Start date of week 2 in 2025 (ISO 8601 standard)
+   * DateOnly.getDateByYearWeekSeq({ year: 2025, weekSeq: 2 }); // 2025-01-06 (Monday)
    *
-   * // 2025년 1월 3주차의 시작일
-   * DateOnly.getDateByYearWeekSeq({ year: 2025, month: 1, weekSeq: 3 }); // 2025-01-13 (월요일)
+   * // Start date of week 3 in January 2025
+   * DateOnly.getDateByYearWeekSeq({ year: 2025, month: 1, weekSeq: 3 }); // 2025-01-13 (Monday)
    */
   static getDateByYearWeekSeq(arg, weekStartDay = 1, minDaysInFirstWeek = 4) {
     return new DateOnly(arg.year, arg.month ?? 1, (arg.weekSeq - 1) * 7 + 1).getWeekSeqStartDate(
@@ -176,8 +176,8 @@ class DateOnly {
     );
   }
   //#endregion
-  //#region Getters (읽기 전용)
-  /** 날짜 세팅이 제대로 되었는지 여부 */
+  //#region Getters (read-only)
+  /** Whether the date is set correctly */
   get isValid() {
     return this.date instanceof Date && !Number.isNaN(this.date.getTime());
   }
@@ -193,55 +193,55 @@ class DateOnly {
   get tick() {
     return this.date.getTime();
   }
-  /** 요일 (일~토: 0~6) */
+  /** Day of week (Sunday~Saturday: 0~6) */
   get dayOfWeek() {
     return this.date.getDay();
   }
   //#endregion
-  //#region 불변 변환 메서드 (새 인스턴스 반환)
-  /** 지정된 연도로 새 인스턴스 반환 */
+  //#region Immutable transformation methods (returns new instance)
+  /** Return new instance with specified year */
   setYear(year) {
     return new DateOnly(year, this.month, this.day);
   }
   /**
-   * 지정된 월로 새 DateOnly 인스턴스를 반환
-   * @param month 설정할 월 (1-12, 범위 외 값은 연도 조정)
-   * @note 대상 월의 일수보다 현재 일자가 크면 해당 월의 마지막 날로 조정됨
-   *       (예: 1월 31일에서 setMonth(2) → 2월 28일 또는 29일)
+   * 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)
    */
   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일)
+   * 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)
    */
   setDay(day) {
     return new DateOnly(this.year, this.month, day);
   }
   //#endregion
-  //#region 산술 메서드 (새 인스턴스 반환)
-  /** 지정된 연수를 더한 새 인스턴스 반환 */
+  //#region Arithmetic methods (returns new instance)
+  /** Return new instance with specified years added */
   addYears(years) {
     return this.setYear(this.year + years);
   }
-  /** 지정된 월수를 더한 새 인스턴스 반환 */
+  /** Return new instance with specified months added */
   addMonths(months) {
     return this.setMonth(this.month + months);
   }
-  /** 지정된 일수를 더한 새 인스턴스 반환 */
+  /** Return new instance with specified days added */
   addDays(days) {
     return new DateOnly(this.tick + days * DateOnly.MS_PER_DAY);
   }
   //#endregion
-  //#region 포맷팅
+  //#region Formatting
   /**
-   * 지정된 포맷으로 문자열 변환
-   * @param format 포맷 문자열
-   * @see dtFormat 지원 포맷 문자열 참조
+   * Convert to string with specified format
+   * @param format Format string
+   * @see dtFormat for supported format strings
    */
   toFormatString(formatStr) {
     return formatDate(formatStr, {

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

@@ -1,8 +1,8 @@
 /**
- * 날짜시간 클래스 (불변)
+ * DateTime class (immutable)
  *
- * JavaScript Date 객체를 래핑하여 불변성과 편리한 API를 제공한다.
- * 밀리초 단위까지 지원하며, 로컬 타임존을 기준으로 동작한다.
+ * Wraps JavaScript Date object to provide immutability and convenient API.
+ * Supports millisecond precision and operates based on local timezone.
  *
  * @example
  * const now = new DateTime();
@@ -11,26 +11,26 @@
  */
 export declare class DateTime {
     readonly date: Date;
-    /** 현재 시간으로 생성 */
+    /** Create with current time */
     constructor();
-    /** 연월일시분초밀리초로 생성 */
+    /** Create with year, month, day, hour, minute, second, millisecond */
     constructor(year: number, month: number, day: number, hour?: number, minute?: number, second?: number, millisecond?: number);
-    /** tick (밀리초)으로 생성 */
+    /** Create from tick (millisecond) */
     constructor(tick: number);
-    /** Date 객체로 생성 */
+    /** Create from Date object */
     constructor(date: Date);
     /**
-     * 문자열을 파싱하여 DateTime 인스턴스를 생성
+     * Parse a string to create DateTime instance
      *
-     * @param str 날짜시간 문자열
-     * @returns 파싱된 DateTime 인스턴스
-     * @throws ArgumentError 지원하지 않는 형식인 경우
+     * @param str DateTime string
+     * @returns Parsed DateTime instance
+     * @throws ArgumentError If unsupported format
      *
      * @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-15 AM 10:30:00")  // yyyy-MM-dd AM/PM HH:mm:ss
      * DateTime.parse("2025-01-15T10:30:00Z")    // ISO 8601
      */
     static parse(str: string): DateTime;
@@ -42,53 +42,53 @@ export declare class DateTime {
     get second(): number;
     get millisecond(): number;
     get tick(): number;
-    /** 요일 (일~토: 0~6) */
+    /** Day of week (Sunday~Saturday: 0~6) */
     get dayOfWeek(): number;
     get timezoneOffsetMinutes(): number;
-    /** 날짜시간 세팅이 제대로 되었는지 여부 */
+    /** Whether the datetime is set correctly */
     get isValid(): boolean;
-    /** 지정된 연도로 새 인스턴스 반환 */
+    /** Return new instance with specified year */
     setYear(year: number): DateTime;
     /**
-     * 지정된 월로 새 DateTime 인스턴스를 반환
-     * @param month 설정할 월 (1-12, 범위 외 값은 연도 조정)
-     * @note 대상 월의 일수보다 현재 일자가 크면 해당 월의 마지막 날로 조정됨
-     *       (예: 1월 31일에서 setMonth(2) → 2월 28일 또는 29일)
+     * 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)
      */
     setMonth(month: number): DateTime;
     /**
-     * 지정된 일자로 새 DateTime 인스턴스를 반환
-     * @param day 설정할 일자
-     * @note 해당 월의 유효 범위를 벗어나는 일자는 JavaScript Date 기본 동작에 따라
-     *       자동으로 다음/이전 달로 조정됨 (예: 1월에 day=32 → 2월 1일)
+     * 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)
      */
     setDay(day: number): DateTime;
-    /** 지정된 시로 새 인스턴스 반환 */
+    /** Return new instance with specified hour */
     setHour(hour: number): DateTime;
-    /** 지정된 분으로 새 인스턴스 반환 */
+    /** Return new instance with specified minute */
     setMinute(minute: number): DateTime;
-    /** 지정된 초로 새 인스턴스 반환 */
+    /** Return new instance with specified second */
     setSecond(second: number): DateTime;
-    /** 지정된 밀리초로 새 인스턴스 반환 */
+    /** Return new instance with specified millisecond */
     setMillisecond(millisecond: number): DateTime;
-    /** 지정된 연수를 더한 새 인스턴스 반환 */
+    /** Return new instance with specified years added */
     addYears(years: number): DateTime;
-    /** 지정된 월수를 더한 새 인스턴스 반환 */
+    /** Return new instance with specified months added */
     addMonths(months: number): DateTime;
-    /** 지정된 일수를 더한 새 인스턴스 반환 */
+    /** Return new instance with specified days added */
     addDays(days: number): DateTime;
-    /** 지정된 시간을 더한 새 인스턴스 반환 */
+    /** Return new instance with specified hours added */
     addHours(hours: number): DateTime;
-    /** 지정된 분을 더한 새 인스턴스 반환 */
+    /** Return new instance with specified minutes added */
     addMinutes(minutes: number): DateTime;
-    /** 지정된 초를 더한 새 인스턴스 반환 */
+    /** Return new instance with specified seconds added */
     addSeconds(seconds: number): DateTime;
-    /** 지정된 밀리초를 더한 새 인스턴스 반환 */
+    /** Return new instance with specified milliseconds added */
     addMilliseconds(milliseconds: number): DateTime;
     /**
-     * 지정된 포맷으로 문자열 변환
-     * @param format 포맷 문자열
-     * @see dtFormat 지원 포맷 문자열 참조
+     * Convert to string with specified format
+     * @param format Format string
+     * @see dtFormat for supported format strings
      */
     toFormatString(formatStr: string): string;
     toString(): string;

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

@@ -1 +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;IA6BtB;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ;IA6DnC,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;IAY/B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ;IAajC;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ;IAY7B,uBAAuB;IACvB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAY/B,wBAAwB;IACxB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ;IAYnC,uBAAuB;IACvB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ;IAYnC,yBAAyB;IACzB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ;IAgB7C,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"}
+{"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,+BAA+B;;IAE/B,sEAAsE;gBAEpE,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,qCAAqC;gBACzB,IAAI,EAAE,MAAM;IACxB,8BAA8B;gBAClB,IAAI,EAAE,IAAI;IA6BtB;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ;IAiFnC,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,yCAAyC;IACzC,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,qBAAqB,IAAI,MAAM,CAElC;IAED,4CAA4C;IAC5C,IAAI,OAAO,IAAI,OAAO,CAErB;IAMD,8CAA8C;IAC9C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAY/B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ;IAajC;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ;IAY7B,8CAA8C;IAC9C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAY/B,gDAAgD;IAChD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ;IAYnC,gDAAgD;IAChD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ;IAYnC,qDAAqD;IACrD,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ;IAgB7C,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ;IAIjC,sDAAsD;IACtD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ;IAInC,oDAAoD;IACpD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAI/B,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ;IAIjC,uDAAuD;IACvD,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ;IAIrC,uDAAuD;IACvD,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ;IAIrC,4DAA4D;IAC5D,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,QAAQ;IAQ/C;;;;OAIG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAazC,QAAQ,IAAI,MAAM;CAKnB"}