Mengembalikan `Datatype.DateTime` baru yang mewakili momen saat ini dalam
waktu, menggunakan jam lokal perangkat. Kebanyakan sistem operasi secara otomatis
menyinkronkan waktu lokal mereka ke server waktu online, jadi ini seharusnya
berada dalam beberapa ratus milidetik. Namun, pengguna dapat dengan mudah menonaktifkan
perilaku sinkronisasi dan mengatur waktu sistem ke apa pun yang mereka mau; untuk
time sync antara klien dan server, gunakan
`Class.Workspace:GetServerTimeNow()` sebagai gantinya.

Ketika Anda perlu mengukur waktu yang telah berlalu antara dua titik dalam
time, seperti saat menguji kinerja, gunakan `Library.os.clock()` sebagai gantinya.

DateTime.now

Mengembalikan `Datatype.DateTime` yang mewakili momen saat ini dalam waktu.

Mengembalikan objek `Datatype.DateTime` baru dari timestamp Unix yang diberikan, atau
nama **detik** sejak 1 Januari 1970 pukul 00:00 (UTC).

Fungsi ini hanya memiliki granularitas hingga 1 detik. Untuk mewakili timestamp
sub-detik, gunakan `Datatype.DateTime.fromUnixTimestampMillis()` sebagai gantinya.

DateTime.fromUnixTimestamp

unixTimestamp

Mengembalikan `Datatype.DateTime` yang mewakili timestamp Unix yang diberikan.

Mengembalikan objek `Datatype.DateTime` baru dari timestamp Unix yang diberikan, atau
nama **milidetik** sejak 1 Januari 1970 pukul 00:00 (UTC).

DateTime.fromUnixTimestampMillis

unixTimestampMillis

Mengembalikan `Datatype.DateTime` yang mewakili timestamp Unix yang diberikan dalam milidetik.

Mengembalikan `Datatype.DateTime` baru menggunakan unit yang diberikan dari waktu UTC. Nilai-nilai
yang diterima mirip dengan yang ditemukan dalam tabel nilai waktu yang dikembalikan oleh
`Datatype.DateTime:ToUniversalTime()|ToUniversalTime()`.

- Unit tanggal (tahun, bulan, hari) yang menghasilkan tanggal yang tidak valid akan menyebabkan kesalahan. Misalnya, 32 Januari atau 29 Februari di tahun bukan kabisat.
- Unit waktu (jam, menit, detik, milidetik) yang berada di luar rentang normal mereka valid. Misalnya, 90 menit akan menyebabkan jam berputar kembali 1; -10 detik akan menyebabkan nilai menit mundur 1.
- Nilai non-integer dibulatkan ke bawah. Misalnya, memberikan 2,5 jam akan setara dengan memberikan 2 jam, bukan 2 jam 30 menit.
- Nilai yang dihilangkan dianggap sebagai nilai terendah mereka dalam rentang normal mereka, kecuali untuk tahun yang default ke 1970.

DateTime.fromUniversalTime

year

month

hour

minute

second

millisecond

Mengembalikan `Datatype.DateTime` baru menggunakan unit yang diberikan dari waktu UTC.

Mengembalikan `Datatype.DateTime` baru menggunakan unit yang diberikan dari waktu lokal. Nilai-nilai
yang diterima mirip dengan yang ditemukan dalam tabel nilai waktu
yang dikembalikan oleh `Datatype.DateTime:ToLocalTime()|ToLocalTime()`.

- Unit tanggal (tahun, bulan, hari) yang menghasilkan tanggal yang tidak valid akan menyebabkan kesalahan. Misalnya, 32 Januari atau 29 Februari di tahun bukan kabisat.
- Unit waktu (jam, menit, detik, milidetik) yang berada di luar rentang normal mereka valid. Misalnya, 90 menit akan menyebabkan jam berputar kembali 1; -10 detik akan menyebabkan nilai menit mundur 1.
- Nilai non-integer dibulatkan ke bawah. Misalnya, memberikan 2,5 jam akan setara dengan memberikan 2 jam, bukan 2 jam 30 menit.
- Nilai yang dihilangkan dianggap sebagai nilai terendah mereka dalam rentang normal mereka, kecuali untuk tahun yang default ke 1970.

