장치의 로컬 시계를 사용하여 현재 시간의 순간을 나타내는 새로운 `Datatype.DateTime`을 반환합니다. 대부분의 운영 체제는 온라인 시간 서버에 대해 로컬 시간을 자동으로 동기화하므로, 이것은 몇 백 밀리초 이내일 것입니다. 그러나 사용자는 동기화 동작을 쉽게 비활성화하고 원하는 대로 시스템 시간을 설정할 수 있습니다. 클라이언트와 서버 간의 동기화된 시간을 원한다면 대신 `Class.Workspace:GetServerTimeNow()`를 사용하십시오.

두 시간 지점 간에 경과한 시간을 정확하게 측정해야 할 때(예를 들어 성능 테스트 시) `Library.os.clock()`를 대신 사용하십시오.

DateTime.now

`Datatype.DateTime`를 반환하여 현재의 시간 순간을 나타냅니다.

주어진 Unix 타임스탬프 또는 1970년 1월 1일 00:00(UTC) 이후의 **초** 수를 나타내는 새로운 `Datatype.DateTime` 객체를 반환합니다.

이 함수는 1초의 정밀도만을 가지고 있습니다. 하위 초 타임스탬프를 나타내려면 대신 `Datatype.DateTime.fromUnixTimestampMillis()`를 사용하십시오.

DateTime.fromUnixTimestamp

unixTimestamp

`Datatype.DateTime`를 반환하여 주어진 Unix 타임스탬프를 나타냅니다.

주어진 Unix 타임스탬프 또는 1970년 1월 1일 00:00(UTC) 이후의 **밀리초** 수를 나타내는 새로운 `Datatype.DateTime` 객체를 반환합니다.

DateTime.fromUnixTimestampMillis

unixTimestampMillis

`Datatype.DateTime`를 반환하여 주어진 Unix 타임스탬프를 밀리초로 나타냅니다.

UTC 시간을 기준으로 주어진 단위를 사용하여 새로운 `Datatype.DateTime`을 반환합니다. 허용된 값은 `Datatype.DateTime:ToUniversalTime()|ToUniversalTime()`이 반환하는 시간 값 테이블에 있는 것과 유사합니다.

- 유효하지 않은 날짜를 생성하는 날짜 단위(년, 월, 일)는 오류를 발생시킵니다. 예를 들어, 1월 32일 또는 윤년이 아닌 해의 2월 29일.
- 정상 범위를 벗어난 시간 단위(시, 분, 초, 밀리초)는 유효합니다. 예를 들어, 90분은 시를 1로 넘어가게 하고, -10초는 분 값을 1 감소시킵니다.
- 비정수 값은 내림 처리됩니다. 예를 들어, 2.5시간을 제공하면 2시간으로 간주됩니다. 2시간 30분이 아닙니다.
- 생략된 값은 정상 범위 내의 최하 값으로 가정되며, 연도는 1970년으로 기본 설정됩니다.

DateTime.fromUniversalTime

year

month

hour

minute

second

millisecond

`Datatype.DateTime`를 반환하여 주어진 단위를 사용하여 UTC 시간에서 생성합니다.

로컬 시간을 기준으로 주어진 단위를 사용하여 새로운 `Datatype.DateTime`을 반환합니다. 허용된 값은 `Datatype.DateTime:ToLocalTime()|ToLocalTime()`이 반환하는 시간 값 테이블에 있는 것과 유사합니다.

- 유효하지 않은 날짜를 생성하는 날짜 단위(년, 월, 일)는 오류를 발생시킵니다. 예를 들어, 1월 32일 또는 윤년이 아닌 해의 2월 29일.
- 정상 범위를 벗어난 시간 단위(시, 분, 초, 밀리초)는 유효합니다. 예를 들어, 90분은 시를 1로 넘어가게 하고, -10초는 분 값을 1 감소시킵니다.
- 비정수 값은 내림 처리됩니다. 예를 들어, 2.5시간을 제공하면 2시간으로 간주됩니다. 2시간 30분이 아닙니다.
- 생략된 값은 정상 범위 내의 최하 값으로 가정되며, 연도는 1970년으로 기본 설정됩니다.

DateTime.fromLocalTime

`Datatype.DateTime`를 반환하여 주어진 단위를 사용하여 로컬 시간에서 생성합니다.

ISO 8601 날짜-시간 문자열을 UTC 시간으로 나타내는 `Datatype.DateTime`을 반환합니다. 이는 `Datatype.DateTime:ToIsoDate()|ToIsoDate()`가 반환하는 문자열처럼 사용할 수 있습니다. 문자열 파싱이 실패할 경우 함수는 `nil`을 반환합니다.

예를 들어, ISO 8601 날짜-시간 문자열은 `2020-01-02T10:30:45Z`이며, 이는 2020년 1월 2일 오전 10시 30분 45초를 나타냅니다.

DateTime.fromIsoDate

isoDate

ISO 8601 날짜-시간 문자열(UTC)에서 `Datatype.DateTime`를 반환합니다.

