Mevcut zamanı temsil eden yeni bir `Datatype.DateTime` nesnesi döndürür,
cihazın yerel saatini kullanarak. Çoğu işletim sistemi, yerel zamanlarını çevrimiçi zaman sunucularıyla otomatik olarak senkronize eder,
yani bu, birkaç yüz milisaniye içinde olmalıdır. Ancak, kullanıcılar senkronizasyon davranışını kolayca devre dışı bırakabilir
ve sistem saatini istedikleri herhangi bir değere ayarlayabilir; istemci ve sunucu arasında senkronize zaman için,
`Class.Workspace:GetServerTimeNow()` kullanın.

İki zaman noktası arasındaki geçen süreyi hassas bir şekilde ölçmeniz gerektiğinde,
performans testleri gibi, `Library.os.clock()` kullanın.

DateTime.now

`Datatype.DateTime` nesnesini, mevcut zamanı temsil eden bir nesne döndürür.

Verilen Unix zaman damgasından veya 1 Ocak 1970 saat 00:00 (UTC) itibarıyla geçen **saniye** sayısından yeni bir `Datatype.DateTime` nesnesi döndürür.

Bu fonksiyon yalnızca 1 saniye hassasiyetine sahiptir. Alt saniye zaman damgalarını temsil etmek için
`Datatype.DateTime.fromUnixTimestampMillis()` kullanın.

DateTime.fromUnixTimestamp

unixTimestamp

Verilen Unix zaman damgasını temsil eden bir `Datatype.DateTime` nesnesi döndürür.

Verilen Unix zaman damgasından veya 1 Ocak 1970 saat 00:00 (UTC) itibarıyla geçen **milisaniye** sayısından yeni bir `Datatype.DateTime` nesnesi döndürür.

DateTime.fromUnixTimestampMillis

unixTimestampMillis

Verilen Unix zaman damgasını milisaniye olarak temsil eden bir `Datatype.DateTime` nesnesi döndürür.

UTC zamanından verilen birimlerle yeni bir `Datatype.DateTime` nesnesi döndürür. Kabul edilen değerler,
`Datatype.DateTime:ToUniversalTime()|ToUniversalTime()` ile döndürülen zaman değerleri tablosunda bulunduğu gibidir.

- Geçersiz bir tarih üreten tarih birimleri (yıl, ay, gün) bir hata verecektir. Örneğin, 32 Ocak veya 29 Şubat,
artık yıl olmayan bir yılda.
- Normal aralığın dışında olan zaman birimleri (saat, dakika, saniye, milisaniye) geçerlidir. Örneğin, 90 dakika bir saatin üzerine 1 ekler; -10 saniye, dakika değerinin 1 geri dönmesine neden olur.
- Tam sayı olmayan değerler aşağı yuvarlanır. Örneğin, 2.5 saat sağlamak, 2 saat sağlamakla eşdeğerdir, 2 saat 30 dakika değil.
- Atlanan değerler, normal aralığındaki en düşük değer olacak şekilde varsayılır, yıl için varsayılan değer 1970'dir.

DateTime.fromUniversalTime

year

month

hour

minute

second

millisecond

Verilen birimlerle UTC zamanından yeni bir `Datatype.DateTime` nesnesi döndürür.

Yerel zamanından verilen birimlerle yeni bir `Datatype.DateTime` nesnesi döndürür. Kabul edilen değerler,
`Datatype.DateTime:ToLocalTime()|ToLocalTime()` ile döndürülen zaman değerleri tablosunda bulunduğu gibidir.

- Geçersiz bir tarih üreten tarih birimleri (yıl, ay, gün) bir hata verecektir. Örneğin, 32 Ocak veya 29 Şubat,
artık yıl olmayan bir yılda.
- Normal aralığın dışında olan zaman birimleri (saat, dakika, saniye, milisaniye) geçerlidir. Örneğin, 90 dakika bir saatin üzerine 1 ekler; -10 saniye, dakika değerinin 1 geri dönmesine neden olur.
- Tam sayı olmayan değerler aşağı yuvarlanır. Örneğin, 2.5 saat sağlamak, 2 saat sağlamakla eşdeğerdir, 2 saat 30 dakika değil.
- Atlanan değerler, normal aralığındaki en düşük değer olacak şekilde varsayılır, yıl için varsayılan değer 1970'dir.

