goodchuck-utils 1.1.0 → 1.2.0

package/dist/date/index.d.ts

@@ -0,0 +1,64 @@
+import dayjs from 'dayjs';
+import 'dayjs/locale/ko';
+/**
+ * 날짜를 지정된 포맷으로 변환
+ * @param date - 변환할 날짜 (Date, string, number)
+ * @param format - 포맷 문자열 (기본값: 'YYYY-MM-DD HH:mm:ss')
+ */
+export declare function formatDate(date?: Date | string | number, format?: string): string;
+/**
+ * 현재 날짜/시간 반환
+ * @param format - 포맷 문자열 (선택)
+ */
+export declare function now(format?: string): string | Date;
+/**
+ * 상대 시간 반환 (예: "3시간 전")
+ * @param date - 기준 날짜
+ * @param locale - 로케일 (기본값: 'ko')
+ */
+export declare function fromNow(date: Date | string | number, locale?: string): string;
+/**
+ * 두 날짜 사이의 차이 계산
+ * @param date1 - 첫 번째 날짜
+ * @param date2 - 두 번째 날짜
+ * @param unit - 단위 ('day', 'hour', 'minute' 등)
+ */
+export declare function diffDate(date1: Date | string | number, date2: Date | string | number, unit?: dayjs.OpUnitType): number;
+/**
+ * 날짜에 시간 더하기
+ * @param date - 기준 날짜
+ * @param value - 더할 값
+ * @param unit - 단위 ('day', 'hour', 'minute' 등)
+ */
+export declare function addDate(date: Date | string | number, value: number, unit?: dayjs.ManipulateType): Date;
+/**
+ * 날짜에 시간 빼기
+ * @param date - 기준 날짜
+ * @param value - 뺄 값
+ * @param unit - 단위 ('day', 'hour', 'minute' 등)
+ */
+export declare function subtractDate(date: Date | string | number, value: number, unit?: dayjs.ManipulateType): Date;
+/**
+ * 날짜가 특정 날짜보다 이전인지 확인
+ */
+export declare function isBefore(date1: Date | string | number, date2: Date | string | number): boolean;
+/**
+ * 날짜가 특정 날짜보다 이후인지 확인
+ */
+export declare function isAfter(date1: Date | string | number, date2: Date | string | number): boolean;
+/**
+ * 두 날짜가 같은지 확인
+ * @param unit - 비교 단위 (기본값: 'millisecond')
+ */
+export declare function isSame(date1: Date | string | number, date2: Date | string | number, unit?: dayjs.OpUnitType): boolean;
+/**
+ * 날짜가 유효한지 확인
+ */
+export declare function isValidDate(date: any): boolean;
+/**
+ * 타임존 변환
+ * @param date - 변환할 날짜
+ * @param tz - 타임존 (예: 'Asia/Seoul')
+ */
+export declare function toTimezone(date: Date | string | number, tz: string): Date;
+//# sourceMappingURL=index.d.ts.map

package/dist/date/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/date/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,iBAAiB,CAAC;AAMzB;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,IAAI,GAAE,IAAI,GAAG,MAAM,GAAG,MAAmB,EACzC,MAAM,GAAE,MAA8B,GACrC,MAAM,CAER;AAED;;;GAGG;AACH,wBAAgB,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGlD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAAE,MAAM,GAAE,MAAa,GAAG,MAAM,CAEnF;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAC7B,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAC7B,IAAI,GAAE,KAAK,CAAC,UAAkB,GAC7B,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CACrB,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,KAAK,CAAC,cAAsB,GACjC,IAAI,CAEN;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,KAAK,CAAC,cAAsB,GACjC,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAE9F;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAE7F;AAED;;;GAGG;AACH,wBAAgB,MAAM,CACpB,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAC7B,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAC7B,IAAI,GAAE,KAAK,CAAC,UAA0B,GACrC,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAEzE"}

package/dist/date/index.js

