From 510b4a9e688550faf8a0377a8346a0fdd31f6ccb Mon Sep 17 00:00:00 2001 From: kric_jspark Date: Wed, 1 Jul 2026 09:36:56 +0900 Subject: [PATCH] =?UTF-8?q?260701=5F03=5FENH:=20date,=20object,=20url=20ut?= =?UTF-8?q?il=20=EC=B6=94=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- package-lock.json | 4 +-- package.json | 2 +- src/date.ts | 62 +++++++++++++++++++++++++++++++++++++++++++++++ src/index.ts | 23 ++++-------------- src/object.ts | 27 +++++++++++++++++++++ src/string.ts | 19 +++++++++++++++ src/types.ts | 9 +++++++ src/url.ts | 39 +++++++++++++++++++++++++++++ 8 files changed, 164 insertions(+), 21 deletions(-) create mode 100644 src/date.ts create mode 100644 src/object.ts create mode 100644 src/string.ts create mode 100644 src/types.ts create mode 100644 src/url.ts diff --git a/package-lock.json b/package-lock.json index d1fd90f..79032eb 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "@kri/common", - "version": "0.1.1", + "version": "0.2.0", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "@kri/common", - "version": "0.1.1", + "version": "0.2.0", "license": "UNLICENSED", "devDependencies": { "typescript": "^6.0.3" diff --git a/package.json b/package.json index fd6423c..753c85a 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@kri/common", - "version": "0.1.1", + "version": "0.2.0", "description": "KRI 프런트엔드 공통 유틸리티", "type": "module", "main": "./dist/index.js", diff --git a/src/date.ts b/src/date.ts new file mode 100644 index 0000000..b0c6274 --- /dev/null +++ b/src/date.ts @@ -0,0 +1,62 @@ +export type DateTimeFormatOption = + | "date" + | "dateHour" + | "dateHourMin" + | "dateTime"; + +const KST_OFFSET_MS = 9 * 60 * 60 * 1000; + +function pad2(value: number): string { + return String(value).padStart(2, "0"); +} + +/** + * 날짜 값을 한국 표준시(KST) 문자열로 변환한다. + */ +export function formatKst( + input: string | number | Date | null | undefined, + option: DateTimeFormatOption = "dateTime", +): string { + if ( + input === null + || input === undefined + || input === "" + ) { + return ""; + } + + const date = input instanceof Date + ? input + : new Date(input); + + if (Number.isNaN(date.getTime())) { + return ""; + } + + const kstDate = new Date( + date.getTime() + KST_OFFSET_MS, + ); + + const year = kstDate.getUTCFullYear(); + const month = pad2(kstDate.getUTCMonth() + 1); + const day = pad2(kstDate.getUTCDate()); + const hour = pad2(kstDate.getUTCHours()); + const minute = pad2(kstDate.getUTCMinutes()); + const second = pad2(kstDate.getUTCSeconds()); + + const datePart = `${year}-${month}-${day}`; + + switch (option) { + case "date": + return datePart; + + case "dateHour": + return `${datePart} ${hour}`; + + case "dateHourMin": + return `${datePart} ${hour}:${minute}`; + + case "dateTime": + return `${datePart} ${hour}:${minute}:${second}`; + } +} \ No newline at end of file diff --git a/src/index.ts b/src/index.ts index f54bb1c..e050bc4 100644 --- a/src/index.ts +++ b/src/index.ts @@ -1,19 +1,6 @@ -/** - * 문자열이 null, undefined 또는 공백인지 확인한다. - */ -export function isBlank( - value: string | null | undefined, -): boolean { - return value === null - || value === undefined - || value.trim().length === 0; -} +export type * from "./types.js"; -/** - * 문자열에 공백이 아닌 문자가 있는지 확인한다. - */ -export function isNotBlank( - value: string | null | undefined, -): boolean { - return !isBlank(value); -} \ No newline at end of file +export * from "./object.js"; +export * from "./url.js"; +export * from "./date.js"; +export * from "./string.js"; \ No newline at end of file diff --git a/src/object.ts b/src/object.ts new file mode 100644 index 0000000..9b30821 --- /dev/null +++ b/src/object.ts @@ -0,0 +1,27 @@ +export function getKeyByValue< + const T extends Record, +>( + map: T, + value: T[keyof T], +): keyof T | undefined { + const entry = Object.entries(map).find( + ([, currentValue]) => currentValue === value, + ); + + return entry + ? (entry[0] as keyof T) + : undefined; +} + +export function getNumberKeyByValue( + map: Record, + value: string, +): number | undefined { + const entry = Object.entries(map).find( + ([, currentValue]) => currentValue === value, + ); + + return entry + ? Number(entry[0]) + : undefined; +} \ No newline at end of file diff --git a/src/string.ts b/src/string.ts new file mode 100644 index 0000000..f54bb1c --- /dev/null +++ b/src/string.ts @@ -0,0 +1,19 @@ +/** + * 문자열이 null, undefined 또는 공백인지 확인한다. + */ +export function isBlank( + value: string | null | undefined, +): boolean { + return value === null + || value === undefined + || value.trim().length === 0; +} + +/** + * 문자열에 공백이 아닌 문자가 있는지 확인한다. + */ +export function isNotBlank( + value: string | null | undefined, +): boolean { + return !isBlank(value); +} \ No newline at end of file diff --git a/src/types.ts b/src/types.ts new file mode 100644 index 0000000..f924cd2 --- /dev/null +++ b/src/types.ts @@ -0,0 +1,9 @@ +export type ValueOf = T[keyof T]; + +export type EnumLikeKey< + T extends Record, +> = keyof T; + +export type EnumLikeValue< + T extends Record, +> = ValueOf; \ No newline at end of file diff --git a/src/url.ts b/src/url.ts new file mode 100644 index 0000000..90e244f --- /dev/null +++ b/src/url.ts @@ -0,0 +1,39 @@ +export type QueryParameterValue = + | string + | string[] + | undefined; + +export type QueryParameters = + Record; + +export function buildUrlWithParams( + targetPath: string, + parameters: QueryParameters, + extra?: Record, +): string { + const searchParams = new URLSearchParams(); + + for (const [key, value] of Object.entries(parameters)) { + if (Array.isArray(value)) { + for (const item of value) { + searchParams.append(key, item); + } + } else if (value !== undefined) { + searchParams.set(key, value); + } + } + + if (extra) { + for (const [key, value] of Object.entries(extra)) { + if (value !== undefined) { + searchParams.set(key, value); + } + } + } + + const queryString = searchParams.toString(); + + return queryString + ? `${targetPath}?${queryString}` + : targetPath; +} \ No newline at end of file