返回一個新的 `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

返回表示給定 Unix 時間戳的 `Datatype.DateTime`。

從給定的 Unix 時間戳或自 1970 年 1 月 1 日 00:00（UTC）以來的**毫秒**數返回一個新的 `Datatype.DateTime` 對象。

DateTime.fromUnixTimestampMillis

unixTimestampMillis

返回表示給定的 Unix 時間戳（以毫秒為單位）的 `Datatype.DateTime`。

使用從 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

返回使用給定單位從 UTC 時間創建的新 `Datatype.DateTime`。

使用從本地時間獲得的給定單位返回一個新的 `Datatype.DateTime`。允許的值與
`Datatype.DateTime:ToLocalTime()|ToLocalTime()` 返回的時間值表中的值類似。

- 生成無效日期的日期單位（年、月、日）會引發錯誤。例如，1 月 32 日或不閏年中的 2 月 29 日。
- 正常範圍之外的時間單位（小時、分鐘、秒、毫秒）是有效的。例如，90 分鐘將使小時加1；-10 秒將使分鐘值回退1。
- 非整數值將向下取整。例如，提供 2.5 小時將等同於提供 2 小時，而不是 2 小時 30 分鐘。
- 被省略的值假設為它們正常範圍內的最低值，但年份默認為 1970 年。

DateTime.fromLocalTime

返回使用給定單位從本地時間創建的新 `Datatype.DateTime`。

從以 UTC 時間為準的 ISO 8601 日期時間字符串返回 `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()` 方法支持日期/時間轉換為字符串。
這兩者的工作方式相同，只是解釋的時區不同。

傳遞給這些方法的第一個參數必須是表示以下顯示的令牌之一的字符串。
然後根據提供的區域將這些令牌替換為特定值。

```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]" 的形式出現，如 "June&nbsp;11"。
在法語中，日期的格式為 "[day]&nbsp;[month]"，如 "11&nbsp;juin"。
通過以下複合令牌自動處理這些特殊規則，因此如果您要顯示簡單的時間和/或日期信息，
請使用這些。