@@ -0,0 +1,92 @@
+import dayjs from 'dayjs';
+import utc from 'dayjs/plugin/utc';
+import timezone from 'dayjs/plugin/timezone';
+import relativeTime from 'dayjs/plugin/relativeTime';
+import 'dayjs/locale/ko';
+dayjs.extend(utc);
+dayjs.extend(timezone);
+dayjs.extend(relativeTime);
+/**
+ * 날짜를 지정된 포맷으로 변환
+ * @param date - 변환할 날짜 (Date, string, number)
+ * @param format - 포맷 문자열 (기본값: 'YYYY-MM-DD HH:mm:ss')
+ */
+export function formatDate(date = new Date(), format = 'YYYY-MM-DD HH:mm:ss') {
+    return dayjs(date).format(format);
+}
+/**
+ * 현재 날짜/시간 반환
+ * @param format - 포맷 문자열 (선택)
+ */
+export function now(format) {
+    const current = dayjs();
+    return format ? current.format(format) : current.toDate();
+}
+/**
+ * 상대 시간 반환 (예: "3시간 전")
+ * @param date - 기준 날짜
+ * @param locale - 로케일 (기본값: 'ko')
+ */
+export function fromNow(date, locale = 'ko') {
+    return dayjs(date).locale(locale).fromNow();
+}
+/**
+ * 두 날짜 사이의 차이 계산
+ * @param date1 - 첫 번째 날짜
+ * @param date2 - 두 번째 날짜
+ * @param unit - 단위 ('day', 'hour', 'minute' 등)
+ */
+export function diffDate(date1, date2, unit = 'day') {
+    return dayjs(date1).diff(dayjs(date2), unit);
+}
+/**
+ * 날짜에 시간 더하기
+ * @param date - 기준 날짜
+ * @param value - 더할 값
+ * @param unit - 단위 ('day', 'hour', 'minute' 등)
+ */
+export function addDate(date, value, unit = 'day') {
+    return dayjs(date).add(value, unit).toDate();
+}
+/**
+ * 날짜에 시간 빼기
+ * @param date - 기준 날짜
+ * @param value - 뺄 값
+ * @param unit - 단위 ('day', 'hour', 'minute' 등)
+ */
+export function subtractDate(date, value, unit = 'day') {
+    return dayjs(date).subtract(value, unit).toDate();
+}
+/**
+ * 날짜가 특정 날짜보다 이전인지 확인
+ */
+export function isBefore(date1, date2) {
+    return dayjs(date1).isBefore(dayjs(date2));
+}
+/**
+ * 날짜가 특정 날짜보다 이후인지 확인
+ */
+export function isAfter(date1, date2) {
+    return dayjs(date1).isAfter(dayjs(date2));
+}
+/**
+ * 두 날짜가 같은지 확인
+ * @param unit - 비교 단위 (기본값: 'millisecond')
+ */
+export function isSame(date1, date2, unit = 'millisecond') {
+    return dayjs(date1).isSame(dayjs(date2), unit);
+}
+/**
+ * 날짜가 유효한지 확인
+ */
+export function isValidDate(date) {
+    return dayjs(date).isValid();
+}
+/**
+ * 타임존 변환
+ * @param date - 변환할 날짜
+ * @param tz - 타임존 (예: 'Asia/Seoul')
+ */
+export function toTimezone(date, tz) {
+    return dayjs(date).tz(tz).toDate();
+}

package/dist/date/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/date/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../src/date/index.test.ts"],"names":[],"mappings":""}

package/dist/date/index.test.js