DateTime.fromLocalTime

Verilen birimlerle yerel zamanından yeni bir `Datatype.DateTime` nesnesi döndürür.

UTC zamanında ISO 8601 tarih-saat dizesinden `Datatype.DateTime` döndürür.
Örneğin `Datatype.DateTime:ToIsoDate()|ToIsoDate()` ile elde edilenler gibi. Dize ayrıştırması başarısız olursa,
fonsksiyon `nil` döndürür.

Örnek bir ISO 8601 tarih-saat dizesi `2020-01-02T10:30:45Z`'dir,
bu, 2 Ocak 2020'de saat 10:30'da 45 saniyeyi temsil eder.

DateTime.fromIsoDate

isoDate

Bir ISO 8601 tarih-saat dizesinden (UTC) `Datatype.DateTime` nesnesi döndürür.

**DateTime** veri türü, Unix zaman damgasını kullanarak bir zamanı temsil eder.
Belirli yerelliklerde tarih ve saatleri kolayca biçimlendirmek için kullanılabilir. Dizeye
çevrildiğinde, saklanan zaman damgası tam sayısının bir dize dönüşümü
geri döndürülür. Zaman dilimi değerlerini saklamazlar. Bunun yerine, zaman dilimleri **DateTime** nesneleri oluşturulurken ve kullanılırken dikkate alınır.

**DateTime** nesneleri yalnızca `Datatype.DateTime.UnixTimestampMillis|UnixTimestampMillis` özellikleri eşit olduğunda eşittir.

#### Zaman Değeri Tablosu

`Datatype.DateTime:ToUniversalTime()|ToUniversalTime()` ve
`Datatype.DateTime:ToLocalTime()|ToLocalTime()` yöntemleri, `Year`, `Month` ve `Day` gibi
time ile ilgili değerlerin bir tablosunu döndürür. Bu fonksiyonlardan döndürülen
tablonun biçimi aşağıda açıklanmıştır, her tam sayının öğesi azalan boyut sırasındadır.

<table>
<thead>
  <tr>
    <td>Ad</td>
    <td>Aralık</td>
    <td>Notlar</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>Genellikle
  0&ndash;59, bazen 60, belirli sistemlerde artık sürelerin karşılanması için.</td>
</tr> <tr>
  <td><code>Millisecond</code></td><td>0&ndash;999</td><td >&mdash;</td>
</tr>
</tbody>
</table>

#### Dize Biçimi

`Datatype.DateTime` nesnesi, `Datatype.DateTime:FormatUniversalTime()|FormatUniversalTime()`
ve `Datatype.DateTime:FormatLocalTime()|FormatLocalTime()` yöntemleri aracılığıyla tarih/saat dönüşümünü destekler. İkisi de
hangi zaman diliminde `Datatype.DateTime`'nın yorumlanması gerektiği dışında aynı şekilde çalışır.

Bu yöntemlere geçirilen ilk argüman, aşağıda gösterilen tokenlerden birini temsil eden bir dizedir.
Tokenler, sağlanan yerelliğe bağlı olarak belirli bir değerle değiştirilir.

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

-- "dddd" tokeni tam haftanın gününü temsil eden bir değerle değiştirilir
print("Bugün " .. dt:FormatLocalTime("dddd", "en-us"))

