maplestory-openapi 2.12.0 → 2.13.0

package/dist/index.mjs

@@ -7337,6 +7337,78 @@ class UnionArtifactDto {
     }
 }
 
+/**
+ * 유니온 챔피언 휘장 정보
+ */
+class UnionChampionBadgeInfoDto {
+    /**
+     * 유니온 챔피언 휘장 효과
+     */
+    stat;
+    constructor(obj) {
+        const { stat } = obj;
+        this.stat = stat;
+    }
+}
+
+/**
+ * 유니온 챔피언 상세 정보
+ */
+class UnionChampionInfoDto {
+    /**
+     * 유니온 챔피언 캐릭터 명
+     */
+    championName;
+    /**
+     * 유니온 챔피언 슬롯
+     */
+    championSlot;
+    /**
+     * 유니온 챔피언 등급
+     */
+    championGrade;
+    /**
+     * 유니온 챔피언 캐릭터의 직업
+     */
+    championClass;
+    /**
+     * 챔피언 휘장 효과
+     */
+    championBadgeInfo;
+    constructor(obj) {
+        const { champion_name, champion_slot, champion_grade, champion_class, champion_badge_info } = obj;
+        this.championName = champion_name;
+        this.championSlot = champion_slot;
+        this.championGrade = champion_grade;
+        this.championClass = champion_class;
+        this.championBadgeInfo = champion_badge_info.map((info) => new UnionChampionBadgeInfoDto(info));
+    }
+}
+
+/**
+ * 유니온 챔피언 정보
+ */
+class UnionChampionDto {
+    /**
+     * 조회 기준일
+     */
+    date;
+    /**
+     * 유니온 챔피언 정보
+     */
+    unionChampion;
+    /**
+     * 유니온 챔피언 휘장 정보
+     */
+    championBadgeTotalInfo;
+    constructor(obj) {
+        const { date, union_champion, champion_badge_total_info } = obj;
+        this.date = date ? new Date(date) : null;
+        this.unionChampion = union_champion.map((info) => new UnionChampionInfoDto(info));
+        this.championBadgeTotalInfo = champion_badge_total_info.map((info) => new UnionChampionBadgeInfoDto(info));
+    }
+}
+
 /**
  * 유니온 정보
  */
@@ -7614,73 +7686,6 @@ const errorMap = {
     ['OPENAPI00011']: MapleStoryApiErrorCode.OPENAPI00011,
 };
 
