デバイスのローカルクロックを使用して、現在の瞬間を表す新しい `Datatype.DateTime` を返します。ほとんどのオペレーティングシステムはオンラインタイムサーバーに対してローカル時刻を自動的に同期するため、数百ミリ秒以内であるべきです。ただし、ユーザーは同期動作を簡単に無効にし、システム時刻を好きなように設定できます。クライアントとサーバー間で同期された時刻が必要な場合は、代わりに `Class.Workspace:GetServerTimeNow()` を使用してください。

パフォーマンスをテストするなど、2つの時点間の経過時間を正確に測定する必要がある場合は、代わりに `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()` メソッドを通じて日付/時刻を文字列に変換することをサポートします。
これらは両方とも同じように機能しますが、`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]" の形式で "June&nbsp;11" のようになります。
フランス語では、日付は "[day]&nbsp;[month]" の形式で "11&nbsp;juin" になります。
これらの特別なルールは、次の合成トークンを通じて自動的に処理されるため、単純な時刻や日付情報を表示する場合は、これらを使用してください。

<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>AM/PM</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 日時文字列として返します。

`Datatype.DateTime` 値を協定世界時 (UTC) とフォーマット文字列として解釈し、文字列を生成します。フォーマット文字列にはトークンを含める必要があり、これにより `Datatype.DateTime` オブジェクトで説明された特定の日付/時間値に置き換えられます。詳細については、このデータ型の説明の **String Format** セクションを参照してください。

```lua
local dt = DateTime.now()
-- en-us では、"LL" トークンは "MMM D, YYYY" に等しく、これにより "2020年6月11日" になります。
print("日付は " .. dt:FormatUniversalTime("LL", "en-us"))
--> "日付は 2020年6月11日"
```


DateTime:FormatUniversalTime

format

locale

`Datatype.DateTime` の値を UTC にフォーマットした文字列として返します。

`Datatype.DateTime` 値を **ローカル時間** とフォーマット文字列として解釈し、文字列を生成します。フォーマット文字列にはトークンを含める必要があり、これにより `Datatype.DateTime` オブジェクトで説明された特定の日付/時間値に置き換えられます。詳細については、このデータ型の説明の **String Format** セクションを参照してください。

```lua
local dt = DateTime.now()
-- en-us では、"LL" トークンは "MMM D, YYYY" に等しく、これにより "2020年6月11日" になります。
print("日付は " .. dt:FormatLocalTime("LL", "en-us"))
--> "日付は 2020年6月11日"
```


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

バーチャル空間

Avatar

アセット

サンプルとプロジェクト

エンジン API

オープンクラウド API

Studio

解析

プラットフォーム

チュートリアル

クリエータープログラム

学習

コース

学ぶ

このメソッドは非同期で、操作の現在の状態を表す `Operation` を返します。このメソッドにはエンドポイントパスが含まれており、これをポーリングすることで実際の応答と該当するメタデータを取得することができます。長時間実行オペレーションについて詳しくは、[ドキュメンテーション]({longRunningOperationsLink})  を参照してください。
            
以下のセクションでは、操作が完了したときに提供される応答とメタデータオブジェクトについて説明します。

ベータエンドポイントが一般向けに使用できるようになりました。破壊的変更は可能ですがまれです。

これらのOpen Cloudドキュメンテーションページは2026年3月31日に削除され、その時点で、新しいOpen Cloudドキュメンテーションに自動的にリダイレクトされます。{linkStart}もっと詳しく{linkEnd}

これらの古いOpen Cloudページは2026年3月31日に削除され、リダイレクトされます。{linkStart}もっと詳しく{linkEnd}

実験的なエンドポイントは公開に向けて準備ができていますが、APIコントラクトが確定するにつれて、時折重大な変更が発生する可能性があります。

このエンドポイントは、APIキーを使って{httpServiceLinkStart}HttpService{httpServiceLinkEnd}を介してバーチャル空間内で呼び出すことができます。

このフィールドはリソースの作成時に設定できますがその後のリクエストでは変更することはできません。

この欄はリソースの作成時に設定できますがその後のリクエストでは変更することはできません。

このフィールドはリクエスト上で提供されることはあるかもしれませんが、応答に入ることはありません。

旧型の認証方式。利用可能な場合は、常にAPIキーまたはOAuth 2.0の使用をお勧めします。

各APIキー：各IPアドレスにつき {maxInPeriod} 回のリクエストが {periodInSeconds} 秒ごとに送信されます

呼び出しに認証を必要としません。通常、レート制限が大幅に低下します。利用可能な場合は、常にAPIキーまたはOAuth 2.0の使用をお勧めします。

各グループ化について、スキーマ内の次のフィールドの1つのみを提供する必要があります。残りは除外できます。

いつでも再度オプトインできます。{linkStart}ご意見・ご感想をお寄せください。{linkEnd}

表示されているのは古いドキュメントです。{linkStart}ご意見・ご感想をお寄せください。{linkEnd}

いつでもオプトアウトして元のリファレンスページに戻ることができます。{linkStart}ご意見・ご感想はこちらからお寄せください。{linkEnd}

表示されているのは改訂されたドキュメントです。{linkStart}ご意見・ご感想をお寄せください。{linkEnd}

このフィールドは応答に設定できますが、リクエストでは無視されます。

注意: トラフィックが集中する時間帯には、呼び出し回数制限が低くなる場合があります。一部のエンドポイントには、追加の呼び出し回数制限が適用されます。 [呼び出し回数制限について詳しく]({link})。

ユーザー1人またはグループ1つのすべてのAPI キーで1日あたりリクエスト {limit} 回

ユーザー1人またはグループ1つのすべてのAPI キーで1時間あたりリクエスト {limit} 回

ユーザー1人またはグループ1つのすべてのAPI キーで1分あたりリクエスト {limit} 回

ユーザー1人またはグループ1つのすべてのAPI キーで1秒あたりリクエスト {limit} 回

API キー所有者1人1分あたりリクエスト {limit} 回

アプリユーザー1人1日あたりリクエスト {limit} 回

アプリユーザー1人1時間あたりリクエスト {limit} 回

アプリユーザー1人1分間あたりリクエスト {limit} 回

アプリユーザー1人1秒あたりリクエスト {limit} 回

API キー所有者1人1秒あたりリクエスト {limit} 回

スコープは、認証情報が持つ権限を制御します。認証情報は、選択したスコープでサポートされているエンドポイントにのみアクセスできます。

安定したエンドポイントは本番環境に対応しており、その存続期間中に重大な変更が発生することはほとんどありません。

このターゲットを使用すると、選択した{requiredParts}へのキーのアクセスを制限できます

このターゲットを使用すると、選択した{requiredParts}と{optionalParts}へのキーのアクセスを制限できます

ターゲットタイプは、認証情報が権限を持つリソースを制限するために使用されます。アカウントが追加のリソースに対する権限を持っている場合でも、選択されたリソースのみが実行されます。一部のスコープにはターゲットパーツがありません。この場合、関連するすべてのリソースを実行できます。

ユーザー所有のAPIキーの場合、ユニバーストップレベルパーツを選択する必要はありません。この場合、APIキーは、適切なグループ権限を持つすべてのユーザー所有のバーチャル空間とグループ所有のバーチャル空間にアクセスできます。

APIキーまたはOAuth 2.0認証を必要とするエンドポイントでは、「試してみる」はまだサポートされていません

安全のため、リスクの高い操作ではCookie認証が無効になっています。

重大なリスクのエンドポイントは非常に機密性が高く、安全のため「試してみる」は無効になっています

注：認証ヘッダーはこのコードサンプルには含まれていません。このコマンドを機能させるには、認証ヘッダーの追加が必要となる場合があります。

重要なデータを変更または削除できる高リスクのエンドポイントです。テストの際は細心の注意を払ってください。

このAPIエンドポイントは高リスクに分類されており、公開済みデータまたはユーザーアカウントに影響を与える可能性があります。

高リスクAPIへの認証済みリクエストは、元に戻せない変更を加える可能性があります。続行する前に、リクエストパラメータを注意深く確認してください。

Cookie認証を使用するにはログインしてください

データを取得する低リスクのエンドポイントです。一般的に、テストしても安全です。

データを変更する中程度のリスクのエンドポイントです。変更が永続的なものになる可能性があるため、重要でないアカウントで慎重にテストしてください。

お持ちのアカウントを保護するには、他のソースからのテキストをここに貼り付けたり、このページから他の人に情報を送信したりしないでください。

実際のアカウント認証情報を使用して、公開済みAPIエンドポイントをテストしようとしています。

行おうとしているAPI呼び出しの影響を理解している場合にのみ、続行してください。テストの前にAPIドキュメントを注意深く確認してください。

API呼び出しは、認証されたセッションを使用して行われます

アカウントまたはデータに影響を与える可能性のある実際のAPI呼び出しです

レート制限とその他のAPI制限が適用されます

一部の操作では、データが変更または削除される場合があります

このエンドポイントは、以下の推奨代替エンドポイントに置き換えられました。

このエンドポイントを呼び出すには、次のスコープが必要です。適切なキーの生成に関する詳細は、[APIキーの管理]({apiKeyReferenceDocLink})を参照してください。

キーの生成に関する詳細は、[APIキーの管理]({apiKeyReferenceDocLink})を参照してください。

次のエンドポイントは、ベースのURLに相対するパスで使用できます。

この文字列は [Timestamp](/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) としてフォーマットされています。

あなたのOAuth 2.0 アプリケーションでこのエンドポイントを使用するには以下の範囲が必要です。OAuth 2.0 アプリケーションの登録方法についての情報は、 [アプリ登録とレビュー]({oauth2ReferenceDocLink}) をごらんください。

非推奨

オープンクラウド参照の改良バージョンを表示しています。

オープンクラウド参照の新バージョンからオプトアウトしました。

広告請求アカウントを表示します。

広告キャンペーンとその成果を表示します。

広告キャンペーンを作成、更新、管理します。

これであなたのアセットについての情報を表示できるようになります。

これでRobloxにアセットをアップロードしたり、アップデートしたりできます。

これにより、ご利用のアカウントがアクセス可能なすべての項目（グループおよびバーチャル空間を含む）とアセットに関して、アセット権限を表示できるようになります。

これは、すべての対象（グループやバーチャル空間を含む）とアカウントがアクセスできるアセットにアセット権限を付与します。

これにより、あなたに代わって行われるアバター自動設定ジョブの状況と結果を表示できるようになります。

これにより、あなたに代わって行われるアバター自動設定ジョブを作成および管理できるようになります。

ユーザー所有のバッジを更新する能力を付与。

あなたのEコマースアイテムについての情報を表示できるようにします。

これにより、同期済みのEコマースアイテムを変更できるようになります。

あなたのEコマース事業者コネクションについての情報を閲覧できるようにします。

これでEコマース事業者コネクションを編集できるようになります。

これでクリエーターストアの製品に関する情報を表示できます。

これでクリエーターストアの製品に関する情報を変更できます。

これにより、クリエーターストアの保存に関する情報を表示できます。

これにより、クリエーターストアの保存に関する情報を変更できます。

あなたの代わりにデータストアを作成する権限を付与します。

あなたに代わってデータストアを削除する権限を付与します。

データストアの一覧を読み取る権限を付与します。

データストアのスナップショットを撮る権限を付与します。

データストアに入力内容を作成する権限を付与します。

データストアの特定の入力内容に削除用の印をつける権限を付与します。

データストアの入力内容一覧にアクセスする権限を付与します。

データストアの特定の入力内容を読み取る権限を付与します。

入力内容の値、属性、ユーザーを更新する権限を付与します。

データストアの入力内容の修正記録を削除する権限を付与します。

データストアの入力内容一覧の修正記録にアクセスする権限を付与します。

データストアの入力内容の修正記録を読み込む権限を付与します。

許可されたユーザーの開発者製品の環境設定詳細を閲覧するアクセス権を付与。

許可されたユーザーの開発者製品を編集するアクセス権を付与。

あなたのユニバースの環境についての情報を表示できるようにします。

これであなたのユニバースの環境を編集できるようにします。

許可されたユーザーのゲームパスの設定詳細を閲覧するアクセス権を付与。

許可されたユーザーのゲームパスを編集するアクセス権を付与。

アカウントのコミュニティ情報を表示する権限を付与します。

アカウントのコミュニティ情報を管理するためのアクセス権を付与します。

あなたコミュニティについての情報を表示できるようにします。

これでお持ちのアカウントのコミュニティ参加リクエストと低ランクのコミュニティメンバーの役割への更新を管理できるようになります。

インスタンスのプロパティデータを表示できます。

インスタンスのプロパティデータを変更できます（現在はスクリプトのみをサポートしています）。

これであなたの持ち物についての情報を表示できるようになります。

ユーザーアセット管理のアクセス権を付与。

あなたのバッジ管理へのアクセス権を付与。

バッジ管理とRobuxの使用管理機能へのアクセス権を付与。

承認済みユーザーのバッジを更新する権限を付与します。

あなたの開発者製品の管理機能へのアクセス権を付与。

通知をオンにしているバーチャル空間についての情報を読むアクセス権を付与します。

あなたに代わって通知をオンまたはオフにするアクセス権を付与します。

あなたのパス管理へのアクセス権を付与。

あなたのコミュニティ管理へのアクセス権を付与。

コミュニティ情報を読む権限を付与。

コミュニティ管理権限を付与。

多言語化テーブルの読み込みと書き込みへのアクセス権を付与

あなたが所有するすべてのバーチャル空間に関するチーム共同制作管理へのアクセス権を付与。

あなたのバーチャル空間の管理機能と、関連する特定の情報へのアクセス権を付与。（例：多言語化の情報）

バーチャル空間の多言語化情報を読むアクセス権を付与。

バーチャル空間の多言語化設定を変更するためのアクセス権を付与。

あなたのユーザーアカウントへのアクセス権を付与。

ユーザーの多言語化設定を変更するアクセス権を付与。

関連するプレースのLuau実行タスクのステータス、ログ、結果を表示できます。

関連するプレースに対して、新しいLuau実行タスクを作成できます。

ユニバース内のすべてのデータ構造を非同期的にフラッシュするためのアクセス権を付与。

新しいキューアイテムを作成するためのアクセス権を付与。

キューの先頭から読み取りアイテムを破棄するためのアクセス権を付与。

キューの先頭からアイテムを読み取るためのアクセス権を付与。

メモリストアアイテムを読み込むためのアクセス権を付与。

マップアイテムを読み込むためのアクセス権を付与。

マップアイテムの作成、更新、削除へのアクセス権を付与。

これでユーザーに代わってメッセージを公開する権限を与えることができます。

これでバーチャル空間からユーザーに通知を送信できるようになります。

（非推奨）順序付けられたデータストア内のエントリのリストを読み込むためのアクセス権を付与。

（非推奨）順序付けられたデータストアに新しいエントリーを作成するためのアクセス権を付与。

順序付けられたデータストアからのリストエントリーへのアクセス権を付与。

順序付けられたデータストアにエントリーを作成するためのアクセス権を付与。

これであなたのバーチャル空間に関連した秘密をリストアップできるようになります。

これであなたのバーチャル空間に関連した秘密を作成してアップデートできるようになります。

この権限を使用すると、評価ジョブを送信してジョブの結果を表示できます。

あなたの定期購入製品についての内容を読む権限を付与。

これにより、あなたに代わってサムネイル情報を読み取れるようになります。

ゲーム解析を読み取る能力を付与します。

プレース情報を読み取る能力を付与。

プレース情報を編集する能力を付与。

Robloxにバーチャル空間の新しいバージョンを公開する権限を付与します。

バーチャル空間の情報を読む能力を付与。

承認済みユーザーのバーチャル空間を編集する権限を付与します。

バーチャル空間内でのユーザー制限を表示できます。

バーチャル空間内でのユーザー制限が編集できるようになります。

これにより、ご利用のアカウントに送信された通知を表示できるようになります。

承認済みユーザーがプレミアム会員がどうかと認証済みかどうかを読み取る権限を付与します。

これで承認済みユーザーのSNSアカウントを閲覧できるようになります。

シングルサインオン機能を有効化。

これにより、あなたのプロフィール情報を読む権限が与えられます。