-- "en-us" yerelliği için "LL" tokeni "MMMM D, YYYY" eşittir
print("Tarih " .. dt:FormatLocalTime("LL", "en-us"))
```

##### Bileşik Tokenler

Yerelliğe bağlı olarak, bu tokenler bir **elemental tokenlerin**
özel kombinasyonları ile değiştirilir. Bu, yerelliğe bağlı olarak doğru bir
tarih/saat dizesi üretir. Örneğin, İngilizce'de tarih, "[ay]&nbsp;[gün]" gibi "Haziran&nbsp;11" şeklindedir. Fransızca'da ise tarih,
"[gün]&nbsp;[ay]" formatındadır, örneğin "11&nbsp;Haziran". Bu özel kurallar,
şu bileşik tokenler aracılığıyla otomatik olarak sizin için işlenir; bu nedenle basit zaman ve/veya tarih bilgisi görüntülerken bunları kullanın.

<table>
  <thead>
    <tr>
      <th>Token(ler)</th>
      <th>Yerel Örnekler (Format)</th>
    </tr>
  </thead>
    <thead>
    <tr>
      <th colspan=2>Zaman</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>Sanal Zaman</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>Ay (Sayı), Gün, Yıl</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>Ay (İsim), Gün, Yıl</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>LL</code></td>
      <td>
        <div><code>en-us</code> : <code>4 Eylül 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>Ay (İsim), Gün, Yıl, Zaman</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>LLL</code></td>
      <td>
        <div><code>en-us</code> : <code>4 Eylül 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>Hafta Günü, Ay (İsim), Gün, Yıl, Zaman</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>LLLL</code></td>
      <td>
        <div><code>en-us</code> : <code>Perşembe, 4 Eylül 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>Per, 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>

##### Elemental Tokenler

Bu tokenlerin her biri bir **tek değer** ile değiştirilir ve daha büyük bir zaman dizesinin öğeleri olarak kullanılabilir.
Sadece basit tarih ve zaman bilgilerine ihtiyacınız varsa, bunları kullanmaktan kaçının,
çünkü **bileşik tokenler** bu amaçlar için daha uygundur.

<table>
<thead>
  <tr>
    <th>Token(ler)</th>
    <th>Örnekler</th>
  </tr>
</thead>
  <thead>
  <tr>
    <th colspan=2>Yıl</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>Ay</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>Ocak</code>, <code>Şubat</code>, &hellip;, <code>Kasım</code>, <code>Aralık</code></td>
</tr>
</tbody>
  <thead>
  <tr>
    <th colspan=2>Gün</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>Yılın Günü</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>Hafta Günü</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>Paz</code>, <code>Pzt</code>, &hellip;, <code>Cum</code>, <code>Cumartesi</code></td>
</tr>
<tr>
  <td><code>dddd</code></td>
  <td><code>Pazar</code>, <code>Pazartesi</code>, &hellip;, <code>Cuma</code>, <code>Cumartesi</code></td>
</tr>
</tbody>
  <thead>
  <tr>
    <th colspan=2>Saat</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>Dakika</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>Saniye</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>Kesirli Saniye</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` nesnesinin değerini Evrensel Koordine Zamanı (UTC) olarak dönüştürür. Döndürülen tablonun anahtarları şunları içerir:
`Year`, `Month`, `Day`, `Hour`, `Minute`, `Second`, `Millisecond`. Daha fazla detay için,
bu veri türünün tanımındaki zaman değeri tablosuna bakın.
Bu tablodaki değerler,
`Datatype.DateTime.fromUniversalTime()|fromUniversalTime()` ile orijinal `Datatype.DateTime` nesnesini üretmek için kullanılabilir.


DateTime:ToUniversalTime

UTC'deki `Datatype.DateTime`'in bileşenlerini döndürür.


`Datatype.DateTime` nesnesinin değerini yerel saat olarak dönüştürür. Döndürülen tablo,
şu anahtarları içerir: `Year`, `Month`, `Day`, `Hour`, `Minute`, `Second`, `Millisecond`. Daha fazla detay için,
bu veri türünün tanımındaki zaman değeri tablosuna bakın. Bu tablodaki değerler,
`Datatype.DateTime.fromLocalTime()|fromLocalTime()` ile orijinal `Datatype.DateTime` nesnesini üretmek için kullanılabilir.


DateTime:ToLocalTime

Yerel saatte `Datatype.DateTime`'in bileşenlerini döndürür.


Bir tarihi ISO 8601 tarih-saat dizesi olarak biçimlendirir. Bu fonksiyondan döndürülen değer,
`Datatype.DateTime.fromIsoDate()|fromIsoDate()` ile orijinal `Datatype.DateTime` nesnesini üretmek için kullanılabilir.

Örnek bir ISO 8601 tarih-saat dizesi `2020-01-02T10:30:45Z`'dir,
bu, 2 Ocak 2020'de saat 10:30'da 45 saniyeyi temsil eder.