**DateTime** 데이터 유형은 Unix 타임스탬프를 사용하여 시간의 순간을 나타냅니다.
특정 로케일에서 날짜와 시간을 쉽게 형식화하는 데 사용할 수 있습니다. 문자열로 변환될 때는 저장된 타임스탬프 정수의 문자열 변환이 반환됩니다. 그들은 시간대 값을 저장하지 않습니다. 대신, **DateTime** 객체를 구성하고 사용할 때 시간대가 고려됩니다.

**DateTime** 객체는 그들의 `Datatype.DateTime.UnixTimestampMillis|UnixTimestampMillis` 속성이 동일할 때만 같습니다.

#### 시간 값 테이블

`Datatype.DateTime:ToUniversalTime()|ToUniversalTime()` 및 `Datatype.DateTime:ToLocalTime()|ToLocalTime()` 메서드는 `Year`, `Month`, `Day`와 같은 시간 관련 값의 테이블을 반환합니다. 이러한 함수에 의해 반환된 테이블의 형식은 아래에 설명되어 있으며, 각 정수 요소는 크기 내림차순으로 정렬됩니다.

<table>
<thead>
  <tr>
    <td>이름</td>
    <td>범위</td>
    <td>비고</td>
  </tr>
</thead>
<tbody>
<tr>
  <td><code>Year</code></td><td>1400&ndash;9999</td><td>&mdash;</td>
</tr>
<tr>
  <td><code>Month</code></td><td>1&ndash;12</td><td>&mdash;</td>
</tr>
<tr>
  <td><code>Day</code></td><td>1&ndash;31</td><td>&mdash;</td>
</tr>
<tr>
  <td><code>Hour</code></td><td>0&ndash;23</td><td>&mdash;</td>
</tr>
<tr>
  <td><code>Minute</code></td><td>0&ndash;59</td><td>&mdash;</td>
</tr>
<tr>
  <td><code>Second</code></td><td>0&ndash;60</td><td>보통
  0&ndash;59, 때때로 특정 시스템에서 윤초를 수용하기 위해 60입니다.</td>
</tr> <tr>
  <td><code>Millisecond</code></td><td>0&ndash;999</td><td>&mdash;</td>
</tr>
</tbody>
</table>

#### 문자열 형식

`Datatype.DateTime` 객체는 `Datatype.DateTime:FormatUniversalTime()|FormatUniversalTime()` 및 `Datatype.DateTime:FormatLocalTime()|FormatLocalTime()` 메서드를 통해 날짜/시간 변환을 문자열로 지원합니다. 두 메서드는 작동 방식이 동일하지만 `Datatype.DateTime`이 해석되는 시간대에 따라 다릅니다.

이 메서드에 전달되는 첫 번째 인수는 아래에 표시된 토큰 중 하나를 나타내는 문자열이어야 합니다. 그런 다음 제공된 로케일에 따라 특정 값으로 토큰이 대체됩니다.

```lua
local dt = DateTime.now()

-- "dddd" 토큰은 주중 전체 이름으로 대체됩니다.
print("오늘은 " .. dt:FormatLocalTime("dddd", "en-us"))

-- "en-us" 로케일의 경우 "LL" 토큰은 "MMMM D, YYYY"와 같습니다.
print("날짜는 " .. dt:FormatLocalTime("LL", "en-us"))
```

##### 복합 토큰

로케일에 따라 이 토큰들은 **특정 조합**으로 대체됩니다. 이는 로케일에 맞는 정확한 날짜/시간 문자열을 생성합니다. 예를 들어, 영어로 날짜는 "[month]&nbsp;[day]" 형식으로 표시됩니다. 프랑스어로 날짜는 "[day]&nbsp;[month]" 형식으로 표시됩니다. 이러한 특별한 규칙은 다음 복합 토큰을 통해 자동으로 처리됩니다. 따라서 간단한 시간 및/또는 날짜 정보를 표시할 때 이들을 사용하십시오.

