mLua · Nemotron-CC 리프레이즈 (CPT)

[task] | diverse_qa [title] | 날짜와 시간 활용하기 [category] | Guides [rephrased] | 질문: "g" 또는 "gg" 사용자 지정 서식 지정자는 무엇을 나타내며, 기본 출력 값은 무엇인가요? 답변: "g" 또는 "gg" 사용자 지정 서식 지정자는 연대를 나타내며, 기본적으로 A.D(Anno Domini, 기원후)로 나타납니다. 질문: "g" 사용자 지정 서식 지정자를 단독으로 사용할 때 주의해야 할 점은 무엇인가요? 답변: 표준 서식 문자열로 잘못 해석되지 않도록 앞에 "%" 사용자 지정 서식 지정자를 사용해야 합니다. 질문: 다음 코드의 출력 결과는 무엇인가요? ```lua local date = DateTime( [original] | "g" 또는 "gg" 사용자 지정 서식 지정자는 연대를 나타냅니다. 기본적으로 A.D(Anno Domini, 기원후)로 나타납니다. "g" 사용자 지정 서식 지정자만 단독으로 사용하는 경우 표준 서식 문자열로 잘못 해석되지 않도록 앞에 "%" 사용자 지정 서식 지정자를 사용해야 합니다. ```lua local date = DateTime(2022, 8, 29, 19, 27, 15, 023) log(date:ToFormattedString("%g")) -- A.D. ``` #### "h" "h" 사용자 지정 서식 지정자는 시간 [chunk_id] | Guides:691:7

[task] | knowledge_list [title] | DataStorage 활용하기 [category] | Guides [rephrased] | * DataStorage는 `GlobalDataStorage`, `UserDataStorage`, `CreatorDataStorage`, `SortableDataStorage`의 4가지 종류로 구분되며, 각 스토리지는 독립적이므로 식별자를 공유하지 않고, 종류가 다르면 동일한 이름이라도 별개의 데이터 스토리지로 취급됩니다. * `GlobalDataStorage`, `UserDataStorage`, `CreatorDataStorage`는 `string` 타입의 값만 저장할 수 있으며, `SortableDataStorage`는 [original] | # 학습 과정 소개 이 가이드는 [Data DB 저장 및 불러오기](/docs/?postId=68)와 병행 학습을 권장합니다. "Data DB 저장 및 불러오기"에서는 간편하게 데이터를 생성, 저장, 불러오는 기능 위주로 살펴보았습니다. 이번 가이드에서는 DataStorageService의 다양한 함수를 통해 데이터를 증가시키거나, 페이지를 가지고 오는 등 크리에이터의 목적에 맞게 데이터를 활용하는 방법을 알아봅시다. ##### 참고 가이드 * [DataStorage 사용량 제한 알아보기](/docs?postId=1044) * [ [chunk_id] | Guides:692:0

[task] | diverse_qa [title] | 날짜와 시간 활용하기 [category] | Guides [rephrased] | 질문: `"mm"` 사용자 지정 서식 지정자는 무엇을 나타내며, 한 자릿수 분일 때 어떻게 표시됩니까? 답변: `"mm"` 사용자 지정 서식 지정자는 분을 00부터 59까지의 숫자로 나타내며, 분은 마지막 시간 이후 경과한 총 분 수를 의미합니다. 분이 한 자릿수인 경우 십의 자리는 0으로 표시됩니다. 질문: 다음 코드에서 `log(date:ToFormattedString("mm"))`의 출력 결과는 무엇입니까? ```lua local date = DateTime(2022, 8, 29, 19, 7, 15, 023) log(date [original] | "mm" 사용자 지정 서식 지정자는 분을 00부터 59까지의 숫자로 나타냅니다. 분은 마지막 시간 이후 경과한 총 분 수를 나타냅니다. 분이 한 자릿수인 경우 십의 자리는 0으로 표시됩니다. ```lua local date = DateTime(2022, 8, 29, 19, 7, 15, 023) log(date:ToFormattedString("mm")) -- 07 ``` #### "M" "M" 사용자 지정 서식 지정자는 월을 1부터 12까지의 숫자로 나타냅니다. 월이 한 자릿수인 경우 십의 자리는 표시되지 않습니다. "M" 사용 [chunk_id] | Guides:691:8

[task] | wikipedia [title] | 날짜와 시간 활용하기 [category] | Guides [rephrased] | DateTime 객체의 `ToFormattedString` 메서드는 사용자 지정 서식 문자열을 인수로 받아 날짜와 시간을 형식화된 문자열로 반환합니다. 이 과정에서 "mm", "M", "MM", "MMM", "MMMM", "s", "ss", "t"와 같은 사용자 지정 서식 지정자를 활용할 수 있으며, 각 지정자는 특정 시간 단위를 정해진 규칙으로 출력합니다. "mm" 지정자는 분을 00부터 59까지의 숫자로 표시합니다. 여기서 분은 마지막 시간 이후 경과한 총 분수를 의미하며, 값이 한 자릿수인 경우 십의 자리에 0이 표시됩니다. [original] | "mm" 사용자 지정 서식 지정자는 분을 00부터 59까지의 숫자로 나타냅니다. 분은 마지막 시간 이후 경과한 총 분 수를 나타냅니다. 분이 한 자릿수인 경우 십의 자리는 0으로 표시됩니다. ```lua local date = DateTime(2022, 8, 29, 19, 7, 15, 023) log(date:ToFormattedString("mm")) -- 07 ``` #### "M" "M" 사용자 지정 서식 지정자는 월을 1부터 12까지의 숫자로 나타냅니다. 월이 한 자릿수인 경우 십의 자리는 표시되지 않습니다. "M" 사용 [chunk_id] | Guides:691:8

[task] | distill [title] | 날짜와 시간 활용하기 [category] | Guides [rephrased] | ### DateTime 서식 지정자 `DateTime` 객체의 `ToFormattedString(format)` 메서드에서 사용할 수 있는 사용자 지정 서식 지정자입니다. 단독으로 사용되는 `y`, `:`, `/`는 표준 서식 문자열로 오해되지 않도록 앞에 `%`를 붙여야 합니다. #### "tt" AM/PM 지정자를 나타냅니다. - **AM**: 00:00:00 ~ 11:59:59.999 - **PM**: 12:00:00 ~ 23:59:59.999 ```lua local date = DateTime(2022, 8, 29, 1 [original] | "tt" 사용자 지정 서식 지정자는 AM/PM 지정자를 나타냅니다. AM 지정자는 0:00:00부터 11:59:59.999까지의 모든 시간에 사용되고 PM 지정자는 12:00:00부터 23:59:59.999까지의 모든 시간에 사용됩니다. ```lua local date = DateTime(2022, 8, 29, 19, 7, 5, 023) log(date:ToFormattedString("tt")) -- PM ``` #### "y" "y" 사용자 지정 서식 지정자는 연도를 한자리 또는 두 자리 숫자로 나타냅니다. 연도가 두 자리를 [chunk_id] | Guides:691:9

[task] | extract_knowledge [title] | 날짜와 시간 활용하기 [category] | Guides [rephrased] | # 날짜와 시간 서식 지정자: 날짜, 요일, 밀리초 표현 mLua에서는 `DateTime` 객체의 `ToFormattedString` 메서드를 통해 사용자 지정 서식 지정자(Custom Format Specifier)를 사용하여 날짜와 시간을 특정 형식으로 문자열 변환할 수 있습니다. 이 절에서는 날짜의 '일', '요일', 그리고 '소수점 이하 시간(밀리초)'을 표현하는 서식 지정자(`dd`, `ddd`, `dddd`, `f`, `ff`, `fff`, `F`, `FF`, `FFF`)의 동작 원리와 사용법을 다룹니다. ## 1. [original] | "dd" 사용자 지정 서식 지정자는 일을 01부터 31까지의 숫자로 나타냅니다. 일이 한 자릿수인 경우 십의 자리에는 0이 표시됩니다. ```lua local date = DateTime(2022, 8, 9, 19, 27, 15) log(date:ToFormattedString("dd")) -- 09 ``` #### "ddd" "ddd" 사용자 지정 서식 지정자는 요일의 약식 이름을 나타냅니다. 문화권을 지정하면, 문화권에 해당하는 약식 요일이 나타납니다. ```lua local date = DateTime(2022, 8, [chunk_id] | Guides:691:6

[task] | wikipedia [title] | 날짜와 시간 활용하기 [category] | Guides [rephrased] | # 날짜와 시간 서식 지정자 (mLua) mLua의 `DateTime` 타입은 `ToFormattedString` 메서드를 통해 특정 서식 문자열을 인수로 받아 날짜와 시간 정보를 문자열로 변환합니다. 이 과정에서 사용 가능한 사용자 지정 서식 지정자(custom format specifier)는 다음과 같습니다. ### AM/PM 지정자 ("tt") `"tt"` 지정자는 AM 또는 PM을 나타냅니다. AM은 00:00:00부터 11:59:59.999까지의 시간 범위에, PM은 12:00:00부터 23:59:59.999까지의 [original] | "tt" 사용자 지정 서식 지정자는 AM/PM 지정자를 나타냅니다. AM 지정자는 0:00:00부터 11:59:59.999까지의 모든 시간에 사용되고 PM 지정자는 12:00:00부터 23:59:59.999까지의 모든 시간에 사용됩니다. ```lua local date = DateTime(2022, 8, 29, 19, 7, 5, 023) log(date:ToFormattedString("tt")) -- PM ``` #### "y" "y" 사용자 지정 서식 지정자는 연도를 한자리 또는 두 자리 숫자로 나타냅니다. 연도가 두 자리를 [chunk_id] | Guides:691:9

[task] | distill [title] | DataStorage 활용하기 [category] | Guides [rephrased] | # DB DataStorage 활용하기 ## Pages 객체 `GlobalDataStoragePages`, `SortableDataStoragePages`, `UserDataStoragePages`, `DataStorageItemPages`, `SortableDataStorageItemPages`, `DataStorageVersionPages`는 DataStorage 정보를 조회하는 객체입니다. - **공통 프로퍼티**: `IsLastPages` - **공통 함수**: `GetCurrentPageDatas()`, `MoveToNe [original] | [GlobalDataStoragePages](/apiReference?postId=709), [SortableDataStoragePages](/apiReference?postId=713), [UserDataStoragePages](/apiReference?postId=717), [DataStorageItemPages](/apiReference?postId=703), [SortableDataStorageItemPages](/apiReference?postId=712), [DataStorageVersionPages](/apiRefere [chunk_id] | Guides:692:2

[task] | diverse_qa [title] | DataStorage 활용하기 [category] | Guides [rephrased] | 질문: DataStorage는 총 몇 가지 종류로 구분되나요? 답변: DataStorage는 GlobalDataStorage, UserDataStorage, CreatorDataStorage, SortableDataStorage 총 4가지 종류로 구분됩니다. 질문: GlobalDataStorage와 SortableDataStorage를 제외한 나머지 두 가지 DataStorage의 이름은 무엇인가요? 답변: 나머지 두 가지 DataStorage는 UserDataStorage와 CreatorDataStorage입니다. 질문: Gl [original] | # 학습 과정 소개 이 가이드는 [Data DB 저장 및 불러오기](/docs/?postId=68)와 병행 학습을 권장합니다. "Data DB 저장 및 불러오기"에서는 간편하게 데이터를 생성, 저장, 불러오는 기능 위주로 살펴보았습니다. 이번 가이드에서는 DataStorageService의 다양한 함수를 통해 데이터를 증가시키거나, 페이지를 가지고 오는 등 크리에이터의 목적에 맞게 데이터를 활용하는 방법을 알아봅시다. ##### 참고 가이드 * [DataStorage 사용량 제한 알아보기](/docs?postId=1044) * [ [chunk_id] | Guides:692:0

[task] | wikipedia [title] | DataStorage 활용하기 [category] | Guides [rephrased] | # DataStorage 활용하기 ## 개요 이 가이드는 **Data DB 저장 및 불러오기** 문서를 병행하여 학습할 것을 권장합니다. 이전 문서에서는 데이터를 간편하게 생성, 저장, 그리고 불러오는 기본 기능에 초점을 맞추었습니다. 본 가이드에서는 `DataStorageService`가 제공하는 다양한 함수를 활용하여 데이터를 증가시키거나 페이지 단위로 데이터를 조회하는 등, 크리에이터의 구체적인 목적에 맞게 데이터를 처리하는 방법을 다룹니다. 관련된 추가 정보는 다음 가이드를 참고할 수 있습니다. * [DataStor [original] | # 학습 과정 소개 이 가이드는 [Data DB 저장 및 불러오기](/docs/?postId=68)와 병행 학습을 권장합니다. "Data DB 저장 및 불러오기"에서는 간편하게 데이터를 생성, 저장, 불러오는 기능 위주로 살펴보았습니다. 이번 가이드에서는 DataStorageService의 다양한 함수를 통해 데이터를 증가시키거나, 페이지를 가지고 오는 등 크리에이터의 목적에 맞게 데이터를 활용하는 방법을 알아봅시다. ##### 참고 가이드 * [DataStorage 사용량 제한 알아보기](/docs?postId=1044) * [ [chunk_id] | Guides:692:0

[task] | wikipedia [title] | DataStorage 활용하기 [category] | Guides [rephrased] | # DB DataStorage 활용하기 `GlobalDataStoragePages`, `SortableDataStoragePages`, `UserDataStoragePages`, `DataStorageItemPages`, `SortableDataStorageItemPages`, `DataStorageVersionPages`는 DataStorage 관련 정보를 조회하기 위해 사용되는 객체입니다. 이러한 Pages 객체는 공통적으로 `IsLastPages` 프로퍼티와 `GetCurrentPageDatas()`, `MoveToNextP [original] | [GlobalDataStoragePages](/apiReference?postId=709), [SortableDataStoragePages](/apiReference?postId=713), [UserDataStoragePages](/apiReference?postId=717), [DataStorageItemPages](/apiReference?postId=703), [SortableDataStorageItemPages](/apiReference?postId=712), [DataStorageVersionPages](/apiRefere [chunk_id] | Guides:692:2

[task] | distill [title] | DataStorage 활용하기 [category] | Guides [rephrased] | # DataStorage 활용 가이드 ## 에러 코드 확인 DataStorage 함수 호출 시 반환되는 `errorCode`로 성공(0) 여부를 확인해야 합니다. ```lua local errorCode, successKeys = globalDataStorage:BatchSetAndWait(keyValues) ``` | ErrorCode | Error Name | 설명 | | :--- | :--- | :--- | | 0 | Ok | 요청 완료 | | 1000000 | Canceled | 요청 취소 | | 1000001 | Int [original] | DataStorage의 함수를 사용해 데이터를 저장, 삭제, 불러오기, 증가시키기, 순회 하기 등 다양한 데이터 관련 작업을 했을 때 해당 작업이 성공했는지 실패했는지를 에러 코드로 확인할 수 있습니다. 함수 요청이 성공했을 때의 에러 코드는 0입니다. 예를 들어, `local errorCode, successKeys = globalDataStorage:BatchSetAndWait(keyValues)` 와 같이 errorCode를 함께 작성해야 합니다. | ErrorCode | Error Name | 설명 | | --- | --- [chunk_id] | Guides:692:1

[task] | diverse_qa [title] | DataStorage 활용하기 [category] | Guides [rephrased] | 질문: DataStorage와 관련된 정보를 조회하기 위한 Pages 객체에는 어떤 것들이 있나요? 답변: GlobalDataStoragePages, SortableDataStoragePages, UserDataStoragePages, DataStorageItemPages, SortableDataStorageItemPages, DataStorageVersionPages가 있습니다. 질문: 모든 Pages 객체가 제공하는 프로퍼티와 함수는 무엇인가요? 답변: 모든 Pages 객체는 IsLastPages 프로퍼티와 GetCurrent [original] | [GlobalDataStoragePages](/apiReference?postId=709), [SortableDataStoragePages](/apiReference?postId=713), [UserDataStoragePages](/apiReference?postId=717), [DataStorageItemPages](/apiReference?postId=703), [SortableDataStorageItemPages](/apiReference?postId=712), [DataStorageVersionPages](/apiRefere [chunk_id] | Guides:692:2

[task] | knowledge_list [title] | DataStorage 활용하기 [category] | Guides [rephrased] | DataStorage 함수 호출 시 작업 성공 여부는 에러 코드로 확인하며, 요청이 성공했을 때 반환되는 에러 코드는 0(Ok)입니다. `globalDataStorage:BatchSetAndWait(keyValues)` 호출 시 첫 번째 반환 값으로 `errorCode`를 반드시 확인해야 합니다. 에러 코드 1000000(Canceled)은 요청이 취소되었음을 의미합니다. 에러 코드 1000001(InternalError)는 내부 에러가 발생했음을 의미합니다. 에러 코드 1000002(NotFound)는 요소를 찾을 수 없어 에러가 [original] | DataStorage의 함수를 사용해 데이터를 저장, 삭제, 불러오기, 증가시키기, 순회 하기 등 다양한 데이터 관련 작업을 했을 때 해당 작업이 성공했는지 실패했는지를 에러 코드로 확인할 수 있습니다. 함수 요청이 성공했을 때의 에러 코드는 0입니다. 예를 들어, `local errorCode, successKeys = globalDataStorage:BatchSetAndWait(keyValues)` 와 같이 errorCode를 함께 작성해야 합니다. | ErrorCode | Error Name | 설명 | | --- | --- [chunk_id] | Guides:692:1

[task] | wikipedia [title] | DataStorage 활용하기 [category] | Guides [rephrased] | # DataStorage의 에러 코드 DataStorage의 함수를 사용하여 데이터를 저장, 삭제, 불러오기, 증가시키기, 순회하기 등 다양한 작업을 수행할 경우, 해당 작업의 성공 여부를 에러 코드(error code)를 통해 확인할 수 있습니다. 함수 요청이 성공적으로 완료되었을 때 반환되는 에러 코드는 0입니다. 따라서 DataStorage 함수를 호출할 때는 반드시 에러 코드를 함께 받아야 하며, 예를 들어 `local errorCode, successKeys = globalDataStorage:BatchSetAndWait [original] | DataStorage의 함수를 사용해 데이터를 저장, 삭제, 불러오기, 증가시키기, 순회 하기 등 다양한 데이터 관련 작업을 했을 때 해당 작업이 성공했는지 실패했는지를 에러 코드로 확인할 수 있습니다. 함수 요청이 성공했을 때의 에러 코드는 0입니다. 예를 들어, `local errorCode, successKeys = globalDataStorage:BatchSetAndWait(keyValues)` 와 같이 errorCode를 함께 작성해야 합니다. | ErrorCode | Error Name | 설명 | | --- | --- [chunk_id] | Guides:692:1

[task] | diverse_qa [title] | 날짜와 시간 활용하기 [category] | Guides [rephrased] | 질문: "tt" 사용자 지정 서식 지정자는 무엇을 나타내며, AM과 PM의 적용 시간은 각각 어떻게 되나요? 답변: "tt" 사용자 지정 서식 지정자는 AM/PM 지정자를 나타냅니다. AM 지정자는 0:00:00부터 11:59:59.999까지의 시간에 사용되고, PM 지정자는 12:00:00부터 23:59:59.999까지의 시간에 사용됩니다. 질문: 다음 코드의 출력 결과는 무엇인가요? ```lua local date = DateTime(2022, 8, 29, 19, 7, 5, 023) log(date:ToFormattedStri [original] | "tt" 사용자 지정 서식 지정자는 AM/PM 지정자를 나타냅니다. AM 지정자는 0:00:00부터 11:59:59.999까지의 모든 시간에 사용되고 PM 지정자는 12:00:00부터 23:59:59.999까지의 모든 시간에 사용됩니다. ```lua local date = DateTime(2022, 8, 29, 19, 7, 5, 023) log(date:ToFormattedString("tt")) -- PM ``` #### "y" "y" 사용자 지정 서식 지정자는 연도를 한자리 또는 두 자리 숫자로 나타냅니다. 연도가 두 자리를 [chunk_id] | Guides:691:9

[task] | extract_knowledge [title] | 날짜와 시간 활용하기 [category] | Guides [rephrased] | # 날짜와 시간 포맷팅: 사용자 지정 서식 지정자 `DateTime` 객체의 `ToFormattedString` 메서드를 통해 날짜와 시간을 문자열로 변환할 때, 특정 서식 지정자를 사용하여 원하는 형식으로 출력할 수 있습니다. 서식 문자열은 표준 문자열과 구별하기 위해, 단독으로 사용하는 특정 지정자 앞에는 반드시 `%` 기호가 필요합니다. ## API 사용법 `DateTime` 인스턴스의 `ToFormattedString(formatString)` 메서드를 호출하여 포맷팅된 문자열을 반환합니다. ### 주요 서식 지정자 [original] | "g" 또는 "gg" 사용자 지정 서식 지정자는 연대를 나타냅니다. 기본적으로 A.D(Anno Domini, 기원후)로 나타납니다. "g" 사용자 지정 서식 지정자만 단독으로 사용하는 경우 표준 서식 문자열로 잘못 해석되지 않도록 앞에 "%" 사용자 지정 서식 지정자를 사용해야 합니다. ```lua local date = DateTime(2022, 8, 29, 19, 27, 15, 023) log(date:ToFormattedString("%g")) -- A.D. ``` #### "h" "h" 사용자 지정 서식 지정자는 시간 [chunk_id] | Guides:691:7

[task] | knowledge_list [title] | DataStorage 활용하기 [category] | Guides [rephrased] | 제시된 문서 내용에서 추출한 핵심 사실 목록입니다. 1. `GlobalDataStoragePages`, `SortableDataStoragePages`, `UserDataStoragePages`, `DataStorageItemPages`, `SortableDataStorageItemPages`, `DataStorageVersionPages`는 DataStorage 관련 정보를 조회하기 위한 객체입니다. 2. 모든 Pages 객체는 `IsLastPages` 프로퍼티를 제공합니다. 3. 모든 Pages 객체는 `GetCurrentPa [original] | [GlobalDataStoragePages](/apiReference?postId=709), [SortableDataStoragePages](/apiReference?postId=713), [UserDataStoragePages](/apiReference?postId=717), [DataStorageItemPages](/apiReference?postId=703), [SortableDataStorageItemPages](/apiReference?postId=712), [DataStorageVersionPages](/apiRefere [chunk_id] | Guides:692:2

[task] | knowledge_list [title] | 날짜와 시간 활용하기 [category] | Guides [rephrased] | ```lua -- "tt" 사용자 지정 서식 지정자는 AM/PM 지정자를 나타내며, 0:00:00부터 11:59:59.999까지의 시간은 "AM", 12:00:00부터 23:59:59.999까지의 시간은 "PM"으로 반환됩니다. local date = DateTime(2022, 8, 29, 19, 7, 5, 023) log(date:ToFormattedString("tt")) -- PM ``` ```lua -- "y" 사용자 지정 서식 지정자는 연도를 한자리 또는 두 자리 숫자로 나타내며, 연도가 두 자리를 넘으면 끝의 두 자리 [original] | "tt" 사용자 지정 서식 지정자는 AM/PM 지정자를 나타냅니다. AM 지정자는 0:00:00부터 11:59:59.999까지의 모든 시간에 사용되고 PM 지정자는 12:00:00부터 23:59:59.999까지의 모든 시간에 사용됩니다. ```lua local date = DateTime(2022, 8, 29, 19, 7, 5, 023) log(date:ToFormattedString("tt")) -- PM ``` #### "y" "y" 사용자 지정 서식 지정자는 연도를 한자리 또는 두 자리 숫자로 나타냅니다. 연도가 두 자리를 [chunk_id] | Guides:691:9

[task] | diverse_qa [title] | DataStorage 활용하기 [category] | Guides [rephrased] | 질문: DataStorage 함수 요청이 성공했을 때 반환되는 에러 코드는 무엇인가요? 답변: 함수 요청이 성공했을 때의 에러 코드는 0입니다. 질문: `globalDataStorage:BatchSetAndWait` 함수를 호출할 때 성공 여부를 확인하기 위해 무엇을 함께 작성해야 하나요? 답변: `errorCode`를 함께 작성해야 합니다. 질문: 에러 코드 1000001에 해당하는 에러 이름과 설명은 무엇인가요? 답변: 에러 이름은 InternalError이며, 설명은 "내부 에러가 발생했습니다."입니다. 질문: 에러 코드 [original] | DataStorage의 함수를 사용해 데이터를 저장, 삭제, 불러오기, 증가시키기, 순회 하기 등 다양한 데이터 관련 작업을 했을 때 해당 작업이 성공했는지 실패했는지를 에러 코드로 확인할 수 있습니다. 함수 요청이 성공했을 때의 에러 코드는 0입니다. 예를 들어, `local errorCode, successKeys = globalDataStorage:BatchSetAndWait(keyValues)` 와 같이 errorCode를 함께 작성해야 합니다. | ErrorCode | Error Name | 설명 | | --- | --- [chunk_id] | Guides:692:1

[task] | distill [title] | DataStorage 활용하기 [category] | Guides [rephrased] | # DataStorage 활용하기 `DataStorage`는 키(Key)와 함께 `Tag`, `Version`을 지정하여 데이터를 저장할 수 있습니다. ## DataStorageKeyInfo 저장 시 메타데이터를 지정하려면 `DataStorageKeyInfo` 객체를 사용합니다. - **생성**: `DataStorageKeyInfo(key, tag, version)` 또는 빈 생성자로 생성 후 프로퍼티(`Key`, `Version` 등)에 값을 대입. - **동작 규칙**: - `Tag`, `Version` 없이 `DataS [original] | DataStorage에 키 값과 더불어 Tag, Version을 지정해서 저장할 수 있습니다. 새로운 두 값을 저장하기 위해선 DataStorageKeyInfo를 활용해야 합니다. `DataStorageKeyInfo("key", "Tag", "Version1")`처럼 매개 변수로 key, Tag, Version을 사용할 수 있습니다. 만약 DataStorageKeyInfo를 Tag, Version 없이 사용한다면, SetAndWait, SetAsync류 함수를 사용해 데이터를 저장한 것과 동일합니다. 또한 SetByInfoAndW [chunk_id] | Guides:692:3

[task] | diverse_qa [title] | DataStorage 활용하기 [category] | Guides [rephrased] | 질문: DataStorage에 데이터를 저장할 때 Tag와 Version을 지정하기 위해 어떤 구조체를 사용해야 하나요? 답변: DataStorageKeyInfo 구조체를 사용해야 합니다. 질문: `DataStorageKeyInfo`를 생성할 때 매개 변수로 사용할 수 있는 값들은 무엇인가요? 답변: key, Tag, Version을 매개 변수로 사용할 수 있습니다. 질문: `DataStorageKeyInfo`를 Tag와 Version 없이 생성하여 저장 함수를 호출하면 어떤 결과가 발생하나요? 답변: Tag와 Version을 [original] | DataStorage에 키 값과 더불어 Tag, Version을 지정해서 저장할 수 있습니다. 새로운 두 값을 저장하기 위해선 DataStorageKeyInfo를 활용해야 합니다. `DataStorageKeyInfo("key", "Tag", "Version1")`처럼 매개 변수로 key, Tag, Version을 사용할 수 있습니다. 만약 DataStorageKeyInfo를 Tag, Version 없이 사용한다면, SetAndWait, SetAsync류 함수를 사용해 데이터를 저장한 것과 동일합니다. 또한 SetByInfoAndW [chunk_id] | Guides:692:3

[task] | knowledge_list [title] | DataStorage 활용하기 [category] | Guides [rephrased] | 1. `DataStorage`에는 키 값과 더불어 `Tag`, `Version`을 지정하여 데이터를 저장할 수 있습니다. 2. `Tag`와 `Version`을 지정하여 저장을 수행하기 위해서는 `DataStorageKeyInfo` 객체를 생성 및 활용해야 합니다. 3. `DataStorageKeyInfo`는 생성 시 `key`, `Tag`, `Version` 순으로 문자열 매개변수를 받아 인스턴스를 생성하며, 예: `DataStorageKeyInfo("key", "Tag", "Version1")` 형태입니다. 4. `DataStor [original] | DataStorage에 키 값과 더불어 Tag, Version을 지정해서 저장할 수 있습니다. 새로운 두 값을 저장하기 위해선 DataStorageKeyInfo를 활용해야 합니다. `DataStorageKeyInfo("key", "Tag", "Version1")`처럼 매개 변수로 key, Tag, Version을 사용할 수 있습니다. 만약 DataStorageKeyInfo를 Tag, Version 없이 사용한다면, SetAndWait, SetAsync류 함수를 사용해 데이터를 저장한 것과 동일합니다. 또한 SetByInfoAndW [chunk_id] | Guides:692:3

[task] | extract_knowledge [title] | 날짜와 시간 활용하기 [category] | Guides [rephrased] | # 날짜와 시간 서식 지정자 (DateTime Formatting) mLua에서는 `DateTime` 객체의 `ToFormattedString` 메서드를 사용하여 날짜와 시간 데이터를 문자열로 변환합니다. 이 메서드는 사용자 지정 서식 문자열을 인자로 받아, 해당 문자열에 포함된 서식 지정자에 따라 날짜의 특정 요소를 포맷팅하여 반환합니다. ## 개념 설명 서식 문자열은 날짜의 연도, 월, 일, 시간, 분, 초, 밀리초, AM/PM 등 특정 요소를 나타내는 알파벳 문자열로 구성됩니다. 각 지정자는 다음과 같은 규칙을 따릅니다. [original] | "mm" 사용자 지정 서식 지정자는 분을 00부터 59까지의 숫자로 나타냅니다. 분은 마지막 시간 이후 경과한 총 분 수를 나타냅니다. 분이 한 자릿수인 경우 십의 자리는 0으로 표시됩니다. ```lua local date = DateTime(2022, 8, 29, 19, 7, 15, 023) log(date:ToFormattedString("mm")) -- 07 ``` #### "M" "M" 사용자 지정 서식 지정자는 월을 1부터 12까지의 숫자로 나타냅니다. 월이 한 자릿수인 경우 십의 자리는 표시되지 않습니다. "M" 사용 [chunk_id] | Guides:691:8

[task] | extract_knowledge [title] | DataStorage 활용하기 [category] | Guides [rephrased] | # DataStorage Pages 객체 활용 ## 개념 설명 `DataStoragePages` 계열 객체는 `DataStorage`와 관련된 데이터 목록을 페이지 단위로 조회하기 위한 객체입니다. 주요 객체로는 `GlobalDataStoragePages`, `SortableDataStoragePages`, `UserDataStoragePages`, `DataStorageItemPages`, `SortableDataStorageItemPages`, `DataStorageVersionPages` 등이 있습니다. 모든 Pages 객 [original] | [GlobalDataStoragePages](/apiReference?postId=709), [SortableDataStoragePages](/apiReference?postId=713), [UserDataStoragePages](/apiReference?postId=717), [DataStorageItemPages](/apiReference?postId=703), [SortableDataStorageItemPages](/apiReference?postId=712), [DataStorageVersionPages](/apiRefere [chunk_id] | Guides:692:2

[task] | distill [title] | DataStorage 활용하기 [category] | Guides [rephrased] | # DB DataStorage 활용하기 (데이터 가져오기) ### 기본 데이터 조회 * **함수**: `GetAndWait` (동기), `GetAsync` (비동기) * **접근성**: * `GlobalDataStorage`, `UserDataStorage`, `CreatorDataStorage`: **문자열(string)** 타입만 조회 가능. * `SortableDataStorage`: **정수(integer)** 타입만 조회 가능. * **타입 변환**: 저장 시 `_UtilLogic:Tabl [original] | 데이터를 가져올 때는 GetAndWait, GetAsync 함수를 사용합니다. GlobalDataStorage, UserDataStorage, CreatorDataStorage는 문자열 타입의 값만 가져올 수 있습니다. 만약 데이터를 저장할 때 `_UtilLogic:TableToString()` 함수를 사용해 데이터를 문자열로 변환했다면, 데이터를 가져올 때는 `_UtilLogic:StringToTable()` 함수를 사용해 기존 타입으로 변환하여 사용할 수 있습니다. SortableDataStorage는 정수 타입의 값만 가져올 [chunk_id] | Guides:692:4

[task] | distill [title] | DataStorage 활용하기 [category] | Guides [rephrased] | # DB DataStorage 활용하기 ## 페이지네이션 (Pages) 목록 조회 시 `Pages` 객체를 반환합니다. 페이지 단위로 데이터를 처리해야 합니다. ```lua local errorCode, pages = _DataStorageService:GetGlobalDataStoragePagesAndWait() while true do local dataList = pages:GetCurrentPageDatas() for _, data in pairs(dataList) do log(data.Na [original] | DataStorage 목록 또는 데이터 목록을 받을 때 페이지 단위로 목록을 조회할 수 있는 객체인 Pages 형태로 값을 받습니다. ```lua local errorCode, globalDataStoragePages = _DataStorageService:GetGlobalDataStoragePagesAndWait() while true do local globalDataStorages = globalDataStoragePages:GetCurrentPageDatas() --GetCurrentPageDatas()로 현 [chunk_id] | Guides:692:6

[task] | knowledge_list [title] | DataStorage 활용하기 [category] | Guides [rephrased] | * 데이터를 가져올 때 `GetAndWait` 함수는 동기로, `GetAsync` 함수는 비동기로 수행되며, `GetAsync`는 작업 완료 시 `callbackFunction` 매개변수로 전달된 함수를 호출합니다. * `GetAndWait` 함수는 동기로 수행되며, 함수의 작업이 완료될 때까지 스크립트 실행을 중단합니다. * `GlobalDataStorage`, `UserDataStorage`, `CreatorDataStorage` 인스턴스는 문자열(string) 타입의 값만 가져올 수 있습니다. * `Sortabl [original] | 데이터를 가져올 때는 GetAndWait, GetAsync 함수를 사용합니다. GlobalDataStorage, UserDataStorage, CreatorDataStorage는 문자열 타입의 값만 가져올 수 있습니다. 만약 데이터를 저장할 때 `_UtilLogic:TableToString()` 함수를 사용해 데이터를 문자열로 변환했다면, 데이터를 가져올 때는 `_UtilLogic:StringToTable()` 함수를 사용해 기존 타입으로 변환하여 사용할 수 있습니다. SortableDataStorage는 정수 타입의 값만 가져올 [chunk_id] | Guides:692:4

[task] | distill [title] | DataStorage 활용하기 [category] | Guides [rephrased] | **DB DataStorage 활용하기** **1. 값 증가 (Increase)** `IncreaseAndWait` 또는 `IncreaseAsync` 함수를 사용해 `delta`만큼 값을 변경합니다. * **동작**: `delta` > 0이면 증가, < 0이면 감소. * **초기화**: 키가 존재하지 않으면 기본값 `0`으로 생성 후 `delta`만큼 적용됩니다. * **반환**: `(errorCode, newValue)` ```lua local ds = _DataStorageService:GetSortableData [original] | SortableDataStorage는 IncreaseAndWait, IncreaseAsync 함수를 활용해 값을 증가시킬 수 있습니다. 각 함수의 delta 입력 값만큼 해당 매개 변수의 값이 증가하거나 감소합니다. 매개 변수로 들어온 값이 양수일 때는 증가, 음수일 때는 감소합니다. 만약, 증가시키고자 하는 값이 DataStorage에 존재하지 않는다면 기본값 0으로 저장하고 delta만큼 증가하게 됩니다. IncreaseAndWait 및 IncreaseAsync 함수는 에러 코드와 증가된 후의 값을 제공합니다. DataStor [chunk_id] | Guides:692:5