DateTime:ToIsoDate

`Datatype.DateTime`'i ISO 8601 tarih-saat dizesi olarak döndürür.


`Datatype.DateTime` değerini Evrensel Koordine Zamanı (UTC) olarak ve bir biçim dizesi ile yorumlanarak bir dize üretir. Biçim dizesi,
`Datatype.DateTime` nesnesi tarafından tanımlanan belirli tarih/zaman değerleriyle değiştirilecek tokenleri içermelidir. Daha fazla detay için,
bu veri türünün tanımındaki **Dize Biçimi** bölümüne bakın.

```lua
local dt = DateTime.now()
-- en-us için, "LL" tokeni "MMM D, YYYY"'ye eşittir, bu da "11 Haziran 2020" verir.
print("Tarih " .. dt:FormatUniversalTime("LL", "en-us"))
--> "Tarih 11 Haziran 2020"
```


DateTime:FormatUniversalTime

format

locale

DateTime değerini UTC'de bir dize olarak biçimlendirilmiş bir şekilde döndürür.


`Datatype.DateTime` nesnesinin değerini **yerel zaman** ve bir biçim dizesi ile yorumlayarak bir dize üretir. Biçim dizesi,
`Datatype.DateTime` nesnesi tarafından tanımlanan belirli tarih/zaman değerleriyle değiştirilecek tokenleri içermelidir. Daha fazla detay için,
bu veri türünün tanımındaki **Dize Biçimi** bölümüne bakın.

```lua
local dt = DateTime.now()
-- en-us için, "LL" tokeni "MMM D, YYYY"'ye eşittir, bu da "11 Haziran 2020" verir.
print("Tarih " .. dt:FormatLocalTime("LL", "en-us"))
--> "Tarih 11 Haziran 2020"
```


DateTime:FormatLocalTime

`Datatype.DateTime` nesnesinin yerel zaman değerini bir dize olarak biçimlendirilmiş bir şekilde döndürür.


DateTime

1 Ocak 1970 saat 00:00 UTC (Unix epoch) itibarıyla geçen **saniye** sayısıdır. Aralık -17,987,443,200 ile 253,402,300,799, yaklaşık yıllar
1400&ndash;9999'dur.


DateTime.UnixTimestamp

1 Ocak 1970 saat 00:00 UTC (Unix epoch) itibarıyla geçen **saniye** sayısıdır.


1 Ocak 1970 saat 00:00 UTC (Unix epoch) itibarıyla geçen **milisaniye** sayısıdır. Aralık -17,987,443,200,000 ile 253,402,300,799,999,
aproximatif yıllar 1400&ndash;9999'dur.


DateTime.UnixTimestampMillis

1 Ocak 1970 saat 00:00 UTC (Unix epoch) itibarıyla geçen **milisaniye** sayısıdır.


Bir zamanı temsil eden bir veri türü.


/reference/engine/datatypes/DateTime.yaml

Luau

Dictionary

Belirli bir olay meydana geldiğinde bağlı işlevleri çalıştıran bir nesne.

Data Type

RBXScriptSignal

number

Harfler, sayılar ve semboller gibi karakterlerin bir dizisi.

string

Deneyimler

Avatar

Varlıklar

Samples and projects

Engine API

Open Cloud API

Studio

Analizler

Platform

Öğreticiler

Yaratıcı programları

Eğitim

Kurslar

Learn

Eş zamansız olan bu yöntem, işlemin geçerli durumunu temsil eden bir `Operation` döndürür Gerçek yanıtı ve uygulanabilir üst verileri elde etmek için yoklayabileceğin bir uç nokta yolu içerir. Daha fazla bilgi için uzun süreli işlemlerle ilgili [dokümantasyonu]({longRunningOperationsLink}) incele.

Aşağıdaki kısımlar, bir işlem tamamlandığında sağlanan yanıt ve üst veri nesnelerini tanımlar.

Beta uç noktaları herkesin kullanımına açıldı. Kesme değişiklikleri mümkün olsa da nadir görülür.

These Open Cloud documentation pages will be removed on March 31, 2026. You will be automatically redirected to the new Open Cloud documentation at that time. {linkStart}Learn more{linkEnd}