<table>
  <thead>
    <tr>
      <th>토큰</th>
      <th>로케일 예 (형식)</th>
    </tr>
  </thead>
    <thead>
    <tr>
      <th colspan=2>시간</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>LT</code></td>
      <td>
        <div><code>en-us</code> : <code>8:30 PM</code> (<code>h:mm A</code>)</div>
        <div><code>zh-cn</code> : <code>20:30</code> (<code>HH:mm</code>)</div>
      </td>
    </tr>
  </tbody>
    <thead>
    <tr>
      <th colspan=2>초가 있는 시간</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>LTS</code></td>
      <td>
        <div><code>en-us</code> : <code>8:30:25 PM</code> (<code>h:mm:ss A</code>)</div>
        <div><code>zh-cn</code> : <code>20:30:25</code> (<code>HH:mm:ss</code>)</div>
      </td>
    </tr>
  </tbody>
    <thead>
    <tr>
      <th colspan=2>월(숫자), 일, 년</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>L</code></td>
      <td>
        <div><code>en-us</code> : <code>09/04/1986</code> (<code>MM/DD/YYYY</code>)</div>
        <div><code>zh-cn</code> : <code>1986/09/04</code> (<code>YYYY/MM/DD</code>)</div>
      </td>
    </tr>
    <tr>
      <td><code>l</code></td>
      <td>
        <div><code>en-us</code> : <code>9/4/1986</code> (<code>M/D/YYYY</code>)</div>
        <div><code>zh-cn</code> : <code>1986/9/4</code> (<code>YYYY/M/D</code>)</div>
      </td>
    </tr>
  </tbody>
    <thead>
    <tr>
      <th colspan=2>월(이름), 일, 년</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>LL</code></td>
      <td>
        <div><code>en-us</code> : <code>September 4, 1986</code> (<code>MMMM D, YYYY</code>)</div>
        <div><code>zh-cn</code> : <code>1986年9月4日</code> (<code>YYYY年M月D日</code>)</div>
      </td>
    </tr>
    <tr>
      <td><code>ll</code></td>
      <td>
        <div><code>en-us</code> : <code>Sep 4, 1986</code> (<code>MMM D, YYYY</code>)</div>
        <div><code>zh-cn</code> : <code>1986年9月4日</code> (<code>YYYY年M月D日</code>)</div>
      </td>
    </tr>
  </tbody>
    <thead>
    <tr>
      <th colspan=2>월(이름), 일, 년, 시간</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>LLL</code></td>
      <td>
        <div><code>en-us</code> : <code>September 4, 1986 8:30 PM</code> (<code>MMMM D, YYYY h:mm A</code>)</div>
        <div><code>zh-cn</code> : <code>1986年9月4日晚上8点30分</code> (<code>YYYY年M月D日Ah点mm分</code>)</div>
      </td>
    </tr>
    <tr>
      <td><code>lll</code></td>
      <td>
        <div><code>en-us</code> : <code>Sep 4, 1986 8:30 PM</code> (<code>MMM D, YYYY h:mm A</code>)</div>
        <div><code>zh-cn</code> : <code>1986年9月4日 20:30</code> (<code>YYYY年M月D日 HH:mm</code>)</div>
      </td>
    </tr>
  </tbody>
    <thead>
    <tr>
      <th colspan=2>주 중, 월(이름), 일, 년, 시간</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>LLLL</code></td>
      <td>
        <div><code>en-us</code> : <code>Thursday, September 4, 1986 8:30 PM</code> (<code>dddd, MMMM D, YYYY h:mm A</code>)</div>
        <div><code>zh-cn</code> : <code>1986年9月4日星期四晚上8点30分</code> (<code>YYYY年M月D日ddddAh点mm分</code>)</div>
      </td>
    </tr>
    <tr>
      <td><code>llll</code></td>
      <td>
        <div><code>en-us</code> : <code>Thu, Sep 4, 1986 8:30 PM</code> (<code>ddd, MMM D, YYYY h:mm A</code>)</div>
        <div><code>zh-cn</code> : <code>1986年9月4日星期四 20:30</code> (<code>YYYY年M月D日dddd HH:mm</code>)</div>
      </td>
    </tr>
  </tbody>
</table>

##### 기본 토큰

이 토큰 각각은 **단일 값**으로 대체되며 더 큰 시간 문자열의 요소로 사용할 수 있습니다. 단순한 날짜 및 시간 정보가 필요할 경우 이를 피하십시오. **복합 토큰**이 이러한 목적에 더 적합합니다.

<table>
<thead>
  <tr>
    <th>토큰</th>
    <th>예시</th>
  </tr>
</thead>
  <thead>
  <tr>
    <th colspan=2>년</th>
  </tr>
</thead>
<tbody>
<tr>
  <td><code>YY</code></td>
  <td><code>70</code>, <code>71</code>, &hellip;, <code>29</code>, <code>30</code></td>
</tr>
<tr>
  <td><code>YYYY</code></td>
  <td><code>1970</code>, <code>1971</code>, &hellip;, <code>2029</code>, <code>2030</code></td>
</tr>
</tbody>
  <thead>
  <tr>
    <th colspan=2>월</th>
  </tr>
</thead>
<tbody>
<tr>
  <td><code>M</code></td>
  <td><code>1</code>, <code>2</code>, &hellip;, <code>11</code>, <code>12</code></td>
</tr>
<tr>
  <td><code>MM</code></td>
  <td><code>01</code>, <code>02</code>, &hellip;, <code>11</code>, <code>12</code></td>
</tr>
<tr>
  <td><code>MMM</code></td>
  <td><code>Jan</code>, <code>Feb</code>, &hellip;, <code>Nov</code>, <code>Dec</code></td>
</tr>
<tr>
  <td><code>MMMM</code></td>
  <td><code>January</code>, <code>February</code>, &hellip;, <code>November</code>, <code>December</code></td>
</tr>
</tbody>
  <thead>
  <tr>
    <th colspan=2>일</th>
  </tr>
</thead>
<tbody>
<tr>
  <td><code>D</code></td>
  <td><code>1</code>, <code>2</code>, &hellip;, <code>30</code>, <code>31</code></td>
</tr>
<tr>
  <td><code>DD</code></td>
  <td><code>01</code>, <code>02</code>, &hellip;, <code>30</code>, <code>31</code></td>
</tr>
</tbody>
  <thead>
  <tr>
    <th colspan=2>연도 내의 일</th>
  </tr>
</thead>
<tbody>
<tr>
  <td><code>DDD</code></td>
  <td><code>1</code>, <code>2</code>, &hellip;, <code>364</code>, <code>365</code></td>
</tr>
<tr>
  <td><code>DDDD</code></td>
  <td><code>001</code>, <code>002</code>, &hellip;, <code>364</code>, <code>365</code></td>
