@3o3/date 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# @3o3/date
+
+## 0.1.0
+
+### Minor Changes
+
+- cc4afa6: 0.0.1 version
+
+### Patch Changes
+
+- Updated dependencies [cc4afa6]
+  - @3o3/utils@0.1.0

package/dist/date.d.ts

@@ -0,0 +1,28 @@
+/** @3o3docs-ignore */
+import { Locale } from 'date-fns';
+export declare type DateFnsDateType = number | Date;
+/** @Description 입력받은 문자열을 Date로 변환합니다*/
+export declare function parseDateString(dateString: string): Date;
+/** @description 월 일 요일을 표기합니다. */
+export declare const formatMMdEEE: (date: string) => string;
+/** @description 월 일 요일을 표기합니다. */
+export declare const formatYYYYMMdEEE: (date: string) => string;
+export declare function formatDateTime(dateTimeString: string): string;
+/** @description 원하는 date-dns에서 지원하는 format에 대응하는 값으로 파싱하는 함수입니다. */
+export declare const format: (date: DateFnsDateType, format: string, _local?: Locale) => string;
+/** @description 유효한 년도인지 체크하는 함수입니다. */
+export declare function isValidYear(value: string | number): boolean;
+/** @description 유효한 월인지 체크하는 함수입니다. */
+export declare function isValidMonth(value: string | number): boolean;
+/** @description 유효한 월인지 체크하는 함수입니다. */
+export declare function isValidDayOfMonth(value: string | number): boolean;
+/** @Decription 1년 52주중 몇번째 주인지 (년도+몇주) 반환하는 함수입니다. */
+export declare const getYearWeekNumber: (date: number | Date, weekStartsOn: 0 | 1 | 2 | 3 | 4 | 5 | 6, firstWeekContainsDate: 1 | 2 | 3 | 4 | 5 | 6 | 7) => string;
+/** @description 날짜, 시간, 분, 초, isoTime 등을 세부적으로 나눠서 반환하는 함수입니다. */
+export declare function getDateDetails(date: Date): {
+    isoTime: string;
+    days: string;
+    months: string;
+    hours: string;
+    isDownTime: boolean;
+};

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+/** @3o3docs-ignore */
+export * from './date';

package/dist/index.js