These old Open Cloud pages will be removed and redirected on March 31, 2026. {linkStart}Learn more{linkEnd}

Deneysel uç noktalar herkese açık şekilde kullanıma hazırdır ancak API sözleşmesi tamamlandıkça zaman zaman önemli değişikliklerden geçebilir.

This endpoint can be called in-experience through {httpServiceLinkStart}HttpService{httpServiceLinkEnd} with an API key.

Bu alan, kaynak oluşturulurken ayarlanabilir ama sonraki taleplerde düzenlenemez.

Bu alanlar, kaynak oluşturulurken ayarlanabilir ama sonraki taleplerde düzenlenemez.

Bu alan, taleplerde sağlanabilir ancak yanıtlara asla dâhil edilmez.

Eski kimlik doğrulama yöntemi. API Anahtarı veya OAuth 2.0 kullanılabilir durumdaysa bunları kullanmayı tercih et.

API Anahtarı başına: Her {periodInSeconds} saniyede IP adresi başına {maxInPeriod} talep

Çağrı için kimlik doğrulama gerektirmez. Genellikle önemli ölçüde düşük oran limitlerine sahiptir. API Anahtarı veya OAuth 2.0 kullanılabilir durumdaysa her zaman bunları kullanmayı tercih et.

Her gruplama için şemada aşağıdaki alanlardan yalnızca birinin sağlanması gerekir, geri kalanlar hariç tutulabilir.

You can opt back in at any time. {linkStart}Provide feedback.{linkEnd}

You are viewing the old docs. {linkStart}Provide feedback.{linkEnd}

You can opt out at any time and be redirected back to the old reference pages. {linkStart}Provide feedback.{linkEnd}

You are viewing the revamped docs. {linkStart}Provide feedback.{linkEnd}

Bu alan, yanıtlar için ayarlanabilir ancak isteklerde göz ardı edilir.

Not: Yoğun trafikli dönemlerde oran sınırları daha düşük olabilir. Bazı uç noktaların ek oran sınırları vardır. [Oran sınırları hakkında daha fazla bilgi edin]({link}).

Tüm API anahtarlarında bir kullanıcı veya grup için günde {limit} talep

Tüm API anahtarlarında bir kullanıcı veya grup için saatte {limit} talep

Tüm API anahtarlarında bir kullanıcı veya grup için dakikada {limit} talep

Tüm API anahtarlarında bir kullanıcı veya grup için saniyede {limit} talep

API anahtarı sahibi başına dakikada {limit} talep

Uygulama kullanıcısı başına günde {limit} talep

Uygulama kullanıcısı başına saatte {limit} talep

Uygulama kullanıcısı başına dakikada {limit} talep

Uygulama kullanıcısı başına saniyede {limit} talep

API anahtarı sahibi başına saniyede {limit} talep

Kapsamlar, kimlik bilgilerinin sahip olduğu izinleri kontrol eder. Kimlik bilgilerin yalnızca seçtiğin kapsamlar tarafından desteklenen uç noktalara erişebilir.

Kararlı uç noktalar üretime hazırdır ve kullanım ömürleri boyunca neredeyse hiçbir zaman önemli değişikliklerden geçmez.

Bu hedef, anahtarının seçilen {requiredParts} parçalarına erişimini sınırlamanı sağlar

Bu hedef, anahtarının seçilen {requiredParts} ve {optionalParts} parçalarına erişimini sınırlamanı sağlar

Hedef türleri, kimlik bilgilerinin izne sahip olduğu kaynakları kısıtlamak için kullanılır. Hesabının ek kaynaklar üzerinde izinleri olsa bile yalnızca seçilen kaynaklar üzerinde işlem yapılabilir. Bazı kapsamların hedef bölümleri yoktur. Böyle durumlarda, ilgili tüm kaynaklar üzerinde işlem yapılabilir.

Kullanıcıya ait API Anahtarları için evren Üst Seviye Bölümünün seçilmesine gerek yoktur. Bu durumda API Anahtarının, kullanıcıya ait tüm deneyimlerine ve uygun grup izinlerine sahip olduğun grup deneyimlerine erişimi olacaktır.

