goodchuck-utils 1.1.0 → 1.3.0

package/dist/string/manipulation.js

@@ -0,0 +1,106 @@
+/**
+ * String Manipulation Utilities
+ */
+/**
+ * 문자열을 지정된 길이로 자르고 말줄임표 추가
+ * @example truncate('Hello World', 5) // 'Hello...'
+ */
+export function truncate(str, length, suffix = '...') {
+    if (str.length <= length)
+        return str;
+    return str.slice(0, length) + suffix;
+}
+/**
+ * 문자열 양쪽 공백 제거 및 연속된 공백을 하나로
+ * @example normalizeWhitespace('  hello   world  ') // 'hello world'
+ */
+export function normalizeWhitespace(str) {
+    return str.trim().replace(/\s+/g, ' ');
+}
+/**
+ * URL 친화적인 슬러그 생성
+ * @example slugify('Hello World!') // 'hello-world'
+ * @example slugify('Test123 World') // 'test123-world'
+ */
+export function slugify(str) {
+    return str
+        .toLowerCase()
+        .trim()
+        .replace(/[^\w\s-]/g, '')
+        .replace(/[\s_]+/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+/**
+ * 랜덤 문자열 생성
+ * @param length - 생성할 문자열 길이
+ * @param charset - 사용할 문자 집합 ('alphanumeric', 'alpha', 'numeric', 'hex')
+ */
+export function randomString(length, charset = 'alphanumeric') {
+    const charsets = {
+        alphanumeric: 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789',
+        alpha: 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz',
+        numeric: '0123456789',
+        hex: '0123456789abcdef',
+    };
+    const chars = charsets[charset];
+    let result = '';
+    for (let i = 0; i < length; i++) {
+        result += chars.charAt(Math.floor(Math.random() * chars.length));
+    }
+    return result;
+}
+/**
+ * 문자열 반복
+ * @example repeat('ab', 3) // 'ababab'
+ */
+export function repeat(str, count) {
+    return str.repeat(count);
+}
+/**
+ * 문자열 뒤집기
+ * @example reverse('hello') // 'olleh'
+ */
+export function reverse(str) {
+    return str.split('').reverse().join('');
+}
+/**
+ * 문자열에서 HTML 태그 제거
+ * @example stripHtml('<p>Hello <strong>World</strong></p>') // 'Hello World'
+ */
+export function stripHtml(str) {
+    return str.replace(/<[^>]*>/g, '');
+}
+/**
+ * 문자열을 특정 길이로 패딩
+ * @example padStart('5', 3, '0') // '005'
+ */
+export function padStart(str, length, fillString = ' ') {
+    return str.padStart(length, fillString);
+}
+/**
+ * 문자열을 특정 길이로 패딩 (오른쪽)
+ * @example padEnd('5', 3, '0') // '500'
+ */
+export function padEnd(str, length, fillString = ' ') {
+    return str.padEnd(length, fillString);
+}
+/**
+ * 템플릿 문자열 치환
+ * @example template('Hello {name}!', { name: 'World' }) // 'Hello World!'
+ */
+export function template(str, values) {
+    return str.replace(/\{(\w+)\}/g, (match, key) => {
+        return values[key] !== undefined ? String(values[key]) : match;
+    });
+}
+/**
+ * 마스킹 (특정 위치의 문자를 *로 변경)
+ * @example mask('1234567890', 3, 7) // '123****890'
+ */
+export function mask(str, start, end, maskChar = '*') {
+    const endPos = end ?? str.length;
+    return (str.slice(0, start) +
+        maskChar.repeat(endPos - start) +
+        str.slice(endPos));
+}

package/dist/string/validation.d.ts

@@ -0,0 +1,79 @@
+/**
+ * String Validation Utilities
+ */
+/**
+ * 빈 문자열 또는 공백만 있는지 확인
+ * @example isEmpty('') // true
+ * @example isEmpty('  ') // true
+ * @example isEmpty('hello') // false
+ */
+export declare function isEmpty(str: string): boolean;
+/**
+ * 문자열이 특정 문자로 시작하는지 확인
+ * @example startsWith('hello', 'he') // true
+ */
+export declare function startsWith(str: string, searchString: string): boolean;
+/**
+ * 문자열이 특정 문자로 끝나는지 확인
+ * @example endsWith('hello', 'lo') // true
+ */
+export declare function endsWith(str: string, searchString: string): boolean;
+/**
+ * 문자열에 특정 문자열이 포함되어 있는지 확인
+ * @example contains('hello world', 'world') // true
+ */
+export declare function contains(str: string, searchString: string): boolean;
+/**
+ * 알파벳만 포함하는지 확인
+ * @example isAlpha('hello') // true
+ * @example isAlpha('hello123') // false
+ */
+export declare function isAlpha(str: string): boolean;
+/**
+ * 숫자만 포함하는지 확인
+ * @example isNumeric('123') // true
+ * @example isNumeric('123.45') // false
+ */
+export declare function isNumeric(str: string): boolean;
+/**
+ * 알파벳과 숫자만 포함하는지 확인
+ * @example isAlphanumeric('hello123') // true
+ * @example isAlphanumeric('hello_123') // false
+ */
+export declare function isAlphanumeric(str: string): boolean;
+/**
+ * 소문자만 포함하는지 확인
+ * @example isLowerCase('hello') // true
+ * @example isLowerCase('Hello') // false
+ */
+export declare function isLowerCase(str: string): boolean;
+/**
+ * 대문자만 포함하는지 확인
+ * @example isUpperCase('HELLO') // true
+ * @example isUpperCase('Hello') // false
+ */
+export declare function isUpperCase(str: string): boolean;
+/**
+ * JSON 형식인지 확인
+ * @example isJSON('{"name":"John"}') // true
+ * @example isJSON('not json') // false
+ */
+export declare function isJSON(str: string): boolean;
+/**
+ * 16진수 색상 코드인지 확인
+ * @example isHexColor('#fff') // true
+ * @example isHexColor('#ffffff') // true
+ * @example isHexColor('fff') // false
+ */
+export declare function isHexColor(str: string): boolean;
+/**
+ * UUID 형식인지 확인
+ * @example isUUID('123e4567-e89b-12d3-a456-426614174000') // true
+ */
+export declare function isUUID(str: string): boolean;
+/**
+ * Base64 인코딩된 문자열인지 확인
+ * @example isBase64('SGVsbG8gV29ybGQ=') // true
+ */
+export declare function isBase64(str: string): boolean;
+//# sourceMappingURL=validation.d.ts.map

package/dist/string/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/string/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE5C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAErE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE5C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO3C;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE3C;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAM7C"}

package/dist/string/validation.js

@@ -0,0 +1,115 @@
+/**
+ * String Validation Utilities
+ */
+/**
+ * 빈 문자열 또는 공백만 있는지 확인
+ * @example isEmpty('') // true
+ * @example isEmpty('  ') // true
+ * @example isEmpty('hello') // false
+ */
+export function isEmpty(str) {
+    return !str || str.trim().length === 0;
+}
+/**
+ * 문자열이 특정 문자로 시작하는지 확인
+ * @example startsWith('hello', 'he') // true
+ */
+export function startsWith(str, searchString) {
+    return str.startsWith(searchString);
+}
+/**
+ * 문자열이 특정 문자로 끝나는지 확인
+ * @example endsWith('hello', 'lo') // true
+ */
+export function endsWith(str, searchString) {
+    return str.endsWith(searchString);
+}
+/**
+ * 문자열에 특정 문자열이 포함되어 있는지 확인
+ * @example contains('hello world', 'world') // true
+ */
+export function contains(str, searchString) {
+    return str.includes(searchString);
+}
+/**
+ * 알파벳만 포함하는지 확인
+ * @example isAlpha('hello') // true
+ * @example isAlpha('hello123') // false
+ */
+export function isAlpha(str) {
+    return /^[a-zA-Z]+$/.test(str);
+}
+/**
+ * 숫자만 포함하는지 확인
+ * @example isNumeric('123') // true
+ * @example isNumeric('123.45') // false
+ */
+export function isNumeric(str) {
+    return /^[0-9]+$/.test(str);
+}
+/**
+ * 알파벳과 숫자만 포함하는지 확인
+ * @example isAlphanumeric('hello123') // true
+ * @example isAlphanumeric('hello_123') // false
+ */
+export function isAlphanumeric(str) {
+    return /^[a-zA-Z0-9]+$/.test(str);
+}
+/**
+ * 소문자만 포함하는지 확인
+ * @example isLowerCase('hello') // true
+ * @example isLowerCase('Hello') // false
+ */
+export function isLowerCase(str) {
+    return str === str.toLowerCase() && str !== str.toUpperCase();
+}
+/**
+ * 대문자만 포함하는지 확인
+ * @example isUpperCase('HELLO') // true
+ * @example isUpperCase('Hello') // false
+ */
+export function isUpperCase(str) {
+    return str === str.toUpperCase() && str !== str.toLowerCase();
+}
+/**
+ * JSON 형식인지 확인
+ * @example isJSON('{"name":"John"}') // true
+ * @example isJSON('not json') // false
+ */
+export function isJSON(str) {
+    try {
+        JSON.parse(str);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 16진수 색상 코드인지 확인
+ * @example isHexColor('#fff') // true
+ * @example isHexColor('#ffffff') // true
+ * @example isHexColor('fff') // false
+ */
+export function isHexColor(str) {
+    return /^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$/.test(str);
+}
+/**
+ * UUID 형식인지 확인
+ * @example isUUID('123e4567-e89b-12d3-a456-426614174000') // true
+ */
+export function isUUID(str) {
+    return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(str);
+}
+/**
+ * Base64 인코딩된 문자열인지 확인
+ * @example isBase64('SGVsbG8gV29ybGQ=') // true
+ */
+export function isBase64(str) {
+    try {
+        return btoa(atob(str)) === str;
+    }
+    catch {
+        return false;
+    }
+}

package/package.json

@@ -1,18 +1,28 @@
 {
   "name": "goodchuck-utils",
-  "version": "1.1.0",
+  "version": "1.3.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": {
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./src/index.js"
+    },
+    "./hooks": {
+      "types": "./dist/hooks/index.d.ts",
+      "import": "./dist/hooks/index.js",
+      "require": "./src/hooks/index.js"
     }
   },
   "keywords": [],
@@ -21,9 +31,23 @@
   "description": "",
   "dependencies": {
     "@types/node": "^25.0.6",
+    "dayjs": "^1.11.19",
     "typescript": "^5.9.3"
   },
   "include": [
     "src/**/*.ts"
-  ]
+  ],
+  "devDependencies": {
+    "@types/react": "^19.2.8",
+    "@vitest/ui": "^4.0.16",
+    "vitest": "^4.0.16"
+  },
+  "peerDependencies": {
+    "react": ">=16.8.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  }
 }

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();
+}