</tr>
</tbody>
  <thead>
  <tr>
    <th colspan=2>주 중</th>
  </tr>
</thead>
<tbody>
<tr>
  <td><code>d</code></td>
  <td><code>0</code>, <code>1</code>, &hellip;, <code>5</code>, <code>6</code></td>
</tr>
<tr>
  <td><code>dd</code></td>
  <td><code>Su</code>, <code>Mo</code>, &hellip;, <code>Fr</code>, <code>Sa</code></td>
</tr>
<tr>
  <td><code>ddd</code></td>
  <td><code>Sun</code>, <code>Mon</code>, &hellip;, <code>Fri</code>, <code>Sat</code></td>
</tr>
<tr>
  <td><code>dddd</code></td>
  <td><code>Sunday</code>, <code>Monday</code>, &hellip;, <code>Friday</code>, <code>Saturday</code></td>
</tr>
</tbody>
  <thead>
  <tr>
    <th colspan=2>시간</th>
  </tr>
</thead>
<tbody>
<tr>
  <td><code>H</code></td>
  <td><code>0</code>, <code>1</code>, &hellip;, <code>22</code>, <code>23</code></td>
</tr>
<tr>
  <td><code>HH</code></td>
  <td><code>00</code>, <code>01</code>, &hellip;, <code>22</code>, <code>23</code></td>
</tr>
<tr>
  <td><code>h</code></td>
  <td><code>1</code>, <code>2</code>, &hellip;, <code>11</code>, <code>12</code></td>
</tr>
<tr>
  <td><code>hh</code></td>
  <td><code>01</code>, <code>02</code>, &hellip;, <code>11</code>, <code>12</code></td>
</tr>
</tbody>
  <thead>
  <tr>
    <th colspan=2>분</th>
  </tr>
</thead>
<tbody>
<tr>
  <td><code>m</code></td>
  <td><code>0</code>, <code>1</code>, &hellip;, <code>58</code>, <code>59</code></td>
</tr>
<tr>
  <td><code>mm</code></td>
  <td><code>00</code>, <code>01</code>, &hellip;, <code>58</code>, <code>59</code></td>
</tr>
</tbody>
  <thead>
  <tr>
    <th colspan=2>초</th>
  </tr>
</thead>
<tbody>
<tr>
  <td><code>s</code></td>
  <td><code>0</code>, <code>1</code>, &hellip;, <code>58</code>, <code>59</code></td>
</tr>
<tr>
  <td><code>ss</code></td>
  <td><code>00</code>, <code>01</code>, &hellip;, <code>58</code>, <code>59</code></td>
</tr>
</tbody>
  <thead>
  <tr>
    <th colspan=2>소수 초</th>
  </tr>
</thead>
<tbody>
<tr>
  <td><code>S</code></td>
  <td><code>0</code>, <code>1</code>, &hellip;, <code>8</code>, <code>9</code></td>
</tr>
<tr>
  <td><code>SS</code></td>
  <td><code>00</code>, <code>01</code>, &hellip;, <code>98</code>, <code>99</code></td>
</tr>
<tr>
  <td><code>SSS</code></td>
  <td><code>000</code>, <code>001</code>, &hellip;, <code>998</code>, <code>999</code></td>
</tr>
</tbody>
  <thead>
  <tr>
    <th colspan=2>오전/오후</th>
  </tr>
</thead>
<tbody>
<tr>
  <td><code>A</code></td>
  <td><div><code>en-us</code> : <code>AM</code>, <code>PM</code></div>
        <div><code>zh-cn</code> : <code>凌晨|조기|오전|정오|오후|저녁</code></div></td>
</tr>
<tr>
  <td><code>a</code></td>
  <td><div><code>en-us</code> : <code>am</code>, <code>pm</code></div>
        <div><code>zh-cn</code> : <code>凌晨|早上|上午|中午|下午|晚上</code></div></td>
</tr>
</tbody>
</table>


이 `Datatype.DateTime` 객체의 값을 협정 세계시(UTC)로 변환합니다.
반환된 테이블에는 다음 키가 포함됩니다:
`Year`, `Month`, `Day`, `Hour`, `Minute`, `Second`, `Millisecond`. 자세한 내용은 이 데이터 유형 설명의 시간 값 테이블을 참조하세요.
이 테이블 내의 값들은 원래의 `Datatype.DateTime` 객체를 생성하기 위해
`Datatype.DateTime.fromUniversalTime()|fromUniversalTime()`에 전달될 수 있습니다.


DateTime:ToUniversalTime

`Datatype.DateTime`의 구성 요소를 UTC로 반환합니다.


이 `Datatype.DateTime` 객체의 값을 로컬 시간으로 변환합니다. 반환된 테이블에는 다음 키가 포함됩니다: `Year`, `Month`, `Day`, `Hour`, `Minute`, `Second`, `Millisecond`. 자세한 내용은 이 데이터 유형 설명의 시간 값 테이블을 참조하세요. 이 테이블 내의 값들은 원래의 `Datatype.DateTime` 객체를 생성하기 위해
`Datatype.DateTime.fromLocalTime()|fromLocalTime()`에 전달될 수 있습니다.