DateTime.fromLocalTime

Mengembalikan `Datatype.DateTime` baru menggunakan unit yang diberikan dari waktu lokal.

Mengembalikan `Datatype.DateTime` dari string tanggal-waktu ISO 8601 dalam waktu UTC,
yang dihasilkan oleh `Datatype.DateTime:ToIsoDate()|ToIsoDate()`. Jika parsing string gagal,
fungsi mengembalikan `nil`.

Contoh string tanggal-waktu ISO 8601 adalah `2020-01-02T10:30:45Z`,
yang mewakili 2 Januari 2020 pukul 10:30 pagi, 45 detik.

DateTime.fromIsoDate

isoDate

Mengembalikan `Datatype.DateTime` dari string tanggal-waktu ISO 8601 (dalam UTC).

Tipe data **DateTime** mewakili momen dalam waktu menggunakan timestamp Unix.
Ini dapat digunakan untuk dengan mudah memformat tanggal dan waktu dalam lokal tertentu. Ketika
konversi ke string, konversi string dari integer timestamp yang disimpan akan
kembali. Mereka tidak menyimpan nilai zona waktu. Sebagai gantinya, zona waktu
dipertimbangkan saat membangun dan menggunakan objek **DateTime**.

Objek **DateTime** dianggap sama jika dan hanya jika
`Datatype.DateTime.UnixTimestampMillis|UnixTimestampMillis` mereka
sama.

#### Tabel Nilai Waktu

Metode `Datatype.DateTime:ToUniversalTime()|ToUniversalTime()` dan
`Datatype.DateTime:ToLocalTime()|ToLocalTime()` mengembalikan tabel nilai-nilai
yang terkait waktu, seperti `Year`, `Month`, dan `Day`. Format tabel yang
kembali dari fungsi-fungsi ini dijelaskan di bawah ini, dengan setiap elemen
integer dalam urutan ukuran menurun.

<table>
<thead>
  <tr>
    <td>Nama</td>
    <td>Rentang</td>
    <td>Catatan</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>Biasanya
  0&ndash;59, terkadang 60 untuk mengakomodasi detik kabisat di beberapa
  sistem.</td>
</tr> <tr>
  <td><code>Millisecond</code></td><td>0&ndash;999</td><td>&mdash;</td>
</tr>
</tbody>
</table>

#### Format String

Objek `Datatype.DateTime` mendukung konversi tanggal/waktu menjadi string
melalui metode `Datatype.DateTime:FormatUniversalTime()|FormatUniversalTime()`
dan `Datatype.DateTime:FormatLocalTime()|FormatLocalTime()`. Keduanya
bekerja sama kecuali untuk zona waktu di mana `Datatype.DateTime` harus diartikan.

Argumen pertama yang diteruskan ke metode ini harus berupa string yang mewakili satu
oleh token yang ditunjukkan di bawah ini. Token-token ini kemudian diganti dengan nilai tertentu
tergantung pada lokal yang diberikan.

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

-- Token "dddd" digantikan dengan hari penuh dalam minggu
print("Hari ini adalah " .. dt:FormatLocalTime("dddd", "en-us"))

