[task] | wikipedia [title] | TimeSpan으로 시간 표현하기 [category] | Guides [rephrased] | # TimeSpan 서식 지정자 mLua에서 `TimeSpan` 객체를 문자열로 변환할 때 `ToFormattedString` 메서드에 사용자 지정 서식 지정자를 전달할 수 있습니다. 이 문서에서는 밀리초 및 그 이하 단위(1/10초, 1/100초)를 출력하는 서식 지정자 `"fff"`, `"F"`, `"FF"`, `"FFF"`의 동작 방식을 설명합니다. ## "fff" 서식 지정자 `"fff"` 사용자 지정 서식 지정자는 밀리초를 출력합니다. 서식 지정 작업 중에는 나머지 소수 자릿수가 잘립니다. `TimeSpan` 객체를 [original] | "fff" 사용자 지정 서식 지정자는 밀리초를 출력합니다. 서식 지정 작업에서 나머지 소수 자릿수는 잘립니다. 문자열로 TimeSpan 객체를 생성할 경우 문자열에는 정확히 소수 세 자리가 포함되어야 합니다. ```lua local timeSpan = TimeSpan(876) log(timeSpan:ToFormattedString("fff")) -- 876 ``` #### "F" "F" 사용자 지정 서식 지정자는 1/10 초를 출력합니다. 서식 지정 작업에서 나머지 소수 자릿수는 잘립니다. 1/10초 값이 0이라면 결과 [chunk_id] | Guides:689:4
[task] | distill [title] | TimeSpan으로 시간 표현하기 [category] | Guides [rephrased] | # TimeSpan 서식 지정자 (mLua) `TimeSpan:ToFormattedString(format)` 은 지정된 서식 문자열에 따라 시간 값을 문자열로 변환합니다. **주의사항:** * 단독으로 사용될 경우 표준 서식 지정자로 오해받을 수 있으므로 `%` 접두사 사용 필수: `%m`, `%s`, `%f`. * 일반적으로 숫자 하나만 포함된 문자열은 **일(days)** 로 해석되므로, 분/초/시간을 의미하려면 해당 서식 지정자를 명시해야 합니다. ## 서식 지정자 목록 | 지정자 | 설명 | 0-9 처리 | 단 [original] | "hh" 사용자 지정 서식 지정자는 시간 수를 나타내는 값을 출력합니다. 시간 값이 0-9라면 출력 문자열 앞에 0이 포함됩니다. 일반적으로 하나의 숫자만 포함하는 문자열은 일 수로 해석됩니다. "hh" 사용자 지정 서식 지정자를 대신 사용하여 숫자 문자열을 시간 수로 해석할 수 있습니다. ```lua local timeSpan = TimeSpan(365, 3, 14, 45) log(timeSpan:ToFormattedString("dd'.'hh':'mm':'ss")) -- 365.03:14:45 ``` #### "m" " [chunk_id] | Guides:689:3
[task] | knowledge_list [title] | TimeSpan으로 시간 표현하기 [category] | Guides [rephrased] | ```lua -- 문서에 명시된 TimeSpan 서식 지정자 및 메서드 사용 규칙 ``` 1. `TimeSpan` 객체의 `ToFormattedString` 메서드는 `"hh"` 서식 지정자를 사용하여 시간 수를 출력하며, 값이 0~9일 경우 출력 문자열 앞에 0이 포함됩니다. 2. `TimeSpan` 객체의 `ToFormattedString` 메서드는 `"m"` 서식 지정자를 단독으로 사용할 경우 표준 서식 지정자로 오해되지 않도록 `"%m"`으로 지정해야 하며, 분 값이 0~9일 경우 한 자리 문자열, 10~59일 경우 두 자 [original] | "hh" 사용자 지정 서식 지정자는 시간 수를 나타내는 값을 출력합니다. 시간 값이 0-9라면 출력 문자열 앞에 0이 포함됩니다. 일반적으로 하나의 숫자만 포함하는 문자열은 일 수로 해석됩니다. "hh" 사용자 지정 서식 지정자를 대신 사용하여 숫자 문자열을 시간 수로 해석할 수 있습니다. ```lua local timeSpan = TimeSpan(365, 3, 14, 45) log(timeSpan:ToFormattedString("dd'.'hh':'mm':'ss")) -- 365.03:14:45 ``` #### "m" " [chunk_id] | Guides:689:3
[task] | wikipedia [title] | TimeSpan으로 시간 표현하기 [category] | Guides [rephrased] | **TimeSpan으로 시간 표현하기** mLua에서 `TimeSpan` 타입의 객체를 문자열로 변환할 때, 표준 서식 지정자 "G"를 사용할 수 있습니다. 일반 긴 서식 지정자 "G"는 항상 일 수와 소수 세 자릿수를 포함하여 출력하며, 문화권 설정에 따라 형식이 달라집니다. 기본 형식은 `[-]d':'hh':'mm':'ss.fff` 입니다. 이 형식에서 사용되는 각 기호의 의미는 다음과 같습니다. 대괄호 `[]` 안의 `-` 기호는 음수를 나타내며, `d`는 일 수, `hh`는 00부터 23 범위의 시간, `mm`는 00부터 [original] | 일반 긴 서식 지정자 "G"는 항상 일 수와 소수 세 자릿수를 출력하고 문화권을 구분합니다. 형식은 [-]d':'hh':'mm':'ss.fff 입니다. | 기호 | 설명 | | --- | --- | | - | 음수를 나타내는 기호 | | . | 초 소수 구분을 나타냅니다. | | fff | 초의 소수 부분을 나타냅니다. | | ss | "00"부터 "59" 범위의 초를 나타냅니다.| | mm | "00"부터 "59" 범위의 분을 나타냅니다. | | hh | "00"부터 "23" 범위의 시간을 나타냅니다. | | d | 일 수를 나 [chunk_id] | Guides:689:2
[task] | knowledge_list [title] | 리소스 관리 [category] | Guides [rephrased] | 1. Resource Storage 리소스는 세부 정보 화면의 이전 기능이나 콘텍스트 메뉴를 통해 그룹 리소스로 소유권을 이전할 수 있으며, 이 과정에서 이전 대상 그룹을 선택해야 합니다. 2. Resource Storage 리소스에는 공유 기능을 설정할 수 있으며, 원작자가 리메이크를 허용한 월드에 공유된 리소스가 포함되면 다른 크리에이터의 리메이크 월드에서도 해당 리소스를 사용할 수 있습니다. 3. 원작자가 Resource Storage 리소스의 공유 기능을 해제하면, 기존에 생성된 리메이크 월드에서도 해당 리소스를 사용할 수 [original] | Resource Storage 리소스는 그룹 리소스로 이전하여 사용할 수 있습니다. | 세부 정보에서 이전하기 | 콘텍스트 메뉴로 이전하기 | | :---: | --- | | | | 위와 같이 선택하면 어떤 그룹으로 소유권을 이전할 것인지 결정할 수 있습니다. > **더 알아보기** > 그룹을 만들어 공동 제작하는 방법에 대해 더 알아보고 싶다면 아래 가이드를 참고하세요! > [공동 제작](/docs/?postId=670) ## 리소스 공유 Resource Storage 리소스에 아래와 같이 공유 기능을 설정할 수 있습니 [chunk_id] | Guides:690:1
[task] | distill [title] | 리소스 관리 [category] | Guides [rephrased] | # 메이커 사용 리소스 관리 ## 리소스 이전 `Resource Storage` 리소스는 그룹 리소스로 소유권을 이전할 수 있습니다. * **방법**: 리소스 세부 정보 또는 콘텍스트 메뉴를 통해 대상 그룹을 선택하여 이전합니다. * **공동 제작**: 그룹을 활용한 공동 제작 방법은 관련 가이드를 참고하세요. ## 리소스 공유 `Resource Storage` 리소스에 공유 기능을 설정하여 리메이크 월드에서 사용을 허용할 수 있습니다. * **동작**: 원작자가 리메이크를 허용한 월드에 공유된 리소스가 포함되어 있으 [original] | Resource Storage 리소스는 그룹 리소스로 이전하여 사용할 수 있습니다. | 세부 정보에서 이전하기 | 콘텍스트 메뉴로 이전하기 | | :---: | --- | | | | 위와 같이 선택하면 어떤 그룹으로 소유권을 이전할 것인지 결정할 수 있습니다. > **더 알아보기** > 그룹을 만들어 공동 제작하는 방법에 대해 더 알아보고 싶다면 아래 가이드를 참고하세요! > [공동 제작](/docs/?postId=670) ## 리소스 공유 Resource Storage 리소스에 아래와 같이 공유 기능을 설정할 수 있습니 [chunk_id] | Guides:690:1
[task] | wikipedia [title] | TimeSpan으로 시간 표현하기 [category] | Guides [rephrased] | # TimeSpan 서식 지정자 `TimeSpan` 객체의 `ToFormattedString` 메서드는 특정 사용자 지정 서식 지정자를 사용하여 시간 값을 문자열로 변환합니다. 이 과정에서 숫자 문자열은 기본적으로 일 수로 해석되므로, 시간·분·초·소수 부분 등을 명확히 나타내기 위해서는 각각의 서식 지정자를 사용해야 합니다. 또한, 특정 서식 지정자가 단독으로 사용될 때 표준 서식 지정자로 잘못 해석되는 것을 방지하기 위해 `%` 기호를 접두사로 붙여야 하는 경우가 있습니다. ## "hh": 시간 `"hh"` 서식 지정자는 [original] | "hh" 사용자 지정 서식 지정자는 시간 수를 나타내는 값을 출력합니다. 시간 값이 0-9라면 출력 문자열 앞에 0이 포함됩니다. 일반적으로 하나의 숫자만 포함하는 문자열은 일 수로 해석됩니다. "hh" 사용자 지정 서식 지정자를 대신 사용하여 숫자 문자열을 시간 수로 해석할 수 있습니다. ```lua local timeSpan = TimeSpan(365, 3, 14, 45) log(timeSpan:ToFormattedString("dd'.'hh':'mm':'ss")) -- 365.03:14:45 ``` #### "m" " [chunk_id] | Guides:689:3
[task] | knowledge_list [title] | 리소스 관리 [category] | Guides [rephrased] | 제시된 문서의 내용을 바탕으로 메이플스토리 월드(MapleStory Worlds)의 리소스 관리에 관한 핵심 사실을 정리한 목록입니다. 1. 메이플스토리 월드의 모든 리소스는 프로퍼티 에디터 또는 스크립트에서 사용 가능하며, 각각 고유한 식별자인 `RUID`를 가지고 있습니다. 2. 리소스는 제공 주체에 따라 플랫폼이 제공하는 `메이플스토리 월드 리소스`와 유저가 등록한 `유저 리소스`로 구분됩니다. 3. `메이플스토리 월드 리소스`는 메이커의 `Resource Storage` 탭과 공식 홈페이지의 `MSW 리소스` 페이지에 [original] | # 학습 과정 소개 유저가 메이커에 등록한 리소스를 관리하는 방법에 대해 알아봅시다. # 리소스 구분 메이플스토리 월드에서의 리소스는 프로퍼티 에디터 혹은 스크립트 등에서 사용할 수 있습니다. 그리고 각각의 리소스마다 RUID가 존재합니다. 리소스는 제공자에 따라 **메이플스토리 월드 리소스**와 **유저 리소스**로 나눌 수 있습니다. ## 메이플스토리 월드 리소스 메이플스토리 월드 리소스는 말 그대로 메이플스토리 월드에서 제공하는 리소스를 말합니다. 메이커의 **Resource Storage** 및 [메이플스토리 월드 [chunk_id] | Guides:690:0
[task] | diverse_qa [title] | TimeSpan으로 시간 표현하기 [category] | Guides [rephrased] | 질문: "fff" 사용자 지정 서식 지정자는 어떤 단위를 출력하나요? 답변: "fff" 사용자 지정 서식 지정자는 밀리초를 출력합니다. 질문: "fff" 서식 지정자를 사용할 때 나머지 소수 자릿수는 어떻게 처리되나요? 답변: 서식 지정 작업에서 나머지 소수 자릿수는 잘립니다. 질문: 문자열로 TimeSpan 객체를 생성할 때 "fff" 서식과 관련하여 문자열에 포함되어야 할 소수 자릿수는 몇 자리인가요? 답변: 문자열에는 정확히 소수 세 자리가 포함되어야 합니다. 질문: 다음 코드 `log(timeSpan:ToFormatte [original] | "fff" 사용자 지정 서식 지정자는 밀리초를 출력합니다. 서식 지정 작업에서 나머지 소수 자릿수는 잘립니다. 문자열로 TimeSpan 객체를 생성할 경우 문자열에는 정확히 소수 세 자리가 포함되어야 합니다. ```lua local timeSpan = TimeSpan(876) log(timeSpan:ToFormattedString("fff")) -- 876 ``` #### "F" "F" 사용자 지정 서식 지정자는 1/10 초를 출력합니다. 서식 지정 작업에서 나머지 소수 자릿수는 잘립니다. 1/10초 값이 0이라면 결과 [chunk_id] | Guides:689:4
[task] | diverse_qa [title] | TimeSpan으로 시간 표현하기 [category] | Guides [rephrased] | 질문: "hh" 사용자 지정 서식 지정자는 어떤 값을 출력하며, 값이 0-9일 때 어떤 특징이 있나요? 답변: "hh" 사용자 지정 서식 지정자는 시간 수를 나타내는 값을 출력합니다. 시간 값이 0-9라면 출력 문자열 앞에 0이 포함됩니다. 질문: 일반적으로 하나의 숫자만 포함하는 문자열은 어떤 단위로 해석되나요? 답변: 일반적으로 하나의 숫자만 포함하는 문자열은 일 수로 해석됩니다. 질문: 아래 코드의 실행 결과는 무엇인가요? ```lua local timeSpan = TimeSpan(365, 3, 14, 45) log(tim [original] | "hh" 사용자 지정 서식 지정자는 시간 수를 나타내는 값을 출력합니다. 시간 값이 0-9라면 출력 문자열 앞에 0이 포함됩니다. 일반적으로 하나의 숫자만 포함하는 문자열은 일 수로 해석됩니다. "hh" 사용자 지정 서식 지정자를 대신 사용하여 숫자 문자열을 시간 수로 해석할 수 있습니다. ```lua local timeSpan = TimeSpan(365, 3, 14, 45) log(timeSpan:ToFormattedString("dd'.'hh':'mm':'ss")) -- 365.03:14:45 ``` #### "m" " [chunk_id] | Guides:689:3
[task] | diverse_qa [title] | 리소스 관리 [category] | Guides [rephrased] | 질문: Resource Storage 리소스를 그룹 리소스로 변경하는 방법은 무엇인가요? 답변: Resource Storage 리소스는 그룹 리소스로 이전하여 사용할 수 있으며, 세부 정보에서 이전하거나 콘텍스트 메뉴를 통해 이전하는 방법으로 그룹 소유권을 결정할 수 있습니다. 질문: 리소스 공유 기능이 설정된 월드 A를 리메이크했을 때, 리메이크 월드에서는 리소스 a를 사용할 수 있나요? 답변: 네, 원작자가 리메이크를 허용한 월드 A에 공유 기능이 설정된 리소스 a가 사용된 경우, 다른 크리에이터가 월드 A를 리메이크하면 리메 [original] | Resource Storage 리소스는 그룹 리소스로 이전하여 사용할 수 있습니다. | 세부 정보에서 이전하기 | 콘텍스트 메뉴로 이전하기 | | :---: | --- | | | | 위와 같이 선택하면 어떤 그룹으로 소유권을 이전할 것인지 결정할 수 있습니다. > **더 알아보기** > 그룹을 만들어 공동 제작하는 방법에 대해 더 알아보고 싶다면 아래 가이드를 참고하세요! > [공동 제작](/docs/?postId=670) ## 리소스 공유 Resource Storage 리소스에 아래와 같이 공유 기능을 설정할 수 있습니 [chunk_id] | Guides:690:1
[task] | extract_knowledge [title] | TimeSpan으로 시간 표현하기 [category] | Guides [rephrased] | # TimeSpan 시간 표현 및 서식 지정 ## 1. 개념 설명 `TimeSpan`은 게임 로직 내에서 시간 간격을 표현하는 데 사용되는 데이터 타입입니다. `TimeSpan` 객체를 문자열로 변환할 때는 `ToFormattedString` 메서드를 사용하며, 첫 번째 인수로 **형식 지정자(format specifier)** 를 지정하여 출력 형식을 제어할 수 있습니다. 표준 TimeSpan 형식 문자열은 단일 형식 지정자를 사용하여 생성됩니다. 지원되는 형식 지정자는 다음과 같습니다. | 형식 지정자 | 이름 | 설명 [original] | 표준 TimeSpan 형식 문자열은 단일 형식 지정자를 사용하여 서식 지정 작업으로 생성되는 TimeSpan 값의 텍스트 표현을 정의합니다. | 형식 지정자 | 이름 | 설명 | | --- | --- | --- | | "c" | 상수 형식 | 문화권을 구분하지 않으며 [-][d'.']hh':'mm':'ss['.'fff] 형식을 사용합니다. | | "g" | 일반 약식 | 문화권을 구분하며, 필요한 내용을 출력합니다. [-][d':']h':'mm':'ss[.FFF] 형식을 사용합니다. | | "G" | 일반 긴 형식 | 문화권을 [chunk_id] | Guides:689:1
[task] | diverse_qa [title] | 리소스 관리 [category] | Guides [rephrased] | 질문: 메이플스토리 월드에서 리소스는 어떤 두 가지 제공자로 나뉘나요? 답변: 리소스는 제공자에 따라 메이플스토리 월드 리소스와 유저 리소스로 나뉩니다. 질문: 메이플스토리 월드 리소스는 어디에서 확인할 수 있나요? 답변: 메이플스토리 월드 리소스는 메이커의 Resource Storage 및 메이플스토리 월드 공식 홈페이지의 MSW 리소스 페이지에서 확인할 수 있습니다. 질문: 유저 리소스는 메이커 상의 등록 위치에 따라 어떻게 구분되나요? 답변: 유저 리소스는 메이커 상에 등록되는 위치에 따라 Workspace 리소스와 Res [original] | # 학습 과정 소개 유저가 메이커에 등록한 리소스를 관리하는 방법에 대해 알아봅시다. # 리소스 구분 메이플스토리 월드에서의 리소스는 프로퍼티 에디터 혹은 스크립트 등에서 사용할 수 있습니다. 그리고 각각의 리소스마다 RUID가 존재합니다. 리소스는 제공자에 따라 **메이플스토리 월드 리소스**와 **유저 리소스**로 나눌 수 있습니다. ## 메이플스토리 월드 리소스 메이플스토리 월드 리소스는 말 그대로 메이플스토리 월드에서 제공하는 리소스를 말합니다. 메이커의 **Resource Storage** 및 [메이플스토리 월드 [chunk_id] | Guides:690:0
[task] | wikipedia [title] | 리소스 관리 [category] | Guides [rephrased] | **메이커 사용 리소스 관리** 메이플스토리 월드 메이커에서는 리소스를 효율적으로 관리하고 공유할 수 있도록 **Resource Storage**와 **Workspace**를 통해 리소스를 관리합니다. 이 섹션에서는 Resource Storage 리소스의 소유권 이전, 공유 설정, 그리고 버전 관리 방식에 대해 설명합니다. ### 리소스 소유권 이전 **Resource Storage**에 저장된 리소스는 개인 소유에서 그룹 리소스로 소유권을 이전하여 사용할 수 있습니다. 소유권 이전은 두 가지 방식으로 수행할 수 있습니다. [original] | Resource Storage 리소스는 그룹 리소스로 이전하여 사용할 수 있습니다. | 세부 정보에서 이전하기 | 콘텍스트 메뉴로 이전하기 | | :---: | --- | | | | 위와 같이 선택하면 어떤 그룹으로 소유권을 이전할 것인지 결정할 수 있습니다. > **더 알아보기** > 그룹을 만들어 공동 제작하는 방법에 대해 더 알아보고 싶다면 아래 가이드를 참고하세요! > [공동 제작](/docs/?postId=670) ## 리소스 공유 Resource Storage 리소스에 아래와 같이 공유 기능을 설정할 수 있습니 [chunk_id] | Guides:690:1
[task] | distill [title] | 날짜와 시간 활용하기 [category] | Guides [rephrased] | # DateTime 활용 가이드 `DateTime`은 그레고리력 기준 서기 0001년 1월 1일 00:00:00부터 9999년 12월 31일 23:59:59까지의 날짜/시간을 나타내는 객체입니다. 특정 시점(입장 시간, 계정 생성일 등)을 표현할 때 사용하며, 시간 계산이 필요할 경우 `TimeSpan`과 함께 활용합니다. ## 상수 별도 할당 없이 직접 참조합니다. | 상수 | 설명 | | :--- | :--- | | `UtcNow` | 현재 UTC 날짜/시간 | | `MaxValue` | `DateTime` 최댓값 | | [original] | # 학습 과정 소개 날짜와 시간을 표현하는 DateTime에 대해 알아보고, 활용할 수 있는 다양한 서식 지정자를 알아봅시다. # DateTime 알아보기 DateTime은 날짜와 시간으로 표시된 시간을 나타내는 객체입니다. 값 형식은 그레고리력에서 00:00:00(자정), 서기 0001년 1월 1일부터 9999년 12월 31일 오후 11:59:59까지의 값으로 날짜와 시간을 나타냅니다. DateTime은 맵에 입장한 시간이나, 계정이 생성된 날처럼 특정 날짜를 나타내기 위해 사용합니다. DateTime은 활용할 때 주로 시간 [chunk_id] | Guides:691:0
[task] | knowledge_list [title] | 날짜와 시간 활용하기 [category] | Guides [rephrased] | * `DateTime` 객체는 `Elapsed` 속성을 통해 다른 실행 공간(서버/클라이언트)으로 값을 전달하여 해당 공간에서 `DateTime` 객체를 재생성할 수 있습니다. * `DateTime` 객체는 기본적으로 UTC(협정 세계시) 기준으로 생성되며, 로컬 시간으로 변환하려면 클라이언트 공간에서 `_UtilLogic` 서비스의 `GetLocalTimeFrom` 메서드를 호출해야 합니다. * `DateTime` 객체의 `ToFormattedString` 메서드는 서식 문자열 인자를 받아 지정된 형식(예: `"'연도는 [original] | DataTime을 DateElapsed를 사용해 다른 실행 공간에서 DateTime을 활용할 수 있습니다. ```lua [server only] void OnBeginPlay() { wait(1) local date = DateTime(2022, 5, 17, 13, 21, 35) self:ServerToClient(date.Elapsed) } [client] void ServerToClient(number dateElapsed) { local date = DateTime(dateElapsed) [chunk_id] | Guides:691:1
[task] | extract_knowledge [title] | 리소스 관리 [category] | Guides [rephrased] | # 메이커 사용 리소스 관리 ## 1. 개념 설명 메이플스토리 월드 메이커에서 리소스는 **Workspace**와 **Resource Storage** 두 가지 공간에 존재할 수 있으며, 각 공간의 리소스는 버전 관리와 리메이크(파생 월드)에 대한 영향 범위에서 차이가 있습니다. * **Workspace 리소스**: 개별 월드 내부에 저장됩니다. 원본 월드에서 파생된 월드(리메이크 또는 Export 후 Import한 월드)의 Workspace 리소스는 원본에서 복제된 상태이므로, 원본 월드의 리소스가 변경되더라도 파생 월드 [original] | Resource Storage 리소스는 그룹 리소스로 이전하여 사용할 수 있습니다. | 세부 정보에서 이전하기 | 콘텍스트 메뉴로 이전하기 | | :---: | --- | | | | 위와 같이 선택하면 어떤 그룹으로 소유권을 이전할 것인지 결정할 수 있습니다. > **더 알아보기** > 그룹을 만들어 공동 제작하는 방법에 대해 더 알아보고 싶다면 아래 가이드를 참고하세요! > [공동 제작](/docs/?postId=670) ## 리소스 공유 Resource Storage 리소스에 아래와 같이 공유 기능을 설정할 수 있습니 [chunk_id] | Guides:690:1
[task] | knowledge_list [title] | 날짜와 시간 활용하기 [category] | Guides [rephrased] | 제공된 문서의 내용을 바탕으로 추출한 핵심 사실 목록입니다. 1. `DateTime`은 그레고리력 기준 서기 0001년 1월 1일 00:00:00부터 9999년 12월 31일 23:59:59까지의 날짜와 시간을 나타내는 객체로, 특정 날짜 표현에 사용됩니다. 2. `DateTime.UtcNow` 상수는 현재 날짜와 시간을 UTC(협정 세계시) 기준으로 반환합니다. 3. `DateTime.MaxValue` 상수는 `DateTime` 타입이 가질 수 있는 최댓값을 반환합니다. 4. `DateTime.MinValue` 상수는 `Date [original] | # 학습 과정 소개 날짜와 시간을 표현하는 DateTime에 대해 알아보고, 활용할 수 있는 다양한 서식 지정자를 알아봅시다. # DateTime 알아보기 DateTime은 날짜와 시간으로 표시된 시간을 나타내는 객체입니다. 값 형식은 그레고리력에서 00:00:00(자정), 서기 0001년 1월 1일부터 9999년 12월 31일 오후 11:59:59까지의 값으로 날짜와 시간을 나타냅니다. DateTime은 맵에 입장한 시간이나, 계정이 생성된 날처럼 특정 날짜를 나타내기 위해 사용합니다. DateTime은 활용할 때 주로 시간 [chunk_id] | Guides:691:0
[task] | extract_knowledge [title] | TimeSpan으로 시간 표현하기 [category] | Guides [rephrased] | # TimeSpan 서식 지정자: 밀리초 및 소수 부분 출력 mLua에서는 `TimeSpan` 객체의 소수 부분(밀리초)을 문자열로 변환할 때 `ToFormattedString` 메서드의 사용자 지정 서식 지정자(Custom Format Specifier)를 사용합니다. 각 지정자는 출력할 소수 자릿수를 결정하며, 지정된 자릿수를 초과하는 값은 잘림(Truncation) 처리됩니다. ## 개념 설명 `TimeSpan`의 소수 부분 출력은 다음과 같은 규칙을 따릅니다. 1. **잘림 처리 (Truncation)**: 서식 지 [original] | "fff" 사용자 지정 서식 지정자는 밀리초를 출력합니다. 서식 지정 작업에서 나머지 소수 자릿수는 잘립니다. 문자열로 TimeSpan 객체를 생성할 경우 문자열에는 정확히 소수 세 자리가 포함되어야 합니다. ```lua local timeSpan = TimeSpan(876) log(timeSpan:ToFormattedString("fff")) -- 876 ``` #### "F" "F" 사용자 지정 서식 지정자는 1/10 초를 출력합니다. 서식 지정 작업에서 나머지 소수 자릿수는 잘립니다. 1/10초 값이 0이라면 결과 [chunk_id] | Guides:689:4
[task] | diverse_qa [title] | 날짜와 시간 활용하기 [category] | Guides [rephrased] | 질문: `DateTime` 객체는 어떤 범위와 기준의 날짜와 시간을 나타내나요? 답변: `DateTime`은 그레고리력 기준으로 서기 0001년 1월 1일 00:00:00부터 9999년 12월 31일 23:59:59까지의 값을 나타냅니다. 질문: `DateTime`은 주로 어떤 상황에서 사용되며, 어떤 객체와 함께 사용되는 경우가 많나요? 답변: `DateTime`은 맵 입장 시간이나 계정 생성일 등 특정 날짜를 나타내는 데 사용되며, 시간 값이 필요하기 때문에 `TimeSpan`과 함께 사용하는 경우가 많습니다. 질문: 현재 [original] | # 학습 과정 소개 날짜와 시간을 표현하는 DateTime에 대해 알아보고, 활용할 수 있는 다양한 서식 지정자를 알아봅시다. # DateTime 알아보기 DateTime은 날짜와 시간으로 표시된 시간을 나타내는 객체입니다. 값 형식은 그레고리력에서 00:00:00(자정), 서기 0001년 1월 1일부터 9999년 12월 31일 오후 11:59:59까지의 값으로 날짜와 시간을 나타냅니다. DateTime은 맵에 입장한 시간이나, 계정이 생성된 날처럼 특정 날짜를 나타내기 위해 사용합니다. DateTime은 활용할 때 주로 시간 [chunk_id] | Guides:691:0
[task] | wikipedia [title] | 리소스 관리 [category] | Guides [rephrased] | # 메이플스토리 월드: 메이커 사용 리소스 관리 메이플스토리 월드(MapleStory Worlds)의 메이커(Maker)는 크리에이터가 제작한 월드에 사용할 리소스를 효율적으로 관리하고 활용할 수 있도록 다양한 기능을 제공합니다. 이 가이드에서는 메이플스토리 월드에서 제공하는 공식 리소스와 유저가 직접 등록한 리소스의 구별 방법, 각 리소스의 저장 위치별 특성, 그리고 사용 권한 구조에 대해 설명합니다. ## 리소스 개요 및 식별 메이플스토리 월드의 리소스는 프로퍼티 에디터(Property Editor)나 스크립트(Script [original] | # 학습 과정 소개 유저가 메이커에 등록한 리소스를 관리하는 방법에 대해 알아봅시다. # 리소스 구분 메이플스토리 월드에서의 리소스는 프로퍼티 에디터 혹은 스크립트 등에서 사용할 수 있습니다. 그리고 각각의 리소스마다 RUID가 존재합니다. 리소스는 제공자에 따라 **메이플스토리 월드 리소스**와 **유저 리소스**로 나눌 수 있습니다. ## 메이플스토리 월드 리소스 메이플스토리 월드 리소스는 말 그대로 메이플스토리 월드에서 제공하는 리소스를 말합니다. 메이커의 **Resource Storage** 및 [메이플스토리 월드 [chunk_id] | Guides:690:0
[task] | extract_knowledge [title] | TimeSpan으로 시간 표현하기 [category] | Guides [rephrased] | # TimeSpan으로 시간 표현하기 ## 1. 개념 설명 mLua에서는 `TimeSpan` 객체를 사용하여 시간 간격을 표현합니다. 이 객체는 `ToFormattedString` 메서드를 통해 문자열로 변환할 수 있으며, 변환 시 표준 서식 지정자나 사용자 지정 서식 문자열을 사용할 수 있습니다. ### 표준 서식 지정자 "G" 일반 긴 서식 지정자 `"G"`는 일 수, 시간, 분, 초, 그리고 초의 소수 부분(3자리)을 포함하여 출력합니다. 기본 형식은 `[-]d':'hh':'mm':'ss.fff` 입니다. | 기호 | [original] | 일반 긴 서식 지정자 "G"는 항상 일 수와 소수 세 자릿수를 출력하고 문화권을 구분합니다. 형식은 [-]d':'hh':'mm':'ss.fff 입니다. | 기호 | 설명 | | --- | --- | | - | 음수를 나타내는 기호 | | . | 초 소수 구분을 나타냅니다. | | fff | 초의 소수 부분을 나타냅니다. | | ss | "00"부터 "59" 범위의 초를 나타냅니다.| | mm | "00"부터 "59" 범위의 분을 나타냅니다. | | hh | "00"부터 "23" 범위의 시간을 나타냅니다. | | d | 일 수를 나 [chunk_id] | Guides:689:2
[task] | distill [title] | 날짜와 시간 활용하기 [category] | Guides [rephrased] | # [Guides] 게임 로직/시스템: 날짜와 시간 활용하기 `DateTime` 객체는 기본적으로 **UTC** 기준으로 동작하며, `Elapsed` 속성을 통해 다른 실행 공간(Server/Client) 간에 전달할 수 있습니다. ## 1. 실행 공간 간 전달 (Server -> Client) `DateTime` 객체 자체를 직접 전달할 수 없으므로, `Elapsed` 값(숫자)을 전달받아 클라이언트에서 다시 `DateTime` 객체로 복원합니다. ```lua [server only] void OnBeginPlay() { [original] | DataTime을 DateElapsed를 사용해 다른 실행 공간에서 DateTime을 활용할 수 있습니다. ```lua [server only] void OnBeginPlay() { wait(1) local date = DateTime(2022, 5, 17, 13, 21, 35) self:ServerToClient(date.Elapsed) } [client] void ServerToClient(number dateElapsed) { local date = DateTime(dateElapsed) [chunk_id] | Guides:691:1
[task] | extract_knowledge [title] | 리소스 관리 [category] | Guides [rephrased] | # 메이플스토리 월드 리소스 관리 ## 1. 개념 설명 메이플스토리 월드(MapleStory Worlds)에서 리소스는 프로퍼티 에디터나 스크립트(mLua)에서 참조되는 데이터 단위를 의미하며, 각 리소스는 고유 식별자인 `RUID`를 가집니다. 리소스는 제공 주체에 따라 두 가지로 구분됩니다. 1. **메이플스토리 월드 리소스 (MSW 리소스)**: 플랫폼에서 공식적으로 제공하는 리소스입니다. 2. **유저 리소스**: 크리에이터가 직접 등록하거나 복제하여 소유권을 가진 리소스입니다. 유저 리소스는 등록 위치에 따라 * [original] | # 학습 과정 소개 유저가 메이커에 등록한 리소스를 관리하는 방법에 대해 알아봅시다. # 리소스 구분 메이플스토리 월드에서의 리소스는 프로퍼티 에디터 혹은 스크립트 등에서 사용할 수 있습니다. 그리고 각각의 리소스마다 RUID가 존재합니다. 리소스는 제공자에 따라 **메이플스토리 월드 리소스**와 **유저 리소스**로 나눌 수 있습니다. ## 메이플스토리 월드 리소스 메이플스토리 월드 리소스는 말 그대로 메이플스토리 월드에서 제공하는 리소스를 말합니다. 메이커의 **Resource Storage** 및 [메이플스토리 월드 [chunk_id] | Guides:690:0
[task] | wikipedia [title] | 날짜와 시간 활용하기 [category] | Guides [rephrased] | # 날짜와 시간 활용하기 본 문서는 `DateTime` 객체의 구조와 사용법을 설명하며, 시간 계산을 위해 함께 사용되는 `TimeSpan` 객체와 다양한 서식 지정자에 대한 정보를 제공합니다. ## 1. DateTime 개요 `DateTime`은 그레고리력(Gregorian calendar) 기준으로 0001년 1월 1일 자정(00:00:00)부터 9999년 12월 31일 오후 11:59:59까지의 범위를 가진 날짜와 시간을 나타내는 객체입니다. 이 객체는 맵 입장 시각이나 계정 생성일과 같이 특정 시점을 기록하는 데 주로 [original] | # 학습 과정 소개 날짜와 시간을 표현하는 DateTime에 대해 알아보고, 활용할 수 있는 다양한 서식 지정자를 알아봅시다. # DateTime 알아보기 DateTime은 날짜와 시간으로 표시된 시간을 나타내는 객체입니다. 값 형식은 그레고리력에서 00:00:00(자정), 서기 0001년 1월 1일부터 9999년 12월 31일 오후 11:59:59까지의 값으로 날짜와 시간을 나타냅니다. DateTime은 맵에 입장한 시간이나, 계정이 생성된 날처럼 특정 날짜를 나타내기 위해 사용합니다. DateTime은 활용할 때 주로 시간 [chunk_id] | Guides:691:0
[task] | knowledge_list [title] | 날짜와 시간 활용하기 [category] | Guides [rephrased] | ```lua -- 핵심 사실 목록 ``` 1. `DateTime` 생성 시 시간과 오전/오후(AM/PM) 지정자만 포함된 문자열(예: `"7 PM"`)은 날짜 구성 요소를 현재 날짜로, 분과 초를 `00:00`으로 가정하여 처리합니다. 2. ISO 8601 표준 시간대 정보를 포함하는 문자열(예: `"2022-08-18T07:22:16.000Z"`)을 `DateTime` 생성에 사용할 경우, 기본값으로 UTC 기준으로 저장되며 `Z` 지정자가 포함된 경우 입력된 시간 값이 그대로 유지됩니다. 3. ISO 8601 표준 시간대 오프 [original] | 시간과 오전/오후(AM/PM) 지정자만 있고 날짜 구성 요소가 없는 문자열의 경우 날짜 구성 요소는 현재 날짜를, 시간(분, 초)은 00:00을 가정합니다. ```lua local dateAsString = "7 PM" local date = DateTime(dateAsString) log(date) -- 05/09/2022 19:00:00 ``` #### ISO 8601 문자열 표준 시간대 정보를 포함하고, ISO 8601을 준수하는 문자열을 사용하는 경우에 DateTime은 기본적으로 UTC로 저장됩니다. 그러므로 UTC [chunk_id] | Guides:691:2
[task] | distill [title] | 날짜와 시간 활용하기 [category] | Guides [rephrased] | # 표준 날짜/시간 서식 지정자 `DateTime` 객체의 `ToFormattedString(format, culture?)` 메서드를 통해 사용 가능합니다. 문화권(`culture`)을 지정하지 않으면 기본 서식이 적용되며, 지정 시 해당 문화권 서식이 적용됩니다. | 지정자 | 설명 | 기본 서식 (문화권 미지정) | | :--- | :--- | :--- | | **"D"** | 자세한 날짜 | `dddd, dd MMMM yyyy` | | **"f"** | 자세한 날짜 + 간단한 시간 | `dddd, dd MMMM yyyy [original] | "D" 표준 서식 지정자는 특정 문화권의 자세한 날짜 서식 문자열을 나타냅니다. 문화권을 지정하지 않으면 서식 문자열은 **"dddd, dd MMMM yyyy"**을 사용합니다. ```lua local date = DateTime(2022, 4, 10) log(date:ToFormattedString("D")) -- Sunday, 10 April 2022 log(date:ToFormattedString("D", "pt-BR")) -- domingo, 10 de abril de 2022 ``` #### "f" "f" 표준 서식 [chunk_id] | Guides:691:3
[task] | wikipedia [title] | 날짜와 시간 활용하기 [category] | Guides [rephrased] | # 날짜와 시간 활용하기 (DateTime) mLua 환경에서는 `DateTime` 객체를 통해 날짜와 시간을 관리할 수 있으며, `DateElapsed` 값을 사용하여 서버와 클라이언트 등 다른 실행 공간 사이에서 시간 정보를 공유하고 활용할 수 있습니다. 기본적으로 `DateTime`은 UTC(협정 세계시) 기준으로 설정됩니다. ## 실행 공간 간 DateTime 활용 서버에서 생성한 `DateTime` 객체의 `Elapsed` 속성 값을 클라이언트로 전달하여, 클라이언트 측에서 동일한 시간 정보를 복원할 수 있습니다. 아 [original] | DataTime을 DateElapsed를 사용해 다른 실행 공간에서 DateTime을 활용할 수 있습니다. ```lua [server only] void OnBeginPlay() { wait(1) local date = DateTime(2022, 5, 17, 13, 21, 35) self:ServerToClient(date.Elapsed) } [client] void ServerToClient(number dateElapsed) { local date = DateTime(dateElapsed) [chunk_id] | Guides:691:1
[task] | knowledge_list [title] | 날짜와 시간 활용하기 [category] | Guides [rephrased] | 1. `DateTime` 타입의 `ToFormattedString` 메서드는 첫 번째 매개변수로 표준 서식 지정자를, 두 번째 매개변수로 선택적 문화권 문자열을 받아 포맷된 날짜 문자열을 반환합니다. 2. 표준 서식 지정자 "D"는 특정 문화권의 자세한 날짜 서식 문자열을 나타내며, 문화권을 지정하지 않으면 기본 서식 문자열은 "dddd, dd MMMM yyyy"입니다. 3. 표준 서식 지정자 "f"는 공백으로 구분된 자세한 날짜("D")와 간단한 시간("t")이 조합된 문자열을 나타내며, 문화권을 지정하지 않으면 기본 서식 문자열 [original] | "D" 표준 서식 지정자는 특정 문화권의 자세한 날짜 서식 문자열을 나타냅니다. 문화권을 지정하지 않으면 서식 문자열은 **"dddd, dd MMMM yyyy"**을 사용합니다. ```lua local date = DateTime(2022, 4, 10) log(date:ToFormattedString("D")) -- Sunday, 10 April 2022 log(date:ToFormattedString("D", "pt-BR")) -- domingo, 10 de abril de 2022 ``` #### "f" "f" 표준 서식 [chunk_id] | Guides:691:3
[task] | extract_knowledge [title] | 날짜와 시간 활용하기 [category] | Guides [rephrased] | # 날짜와 시간 관리: DateTime ## 1. 개념 설명 `DateTime`은 날짜와 시간을 표현하는 객체입니다. 그레고리력 기준으로 서기 0001년 1월 1일 자정(00:00:00)부터 9999년 12월 31일 오후 11:59:59까지의 범위를 지원합니다. 맵 입장 시간, 계정 생성일 등 특정 시점을 기록하거나 계산할 때 사용됩니다. 시간 간격 계산이 필요할 때는 `TimeSpan`과 함께 사용하는 경우가 많습니다. ## 2. API 사용법 ### 2.1. 상수 (Constants) 별도의 할당 없이 직접 참조하여 사용할 [original] | # 학습 과정 소개 날짜와 시간을 표현하는 DateTime에 대해 알아보고, 활용할 수 있는 다양한 서식 지정자를 알아봅시다. # DateTime 알아보기 DateTime은 날짜와 시간으로 표시된 시간을 나타내는 객체입니다. 값 형식은 그레고리력에서 00:00:00(자정), 서기 0001년 1월 1일부터 9999년 12월 31일 오후 11:59:59까지의 값으로 날짜와 시간을 나타냅니다. DateTime은 맵에 입장한 시간이나, 계정이 생성된 날처럼 특정 날짜를 나타내기 위해 사용합니다. DateTime은 활용할 때 주로 시간 [chunk_id] | Guides:691:0