@@ -0,0 +1,114 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var dateFns = require('date-fns');
+var utils = require('@3o3/utils');
+var locale = require('date-fns/locale/ko/index.js');
+
+function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
+
+var locale__default = /*#__PURE__*/_interopDefaultLegacy(locale);
+
+/** @3o3docs-ignore */
+/** @Description 입력받은 문자열을 Date로 변환합니다*/
+function parseDateString(dateString) {
+  var date = new Date(dateString);
+  if (dateFns.isValid(date)) {
+    return date;
+  }
+  throw new Error('Invalid date format');
+}
+
+/** @description 월 일 요일을 표기합니다. */
+var formatMMdEEE = function formatMMdEEE(date) {
+  if (utils.isBlank(date)) {
+    return '-';
+  }
+  var _date = parseDateString(date.replace(/-/g, '/'));
+  return format(_date, 'MM월 d일 EEE');
+};
+
+/** @description 월 일 요일을 표기합니다. */
+var formatYYYYMMdEEE = function formatYYYYMMdEEE(date) {
+  if (utils.isBlank(date)) {
+    return '-';
+  }
+  var _date = parseDateString(date.replace(/-/g, '/'));
+  return format(_date, 'yyyy년 MM월 d일 EEE');
+};
+function formatDateTime(dateTimeString) {
+  if (utils.isBlank(dateTimeString)) {
+    return '-';
+  }
+  var _date = parseDateString(dateTimeString.trim().replace(/\//g, '-').replace(/\s/, 'T'));
+  return format(dateFns.parseISO(_date.toISOString()), 'yyyy-MM-dd HH:mm');
+}
+
+/** @description 원하는 date-dns에서 지원하는 format에 대응하는 값으로 파싱하는 함수입니다. */
+var format = function format(date, _format2, _local) {
+  return dateFns.format(date, _format2, {
+    locale: _local !== null && _local !== void 0 ? _local : locale__default["default"]
+  });
+};
+
+/** @description 유효한 년도인지 체크하는 함수입니다. */
+function isValidYear(value) {
+  var year = Number(value);
+  if (isNaN(year)) {
+    return false;
+  }
+  return year >= 1900 && year <= 2099;
+}
+
+/** @description 유효한 월인지 체크하는 함수입니다. */
+function isValidMonth(value) {
+  var month = Number(value);
+  if (isNaN(month)) {
+    return false;
+  }
+  return month > 0 && month <= 12;
+}
+
+/** @description 유효한 월인지 체크하는 함수입니다. */
+function isValidDayOfMonth(value) {
+  var dayOfMonth = Number(value);
+  if (isNaN(dayOfMonth)) {
+    return false;
+  }
+  return dayOfMonth > 0 && dayOfMonth <= 31;
+}
+
+/** @Decription 1년 52주중 몇번째 주인지 (년도+몇주) 반환하는 함수입니다. */
+var getYearWeekNumber = function getYearWeekNumber(date, weekStartsOn, firstWeekContainsDate) {
+  return dateFns.getYear(date).toString() + dateFns.getWeek(new Date(date), {
+    weekStartsOn: weekStartsOn,
+    firstWeekContainsDate: firstWeekContainsDate
+  });
+};
+
+/** @description 날짜, 시간, 분, 초, isoTime 등을 세부적으로 나눠서 반환하는 함수입니다. */
+function getDateDetails(date) {
+  var isoTime = dateFns.formatISO(date);
+  var days = dateFns.format(date, 'd');
+  var months = dateFns.format(date, 'L');
+  var hours = dateFns.format(date, 'H');
+  return {
+    isoTime: isoTime,
+    days: days,
+    months: months,
+    hours: hours,
+    isDownTime: Number(hours) > 23 || Number(hours) < 9
+  };
+}
+
+exports.format = format;
+exports.formatDateTime = formatDateTime;
+exports.formatMMdEEE = formatMMdEEE;
+exports.formatYYYYMMdEEE = formatYYYYMMdEEE;
+exports.getDateDetails = getDateDetails;
+exports.getYearWeekNumber = getYearWeekNumber;
+exports.isValidDayOfMonth = isValidDayOfMonth;
+exports.isValidMonth = isValidMonth;
+exports.isValidYear = isValidYear;
+exports.parseDateString = parseDateString;

package/esm/date.mjs

@@ -0,0 +1,97 @@
+import { isValid, parseISO, format as format$1, getYear, getWeek, formatISO } from 'date-fns';
+import { isBlank } from '@3o3/utils';
+import locale from 'date-fns/locale/ko/index.js';
+
+/** @3o3docs-ignore */
+/** @Description 입력받은 문자열을 Date로 변환합니다*/
+function parseDateString(dateString) {
+  var date = new Date(dateString);
+  if (isValid(date)) {
+    return date;
+  }
+  throw new Error('Invalid date format');
+}
+
+/** @description 월 일 요일을 표기합니다. */
+var formatMMdEEE = function formatMMdEEE(date) {
+  if (isBlank(date)) {
+    return '-';
+  }
+  var _date = parseDateString(date.replace(/-/g, '/'));
+  return format(_date, 'MM월 d일 EEE');
+};
+
+/** @description 월 일 요일을 표기합니다. */
+var formatYYYYMMdEEE = function formatYYYYMMdEEE(date) {
+  if (isBlank(date)) {
+    return '-';
+  }
+  var _date = parseDateString(date.replace(/-/g, '/'));
+  return format(_date, 'yyyy년 MM월 d일 EEE');
+};
+function formatDateTime(dateTimeString) {
+  if (isBlank(dateTimeString)) {
+    return '-';
+  }
+  var _date = parseDateString(dateTimeString.trim().replace(/\//g, '-').replace(/\s/, 'T'));
+  return format(parseISO(_date.toISOString()), 'yyyy-MM-dd HH:mm');
+}
+
+/** @description 원하는 date-dns에서 지원하는 format에 대응하는 값으로 파싱하는 함수입니다. */
+var format = function format(date, _format2, _local) {
+  return format$1(date, _format2, {
+    locale: _local !== null && _local !== void 0 ? _local : locale
+  });
+};
+
+/** @description 유효한 년도인지 체크하는 함수입니다. */
+function isValidYear(value) {
+  var year = Number(value);
+  if (isNaN(year)) {
+    return false;
+  }
+  return year >= 1900 && year <= 2099;
+}
+
+/** @description 유효한 월인지 체크하는 함수입니다. */
+function isValidMonth(value) {
+  var month = Number(value);
+  if (isNaN(month)) {
+    return false;
+  }
+  return month > 0 && month <= 12;
+}
+
+/** @description 유효한 월인지 체크하는 함수입니다. */
+function isValidDayOfMonth(value) {
+  var dayOfMonth = Number(value);
+  if (isNaN(dayOfMonth)) {
+    return false;
+  }
+  return dayOfMonth > 0 && dayOfMonth <= 31;
+}
+
+/** @Decription 1년 52주중 몇번째 주인지 (년도+몇주) 반환하는 함수입니다. */
+var getYearWeekNumber = function getYearWeekNumber(date, weekStartsOn, firstWeekContainsDate) {
+  return getYear(date).toString() + getWeek(new Date(date), {
+    weekStartsOn: weekStartsOn,
+    firstWeekContainsDate: firstWeekContainsDate
+  });
+};
+
+/** @description 날짜, 시간, 분, 초, isoTime 등을 세부적으로 나눠서 반환하는 함수입니다. */
+function getDateDetails(date) {
+  var isoTime = formatISO(date);
+  var days = format$1(date, 'd');
+  var months = format$1(date, 'L');
+  var hours = format$1(date, 'H');
+  return {
+    isoTime: isoTime,
+    days: days,
+    months: months,
+    hours: hours,
+    isDownTime: Number(hours) > 23 || Number(hours) < 9
+  };
+}
+
+export { format, formatDateTime, formatMMdEEE, formatYYYYMMdEEE, getDateDetails, getYearWeekNumber, isValidDayOfMonth, isValidMonth, isValidYear, parseDateString };

package/esm/index.mjs

@@ -0,0 +1 @@
+export { format, formatDateTime, formatMMdEEE, formatYYYYMMdEEE, getDateDetails, getYearWeekNumber, isValidDayOfMonth, isValidMonth, isValidYear, parseDateString } from './date.mjs';

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@3o3/date",
+  "version": "0.1.0",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "import": "./esm/index.mjs",
+      "types": "./dist/index.d.ts"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "esm"
+  ],
+  "scripts": {
+    "build": "rm -rf dist esm && tsc --declaration --emitDeclarationOnly --declarationDir dist && rollup -c rollup.config.js",
+    "prepack": "yarn build",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@3o3/utils": "^0.1.0",
+    "date-fns": "^2.25.0"
+  },
+  "devDependencies": {
+    "@3o3/rollup-config": "^0.1.0",
+    "@babel/core": "^7",
+    "@babel/plugin-proposal-class-properties": "^7.14.5",
+    "@babel/plugin-proposal-nullish-coalescing-operator": "^7.14.5",
+    "@babel/plugin-proposal-optional-chaining": "^7.14.5",
+    "@babel/preset-env": "^7.14.8",
+    "@babel/preset-typescript": "^7.18.6",
+    "@rollup/plugin-babel": "^5.3.1",
+    "@rollup/plugin-commonjs": "^22.0.1",
+    "@rollup/plugin-json": "^4.1.0",
+    "@rollup/plugin-node-resolve": "^13.3.0",
+    "@types/babel__core": "^7",
+    "@types/babel__preset-env": "^7",
+    "@types/jest": "^28.1.8",
+    "@types/node": "^14.0.23",
+    "babel-jest": "^29.0.1",
+    "builtin-modules": "^3.1.0",
+    "date-fns": "^2.25.0",
+    "jest": "^29.0.1",
+    "jest-environment-jsdom": "^28.1.1",
+    "jest-mock": "^27.4.2",
+    "rollup": "^2.77.0",
+    "tslib": "^2.0.0",
+    "typescript": "4.8.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": {
+        "require": "./dist/index.js",
+        "import": "./esm/index.mjs",
+        "types": "./dist/index.d.ts"
+      },
+      "./package.json": "./package.json"
+    },
+    "import": "./esm/index.mjs",
+    "main": "./dist/index.js",
+    "module": "./esm/index.mjs",
+    "types": "./dist/index.d.ts"
+  },
+  "module": "./esm/index.mjs"
+}