Dene, API anahtarı veya OAuth 2.0 kimlik doğrulaması gerektiren uç noktalar için henüz desteklenmiyor

Güvenlik için yüksek riskli işlemlerde çerez kimlik doğrulaması devre dışı bırakılmıştır.

Kritik risk uç noktaları son derece hassastır ve güvenlik için Dene düğmesi devre dışı bırakılmıştır

Not: Kimlik doğrulama başlıkları bu kod örneğine dâhil edilmemiştir. Bu komutun çalışması için bir kimlik doğrulama başlığı eklemen gerekebilir.

Bu, kritik verileri değiştirebilecek veya silebilecek yüksek riskli bir uç noktadır. Test ederken çok dikkatli ol.

Bu API uç noktası YÜKSEK RİSKLİ olarak sınıflandırılmıştır ve canlı verileri veya kullanıcı hesaplarını etkileyebilir.

Yüksek riskli API'lere yönelik kimliği doğrulanmış talepler, geri alınamayan değişikliklere neden olabilir. Devam etmeden önce lütfen talep parametrelerini dikkatlice incele.

Çerez kimlik doğrulamasını kullanmak için lütfen giriş yap

Bu, verileri alan düşük riskli bir uç noktadır. Test edilmesi genellikle güvenlidir.

Bu, verileri değiştiren orta riskli bir uç noktadır. Değişiklikler kalıcı olabileceğinden, kritik olmayan hesaplarla dikkatlice test et.

Hesabını güvende tutmak istiyorsan buraya asla başka kaynaklardan metin yapıştırma veya bu sayfadan başkalarına bilgi gönderme.

Gerçek hesap kimlik bilgilerini kullanarak canlı API uç noktalarını test etmek üzeresin.

Yalnızca yapmak üzere olduğun API çağrılarının sonuçlarını anlıyorsan devam et. Test etmeden önce API belgelerini dikkatlice incele.

API çağrıları, kimliği doğrulanmış oturumun kullanılarak yapılacaktır

Bunlar, hesabını veya verilerini etkileyebilecek gerçek API çağrılarıdır

İstek sınırları ve diğer API kısıtlamaları geçerlidir

Bazı işlemler verileri değiştirebilir veya silebilir

This endpoint has been superseded by these recommended alternative endpoints:

Bu uç noktayı çağırmak için aşağıdaki kapsamlar gereklidir. Uygun anahtarları
oluşturma hakkında daha fazla bilgi [API anahtarlarını yönetme]({apiKeyReferenceDocLink}) bölümünden edinilir.

Anahtar oluşturma hakkında daha fazla bilgi [API anahtarlarını yönetme]({apiKeyReferenceDocLink}) bölümünden edinilir.

Şu uç noktaları, taban URL'ye göre belirlenen yollarda mevcut.