<table>
  <thead>
    <tr>
      <th>令牌（Token）</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>令牌（Token）</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.fromUniversalTime()|fromUniversalTime()` 以生成原始的 `Datatype.DateTime` 對象。

DateTime:ToUniversalTime

返回 `Datatype.DateTime` 的 UTC 組件。

將此 `Datatype.DateTime` 對象的值轉換為本地時間。返回的表包含以下鍵：
`Year`、`Month`、`Day`、`Hour`、`Minute`、`Second`、`Millisecond`。有關更多詳細信息，請參閱此數據類型描述中的時間值表。
此表中的值可以傳遞給 `Datatype.DateTime.fromLocalTime()|fromLocalTime()` 以生成原始的 `Datatype.DateTime` 對象。

DateTime:ToLocalTime

返回 `Datatype.DateTime` 的本地時間組件。

將日期格式化為 ISO 8601 日期時間字符串。此函數返回的值可以傳遞給
`Datatype.DateTime.fromIsoDate()|fromIsoDate()` 以生成原始的 `Datatype.DateTime` 對象。

一個 ISO 8601 日期時間字符串的示例是 `2020-01-02T10:30:45Z`，
代表 2020 年 1 月 2 日上午 10:30，45 秒。

DateTime:ToIsoDate

返回作為 ISO 8601 日期時間字符串的 `Datatype.DateTime`。

根據 `Datatype.DateTime` 的值生成字符串，該值解釋為協調世界時間（UTC）和格式字符串。格式字符串應包含令牌，這些令牌將替換為 `Datatype.DateTime` 對象所描述的某些日期/時間值。
有關更多詳細信息，請參閱此數據類型描述中的 **字符串格式** 部分。

```lua
local dt = DateTime.now()
-- 對於 en-us，"LL" 令牌等於 "MMM D, YYYY"，給出 "June 11, 2020"
print("日期是 " .. dt:FormatUniversalTime("LL", "en-us"))
--> "日期是 June 11, 2020"
```

DateTime:FormatUniversalTime

format

locale

返回格式為字符串的 UTC 值的 `Datatype.DateTime`。

根據`Datatype.DateTime` 的值生成字符串，該值解釋為**本地時間**和格式字符串。
格式字符串應包含令牌，這些令牌將替換為 `Datatype.DateTime` 對象所描述的某些日期/時間值。
有關更多詳細信息，請參閱此數據類型描述中的 **字符串格式** 部分。

```lua
local dt = DateTime.now()
-- 對於 en-us，"LL" 令牌等於 "MMM D, YYYY"，給出 "June 11, 2020"
print("日期是 " .. dt:FormatLocalTime("LL", "en-us"))
--> "日期是 June 11, 2020"
```

DateTime:FormatLocalTime

返回格式為字符串的 `Datatype.DateTime` 對象的本地時間值。

DateTime

自 1970 年 1 月 1 日 00:00 UTC（Unix 元年）以來的**秒**數。
範圍是 -17,987,443,200 到 253,402,300,799，約為 1400&ndash;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&ndash;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

分析

平台

教學

創作者計畫

教育

課程

學習

此方法不同步且會傳回一個「Operation」，代表該操作的目前狀態。其中包含一個端點路徑，您可以輪詢以獲得實際回應和適用的中繼資料。詳情請參閱關於長期執行操作的[說明文件]({longRunningOperationsLink})。
            
以下部分描述操作完成時提供的回應和中繼資料物件。

Beta 測試終點已準備好公開使用。可能出現導致功能無法正常運作的變更，但機率不高。

這些開放式雲端文件頁面將於 2026 年 3 月 31 日移除。屆時，系統會自動將你重新導向至新版開放式雲端文件。{linkStart}瞭解詳情{linkEnd}

這些舊版開放式雲端頁面將於 2026 年 3 月 31 日移除，並重新導向至新頁面。{linkStart}瞭解詳情{linkEnd}

實驗端點已可供公開使用，但隨著 API 合約結束，可能會偶爾發生重大變更。

此終點可在體驗內透過 {httpServiceLinkStart}HttpService{httpServiceLinkEnd} 使用 API 金鑰呼叫。

建立資源時可設定此欄位，但可能無法在後續請求中修改。

建立資源時可設定這些欄位，但可能無法在後續請求中修改。

此欄位可在請求中提供，但永遠不會包含在回應中。

舊版本驗證方法。可用時，請務必使用 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} 次要求數

每位應用程式使用者每秒 {limit} 次要求數

每位 API 金鑰擁有者每秒 {limit} 次要求數

範圍控制憑證的權限。憑證只能存取你選取的範圍所支援的端點。

穩定終點已準備好投入正式環境，在其生命週期中幾乎不會發生破壞性變更。

此目標可讓你將金鑰存取權限制為所選的{requiredParts}

此目標可讓你將金鑰存取權限制為所選的{requiredParts}和{optionalParts}

目標類型是用來限制憑證對於資源的權限。即使你的帳戶擁有其他資源的權限，也只能對所選資源執行操作。某些操作範圍不包含特定目標部分。在這種情況下，所有相關資源皆可操作。

對於使用者擁有的 API 金鑰，無需選擇宇宙的頂層部分。在這種情況下，你的 API 金鑰將可存取你所擁有的使用者體驗內容，以及你具備正確群組權限的所有群組體驗內容。

「立即試試」功能尚未支援需要 API 金鑰或 OAuth 2.0 驗證的端點

為了安全起見，Cookie 驗證在高風險操作中已停用。

關鍵風險端點極為敏感，為了安全起見，已停用「立即試試」功能

注意：此程式碼範例中不包含驗證標頭資訊。你可能需要為此指令新增驗證標頭，才能正常運作。

這是一個高風險端點，用以修改或刪除關鍵資料。測試時請格外小心。

此 API 端點已被歸類為高風險，且可能會影響即時資料或使用者帳號。

對於高風險 API 的驗證請求，可能會造成無法撤銷的變更。請在繼續之前仔細檢查請求參數。

這是一個低風險端點，用以擷取資料。測試這個端點通常是安全的。

這是一個中等風險端點，用以修改資料。請謹慎地使用非關鍵帳戶測試，因為變更可能是永久性的。

為了確保帳號安全，切勿從其他來源貼上文字，或將此頁面的資訊傳送給其他人。

你即將使用實際帳號憑證來測試已發布的 API 端點。

除非你了解即將進行的 API 呼叫可能涉及的後果，方可繼續操作。在測試之前，請仔細閱讀 API 文件。

API 呼叫將透過你已驗證的工作階段進行

這些皆為實際 API 呼叫，可能會影響你的帳號或資料

部分操作可能會修改或刪除資料

此終點已被這些建議的替代終點取代：

需要以下範圍才能呼叫此端點。若要了解更多
關於產生正確金鑰的資訊，請參閱[管理 API 金鑰]({apiKeyReferenceDocLink})。

若要了解更多關於產生金鑰的資訊，請參閱[管理 API 金鑰]({apiKeyReferenceDocLink})。

根據相對基本網址的路徑，可使用下列終點。

此字串的格式為 [FieldMask](/cloud/reference/types#fieldmask)。

JSON 值可為「null」、「boolean」、「string」、「number」、「array」或「object」。

若想使用此端點，您的 OAuth 2.0 應用程式需要以下範圍。有關如何註冊 OAuth 2.0 應用程式的更多資訊，請查看[應用程式註冊和審查]({oauth2ReferenceDocLink})。

若要了解更多關於如何註冊 OAuth 2.0 應用程式的資訊，請參閱[App 註冊與審核]({oauth2ReferenceDocLink})。

以下物件描述被接受或退回的負載。若要獲得更多關於物件使用時機的資訊，請查看個別終點。

需要以下範圍才能呼叫此端點。

資源路徑

此字串的格式為 [Timestamp](/cloud/reference/types#timestamp)。

若想使用此端點，您的 OAuth 2.0 應用程式需要以下範圍。有關如何註冊 OAuth 2.0 應用程式的更多資訊，請查看 [應用程式註冊和審查]（{oauth2ReferenceDocLink}）。

不推薦

你正在檢視新版 Open Cloud 參考資料。

你已選擇退出新版 Open Cloud 參考資料。

建立、更新並管理你的廣告活動。

這可以查看有關您資產的資訊。

這可以上傳和更新 Roblox 的資產。

這項操作可讓你查看主體（包括群組和體驗）的素材權限，以及帳號可存取的素材。

這會允許授予素材權限給您的帳號可存取的任何對象（包含群組和體驗）及素材。

這項操作可讓你代為檢視虛擬人偶自動設定工作的狀態和結果。

這項操作可讓你代為建立和管理虛擬人偶自動設定工作。

授予更新使用者所擁有之徽章的能力。

這會允許查看您商品的相關資訊。

這麼做可對已同步的商品進行變更。

此操作可讓你檢視商務聯絡對象的資訊。

這會允許對您的商務商家連結進行編輯。

這能讓您檢視您創作者商店商品的相關資訊。

這能讓您修改您創作者商店商品的相關資訊。

這項操作可以讓你查看創作者商店儲存項目的相關資訊。

這項操作可讓你修改創作者商店儲存項目的相關資訊。

授予代為建立資料存儲的存取權。

授予代為刪除資料存儲的權限。

授予讀取資料存儲清單的存取權。

授予為資料存儲拍攝快照的存取權。

授予在資料存儲中建立條目的存取權。

授予標記指定條目以進行刪除的存取權。

授予可列出資料存儲項目的存取權。

授予在資料存儲中讀取指定條目的存取權。

授予更新項目值、屬性和使用者的存取權。

授予可刪除資料存儲條目修訂版的存取權。

授予可列出資料存儲條目修訂版的存取權。

授予可讀取資料存儲條目修訂版的存取權。

授予檢視授權使用者開發者產品設定詳細資訊的權限。

授予編輯授權使用者開發者產品的權限。

這會允許查看您宇宙環境的相關資訊。

授予檢視授權使用者遊戲通行證設定詳細資訊的權限。

授予編輯授權使用者遊戲通行證的權限。

授予檢視帳號社群論壇資訊的權限。

授予管理帳號社群論壇資訊的權限。

這會允許查看您社群的相關資訊。

這能讓您管理自己帳號的社群加入申請和低階社群成員的角色更新。

允許你修改個體的屬性資料（目前僅支援指令碼）。

這可以查看有關您道具欄的資訊。

授予管理使用者資產的存取權。

授予管理您徽章和花費 Robux 的權限。

授予更新授權使用者徽章的權限。

授予管理您開發者產品的權限。

授予存取權限，以讀取你已開啟通知的體驗相關資訊。

授予存取權限，代你開啟或關閉體驗通知。

授予讀取與寫入您在地化表格的權限。

授予管理您擁有之所有體驗的團隊協作權限。

授予管理您的體驗及部分體驗相關資訊（例如：在地化資訊）的權限。

授予讀取您體驗之在地化資訊的權限。

授予修改您體驗在地化偏好的權限。

授予管理您使用者帳號的權限。

授予修改使用者在地化偏好的權限。

允許你檢視關聯地點的 Luau 執行任務狀態、紀錄和結果。

允許你為關聯地點建立新的 Luau 執行任務。

授予非同步清除宇宙中所有資料結構的存取權。

授予建立新佇列項目的存取權。

授予從佇列前端捨棄讀取項目的存取權。

授予從佇列前端讀取項目的權限。

授予讀取記憶存儲項目的存取權。

授予建立、更新和刪除地圖項目的存取權。

給予代替使用者發布訊息的能力。

這能讓您的體驗向使用者傳送通知。

（棄用）授予在已排序資料存儲中讀取條目清單的存取權。

（棄用）授予在已排序資料存儲中建立新條目的存取權。

授予從已排序資料存儲中列出條目的存取權。

授予在已排序資料存儲中建立條目的存取權。

此將允許列出與您的體驗相關的機密資料。

此將允許建立並更新與您的體驗相關的機密資料。

此權限可讓你提交評估工作，並檢視工作結果。

授予讀取您訂閱產品相關資訊的權限。

這項操作可讓你代為讀取縮圖資訊。

授予發佈新版本體驗到 Roblox 的權限。

授予編輯授權使用者體驗的權限。

讓您檢視體驗中的使用者限制。

讓您在體驗中編輯使用者限制。

這項操作將允許檢視傳送至你帳號的通知。

授予讀取權限，查看授權使用者的高級會員與驗證狀態。

此舉可以讓你查看授權使用者的社群帳號。

這將授予讀取您個人檔案資訊的權限。