DateTime:ToLocalTime

`Datatype.DateTime`의 구성 요소를 로컬 시간으로 반환합니다.


날짜를 ISO 8601 날짜-시간 문자열로 포맷합니다. 이 함수가 반환하는 값은
원래의 `Datatype.DateTime` 객체를 생성하기 위해
`Datatype.DateTime.fromIsoDate()|fromIsoDate()`에 전달될 수 있습니다.

예시 ISO 8601 날짜-시간 문자열은 `2020-01-02T10:30:45Z`로,
이는 2020년 1월 2일 10시 30분 45초를 나타냅니다.


DateTime:ToIsoDate

`Datatype.DateTime`을 ISO 8601 날짜-시간 문자열로 반환합니다.


협정 세계시(UTC)로 해석된 `Datatype.DateTime` 값과 포맷 문자열로부터 문자열을 생성합니다. 포맷 문자열에는 토큰이 포함되어야 하며,
이는 `Datatype.DateTime` 객체로 설명된 특정 날짜/시간 값으로 대체됩니다. 자세한 내용은 이 데이터 유형 설명의 **문자열 포맷** 섹션을 참조하세요.

```lua
local dt = DateTime.now()
-- en-us의 경우, "LL" 토큰은 "MMM D, YYYY"에 해당하며, 이는 "2020년 6월 11일"을 제공합니다.
print("The date is " .. dt:FormatUniversalTime("LL", "en-us"))
--> "The date is June 11, 2020"
```


DateTime:FormatUniversalTime

format

locale

UTC로 포맷된 문자열로서 DateTime의 값을 반환합니다.


**로컬 시간**으로 해석된 `Datatype.DateTime` 값과 포맷 문자열로부터 문자열을 생성합니다. 포맷 문자열에는 토큰이 포함되어야 하며,
이는 `Datatype.DateTime` 객체로 설명된 특정 날짜/시간 값으로 대체됩니다. 자세한 내용은 이 데이터 유형 설명의 **문자열 포맷** 섹션을 참조하세요.

```lua
local dt = DateTime.now()
-- en-us의 경우, "LL" 토큰은 "MMM D, YYYY"에 해당하며, 이는 "2020년 6월 11일"을 제공합니다.
print("The date is " .. dt:FormatLocalTime("LL", "en-us"))
--> "The date is June 11, 2020"
```


DateTime:FormatLocalTime

`Datatype.DateTime` 객체의 값을 로컬 시간으로 포맷된 문자열로 반환합니다.


DateTime

1970년 1월 1일 00:00 UTC(Unix 에포크) 이후의 **초** 수입니다. 범위는 -17,987,443,200에서 253,402,300,799까지로, 약 1400년에서 9999년까지입니다.


DateTime.UnixTimestamp

1970년 1월 1일 00:00 UTC(Unix 에포크) 사이의 **초** 수입니다.


1970년 1월 1일 00:00 UTC(Unix 에포크) 이후의 **밀리초** 수입니다. 범위는 -17,987,443,200,000에서 253,402,300,799,999까지로, 약 1400년에서 9999년까지입니다.


DateTime.UnixTimestampMillis

1970년 1월 1일 00:00 UTC(Unix 에포크) 사이의 **밀리초** 수입니다.


시간의 순간을 나타내는 데이터 유형입니다.


/reference/engine/datatypes/DateTime.yaml

Luau

Dictionary

특정 발생 시 연결된 함수를 실행하는 객체입니다.

Data Type

RBXScriptSignal

number

문자, 숫자 및 기호와 같은 문자 시퀀스입니다.

string

체험

아바타

애셋

샘플 및 프로젝트

엔진 API

개방형 클라우드 API

Studio

애널리틱스

플랫폼

튜토리얼

크리에이터 프로그램

교육

코스

학습

비동기적 방식으로, 현재 작업 상태를 나타내는 '작업'을 반환합니다. 여기에는 투표를 진행하여 실제 응답과 적용 가능한 메타데이터를 얻을 수 있는 엔드포인트 경로가 포함됩니다. 자세한 정보는 장기 작업에 관한 [설명서]({longRunningOperationsLink})에서 확인하세요.
            
아래 섹션은 작업 완료 시 제공되는 응답 및 메타데이터 개체에 대한 설명입니다.

베타 끝점이 공개적으로 사용될 준비가 되었습니다. 중대한 변경이 발생할 수 있지만 가능성은 낮습니다.

이 개방형 클라우드 설명서 페이지는 2026년 3월 31일부터 이용할 수 없게 됩니다. 이후에는 새로운 개방형 클라우드 설명서로 자동으로 리디렉션됩니다. {linkStart}자세히 알아보기{linkEnd}

이 기존 개방형 클라우드 페이지는 2026년 3월 31일부터 이용할 수 없게 되며, 새로운 페이지로 리디렉션됩니다. {linkStart}자세히 알아보기{linkEnd}

실험적인 엔드포인트는 공개적으로 사용할 수 있지만, API 계약이 확정되는 과정에서 간헐적으로 호환성이 깨지는 변경이 발생할 수 있습니다.

이 엔드포인트는 API 키를 사용하여 {httpServiceLinkStart}HttpService{httpServiceLinkEnd}를 통해 체험 내에서 호출할 수 있습니다.