Bu dizi [FieldMask](/cloud/reference/types#fieldmask) olarak biçimlendirilmiş.

JSON değeri `null`, `boolean`, `string`, `number`, `array` ya da `object` olabilir.

Bu uç noktasının kullanılması adına OAuth 2.0 uygulaman için aşağıdaki kapsamlar gerekir. OAuth 2.0 uygulamanı nasıl kaydettireceğin hakkında daha fazla bilgi için [Uygulama kaydı ve incelemesi]({oauth2ReferenceDocLink}) sayfasını incele.

Bir OAuth 2.0 uygulamasını kaydetme hakkında daha fazla bilgi [Uygulama kaydı ve inceleme]({oauth2ReferenceDocLink}) bölümünden edinilir.

Şu nesneler kabul edilen veya döndürülen yükleri tanımlar. Bu nesnelerin ne zaman kullanıldığı hakkında daha fazla bilgi için tüm uç noktalara bak.

Bu uç noktayı çağırmak için aşağıdaki kapsamlar gereklidir.

Resource Paths

Bu dizi [Timestamp](/cloud/reference/types#timestamp) olarak biçimlendirilmiş.

Bu uç noktasının kullanılması adına OAuth 2.0 uygulaman için aşağıdaki kapsamlar gerekir. OAuth 2.0 uygulamanı nasıl kaydettireceğin hakkında daha fazla bilgi için [Uygulama Kaydı ve İncelemesi]({oauth2ReferenceDocLink}) sayfasını incele.

Not Recommended

You are viewing the revamped Open Cloud reference.

You've opted out of the new Open Cloud reference.

View your ad campaigns and their performance.

Create, update, and manage your ad campaigns.

This allows viewing information about your assets.

This allows uploading and updating assets to Roblox.

This allows viewing asset permissions for subjects (including groups and experiences) and assets your account has access to.

This allows granting asset permissions to any subjects (including groups and experiences) and assets your account has access to.

This allows you to view the status and results of avatar auto-setup jobs on your behalf.

This allows you to create and manage avatar auto-setup jobs on your behalf.

Grants the ability to update badges owned by the user.

This allows viewing information about your commerce items.

This allows making changes to your synced commerce items.

This allows viewing information about your commerce merchant connections.

This allows editing of your commerce merchant connections.

This allows you to view information about your Creator Store products.

This allows you to modify information about your Creator Store products.

This allows you to view information about your Creator Store saves.

This allows you to modify information about your Creator Store saves.

Grants access to create data stores on your behalf.

Grants access to delete data stores on your behalf.

Grants access to read a list of data stores.

Grants access to take a snapshot of your data stores.

Grants access to create entries in your data stores.

Grants access to mark specified entries for deletion.

Grants access to list your data store's entries.

Grants access to read specified entries in your data stores.

Grants access to update the value, attributes, and users of an entry.

Grants access to delete revisions of your data store's entries.

Grants access to list revisions for your data store's entries.

Grants access to read revisions of your data store's entries.

Grants access to view configuration details for the authorized user's developer products.

Grants access to edit the authorized user's developer products.

This allows viewing information about your universe's environments.

This allows editing of your universe's environments.

Grants access to view configuration details for the authorized user's game passes.

Grants access to edit the authorized user's game passes.

Grants access to view community forums information for your account.

Grants access to manage community forums information for your account.

This allows viewing information about your communities.

This allows you to manage community join requests and role updates of lower-ranked community members for your account.

Allows you to view an instance's property data.

Allows you to modify the property data of instances (currently only supports Scripts).

This allows viewing information about your inventory.

Grants access to manage your badges and spend Robux.

Grants access to update the authorized user's badges.

Grants access to manage your developer products.

Grants access to read information about the experiences you have notifications on for.

Grants access to turn on or off notifications for experiences on your behalf.

Grants access to manage your communities.

Grants permission to read community information.

Grants access to read and write your localization tables

Grants access to manage team collaboration for all experiences you own.

Grants access to manage your experiences and certain information associated with your experiences (e.g. localization information).

Grants access to read your experiences' localization information.

Grants access to modify your experiences' localization preferences.

Grants access to manage your user account.

Grants access to modify user localization preferences.

Allows you to view the status, logs, and results of Luau execution tasks for the associated place.

Allows you to create new Luau execution tasks for the associated place.

Grants access to asynchronously flush all data structures in the universe.

Grants access to discard read items from the front of the queue.

Grants access to read items at the front of the queue.

Grants access to read your memory store items.

Grants access to create, update, and delete map items.

This grants the ability to publish messages on behalf of users.

This allows sending notifications from your experience to users.

(Deprecated) Grants access to read a list of entries in an ordered data store.

(Deprecated) Grants access to create a new entry in an ordered data store.

Grants access to list entries from an ordered data store.

Grants access to create entries in an ordered data store.

This allows listing secrets associated with your experience.

This allows creating and updating secrets associated with your experience.

This permission allows you to submit an evaluation job and view the job result.

Grants access to read about your subscription products.

This allows you to read thumbnail information on your behalf.

Grants the ability to read game analytics.

Grants the ability to read place information.

Grants the ability to edit place information.

Grants access to publish new versions of experiences to Roblox.

Grants the ability to read experience information.

Grants access to edit the authorized user's experiences.

Allows you to view user restrictions in the experience.

Allows you to edit user restrictions in the experience.

This allows viewing notifications sent to your account.

Grants the ability to read the authorized user's premium and verified status.

This allows you to view the authorized user's social accounts.

This enables Single Sign-On functionality.

This grants access to read your profile information.