@@ -0,0 +1,166 @@
+import { describe, it, expect } from 'vitest';
+import { formatDate, now, fromNow, diffDate, addDate, subtractDate, isBefore, isAfter, isSame, isValidDate, toTimezone, } from './index';
+describe('Date Utils', () => {
+    describe('formatDate', () => {
+        it('should format date with default format', () => {
+            const date = new Date('2024-01-15 10:30:45');
+            const result = formatDate(date);
+            expect(result).toBe('2024-01-15 10:30:45');
+        });
+        it('should format date with custom format', () => {
+            const date = new Date('2024-01-15');
+            const result = formatDate(date, 'YYYY년 MM월 DD일');
+            expect(result).toBe('2024년 01월 15일');
+        });
+        it('should format string date', () => {
+            const result = formatDate('2024-01-15', 'YYYY-MM-DD');
+            expect(result).toBe('2024-01-15');
+        });
+        it('should format timestamp', () => {
+            const timestamp = new Date('2024-01-15').getTime();
+            const result = formatDate(timestamp, 'YYYY-MM-DD');
+            expect(result).toBe('2024-01-15');
+        });
+    });
+    describe('now', () => {
+        it('should return formatted current date when format is provided', () => {
+            const result = now('YYYY-MM-DD');
+            expect(result).toMatch(/^\d{4}-\d{2}-\d{2}$/);
+        });
+        it('should return Date object when no format is provided', () => {
+            const result = now();
+            expect(result).toBeInstanceOf(Date);
+        });
+    });
+    describe('fromNow', () => {
+        it('should return relative time in Korean', () => {
+            const yesterday = new Date();
+            yesterday.setDate(yesterday.getDate() - 1);
+            const result = fromNow(yesterday, 'ko');
+            expect(result).toContain('전');
+        });
+        it('should return relative time in English', () => {
+            const yesterday = new Date();
+            yesterday.setDate(yesterday.getDate() - 1);
+            const result = fromNow(yesterday, 'en');
+            expect(result).toContain('ago');
+        });
+    });
+    describe('diffDate', () => {
+        it('should calculate difference in days', () => {
+            const date1 = new Date('2024-01-20');
+            const date2 = new Date('2024-01-15');
+            const result = diffDate(date1, date2, 'day');
+            expect(result).toBe(5);
+        });
+        it('should calculate difference in hours', () => {
+            const date1 = new Date('2024-01-15 15:00:00');
+            const date2 = new Date('2024-01-15 12:00:00');
+            const result = diffDate(date1, date2, 'hour');
+            expect(result).toBe(3);
+        });
+        it('should handle negative differences', () => {
+            const date1 = new Date('2024-01-15');
+            const date2 = new Date('2024-01-20');
+            const result = diffDate(date1, date2, 'day');
+            expect(result).toBe(-5);
+        });
+    });
+    describe('addDate', () => {
+        it('should add days to date', () => {
+            const date = new Date('2024-01-15');
+            const result = addDate(date, 5, 'day');
+            expect(formatDate(result, 'YYYY-MM-DD')).toBe('2024-01-20');
+        });
+        it('should add hours to date', () => {
+            const date = new Date('2024-01-15 10:00:00');
+            const result = addDate(date, 3, 'hour');
+            expect(formatDate(result, 'YYYY-MM-DD HH:mm:ss')).toBe('2024-01-15 13:00:00');
+        });
+        it('should add months to date', () => {
+            const date = new Date('2024-01-15');
+            const result = addDate(date, 2, 'month');
+            expect(formatDate(result, 'YYYY-MM-DD')).toBe('2024-03-15');
+        });
+    });
+    describe('subtractDate', () => {
+        it('should subtract days from date', () => {
+            const date = new Date('2024-01-20');
+            const result = subtractDate(date, 5, 'day');
+            expect(formatDate(result, 'YYYY-MM-DD')).toBe('2024-01-15');
+        });
+        it('should subtract hours from date', () => {
+            const date = new Date('2024-01-15 13:00:00');
+            const result = subtractDate(date, 3, 'hour');
+            expect(formatDate(result, 'YYYY-MM-DD HH:mm:ss')).toBe('2024-01-15 10:00:00');
+        });
+    });
+    describe('isBefore', () => {
+        it('should return true if first date is before second', () => {
+            const date1 = new Date('2024-01-15');
+            const date2 = new Date('2024-01-20');
+            expect(isBefore(date1, date2)).toBe(true);
+        });
+        it('should return false if first date is after second', () => {
+            const date1 = new Date('2024-01-20');
+            const date2 = new Date('2024-01-15');
+            expect(isBefore(date1, date2)).toBe(false);
+        });
+    });
+    describe('isAfter', () => {
+        it('should return true if first date is after second', () => {
+            const date1 = new Date('2024-01-20');
+            const date2 = new Date('2024-01-15');
+            expect(isAfter(date1, date2)).toBe(true);
+        });
+        it('should return false if first date is before second', () => {
+            const date1 = new Date('2024-01-15');
+            const date2 = new Date('2024-01-20');
+            expect(isAfter(date1, date2)).toBe(false);
+        });
+    });
+    describe('isSame', () => {
+        it('should return true for exact same dates', () => {
+            const date1 = new Date('2024-01-15 10:30:45');
+            const date2 = new Date('2024-01-15 10:30:45');
+            expect(isSame(date1, date2)).toBe(true);
+        });
+        it('should return true for same day (ignoring time)', () => {
+            const date1 = new Date('2024-01-15 10:00:00');
+            const date2 = new Date('2024-01-15 15:00:00');
+            expect(isSame(date1, date2, 'day')).toBe(true);
+        });
+        it('should return false for different days', () => {
+            const date1 = new Date('2024-01-15');
+            const date2 = new Date('2024-01-16');
+            expect(isSame(date1, date2, 'day')).toBe(false);
+        });
+    });
+    describe('isValidDate', () => {
+        it('should return true for valid dates', () => {
+            expect(isValidDate(new Date('2024-01-15'))).toBe(true);
+            expect(isValidDate('2024-01-15')).toBe(true);
+            expect(isValidDate(1705276800000)).toBe(true);
+        });
+        it('should return false for invalid dates', () => {
+            expect(isValidDate('invalid-date')).toBe(false);
+            expect(isValidDate(NaN)).toBe(false);
+            expect(isValidDate(null)).toBe(false);
+        });
+    });
+    describe('toTimezone', () => {
+        it('should convert to specific timezone', () => {
+            const date = new Date('2024-01-15T00:00:00Z');
+            const result = toTimezone(date, 'Asia/Seoul');
+            expect(result).toBeInstanceOf(Date);
+        });
+        it('should handle different timezones', () => {
+            const date = new Date('2024-01-15T12:00:00Z');
+            const nyTime = toTimezone(date, 'America/New_York');
+            const seoulTime = toTimezone(date, 'Asia/Seoul');
+            expect(nyTime).toBeInstanceOf(Date);
+            expect(seoulTime).toBeInstanceOf(Date);
+            expect(nyTime.getTime()).toBe(seoulTime.getTime());
+        });
+    });
+});