-/**
- * 유니온 챔피언 휘장 정보
- */
-class UnionChampionBadgeInfoDto {
-    /**
-     * 유니온 챔피언 휘장 효과
-     */
-    stat;
-    constructor(obj) {
-        const { stat } = obj;
-        this.stat = stat;
-    }
-}
-
-/**
- * 유니온 챔피언 상세 정보
- */
-class UnionChampionInfoDto {
-    /**
-     * 유니온 챔피언 슬롯
-     */
-    championSlot;
-    /**
-     * 유니온 챔피언 등급
-     */
-    championGrade;
-    /**
-     * 유니온 챔피언 캐릭터의 직업
-     */
-    championClass;
-    /**
-     * 챔피언 휘장 효과
-     */
-    championBadgeInfo;
-    constructor(obj) {
-        const { champion_slot, champion_grade, champion_class, champion_badge_info } = obj;
-        this.championSlot = champion_slot;
-        this.championGrade = champion_grade;
-        this.championClass = champion_class;
-        this.championBadgeInfo = champion_badge_info.map((info) => new UnionChampionBadgeInfoDto(info));
-    }
-}
-
-/**
- * 유니온 챔피언 정보
- */
-class UnionChampionDto {
-    /**
-     * 조회 기준일
-     */
-    date;
-    /**
-     * 유니온 챔피언 정보
-     */
-    unionChampion;
-    /**
-     * 유니온 챔피언 휘장 정보
-     */
-    championBadgeTotalInfo;
-    constructor(obj) {
-        const { date, union_champion, champion_badge_total_info } = obj;
-        this.date = date ? new Date(date) : null;
-        this.unionChampion = union_champion.map((info) => new UnionChampionInfoDto(info));
-        this.championBadgeTotalInfo = champion_badge_total_info.map((info) => new UnionChampionBadgeInfoDto(info));
-    }
-}
-
 dayjs.extend(timezone);
 dayjs.extend(utc);
 /**
@@ -7692,7 +7697,6 @@ class MapleStoryApi {
     client;
     static BASE_URL = 'https://open.api.nexon.com/';
     static DEFAULT_TIMEOUT = 5000;
-    static kstOffset = 540;
     get timeout() {
         return this.client.defaults.timeout;
     }
@@ -7759,11 +7763,11 @@ class MapleStoryApi {
     async getCharacterBasic(ocid, dateOptions) {
         const path = 'maplestory/v1/character/basic';
         const date = dateOptions
-            ? MapleStoryApi.toDateString({
+            ? toDateString(dateOptions, {
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions)
+            })
             : undefined;
         const query = {
             ocid: ocid,
@@ -7847,11 +7851,11 @@ class MapleStoryApi {
     async getCharacterPopularity(ocid, dateOptions) {
         const path = 'maplestory/v1/character/popularity';
         const date = dateOptions
-            ? MapleStoryApi.toDateString({
+            ? toDateString(dateOptions, {
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions)
+            })
             : undefined;
         const query = {
             ocid: ocid,
@@ -7875,11 +7879,11 @@ class MapleStoryApi {
     async getCharacterStat(ocid, dateOptions) {
         const path = 'maplestory/v1/character/stat';
         const date = dateOptions
-            ? MapleStoryApi.toDateString({
+            ? toDateString(dateOptions, {
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions)
+            })
             : undefined;
         const query = {
             ocid: ocid,
@@ -7903,11 +7907,11 @@ class MapleStoryApi {
     async getCharacterHyperStat(ocid, dateOptions) {
         const path = 'maplestory/v1/character/hyper-stat';
         const date = dateOptions
-            ? MapleStoryApi.toDateString({
+            ? toDateString(dateOptions, {
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions)
+            })
             : undefined;
         const query = {
             ocid: ocid,
@@ -7931,11 +7935,11 @@ class MapleStoryApi {
     async getCharacterPropensity(ocid, dateOptions) {
         const path = 'maplestory/v1/character/propensity';
         const date = dateOptions
-            ? MapleStoryApi.toDateString({
+            ? toDateString(dateOptions, {
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions)
+            })
             : undefined;
         const query = {
             ocid: ocid,
@@ -7959,11 +7963,11 @@ class MapleStoryApi {
     async getCharacterAbility(ocid, dateOptions) {
         const path = 'maplestory/v1/character/ability';
         const date = dateOptions
-            ? MapleStoryApi.toDateString({
+            ? toDateString(dateOptions, {
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions)
+            })
             : undefined;
         const query = {
             ocid: ocid,
@@ -7987,11 +7991,11 @@ class MapleStoryApi {
     async getCharacterItemEquipment(ocid, dateOptions) {
         const path = 'maplestory/v1/character/item-equipment';
         const date = dateOptions
-            ? MapleStoryApi.toDateString({
+            ? toDateString(dateOptions, {
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions)
+            })
             : undefined;
         const query = {
             ocid: ocid,
@@ -8015,11 +8019,11 @@ class MapleStoryApi {
     async getCharacterCashItemEquipment(ocid, dateOptions) {
         const path = 'maplestory/v1/character/cashitem-equipment';
         const date = dateOptions
-            ? MapleStoryApi.toDateString({
+            ? toDateString(dateOptions, {
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions)
+            })
             : undefined;
         const query = {
             ocid: ocid,
@@ -8043,11 +8047,11 @@ class MapleStoryApi {
     async getCharacterSymbolEquipment(ocid, dateOptions) {
         const path = 'maplestory/v1/character/symbol-equipment';
         const date = dateOptions
-            ? MapleStoryApi.toDateString({
+            ? toDateString(dateOptions, {
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions)
+            })
             : undefined;
         const query = {
             ocid: ocid,
@@ -8071,11 +8075,11 @@ class MapleStoryApi {
     async getCharacterSetEffect(ocid, dateOptions) {
         const path = 'maplestory/v1/character/set-effect';
         const date = dateOptions
-            ? MapleStoryApi.toDateString({
+            ? toDateString(dateOptions, {
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions)
+            })
             : undefined;
         const query = {
             ocid: ocid,
@@ -8098,13 +8102,16 @@ class MapleStoryApi {
      */
     async getCharacterBeautyEquipment(ocid, dateOptions) {
         const path = 'maplestory/v1/character/beauty-equipment';
-        const query = {
-            ocid: ocid,
-            date: dateOptions ? MapleStoryApi.toDateString({
+        const date = dateOptions
+            ? toDateString(dateOptions, {
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions) : undefined,
+            })
+            : undefined;
+        const query = {
+            ocid: ocid,
+            date: date,
         };
         const { data } = await this.client.get(path, {
             params: query,
@@ -8124,11 +8131,11 @@ class MapleStoryApi {
     async getCharacterAndroidEquipment(ocid, dateOptions) {
         const path = 'maplestory/v1/character/android-equipment';
         const date = dateOptions
-            ? MapleStoryApi.toDateString({
+            ? toDateString(dateOptions, {
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions)
+            })
             : undefined;
         const query = {
             ocid: ocid,
@@ -8152,11 +8159,11 @@ class MapleStoryApi {
     async getCharacterPetEquipment(ocid, dateOptions) {
         const path = 'maplestory/v1/character/pet-equipment';
         const date = dateOptions
-            ? MapleStoryApi.toDateString({
+            ? toDateString(dateOptions, {
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions)
+            })
             : undefined;
         const query = {
             ocid: ocid,
@@ -8192,11 +8199,11 @@ class MapleStoryApi {
     async getCharacterSkill(ocid, characterSkillGrade, dateOptions) {
         const path = 'maplestory/v1/character/skill';
         const date = dateOptions
-            ? MapleStoryApi.toDateString({
+            ? toDateString(dateOptions, {
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions)
+            })
             : undefined;
         const query = {
             ocid: ocid,
@@ -8221,11 +8228,11 @@ class MapleStoryApi {
     async getCharacterLinkSkill(ocid, dateOptions) {
         const path = 'maplestory/v1/character/link-skill';
         const date = dateOptions
-            ? MapleStoryApi.toDateString({
+            ? toDateString(dateOptions, {
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions)
+            })
             : undefined;
         const query = {
             ocid: ocid,
@@ -8249,11 +8256,11 @@ class MapleStoryApi {
     async getCharacterVMatrix(ocid, dateOptions) {
         const path = 'maplestory/v1/character/vmatrix';
         const date = dateOptions
-            ? MapleStoryApi.toDateString({
+            ? toDateString(dateOptions, {
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions)
+            })
             : undefined;
         const query = {
             ocid: ocid,
@@ -8277,11 +8284,11 @@ class MapleStoryApi {
     async getCharacterHexaMatrix(ocid, dateOptions) {
         const path = 'maplestory/v1/character/hexamatrix';
         const date = dateOptions
-            ? MapleStoryApi.toDateString({
+            ? toDateString(dateOptions, {
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions)
+            })
             : undefined;
         const query = {
             ocid: ocid,
@@ -8305,11 +8312,11 @@ class MapleStoryApi {
     async getCharacterHexaMatrixStat(ocid, dateOptions) {
         const path = 'maplestory/v1/character/hexamatrix-stat';
         const date = dateOptions
-            ? MapleStoryApi.toDateString({
+            ? toDateString(dateOptions, {
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions)
+            })
             : undefined;
         const query = {
             ocid: ocid,
@@ -8333,11 +8340,11 @@ class MapleStoryApi {
     async getCharacterDojang(ocid, dateOptions) {
         const path = 'maplestory/v1/character/dojang';
         const date = dateOptions
-            ? MapleStoryApi.toDateString({
+            ? toDateString(dateOptions, {
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions)
+            })
             : undefined;
         const query = {
             ocid: ocid,
@@ -8363,11 +8370,11 @@ class MapleStoryApi {
     async getUnion(ocid, dateOptions) {
         const path = 'maplestory/v1/user/union';
         const date = dateOptions
-            ? MapleStoryApi.toDateString({
+            ? toDateString(dateOptions, {
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions)
+            })
             : undefined;
         const query = {
             ocid: ocid,
@@ -8391,11 +8398,11 @@ class MapleStoryApi {
     async getUnionRaider(ocid, dateOptions) {
         const path = 'maplestory/v1/user/union-raider';
         const date = dateOptions
-            ? MapleStoryApi.toDateString({
+            ? toDateString(dateOptions, {
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions)
+            })
             : undefined;
         const query = {
             ocid: ocid,
@@ -8419,11 +8426,11 @@ class MapleStoryApi {
     async getUnionArtifact(ocid, dateOptions) {
         const path = 'maplestory/v1/user/union-artifact';
         const date = dateOptions
-            ? MapleStoryApi.toDateString({
+            ? toDateString(dateOptions, {
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions)
+            })
             : undefined;
         const query = {
             ocid: ocid,
@@ -8448,11 +8455,11 @@ class MapleStoryApi {
     async getUnionChampion(ocid, dateOptions) {
         const path = 'maplestory/v1/user/union-champion';
         const date = dateOptions
-            ? MapleStoryApi.toDateString({
+            ? toDateString(dateOptions, {
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions)
+            })
             : undefined;
         const query = {
             ocid: ocid,
@@ -8498,11 +8505,11 @@ class MapleStoryApi {
     async getGuildBasic(guildId, dateOptions) {
         const path = 'maplestory/v1/guild/basic';
         const date = dateOptions
-            ? MapleStoryApi.toDateString({
+            ? toDateString(dateOptions, {
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions)
+            })
             : undefined;
         const query = {
             oguild_id: guildId,
@@ -8522,16 +8529,16 @@ class MapleStoryApi {
             query.cursor = parameter;
         }
         else if (typeof parameter === 'object' || parameter === undefined) {
-            query.date = MapleStoryApi.toDateString({
-                year: 2023,
-                month: 12,
-                day: 27,
-            }, parameter ??
-                MapleStoryApi.getProperDefaultDateOptions({
+            query.date = toDateString(parameter ??
+                getProperDefaultDateOptions({
                     hour: 0,
                     minute: 0,
                     dateOffset: 0,
-                }));
+                }), {
+                year: 2023,
+                month: 12,
+                day: 27,
+            });
         }
         const { data } = await this.client.get(path, {
             params: query,
@@ -8547,15 +8554,11 @@ class MapleStoryApi {
             query.cursor = parameter;
         }
         else if (typeof parameter === 'object' || parameter === undefined) {
-            query.date = MapleStoryApi.toDateString({
-                year: 2022,
-                month: 11,
-                day: 25,
-            }, parameter ??
-                MapleStoryApi.getProperDefaultDateOptions({
-                    hour: 4,
+            query.date = toDateString(parameter ??
+                getProperDefaultDateOptions({
+                    hour: 0,
                     minute: 0,
-                    dateOffset: 1,
+                    dateOffset: 0,
                 }));
         }
         const { data } = await this.client.get(path, {
@@ -8572,16 +8575,16 @@ class MapleStoryApi {
             query.cursor = parameter;
         }
         else if (typeof parameter === 'object' || parameter === undefined) {
-            query.date = MapleStoryApi.toDateString({
+            query.date = toDateString(parameter ??
+                getProperDefaultDateOptions({
+                    hour: 0,
+                    minute: 0,
+                    dateOffset: 0,
+                }), {
                 year: 2024,
                 month: 1,
                 day: 25,
-            }, parameter ??
-                MapleStoryApi.getProperDefaultDateOptions({
-                    hour: 4,
-                    minute: 0,
-                    dateOffset: 1,
-                }));
+            });
         }
         const { data } = await this.client.get(path, {
             params: query,
@@ -8600,18 +8603,18 @@ class MapleStoryApi {
      * @param dateOptions 조회 기준일 (KST).
      *
      */
-    async getOverallRanking(filterOptions, dateOptions = MapleStoryApi.getProperDefaultDateOptions({
+    async getOverallRanking(filterOptions, dateOptions = getProperDefaultDateOptions({
         hour: 8,
         minute: 30,
         dateOffset: 0,
     })) {
         const path = 'maplestory/v1/ranking/overall';
         const query = {
-            date: MapleStoryApi.toDateString({
+            date: toDateString(dateOptions, {
                 year: 2023,
                 month: 12,
                 day: 22,
-            }, dateOptions),
+            }),
         };
         if (filterOptions) {
             const { worldName, worldType, characterClass, ocid, page } = filterOptions;
@@ -8635,18 +8638,18 @@ class MapleStoryApi {
      * @param filterOptions 검색 기준
      * @param dateOptions 조회 기준일 (KST)
      */
-    async getUnionRanking(filterOptions, dateOptions = MapleStoryApi.getProperDefaultDateOptions({
+    async getUnionRanking(filterOptions, dateOptions = getProperDefaultDateOptions({
         hour: 8,
         minute: 30,
         dateOffset: 0,
     })) {
         const path = 'maplestory/v1/ranking/union';
         const query = {
-            date: MapleStoryApi.toDateString({
+            date: toDateString(dateOptions, {
                 year: 2023,
                 month: 12,
                 day: 22,
-            }, dateOptions),
+            }),
         };
         if (filterOptions) {
             const { worldName, ocid, page } = filterOptions;
@@ -8668,18 +8671,18 @@ class MapleStoryApi {
      * @param filterOptions 검색 기준
      * @param dateOptions 조회 기준일 (KST)
      */
-    async getGuildRanking(filterOptions, dateOptions = MapleStoryApi.getProperDefaultDateOptions({
+    async getGuildRanking(filterOptions, dateOptions = getProperDefaultDateOptions({
         hour: 8,
         minute: 30,
         dateOffset: 0,
     })) {
         const path = 'maplestory/v1/ranking/guild';
         const query = {
-            date: MapleStoryApi.toDateString({
+            date: toDateString(dateOptions, {
                 year: 2023,
                 month: 12,
                 day: 22,
-            }, dateOptions),
+            }),
             ranking_type: 0,
         };
         if (filterOptions) {
@@ -8703,18 +8706,18 @@ class MapleStoryApi {
      * @param filterOptions 검색 기준
      * @param dateOptions 조회 기준일 (KST)
      */
-    async getDojangRanking(filterOptions, dateOptions = MapleStoryApi.getProperDefaultDateOptions({
+    async getDojangRanking(filterOptions, dateOptions = getProperDefaultDateOptions({
         hour: 8,
         minute: 30,
         dateOffset: 0,
     })) {
         const path = 'maplestory/v1/ranking/dojang';
         const query = {
-            date: MapleStoryApi.toDateString({
+            date: toDateString(dateOptions, {
                 year: 2023,
                 month: 12,
                 day: 22,
-            }, dateOptions),
+            }),
             difficulty: 0,
         };
         if (filterOptions) {
@@ -8739,18 +8742,18 @@ class MapleStoryApi {
      * @param filterOptions 검색 기준
      * @param dateOptions 조회 기준일 (KST)
      */
-    async getSeedRanking(filterOptions, dateOptions = MapleStoryApi.getProperDefaultDateOptions({
+    async getSeedRanking(filterOptions, dateOptions = getProperDefaultDateOptions({
         hour: 8,
         minute: 30,
         dateOffset: 0,
     })) {
         const path = 'maplestory/v1/ranking/theseed';
         const query = {
-            date: MapleStoryApi.toDateString({
+            date: toDateString(dateOptions, {
                 year: 2023,
                 month: 12,
                 day: 22,
-            }, dateOptions),
+            }),
         };
         if (filterOptions) {
             const { worldName, ocid, page } = filterOptions;
@@ -8772,18 +8775,18 @@ class MapleStoryApi {
      * @param filterOptions 검색 기준
      * @param dateOptions 조회 기준일 (KST)
      */
-    async getAchievementRanking(filterOptions, dateOptions = MapleStoryApi.getProperDefaultDateOptions({
+    async getAchievementRanking(filterOptions, dateOptions = getProperDefaultDateOptions({
         hour: 8,
         minute: 30,
         dateOffset: 0,
     })) {
         const path = 'maplestory/v1/ranking/achievement';
         const query = {
-            date: MapleStoryApi.toDateString({
+            date: toDateString(dateOptions, {
                 year: 2023,
                 month: 12,
                 day: 22,
-            }, dateOptions),
+            }),
         };
         if (filterOptions) {
             const { ocid, page } = filterOptions;
@@ -8946,52 +8949,54 @@ class MapleStoryApi {
         const xml = (await xml2js.parseStringPromise(response.data));
         return new InspectionInfoDto(xml);
     }
-    /**
-     * API 서버의 데이터 갱신 시간에 따라 데이터가 조회 가능한 최신 날짜를 반환합니다.
-     *
-     * @param options
-     * @private
-     */
-    static getProperDefaultDateOptions(options) {
-        const { hour, minute, dateOffset } = options;
-        const kstNow = dayjs().utcOffset(MapleStoryApi.kstOffset);
-        const updateDate = dayjs()
-            .utcOffset(MapleStoryApi.kstOffset)
-            .hour(hour)
-            .minute(minute);
-        let adjustedDate;
-        if (kstNow.isAfter(updateDate)) {
-            adjustedDate = kstNow;
-        }
-        else {
-            adjustedDate = kstNow.subtract(1, 'day');
-        }
-        adjustedDate = adjustedDate.subtract(dateOffset ?? 0, 'day');
-        return {
-            year: adjustedDate.year(),
-            month: adjustedDate.month() + 1,
-            day: adjustedDate.date(),
-        };
-    }
-    /**
-     * 날짜 정보를 API 서버에서 요구하는 포맷으로 변환합니다.
-     *
-     * @param minDateOptions API 호출 가능한 최소 날짜
-     * @param dateOptions 조회 하려는 날짜
-     * @private
-     */
-    static toDateString(minDateOptions, dateOptions) {
+}
+const KST_OFFSET = 540;
+/**
+ * API 서버의 데이터 갱신 시간에 따라 데이터가 조회 가능한 최신 날짜를 반환합니다.
+ *
+ * @param options
+ */
+const getProperDefaultDateOptions = (options) => {
+    const { hour, minute, dateOffset } = options;
+    const kstNow = dayjs().utcOffset(KST_OFFSET);
+    const updateDate = dayjs()
+        .utcOffset(KST_OFFSET)
+        .hour(hour)
+        .minute(minute);
+    let adjustedDate;
+    if (kstNow.isAfter(updateDate)) {
+        adjustedDate = kstNow;
+    }
+    else {
+        adjustedDate = kstNow.subtract(1, 'day');
+    }
+    adjustedDate = adjustedDate.subtract(dateOffset ?? 0, 'day');
+    return {
+        year: adjustedDate.year(),
+        month: adjustedDate.month() + 1,
+        day: adjustedDate.date(),
+    };
+};
+/**
+ * 날짜 정보를 API 서버에서 요구하는 포맷으로 변환합니다.
+ *
+ * @param dateOptions 조회 하려는 날짜
+ * @param minDateOptions API 호출 가능한 최소 날짜
+ */
+const toDateString = (dateOptions, minDateOptions) => {
+    const { year, month, day } = dateOptions;
+    const str = dayjs(`${year}-${month}-${day}`)
+        .utcOffset(KST_OFFSET)
+        .format('YYYY-MM-DD');
+    if (minDateOptions) {
         const { year: minYear, month: minMonth, day: minDay } = minDateOptions;
-        const { year, month, day } = dateOptions;
         if (year < minYear ||
             (year === minYear && month < minMonth) ||
             (year === minYear && month === minMonth && day < minDay)) {
             throw new Error(`You can only retrieve data after ${dayjs(`${minYear}-${minMonth}-${minDay}`).format('YYYY-MM-DD')}.`);
         }
-        return dayjs(`${year}-${month}-${day}`)
-            .utcOffset(MapleStoryApi.kstOffset)
-            .format('YYYY-MM-DD');
     }
-}
+    return str;
+};
 
 export { AchievementRankingDto, AchievementRankingResponseDto, CashshopNoticeDetailDto, CashshopNoticeListDto, CashshopNoticeListItemDto, CharacterAbilityDto, CharacterAbilityInfoDto, CharacterAbilityPresetDto, CharacterAndroidCashItemEquipmentColoringPrismDto, CharacterAndroidCashItemEquipmentDto, CharacterAndroidCashItemEquipmentOptionDto, CharacterAndroidEquipmentDto, CharacterAndroidEquipmentFaceDto, CharacterAndroidEquipmentHairDto, CharacterAndroidEquipmentPresetDto, CharacterBasicDto, CharacterBeautyEquipmentDto, CharacterBeautyEquipmentFaceDto, CharacterBeautyEquipmentHairDto, CharacterCashItemEquipmentColoringPrismDto, CharacterCashItemEquipmentDto, CharacterCashItemEquipmentOptionDto, CharacterCashItemEquipmentPresetDto, CharacterDojangDto, CharacterDto, CharacterHexaMatrixDto, CharacterHexaMatrixEquipmentDto, CharacterHexaMatrixEquipmentLinkedSkillDto, CharacterHexaMatrixStatCoreDto, CharacterHexaMatrixStatDto, CharacterHyperStatDto, CharacterHyperStatPresetDto, CharacterImageAction, CharacterImageDto, CharacterImageEmotion, CharacterImageWeaponMotion, CharacterItemEquipmentAddOptionDto, CharacterItemEquipmentBaseOptionDto, CharacterItemEquipmentDragonInfoDto, CharacterItemEquipmentDto, CharacterItemEquipmentEtcOptionDto, CharacterItemEquipmentExceptionalOptionDto, CharacterItemEquipmentInfoDto, CharacterItemEquipmentMechanicInfoDto, CharacterItemEquipmentStarforceOptionDto, CharacterItemEquipmentTitleDto, CharacterItemEquipmentTotalOptionDto, CharacterLinkSkillDto, CharacterLinkSkillInfoDto, CharacterListAccountCharacterDto, CharacterListAccountDto, CharacterListDto, CharacterPetEquipmentAutoSkillDto, CharacterPetEquipmentDto, CharacterPetEquipmentItemDto, CharacterPetEquipmentItemOptionDto, CharacterPopularityDto, CharacterPropensityDto, CharacterSetEffectDto, CharacterSetEffectInfoDto, CharacterSetEffectOptionFullDto, CharacterSetEffectSetDto, CharacterSkillDto, CharacterSkillInfoDto, CharacterStatDto, CharacterSymbolEquipmentDto, CharacterSymbolEquipmentInfoDto, CharacterVMatrixCodeEquipmentDto, CharacterVMatrixDto, CubeHistoryDto, CubeHistoryResponseDto, CubeResultOptionDto, DojangRankingDto, DojangRankingResponseDto, EventNoticeDetailDto, EventNoticeListDto, EventNoticeListItemDto, GuildBasicDto, GuildDto, GuildRankingDto, GuildRankingResponseDto, GuildSkillDto, InspectionInfoDto, MapleStoryApi, MapleStoryApiError, MapleStoryApiErrorCode, NoticeDetailDto, NoticeListDto, NoticeListItemDto, OverallRankingDto, OverallRankingResponseDto, PotentialHistoryDto, PotentialHistoryResponseDto, PotentialOptionGrade, PotentialResultOptionDto, StarforceEventDto, StarforceHistoryDto, StarforceHistoryResponseDto, TheSeedRankingDto, TheSeedRankingResponseDto, UnionArtifactCrystalDto, UnionArtifactDto, UnionArtifactEffectDto, UnionDto, UnionRaiderBlockControlPointDto, UnionRaiderBlockDto, UnionRaiderBlockPositionDto, UnionRaiderDto, UnionRaiderInnerStatDto, UnionRaiderPresetDto, UnionRankingDto, UnionRankingResponseDto, UpdateNoticeDetailDto, UpdateNoticeListDto, UpdateNoticeListItemDto, potentialOptionGradeFromString };