-- Untuk lokal "en-us", token "LL" sama dengan "MMMM D, YYYY"
print("Tanggalnya adalah " .. dt:FormatLocalTime("LL", "en-us"))
```

##### Token Komposit

Bergantung pada lokal, token-token ini menggantikan **kombinasi spesifik** dari
**token elemental** yang dijelaskan di bagian berikutnya. Ini menghasilkan string tanggal/waktu
yang benar tergantung pada lokal. Misalnya, dalam bahasa Inggris, tanggal
memiliki format "[month]&nbsp;[day]" seperti dalam "Juni&nbsp;11". Dalam bahasa Prancis, tanggal
adalah dalam format "[day]&nbsp;[month]" seperti dalam "11&nbsp;juin". Aturan khusus ini
ditangani untuk Anda secara otomatis melalui token komposit berikut, jadi gunakan
ini jika Anda menampilkan informasi waktu dan/atau tanggal yang sederhana.

<table>
  <thead>
    <tr>
      <th>Token(s)</th>
      <th>Contoh Lokal (Format)</th>
    </tr>
  </thead>
    <thead>
    <tr>
      <th colspan=2>Waktu</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>Waktu dengan Detik</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>Bulan (Nomor), Hari, Tahun</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>Bulan (Nama), Hari, Tahun</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>Bulan (Nama), Hari, Tahun, Waktu</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>Hari dalam Minggu, Bulan (Nama), Hari, Tahun, Waktu</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>LLLL</code></td>
      <td>
        <div><code>en-us</code> : <code>Kamis, 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>Kam, 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>

##### Token Elemental

Setiap token ini menggantikan menjadi **satu nilai** dan dapat digunakan sebagai elemen
dari string waktu yang lebih besar. Hindari menggunakan ini jika Anda hanya memerlukan informasi tanggal dan
waktu yang sederhana, karena **token komposit** lebih sesuai untuk tujuan tersebut.

<table>
<thead>
  <tr>
    <th>Token(s)</th>
    <th>Contoh</th>
  </tr>
</thead>
  <thead>
  <tr>
    <th colspan=2>Tahun</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>Bulan</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>Januari</code>, <code>Februari</code>, &hellip;, <code>November</code>, <code>Desember</code></td>
</tr>
</tbody>
  <thead>
  <tr>
    <th colspan=2>Hari dalam Bulan</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>Hari dalam Tahun</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>Hari dalam Minggu</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>Hari Minggu</code>, <code>Hari Senin</code>, &hellip;, <code>Hari Jumat</code>, <code>Hari Sabtu</code></td>
</tr>
</tbody>
  <thead>
  <tr>
    <th colspan=2>Jam</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>Menit</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>Detik</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>Detik Fraksional</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>


Mengonversi nilai objek `Datatype.DateTime` ini ke Waktu Terkoordinasi Universal (UTC). Tabel yang dikembalikan berisi kunci berikut:
`Year`, `Month`, `Day`, `Hour`, `Minute`, `Second`, `Millisecond`. Untuk
detail lebih lanjut, lihat tabel nilai waktu dalam deskripsi tipe data ini.
Nilai-nilai dalam tabel ini dapat diteruskan ke
`Datatype.DateTime.fromUniversalTime()|fromUniversalTime()` untuk menghasilkan objek
`Datatype.DateTime` yang asli.


DateTime:ToUniversalTime

Mengembalikan komponen dari `Datatype.DateTime` dalam UTC.


Mengonversi nilai objek `Datatype.DateTime` ini ke waktu lokal. Tabel yang dikembalikan berisi kunci berikut: `Year`, `Month`, `Day`,
`Hour`, `Minute`, `Second`, `Millisecond`. Untuk detail lebih lanjut, lihat tabel
nilai waktu dalam deskripsi tipe data ini. Nilai-nilai dalam tabel ini
akan diteruskan ke `Datatype.DateTime.fromLocalTime()|fromLocalTime()` untuk
menghasilkan objek `Datatype.DateTime` yang asli.


DateTime:ToLocalTime

Mengembalikan komponen dari `Datatype.DateTime` dalam waktu lokal.


Memformat tanggal sebagai string tanggal-waktu ISO 8601. Nilai yang dikembalikan oleh fungsi ini
bisa diteruskan ke
`Datatype.DateTime.fromIsoDate()|fromIsoDate()` untuk menghasilkan objek
`Datatype.DateTime` yang asli.

Contoh string tanggal-waktu ISO 8601 adalah `2020-01-02T10:30:45Z`,
yang mewakili 2 Januari 2020 pukul 10:30 pagi, 45 detik.


DateTime:ToIsoDate

Mengembalikan `Datatype.DateTime` sebagai string tanggal-waktu ISO 8601.


Menghasilkan string dari nilai `Datatype.DateTime` yang diartikan sebagai
Waktu Terkoordinasi Universal (UTC) dan format string. Format string
seharusnya berisi token, yang akan menggantikan dengan nilai tanggal/waktu tertentu
yang dijelaskan oleh objek `Datatype.DateTime`. Untuk detail lebih lanjut, lihat
bagian **Format String** dalam deskripsi tipe data ini.

```lua
local dt = DateTime.now()
-- Untuk en-us, token "LL" sama dengan "MMM D, YYYY", yang memberikan "Juni 11, 2020"
print("Tanggalnya adalah " .. dt:FormatUniversalTime("LL", "en-us"))
--> "Tanggalnya adalah Juni 11, 2020"
```


DateTime:FormatUniversalTime

format

locale

Mengembalikan nilai DateTime dalam UTC diformat ke dalam string.


Menghasilkan string dari nilai `Datatype.DateTime` yang diartikan sebagai
**waktu lokal** dan format string. Format string seharusnya berisi
token, yang akan menggantikan dengan nilai tanggal/waktu tertentu yang dijelaskan oleh
objek `Datatype.DateTime`. Untuk detail lebih lanjut, lihat bagian **Format String**
dalam deskripsi tipe data ini.

```lua
local dt = DateTime.now()
-- Untuk en-us, token "LL" sama dengan "MMM D, YYYY", yang memberikan "Juni 11, 2020"
print("Tanggalnya adalah " .. dt:FormatLocalTime("LL", "en-us"))
--> "Tanggalnya adalah Juni 11, 2020"
```


DateTime:FormatLocalTime

Mengembalikan nilai objek `Datatype.DateTime` dalam waktu lokal diformat
ke dalam string.


DateTime

Jumlah **detik** sejak 1 Januari 1970 pukul 00:00 UTC (epoch Unix). Rentang adalah -17.987.443.200 hingga 253.402.300.799, kira-kira tahun
1400&ndash;9999.


DateTime.UnixTimestamp

Jumlah **detik** antara 1 Januari 1970 pukul 00:00 UTC (epoch Unix).


Jumlah **milidetik** sejak 1 Januari 1970 pukul 00:00 UTC (epoch Unix). Rentang adalah -17.987.443.200.000 hingga 253.402.300.799.999,
kira-kira tahun 1400&ndash;9999.


DateTime.UnixTimestampMillis

Jumlah **milidetik** antara 1 Januari 1970 pukul 00:00 UTC (epoch Unix).


Tipe data yang mewakili momen dalam waktu.


/reference/engine/datatypes/DateTime.yaml

Luau

Dictionary

Sebuah objek yang menjalankan fungsi terkait saat terjadinya suatu kejadian.

Data Type

RBXScriptSignal

number

Sekuens karakter, seperti huruf, angka, dan simbol.

string

Pengalaman Virtual

Avatar

Aset

Sampel dan proyek

Engine API

Open Cloud API

Studio

Analitik

Platform

Tutorial

Program kreator

Edukasi

Kursus

Pelajari

Metode ini tidak sinkron dan menghasilkan sebuah `Operasi`, yang mewakili keadaan operasi saat ini. Operasi tersebut berisi jalur endpoint yang dapat Anda pantau untuk memperoleh respons aktual dan metadata yang relevan. Lihat [dokumentasi]({longRunningOperationsLink}) tentang operasi jangka panjang untuk mengetahui informasi selengkapnya.
            
Bagian berikut menjelaskan objek respons dan metadata yang disediakan saat operasi selesai.

Endpoint beta siap digunakan publik. Perubahan yang menyebabkan kerusakan mungkin terjadi tetapi jarang.

Halaman dokumentasi Open Cloud ini akan dihapus pada 31 Maret 2026. Kamu akan otomatis dialihkan ke dokumentasi Open Cloud yang baru pada saat itu. {linkStart}Pelajari selengkapnya{linkEnd}

Halaman Open Cloud lama ini akan dihapus dan dialihkan pada 31 Maret 2026. {linkStart}Pelajari selengkapnya{linkEnd}

Endpoint eksperimental siap digunakan publik, tetapi mungkin terkadang mengalami perubahan yang menyebabkan kerusakan saat kontrak API diselesaikan.

Endpoint ini dapat dipanggil dalam pengalaman virtual melalui {httpServiceLinkStart}HttpService{httpServiceLinkEnd} dengan kunci API.

Kolom ini mungkin akan muncul saat resource dibuat, tetapi mungkin tidak akan diubah oleh permintaan berikutnya.

Kolom ini boleh diisi saat pembuataan resource, tetapi tidak boleh diubah melalui permintaan berikutnya.

Kolom ini mungkin akan disediakan di permintaan, tetapi tidak akan pernah disertakan di respons.

Metode autentikasi versi lama. Sebaiknya selalu gunakan Kunci API atau OAuth 2.0 jika tersedia.

Per Kunci API: {maxInPeriod} permintaan setiap {periodInSeconds} detik per Alamat IP

Tidak memerlukan autentikasi untuk memanggil. Biasanya memiliki batas rate yang jauh lebih rendah. Sebaiknya selalu gunakan Kunci API atau OAuth 2.0 jika tersedia.

Untuk setiap pengelompokan, hanya satu dari bidang berikut dalam skema yang harus disediakan. Sisanya dapat dikecualikan.

Kamu bisa memilih bergabung kembali kapan saja. {linkStart}Berikan masukan.{linkEnd}

Kamu sedang melihat dokumen lama. {linkStart}Berikan masukan.{linkEnd}

Kamu bisa memilih untuk keluar kapan saja dan akan diarahkan kembali ke halaman referensi sebelumnya. {linkStart}Berikan masukan.{linkEnd}

Kamu sedang melihat dokumen yang baru. {linkStart}Berikan masukan.{linkEnd}

Kolom ini mungkin akan muncul di respons, tetapi akan diabaikan di permintaan.

Catatan: Batas permintaan dapat lebih rendah selama periode traffic yang tinggi. Beberapa endpoint memiliki batas permintaan tambahan. [Pelajari selengkapnya tentang batas permintaan]({link}).

{limit} permintaan per hari di semua kunci API untuk pengguna atau grup

{limit} permintaan per jam di semua kunci API untuk pengguna atau grup

{limit} permintaan per menit di semua kunci API untuk pengguna atau grup

{limit} permintaan per detik di semua kunci API untuk pengguna atau grup

{limit} permintaan per menit per pemilik kunci API

{limit} permintaan per hari per pengguna aplikasi

{limit} permintaan per jam per pengguna aplikasi

{limit} permintaan per menit per pengguna aplikasi

{limit} permintaan per detik per pengguna aplikasi

{limit} permintaan per detik per pemilik kunci API

Beberapa cakupan mengontrol izin yang dimiliki kredensialmu. Kredensialmu hanya dapat mengakses endpoint yang sesuai dengan cakupan yang kamu pilih.

Endpoint yang stabil siap digunakan dalam produksi dan hampir tidak akan mengalami perubahan yang menyebabkan kerusakan selama masa pakainya.

Target ini memungkinkanmu membatasi akses pentingmu ke {requiredParts} yang dipilih

Target ini memungkinkanmu membatasi akses pentingmu ke {requiredParts} dan {optionalParts} yang dipilih

Tipe target digunakan untuk membatasi sumber daya yang bisa diakses oleh kredensialmu. Sekalipun izin akunmu lebih luas, hanya sumber daya yang dipilih yang dapat dipakai. Beberapa cakupan tidak memiliki bagian target. Dalam kasus ini, semua sumber dayamu yang relevan bisa langsung dipakai.

Bagian Tingkat Atas universe tidak perlu dipilih untuk Kunci API milik pengguna. Dalam hal ini, Kunci API-mu akan memiliki akses ke semua pengalaman virtual milikmu sendiri dan pengalaman virtual milik grup yang izin aksesnya kamu kantongi.

Coba Saja belum didukung untuk endpoint yang mewajibkan kunci API atau autentikasi OAuth 2.0

Autentikasi cookie dinonaktifkan untuk operasi berisiko tinggi demi keamanan.

Endpoint berisiko kritis sangat sensitif dan fungsi Coba Saja dinonaktifkan demi keamanan

Catatan: Header autentikasi tidak termasuk dalam sampel kode ini. Kamu mungkin perlu menambahkan header autentikasi agar perintah ini berfungsi.

Ini adalah endpoint berisiko tinggi yang dapat mengubah atau menghapus data penting. Gunakan dengan sangat hati-hati selama pengujian.

Endpoint API ini telah diklasifikasikan sebagai BERISIKO TINGGI dan dapat memengaruhi data aktif atau akun pengguna.

Permintaan yang diautentikasi ke API berisiko tinggi dapat membuat perubahan yang tidak dapat dibatalkan. Review parameter permintaanmu sebelum melanjutkan.

Login untuk menggunakan autentikasi cookie

Ini adalah endpoint berisiko rendah yang mengambil data. Ini umumnya aman untuk diuji.

Ini adalah endpoint berisiko sedang yang memodifikasi data. Uji dengan hati-hati menggunakan akun non-penting, karena perubahan mungkin bersifat permanen.

Untuk menjaga keamanan akun kamu, jangan pernah menempelkan teks dari sumber lain di sini atau mengirimkan informasi dari halaman ini kepada orang lain.

Kamu akan menguji endpoint API live menggunakan kredensial akunmu yang sebenarnya.

Hanya lanjutkan jika kamu memahami implikasi dari panggilan API yang akan kamu lakukan. Review dokumentasi API dengan cermat sebelum pengujian.

Panggilan API akan dilakukan menggunakan sesi kamu yang sudah diautentikasi

Ini adalah panggilan API aktual yang dapat memengaruhi akun atau data kamu

Batas rating dan pembatasan API lainnya berlaku

Beberapa operasi dapat mengubah atau menghapus data

Endpoint ini telah digantikan oleh endpoint alternatif yang direkomendasikan berikut:

Cakupan berikut diperlukan untuk memanggil endpoint ini. Untuk mengetahui
informasi selengkapnya tentang cara membuat kunci yang tepat, lihat [Cara Mengelola Kunci API]({apiKeyReferenceDocLink}).

Untuk mengetahui informasi selengkapnya tentang cara membuat kunci, lihat [Cara Mengelola Kunci API]({apiKeyReferenceDocLink}).

Endpoint berikut tersedia di jalur relatif terhadap base URL.

String ini diformat sebagai [FieldMask](/cloud/reference/types#fieldmask).

Nilai JSON dapat berupa `null`, `boolean`, `string`, `number`, `array`, atau `object`.

Cakupan berikut diperlukan agar aplikasi OAuth 2.0 dapat menggunakan endpoint ini. Untuk mengetahui informasi selengkapnya tentang cara mendaftarkan aplikasi OAuth 2.0, lihat [Pendaftaran dan review aplikasi]({oauth2ReferenceDocLink}).

Untuk mengetahui informasi selengkapnya tentang cara mendaftarkan aplikasi OAuth 2.0, lihat [Pendaftaran dan review aplikasi]({oauth2ReferenceDocLink}).

Objek berikut mendeskripsikan muatan yang diterima atau diberikan. Lihat masing-masing endpoint untuk mengetahui informasi selengkapnya tentang waktu penggunaan objek ini.

Cakupan berikut diperlukan untuk memanggil endpoint ini.

Jalur Resource

String ini diformat sebagai [Timestamp](/cloud/reference/types#timestamp).

Cakupan berikut diperlukan agar aplikasi OAuth 2.0 dapat menggunakan endpoint ini. Untuk mengetahui informasi selengkapnya tentang cara mendaftarkan aplikasi OAuth 2.0, lihat [Pendaftaran dan Review Aplikasi]({oauth2ReferenceDocLink}).

Tidak Direkomendasikan

Kamu sedang melihat referensi Open Cloud yang baru.

Kamu sudah memilih keluar dari referensi Open Cloud yang baru.

Buat, update, dan kelola kampanye iklanmu.

Ini memungkinkan untuk melihat informasi tentang asetmu.

Ini memungkinkan upload dan update aset ke Roblox.

Ini memungkinkanmu melihat izin aset untuk subjek (termasuk grup dan pengalaman virtual) dan aset yang dapat diakses oleh akunmu.

Ini memungkinkan pemberian izin aset kepada subjek mana pun (termasuk grup dan pengalaman) dan aset yang dapat diakses oleh akunmu.

Ini memungkinkanmu melihat status dan hasil tugas penyiapan otomatis avatar atas namamu.

Ini memungkinkanmu membuat dan mengelola tugas penyiapan otomatis avatar atas namamu.

Memberi kemampuan untuk meng-update lencana yang dimiliki oleh pengguna.

Ini memungkinkan untuk melihat informasi tentang item komersialmu.

Ini memungkinkan untuk membuat perubahan pada item komersialmu yang telah disinkronkan.

Ini memungkinkan kamu melihat informasi tentang koneksi merchant komersialmu.

Ini memungkinkan pengeditan koneksi merchant komersialmu.

Ini memungkinkan kamu melihat informasi tentang produk di Toko Kreatormu.

Ini memungkinkan kamu mengubah informasi tentang produk di Toko Kreatormu.

Ini memungkinkan kamu melihat informasi tentang penyimpanan produk di Toko Kreatormu.

Ini memungkinkan kamu mengubah informasi tentang penyimpanan produk di Toko Kreatormu.

Memberi akses untuk membuat penyimpanan data atas namamu.

Memberi akses untuk menghapus penyimpanan data atas namamu.

Memberi akses untuk membaca daftar penyimpanan data.

Memberi akses untuk mengambil snapshot penyimpanan datamu.

Memberi akses untuk membuat entri dalam penyimpanan datamu.

Memberi akses untuk menandai entri tertentu agar dihapus.

Memberi akses untuk membuat daftar entri penyimpanan datamu.

Memberi akses untuk membaca entri tertentu dalam penyimpanan datamu.

Memberi akses untuk meng-update nilai, atribut, dan pengguna suatu entri.

Memberi akses untuk menghapus revisi entri penyimpanan datamu.

Memberi akses untuk membuat daftar revisi entri penyimpanan datamu.

Memberi akses untuk melihat detail konfigurasi untuk produk developer pengguna yang diotorisasi.

Memberi akses untuk mengedit produk developer pengguna yang diotorisasi.

Ini memungkinkan untuk melihat informasi tentang lingkungan universe-mu.

Ini memungkinkan pengeditan lingkungan universe-mu.

Memberi akses untuk melihat detail konfigurasi untuk pas game pengguna yang diotorisasi.

Memberi akses untuk mengedit pas game pengguna yang diotorisasi.

Memberi akses untuk melihat informasi forum komunitas untuk akunmu.

Memberi akses untuk mengelola informasi forum komunitas untuk akunmu.

Ini memungkinkan untuk melihat informasi tentang komunitas kamu.

Dengan cara ini, kamu dapat mengelola permintaan bergabung ke komunitas dan perubahan peran anggota komunitas berperingkat rendah untuk akunmu.

Memungkinkan kamu untuk melihat data properti suatu kejadian.

Memungkinkan kamu mengubah data properti kejadian (saat ini hanya mendukung Script).

Ini memungkinkan untuk melihat informasi tentang inventarismu.

Memberi akses untuk mengelola aset penggunamu.

Memberi akses untuk mengelola lencanamu dan membelanjakan Robux.

Memberi akses untuk meng-update lencana pengguna yang diotorisasi.

Memberi akses untuk mengelola produk developermu.

Memberi akses untuk membaca informasi tentang notifikasi pengalaman virtualmu.

Memberi akses untuk mengaktifkan atau menonaktifkan notifikasi pengalaman virtual atas namamu.

Memberi akses untuk mengelola komunitasmu.

Memberi izin untuk membaca informasi komunitas.

Memberi akses untuk membaca dan menulis tabel pelokalanmu

Memberi akses untuk mengelola kolaborasi tim untuk semua pengalaman virtualmu.

Memberi akses untuk mengelola pengalaman virtualmu dan informasi tertentu terkait dengan pengalaman virtualmu (misal, informasi pelokalan).

Memberi akses untuk membaca informasi pelokalan pengalamanmu.

Memberi akses untuk mengubah preferensi pelokalan pengalamanmu.

Memberi akses untuk mengelola akun penggunamu.

Memberi akses untuk mengubah preferensi pelokalan pengguna.

Memungkinkan kamu untuk melihat status, log, dan hasil tugas eksekusi Luau untuk tempat terkait.

Memungkinkan kamu untuk membuat tugas eksekusi Luau baru untuk tempat terkait.

Memberi akses untuk melakukan flush secara asinkron pada semua struktur data di universe.

Memberi akses untuk membuat item antrean baru.

Memberi akses untuk membuang item baca dari bagian depan antrean.

Memberi akses untuk membaca item di bagian depan antrean.

Memberi akses untuk membaca item penyimpanan memori kamu.

Memberi akses untuk membuat, meng-update dan menghapus item peta.

Ini memberi kemampuan untuk memublikasikan pesan atas nama pengguna.

Ini memungkinkan pengiriman notifikasi dari pengalaman virtualmu ke pengguna.

(Tidak digunakan lagi) Memberi akses untuk membaca daftar entri dalam penyimpanan data terurut.

(Tidak digunakan lagi) Memberi akses untuk membuat entri baru dalam penyimpanan data terurut.

Memberi akses untuk membuat daftar entri dari penyimpanan data terurut.

Memberi akses untuk membuat entri dalam penyimpanan data terurut.

Ini memungkinkan pembuatan daftar rahasia yang terkait dengan pengalaman virtualmu.

Ini memungkinkan pembuatan dan update rahasia yang terkait dengan pengalaman virtualmu.

Izin ini memungkinkan kamu dapat mengirimkan tugas evaluasi dan melihat hasil tugas tersebut.

Memberi akses untuk membaca tentang produk langgananmu.

Ini memungkinkanmu membaca informasi thumbnail atas namamu.

Memberi kemampuan untuk membaca analitik game.

Memberi kemampuan untuk membaca informasi tempat.

Memberi kemampuan untuk mengedit informasi tempat.

Memberi akses untuk memublikasikan versi baru pengalaman virtual ke Roblox.

Memberi kemampuan untuk membaca informasi pengalaman virtual.

Memberi akses untuk mengedit pengalaman virtual pengguna yang diotorisasi.

Memungkinkanmu melihat batasan pengguna di pengalaman virtual.

Memungkinkan kamu mengedit batasan pengguna di pengalaman virtual.

Ini memungkinkanmu melihat notifikasi yang dikirim ke akunmu.

Memberi kemampuan untuk membaca status premium dan terverifikasi pengguna yang diotorisasi.

Ini memungkinkan kamu melihat akun sosial pengguna yang diotorisasi.

Ini mengaktifkan fungsionalitas Single Sign-On.

Ini memberi akses untuk membaca informasi profil kamu.