package/dist/index.d.ts

@@ -1,5 +1,2 @@
-declare function add(a: number, b: number): number;
-declare function subtract(a: number, b: number): number;
-declare function multiply(a: number, b: number): number;
-declare function divide(a: number, b: number): number;
-export { add, subtract, multiply, divide };
+export * from './date';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,QAAQ,CAAC"}

package/dist/index.js

@@ -1,18 +1,8 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.add = add;
-exports.subtract = subtract;
-exports.multiply = multiply;
-exports.divide = divide;
-function add(a, b) {
-    return a + b;
-}
-function subtract(a, b) {
-    return a - b;
-}
-function multiply(a, b) {
-    return a * b;
-}
-function divide(a, b) {
-    return a / b;
-}
+// Date utilities
+export * from './date';
+// String utilities (placeholder for future)
+// export * from './string';
+// Array utilities (placeholder for future)
+// export * from './array';
+// Object utilities (placeholder for future)
+// export * from './object';

package/package.json

@@ -1,12 +1,17 @@
 {
   "name": "goodchuck-utils",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "type": "module",
   "main": "dist/index.js",
   "scripts": {
     "prepare": "npm run build:tsc",
+    "prepublishOnly": "npm run test:run && npm run build:tsc",
     "build": "npm run build",
-    "build:tsc": "tsc"
+    "build:tsc": "tsc",
+    "test": "vitest",
+    "test:ui": "vitest --ui",
+    "test:run": "vitest run",
+    "test:coverage": "vitest run --coverage"
   },
   "exports": {
     ".": {
@@ -21,9 +26,14 @@
   "description": "",
   "dependencies": {
     "@types/node": "^25.0.6",
+    "dayjs": "^1.11.19",
     "typescript": "^5.9.3"
   },
   "include": [
     "src/**/*.ts"
-  ]
+  ],
+  "devDependencies": {
+    "@vitest/ui": "^4.0.16",
+    "vitest": "^4.0.16"
+  }
 }

package/src/date/index.test.ts

@@ -0,0 +1,206 @@
+import { describe, it, expect } from 'vitest';
+import {
+  formatDate,
+  now,
+  fromNow,
+  diffDate,
+  addDate,
+  subtractDate,
+  isBefore,
+  isAfter,
+  isSame,
+  isValidDate,
+  toTimezone,
+} from './index';
+
+describe('Date Utils', () => {
+  describe('formatDate', () => {
+    it('should format date with default format', () => {
+      const date = new Date('2024-01-15 10:30:45');
+      const result = formatDate(date);
+      expect(result).toBe('2024-01-15 10:30:45');
+    });
+
+    it('should format date with custom format', () => {
+      const date = new Date('2024-01-15');
+      const result = formatDate(date, 'YYYY년 MM월 DD일');
+      expect(result).toBe('2024년 01월 15일');
+    });
+
+    it('should format string date', () => {
+      const result = formatDate('2024-01-15', 'YYYY-MM-DD');
+      expect(result).toBe('2024-01-15');
+    });
+
+    it('should format timestamp', () => {
+      const timestamp = new Date('2024-01-15').getTime();
+      const result = formatDate(timestamp, 'YYYY-MM-DD');
+      expect(result).toBe('2024-01-15');
+    });
+  });
+
+  describe('now', () => {
+    it('should return formatted current date when format is provided', () => {
+      const result = now('YYYY-MM-DD');
+      expect(result).toMatch(/^\d{4}-\d{2}-\d{2}$/);
+    });
+
+    it('should return Date object when no format is provided', () => {
+      const result = now();
+      expect(result).toBeInstanceOf(Date);
+    });
+  });
+
+  describe('fromNow', () => {
+    it('should return relative time in Korean', () => {
+      const yesterday = new Date();
+      yesterday.setDate(yesterday.getDate() - 1);
+      const result = fromNow(yesterday, 'ko');
+      expect(result).toContain('전');
+    });
+
+    it('should return relative time in English', () => {
+      const yesterday = new Date();
+      yesterday.setDate(yesterday.getDate() - 1);
+      const result = fromNow(yesterday, 'en');
+      expect(result).toContain('ago');
+    });
+  });
+
+  describe('diffDate', () => {
+    it('should calculate difference in days', () => {
+      const date1 = new Date('2024-01-20');
+      const date2 = new Date('2024-01-15');
+      const result = diffDate(date1, date2, 'day');
+      expect(result).toBe(5);
+    });
+
+    it('should calculate difference in hours', () => {
+      const date1 = new Date('2024-01-15 15:00:00');
+      const date2 = new Date('2024-01-15 12:00:00');
+      const result = diffDate(date1, date2, 'hour');
+      expect(result).toBe(3);
+    });
+
+    it('should handle negative differences', () => {
+      const date1 = new Date('2024-01-15');
+      const date2 = new Date('2024-01-20');
+      const result = diffDate(date1, date2, 'day');
+      expect(result).toBe(-5);
+    });
+  });
+
+  describe('addDate', () => {
+    it('should add days to date', () => {
+      const date = new Date('2024-01-15');
+      const result = addDate(date, 5, 'day');
+      expect(formatDate(result, 'YYYY-MM-DD')).toBe('2024-01-20');
+    });
+
+    it('should add hours to date', () => {
+      const date = new Date('2024-01-15 10:00:00');
+      const result = addDate(date, 3, 'hour');
+      expect(formatDate(result, 'YYYY-MM-DD HH:mm:ss')).toBe('2024-01-15 13:00:00');
+    });
+
+    it('should add months to date', () => {
+      const date = new Date('2024-01-15');
+      const result = addDate(date, 2, 'month');
+      expect(formatDate(result, 'YYYY-MM-DD')).toBe('2024-03-15');
+    });
+  });
+
+  describe('subtractDate', () => {
+    it('should subtract days from date', () => {
+      const date = new Date('2024-01-20');
+      const result = subtractDate(date, 5, 'day');
+      expect(formatDate(result, 'YYYY-MM-DD')).toBe('2024-01-15');
+    });
+
+    it('should subtract hours from date', () => {
+      const date = new Date('2024-01-15 13:00:00');
+      const result = subtractDate(date, 3, 'hour');
+      expect(formatDate(result, 'YYYY-MM-DD HH:mm:ss')).toBe('2024-01-15 10:00:00');
+    });
+  });
+
+  describe('isBefore', () => {
+    it('should return true if first date is before second', () => {
+      const date1 = new Date('2024-01-15');
+      const date2 = new Date('2024-01-20');
+      expect(isBefore(date1, date2)).toBe(true);
+    });
+
+    it('should return false if first date is after second', () => {
+      const date1 = new Date('2024-01-20');
+      const date2 = new Date('2024-01-15');
+      expect(isBefore(date1, date2)).toBe(false);
+    });
+  });
+
+  describe('isAfter', () => {
+    it('should return true if first date is after second', () => {
+      const date1 = new Date('2024-01-20');
+      const date2 = new Date('2024-01-15');
+      expect(isAfter(date1, date2)).toBe(true);
+    });
+
+    it('should return false if first date is before second', () => {
+      const date1 = new Date('2024-01-15');
+      const date2 = new Date('2024-01-20');
+      expect(isAfter(date1, date2)).toBe(false);
+    });
+  });
+
+  describe('isSame', () => {
+    it('should return true for exact same dates', () => {
+      const date1 = new Date('2024-01-15 10:30:45');
+      const date2 = new Date('2024-01-15 10:30:45');
+      expect(isSame(date1, date2)).toBe(true);
+    });
+
+    it('should return true for same day (ignoring time)', () => {
+      const date1 = new Date('2024-01-15 10:00:00');
+      const date2 = new Date('2024-01-15 15:00:00');
+      expect(isSame(date1, date2, 'day')).toBe(true);
+    });
+
+    it('should return false for different days', () => {
+      const date1 = new Date('2024-01-15');
+      const date2 = new Date('2024-01-16');
+      expect(isSame(date1, date2, 'day')).toBe(false);
+    });
+  });
+
+  describe('isValidDate', () => {
+    it('should return true for valid dates', () => {
+      expect(isValidDate(new Date('2024-01-15'))).toBe(true);
+      expect(isValidDate('2024-01-15')).toBe(true);
+      expect(isValidDate(1705276800000)).toBe(true);
+    });
+
+    it('should return false for invalid dates', () => {
+      expect(isValidDate('invalid-date')).toBe(false);
+      expect(isValidDate(NaN)).toBe(false);
+      expect(isValidDate(null)).toBe(false);
+    });
+  });
+
+  describe('toTimezone', () => {
+    it('should convert to specific timezone', () => {
+      const date = new Date('2024-01-15T00:00:00Z');
+      const result = toTimezone(date, 'Asia/Seoul');
+      expect(result).toBeInstanceOf(Date);
+    });
+
+    it('should handle different timezones', () => {
+      const date = new Date('2024-01-15T12:00:00Z');
+      const nyTime = toTimezone(date, 'America/New_York');
+      const seoulTime = toTimezone(date, 'Asia/Seoul');
+
+      expect(nyTime).toBeInstanceOf(Date);
+      expect(seoulTime).toBeInstanceOf(Date);
+      expect(nyTime.getTime()).toBe(seoulTime.getTime());
+    });
+  });
+});

package/src/date/index.ts

@@ -0,0 +1,123 @@
+import dayjs from 'dayjs';
+import utc from 'dayjs/plugin/utc';
+import timezone from 'dayjs/plugin/timezone';
+import relativeTime from 'dayjs/plugin/relativeTime';
+import 'dayjs/locale/ko';
+
+dayjs.extend(utc);
+dayjs.extend(timezone);
+dayjs.extend(relativeTime);
+
+/**
+ * 날짜를 지정된 포맷으로 변환
+ * @param date - 변환할 날짜 (Date, string, number)
+ * @param format - 포맷 문자열 (기본값: 'YYYY-MM-DD HH:mm:ss')
+ */
+export function formatDate(
+  date: Date | string | number = new Date(),
+  format: string = 'YYYY-MM-DD HH:mm:ss'
+): string {
+  return dayjs(date).format(format);
+}
+
+/**
+ * 현재 날짜/시간 반환
+ * @param format - 포맷 문자열 (선택)
+ */
+export function now(format?: string): string | Date {
+  const current = dayjs();
+  return format ? current.format(format) : current.toDate();
+}
+
+/**
+ * 상대 시간 반환 (예: "3시간 전")
+ * @param date - 기준 날짜
+ * @param locale - 로케일 (기본값: 'ko')
+ */
+export function fromNow(date: Date | string | number, locale: string = 'ko'): string {
+  return dayjs(date).locale(locale).fromNow();
+}
+
+/**
+ * 두 날짜 사이의 차이 계산
+ * @param date1 - 첫 번째 날짜
+ * @param date2 - 두 번째 날짜
+ * @param unit - 단위 ('day', 'hour', 'minute' 등)
+ */
+export function diffDate(
+  date1: Date | string | number,
+  date2: Date | string | number,
+  unit: dayjs.OpUnitType = 'day'
+): number {
+  return dayjs(date1).diff(dayjs(date2), unit);
+}
+
+/**
+ * 날짜에 시간 더하기
+ * @param date - 기준 날짜
+ * @param value - 더할 값
+ * @param unit - 단위 ('day', 'hour', 'minute' 등)
+ */
+export function addDate(
+  date: Date | string | number,
+  value: number,
+  unit: dayjs.ManipulateType = 'day'
+): Date {
+  return dayjs(date).add(value, unit).toDate();
+}
+
+/**
+ * 날짜에 시간 빼기
+ * @param date - 기준 날짜
+ * @param value - 뺄 값
+ * @param unit - 단위 ('day', 'hour', 'minute' 등)
+ */
+export function subtractDate(
+  date: Date | string | number,
+  value: number,
+  unit: dayjs.ManipulateType = 'day'
+): Date {
+  return dayjs(date).subtract(value, unit).toDate();
+}
+
+/**
+ * 날짜가 특정 날짜보다 이전인지 확인
+ */
+export function isBefore(date1: Date | string | number, date2: Date | string | number): boolean {
+  return dayjs(date1).isBefore(dayjs(date2));
+}
+
+/**
+ * 날짜가 특정 날짜보다 이후인지 확인
+ */
+export function isAfter(date1: Date | string | number, date2: Date | string | number): boolean {
+  return dayjs(date1).isAfter(dayjs(date2));
+}
+
+/**
+ * 두 날짜가 같은지 확인
+ * @param unit - 비교 단위 (기본값: 'millisecond')
+ */
+export function isSame(
+  date1: Date | string | number,
+  date2: Date | string | number,
+  unit: dayjs.OpUnitType = 'millisecond'
+): boolean {
+  return dayjs(date1).isSame(dayjs(date2), unit);
+}
+
+/**
+ * 날짜가 유효한지 확인
+ */
+export function isValidDate(date: any): boolean {
+  return dayjs(date).isValid();
+}
+
+/**
+ * 타임존 변환
+ * @param date - 변환할 날짜
+ * @param tz - 타임존 (예: 'Asia/Seoul')
+ */
+export function toTimezone(date: Date | string | number, tz: string): Date {
+  return dayjs(date).tz(tz).toDate();
+}

package/src/index.ts

@@ -1,17 +1,11 @@
-function add(a: number, b: number) {
-  return a + b;
-}
+// Date utilities
+export * from './date';
 
-function subtract(a: number, b: number) {
-  return a - b;
-}
+// String utilities (placeholder for future)
+// export * from './string';
 
-function multiply(a: number, b: number) {
-  return a * b;
-}
+// Array utilities (placeholder for future)
+// export * from './array';
 
-function divide(a: number, b: number) {
-  return a / b;
-}
-
-export { add, subtract, multiply, divide };
+// Object utilities (placeholder for future)
+// export * from './object';

package/tsconfig.json

@@ -1,14 +1,18 @@
 {
   "compilerOptions": {
-    "target": "es6" /* 최신 브라우저는 es6을 대부분 지원한다. */,
-    "module": "commonjs" /* 모듈 시스템을 지정한다. */,
-    "lib": [
-      "es5",
-      "es6",
-      "dom"
-    ] /* 타입스크립트가 어떤 버전의 JS의 빌트인 api를 사용할건지에 대한 것을 명시해 준다. */,
-    "declaration": true /* 타입스크립트가 자동으로 타입정의 (d.ts) 파일을 생성해 준다. */,
-    "outDir": "dist" /* 컴파일된 결과물을 어디에 저장할지에 대한 것을 명시해 준다. */,
-    "strict": true /* 타입스크립트의 엄격한 모드를 활성화한다. */
-  }
+    "target": "ES2020",
+    "module": "ESNext",
+    "lib": ["ES2020", "DOM"],
+    "declaration": true,
+    "declarationMap": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "moduleResolution": "node",
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["node_modules", "dist"]
 }

package/vitest.config.ts

@@ -0,0 +1,13 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+    coverage: {
+      provider: 'v8',
+      reporter: ['text', 'html'],
+      exclude: ['node_modules/', 'dist/', '**/*.test.ts'],
+    },
+  },
+});