이 필드는 리소스를 생성할 때 설정될 수 있지만 후속 요청에 의해 수정될 수는 없습니다.

이 필드는 요청에 제공될 수 있지만 응답에는 포함되지 않습니다.

레거시 인증 방식. 가능한 경우 언제나 API 키 또는 OAuth 2.0을 우선 사용합니다.

각 API 키별: IP 주소당 {periodInSeconds}초마다 {maxInPeriod} 요청

호출에 인증이 필요하지 않습니다. 일반적으로 호출 제한이 매우 낮습니다. 가능한 경우 언제나 API 키 또는 OAuth 2.0을 우선 사용합니다.

각 그룹화에 대해 스키마의 다음 필드 중 하나만 제공해야 하며 나머지는 제외할 수 있습니다.

언제든지 다시 참여할 수 있습니다. {linkStart}피드백을 남겨주세요.{linkEnd}

기존 문서를 보고 계십니다. {linkStart}피드백을 남겨주세요.{linkEnd}

언제든지 옵트아웃하고 이전의 참조 페이지로 리디렉션될 수 있습니다. {linkStart}피드백을 남겨 주세요.{linkEnd}

새롭게 개선된 문서를 보고 계십니다. {linkStart}피드백을 남겨주세요.{linkEnd}

이 필드는 응답에서 설정할 수 있지만 요청에서는 무시됩니다.

참고: 트래픽이 많은 기간에는 속도 제한이 더 낮아질 수 있습니다. 일부 엔드포인트에는 속도 제한이 추가로 적용됩니다. [속도 제한에 대해서 자세히 알아보세요]({link}).

사용자 또는 그룹의 모든 API 키에 일 요청 {limit}건

사용자 또는 그룹의 모든 API 키에 시간당 요청 {limit}건

사용자 또는 그룹의 모든 API 키에 분당 요청 {limit}건

사용자 또는 그룹의 모든 API 키에 초당 요청 {limit}건

API 키 소유자당 분당 요청 {limit}건

앱 사용자당 시간당 요청 {limit}건

앱 사용자당 분당 요청 {limit}건

앱 사용자당 초당 요청 {limit}건

API 키 소유자당 초당 요청 {limit}건

범위는 내 자격 증명에 부여된 권한을 제어합니다. 내 자격 증명은 내가 선택한 범위가 지원하는 끝점만 액세스할 수 있습니다.

안정적인 엔드포인트는 프로덕션 환경에서 바로 사용할 준비가 되어 있으며 수명 주기 동안 호환성을 저해하는 변경이 발생할 가능성이 거의 없습니다.

이 대상은 선택한 {requiredParts}에 대한 내 키 액세스를 제한할 수 있게 해줍니다.

이 대상은 선택한 {requiredParts} 및 {optionalParts}에 대한 내 키 액세스를 제한할 수 있게 해줍니다.

대상 유형은 자격 증명에 권한이 있는 리소스를 제한하는 데 사용됩니다. 계정에 추가 리소스에 대한 권한이 있더라도 선택한 리소스만 이용할 수 있습니다. 일부 범위에는 대상 파트가 없으며, 이 경우 모든 관련 리소스를 이용할 수 있습니다.

사용자 소유 API 키에 대해서는 유니버스의 최상위 레벨 파트를 선택할 필요가 없습니다. 이 경우 API 키는 올바른 그룹 권한이 있는 모든 사용자 소유 체험과 그룹 소유 체험에 액세스할 수 있습니다.

이용해 보기는 아직 API 키 또는 OAuth 2.0 인증이 필요한 끝점에 지원되지 않습니다

안전을 위해 고위험 작업에선 쿠키 인증이 비활성화됩니다.

중요 위험 끝점은 극도로 민감하며 안전을 위해 이용해 보기는 비활성화됩니다

참고: 이 코드 샘플에는 인증 헤더가 포함되지 않습니다. 이 명령이 작동하려면 인증 헤더를 추가해야 할 수 있습니다.

중요 데이터를 수정하거나 삭제할 수 있는 고위험 끝점입니다. 테스트 시 매우 신중하게 이용하세요.

이 API 엔드포인트는 높은 위험으로 분류되었으며 라이브 데이터나 사용자 계정에 영향을 줄 수 있습니다.

높은 위험 API로의 인증된 요청은 되돌릴 수 없는 변경 사항을 초래할 수도 있습니다. 진행하기 전에 요청 매개변수를 신중하게 검토하세요.

쿠키 인증을 사용하려면 로그인하세요

데이터를 가져오는 저위험 끝점입니다. 일반적으로 테스트하기에 안전합니다.

데이터를 수정하는 중간 정도의 위험 끝점입니다. 변경 사항이 영구적으로 적용될 수 있으므로, 중요하지 않은 계정으로 신중하게 테스트하세요.

계정을 안전하게 보호하려면 다른 소스의 텍스트를 이곳에 붙여넣거나 이 페이지의 정보를 타인에게 전송하지 마세요.

실제 계정 자격 증명을 이용하여 실시간 API 끝점을 테스트하려고 합니다.

진행하려는 API 호출이 주는 영향을 이해한 경우에만 진행하세요. 테스트 전에 API 문서를 주의 깊게 읽어보시기 바랍니다.

API 호출은 인증된 세션을 이용해 진행됩니다

이는 실제 API 호출로, 회원님의 계정 또는 데이터에 영향을 줄 수 있습니다

비율 제한 및 기타 API 제한이 적용됩니다

일부 작업이 데이터를 수정하거나 삭제할 수 있습니다

이 끝점은 다음 추천 끝점으로 대체되었습니다.

이 엔드포인트를 호출하려면 다음 스코프가 필요합니다. 적절한 키 생성에 대한
자세한 내용은 [API 키 관리]({apiKeyReferenceDocLink})에서 확인하세요.

키 생성에 대한 자세한 내용은 [API 키 관리]({apiKeyReferenceDocLink})에서 확인하세요.

다음 끝점은 기준 URL과 관련된 경로에서 사용할 수 있습니다.

이 문자열은 [FieldMask](/cloud/reference/types#fieldmask) 형식으로 지정됩니다.

JSON 값은 `null`, `boolean`, `string`, `number`, `array`, `object`일 수 있습니다.

OAuth 2.0 애플리케이션에서 이 엔드포인트를 사용하려면 다음 범위가 필요합니다. OAuth 2.0 애플리케이션 등록 방법에 대한 자세한 내용은 [앱 등록 및 심사]({oauth2ReferenceDocLink})에서 확인하세요.

OAuth 2.0 애플리케이션 등록 방법에 대한 자세한 내용은 [앱 등록 및 검토]({oauth2ReferenceDocLink})에서 확인하세요.

다음 개체는 수락되거나 반환되는 페이로드를 설명합니다. 이러한 개체가 사용되는 시기에 대한 자세한 정보는 각 개별 끝점을 참고하세요.

이 끝점을 호출하려면 다음 스코프가 필요합니다.

리소스 경로

이 문자열은 [Timestamp](/cloud/reference/types#timestamp) 형식으로 지정됩니다.

권장되지 않음

개선된 개방형 클라우드 참조를 보고 있습니다.

새로운 오픈 클라우드 참조에서 옵트아웃했습니다.

광고 캠페인과 캠페인의 성과를 확인합니다.

광고 캠페인을 만들고, 업데이트하고, 관리합니다.

이를 통해 애셋에 대한 정보를 볼 수 있습니다.

이를 통해 애셋을 Roblox에 업로드하고 업데이트할 수 있습니다.

이는 나의 계정이 액세스할 수 있도록 주제(그룹 및 체험 포함)와 애셋에 애셋 권한을 볼 수 있도록 합니다.

이는 나의 계정이 액세스할 수 있는 모든 주체(그룹 및 체험 포함)와 애셋에 애셋 권한을 부여할 수 있도록 합니다.

이를 통해 사용자를 대신하여 아바타 자동 설정 작업의 상태와 결과를 볼 수 있습니다.

이를 통해 사용자를 대신하여 아바타 자동 설정 작업을 만들고 관리할 수 있습니다.

사용자가 소유한 배지를 업데이트할 수 있는 권한을 부여합니다.

이를 통해 커머스 아이템에 대한 정보를 볼 수 있습니다.

이를 통해 동기화된 커머스 아이템을 변경할 수 있습니다.

이를 통해 커머스 판매자 연결과 관련된 정보를 볼 수 있습니다.

이를 통해 커머스 판매자 연결을 편집할 수 있습니다.

이를 통해 크리에이터 상점 상품에 대한 정보를 볼 수 있습니다.

이를 통해 크리에이터 상점 상품에 대한 정보를 수정할 수 있습니다.

이를 통해 크리에이터 상점 저장 상품에 대한 정보를 볼 수 있습니다.

이를 통해 크리에이터 상점 저장 상품에 대한 정보를 수정할 수 있습니다.

나를 대신해 데이터 저장소를 생성할 권한을 부여합니다.

나를 대신해 데이터 저장소를 삭제할 수 있도록 권한을 부여합니다.

데이터 저장소의 목록을 읽을 권한을 부여합니다.

데이터 저장소의 스냅샷을 촬영할 권한을 부여합니다.

데이터 저장소에서 항목을 생성할 권한을 부여합니다.

지정된 항목을 삭제 대상으로 표시할 수 있는 권한을 부여합니다.

데이터 저장소 항목을 나열할 권한을 부여합니다.

데이터 저장소에서 지정된 항목을 읽을 권한을 부여합니다.

항목의 값, 특성, 사용자를 업데이트할 수 있는 권한을 부여합니다.

데이터 저장소 항목의 수정 사항을 삭제할 권한을 부여합니다.

데이터 저장소 항목의 수정 사항을 나열할 권한을 부여합니다.

데이터 저장소 항목의 수정 사항을 읽을 권한을 부여합니다.

승인한 사용자의 개발자 제품에 대한 구성 세부 정보를 볼 권한을 부여합니다.

승인한 사용자의 개발제 제품을 편집할 권한을 부여합니다.

이를 통해 유니버스의 환경을 볼 수 있습니다.

이를 통해 유니버스의 환경을 편집할 수 있습니다.

승인한 사용자의 게임 패스에 대한 구성 세부 정보를 볼 권한을 부여합니다.

승인한 사용자의 게임 패스를 편집할 권한을 부여합니다.

계정의 커뮤니티 포럼 정보를 볼 수 있도록 권한을 부여합니다.

계정의 커뮤니티 포럼 정보를 관리할 수 있는 권한을 부여합니다.

이를 통해 커뮤니티에 대한 정보를 볼 수 있습니다.

이를 통해 계정에 대한 커뮤니티 가입 요청과 등급이 낮은 커뮤니티 멤버의 역할 업데이트를 관리할 수 있습니다.

인스턴스의 속성 데이터를 조회하는 권한입니다.

인스턴스의 속성 데이터를 수정할 수 있는 권한입니다(현재는 스크립트만 지원됩니다).

이를 통해 인벤토리에 대한 정보를 볼 수 있습니다.

사용자 애셋을 관리할 수 있는 액세스 권한을 부여합니다.

내 배지를 관리할 수 있는 액세스 권한을 부여합니다.

내 배지를 관리하고 Robux를 사용할 수 있는 액세스 권한을 부여합니다.

승인한 사용자의 배지를 업데이트할 권한을 부여합니다.

내 개발자 상품을 관리할 수 있는 액세스 권한을 부여합니다.

알림을 설정 중인 체험의 정보를 읽을 수 있는 권한을 부여합니다.

나를 대신해 체험에 대한 알림을 켜거나 끌 수 있는 권한을 부여합니다.

내 패스를 관리할 수 있는 액세스 권한을 부여합니다.

내 커뮤니티를 관리할 수 있는 권한을 부여합니다.

커뮤니티 정보를 읽을 수 있는 권한을 부여합니다.

커뮤니티 관리 권한을 부여합니다.

내 로컬라이제이션 테이블을 읽고 쓸 수 있는 액세스 권한을 부여합니다

소유한 모든 체험의 팀 공동 작업을 관리할 수 있는 권한을 부여합니다.

체험 및 체험과 관련된 특정 정보를 관리할 자격을 부여합니다(예: 로컬라이제이션 정보).

내 체험의 로컬라이제이션 정보를 읽을 수 있는 액세스 권한을 부여합니다.

내 체험의 로컬라이제이션 기본 설정을 수정할 수 있는 액세스 권한을 부여합니다.

내 사용자 계정을 관리할 수 있는 권한을 부여합니다.

사용자 로컬라이제이션 기본 설정을 수정할 수 있는 액세스 권한을 부여합니다.

관련 플레이스의 상태, 로그, Luau 실행 작업의 결과를 조회할 수 있습니다.

관련 플레이스의 새로운 Luau 실행 작업을 생성할 수 있는 권한입니다.

유니버스 내 모든 데이터 구조를 비동기적으로 플러시할 수 있는 권한을 부여합니다.

신규 대기열 아이템을 생성할 권한을 부여합니다.

대기열 앞부분에서 읽은 아이템을 폐기할 수 있는 권한을 부여합니다.

대기열 앞부분에서 아이템을 읽을 수 있는 권한을 부여합니다.

메모리 저장소 아이템을 읽을 권한을 부여합니다.

맵 아이템을 읽는 권한을 부여합니다.

맵 아이템을 생성하고, 업데이트하고, 삭제하는 권한을 부여합니다.

사용자를 대신해 메시지를 게시할 수 있는 권한이 부여됩니다.

이를 통해 체험에서 사용자에게 알림을 보낼 수 있습니다.

(사용되지 않음) 정렬된 데이터 저장소에서 아이템 목록을 읽을 권한을 부여합니다.

(사용되지 않음) 정렬된 데이터 저장소에서 신규 항목을 생성할 권한을 부여합니다.

정렬된 데이터 저장소에서 아이템을 조회할 권한을 부여합니다.

정렬된 데이터 저장소에서 항목을 생성할 권한을 부여합니다.

이를 통해 체험과 관련된 보안 비밀을 나열할 수 있습니다.

이를 통해 체험과 관련된 보안 비밀을 생성하고 업데이트할 수 있습니다.

이 권한을 통해 평가 작업을 제출하고 결과를 조회할 수 있습니다.

구독 상품에 대해 읽을 수 있는 액세스 권한을 부여합니다.

이를 통해 사용자를 대신하여 썸네일 정보를 읽을 수 있습니다.

게임 애널리틱스를 읽을 수 있는 권한을 부여합니다.

플레이스 정보를 읽을 수 있는 권한을 부여합니다.

플레이스 정보를 편집할 수 있는 권한을 부여합니다.

체험의 새로운 버전을 Roblox에 게시할 수 있는 권한을 부여합니다.

체험 정보를 읽을 수 있는 권한을 부여합니다.

승인한 사용자의 체험을 편집할 권한을 부여합니다.

체험에서 사용자 제한을 볼 수 있습니다.

체험에서 사용자 제한을 편집할 수 있습니다.

계정으로 전송된 알림을 볼 수 있습니다.

승인한 사용자의 Premium 및 인증 상태를 읽을 수 있는 권한을 부여합니다.

이를 통해 승인한 사용자의 소셜 계정을 볼 수 있습니다.

이 작업은 싱글 사인온 기능을 활성화합니다.

프로필 정보를 읽을 수 있는 액세스 권한을 부여합니다.