Restituisce un nuovo `Datatype.DateTime` che rappresenta il momento attuale nel
tempo, utilizzando l'orologio locale del dispositivo. La maggior parte dei sistemi operativi sincronizza automaticamente
il proprio orario locale con i server di tempo online, quindi questo dovrebbe essere
entro un paio di centinaia di millisecondi. Tuttavia, gli utenti possono facilmente disabilitare
il comportamento di sincronizzazione e impostare l'ora del sistema a qualsiasi valore vogliano; per
un orario sincronizzato tra client e server, utilizza
`Class.Workspace:GetServerTimeNow()` invece.

Quando hai bisogno di misurare con precisione il tempo trascorso tra due punti nel
tempo, come quando si testa le prestazioni, utilizza `Library.os.clock()` invece.

DateTime.now

Restituisce un `Datatype.DateTime` che rappresenta il momento attuale nel tempo.

Restituisce un nuovo oggetto `Datatype.DateTime` dal timestamp Unix fornito, o
il numero di **secondi** dal 1 gennaio 1970 alle 00:00 (UTC).

Questa funzione ha solo granularità di 1 secondo. Per rappresentare timestamp sotto-secondo,
devono essere utilizzati `Datatype.DateTime.fromUnixTimestampMillis()` invece.

DateTime.fromUnixTimestamp

unixTimestamp

Restituisce un `Datatype.DateTime` che rappresenta il dato timestamp Unix fornito.

Restituisce un nuovo oggetto `Datatype.DateTime` dal timestamp Unix fornito, o
il numero di **millisecondi** dal 1 gennaio 1970 alle 00:00 (UTC).

DateTime.fromUnixTimestampMillis

unixTimestampMillis

Restituisce un `Datatype.DateTime` che rappresenta il dato timestamp Unix in millisecondi.

Restituisce un nuovo `Datatype.DateTime` utilizzando le unità fornite da un tempo UTC. I valori
accettati sono simili a quelli presenti nella tabella dei valori temporali restituita da
`Datatype.DateTime:ToUniversalTime()|ToUniversalTime()`.

- Unità di data (anno, mese, giorno) che producono una data non valida solleveranno un errore. Ad esempio, il 32 gennaio o il 29 febbraio in un anno non bisestile.
- Le unità di tempo (ora, minuto, secondo, millisecondo) che sono al di fuori del loro normale intervallo sono valide. Ad esempio, 90 minuti causeranno l'ora di scorrere con 1; -10 secondi causeranno il valore del minuto di tornare indietro di 1.
- I valori non interi vengono arrotondati verso il basso. Ad esempio, fornire 2,5 ore sarà equivalente a fornire 2 ore, non 2 ore 30 minuti.
- I valori omessi sono assunti come il loro valore minimo nel loro normale intervallo, eccetto per l'anno che di default è 1970.

DateTime.fromUniversalTime

year

month

hour

minute

second

millisecond

Restituisce un nuovo `Datatype.DateTime` utilizzando le unità fornite da un tempo UTC.

Restituisce un nuovo `Datatype.DateTime` utilizzando le unità fornite da un tempo locale. I
valori accettati sono simili a quelli presenti nella tabella dei valori temporali
restituita da `Datatype.DateTime:ToLocalTime()|ToLocalTime()`.

- Unità di data (anno, mese, giorno) che producono una data non valida solleveranno un errore. Ad esempio, il 32 gennaio o il 29 febbraio in un anno non bisestile.
- Le unità di tempo (ora, minuto, secondo, millisecondo) che sono al di fuori del loro normale intervallo sono valide. Ad esempio, 90 minuti causeranno l'ora di scorrere con 1; -10 secondi causeranno il valore del minuto di tornare indietro di 1.
- I valori non interi vengono arrotondati verso il basso. Ad esempio, fornire 2,5 ore sarà equivalente a fornire 2 ore, non 2 ore 30 minuti.
- I valori omessi sono assunti come il loro valore minimo nel loro normale intervallo, eccetto per l'anno che di default è 1970.

DateTime.fromLocalTime

Restituisce un nuovo `Datatype.DateTime` utilizzando le unità fornite da un tempo locale.

Restituisce un `Datatype.DateTime` da una stringa di data-ora ISO 8601 in UTC
seguente, come quelle restituite da `Datatype.DateTime:ToIsoDate()|ToIsoDate()`. Se l'analisi della stringa fallisce,
la funzione restituisce `nil`.

Un esempio di stringa di data-ora ISO 8601 sarebbe `2020-01-02T10:30:45Z`,
che rappresenta il 2 gennaio 2020 alle 10:30 AM, 45 secondi.

DateTime.fromIsoDate

isoDate

Restituisce un `Datatype.DateTime` da una stringa di data-ora ISO 8601 (in UTC).

Il tipo di dato **DateTime** rappresenta un momento nel tempo utilizzando un timestamp Unix.
Può essere utilizzato per formattare facilmente date e orari in specifiche località. Quando
è convertito in una stringa, viene restituita una conversione in stringa dell'intero timestamp memorizzato.
Non memorizza valori di fuso orario. Invece, i fusi orari vengono considerati
quando si costruiscono e si utilizzano oggetti **DateTime**.

Gli oggetti **DateTime** sono uguali se e solo se le loro
proprietà `Datatype.DateTime.UnixTimestampMillis|UnixTimestampMillis` sono
euguali.

#### Tabella dei Valori del Tempo

I metodi `Datatype.DateTime:ToUniversalTime()|ToUniversalTime()` e
`Datatype.DateTime:ToLocalTime()|ToLocalTime()` restituiscono una tabella di
valori relativi al tempo, come `Year`, `Month` e `Day`. Il formato della
tabella restituita da queste funzioni è descritto di seguito, con ogni elemento intero
in ordine di grandezza decrescente.

<table>
<thead>
  <tr>
    <td>Nome</td>
    <td>Intervallo</td>
    <td>Note</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>Di solito
  0&ndash;59, a volte 60 per adattarsi ai secondi bisestili in alcuni
  sistemi.</td>
</tr> <tr>
  <td><code>Millisecond</code></td><td>0&ndash;999</td><td >&mdash;</td>
</tr>
</tbody>
</table>

#### Formato della Stringa

L'oggetto `Datatype.DateTime` supporta la conversione di data/ora in una stringa
tramite i metodi `Datatype.DateTime:FormatUniversalTime()|FormatUniversalTime()`
e `Datatype.DateTime:FormatLocalTime()|FormatLocalTime()`. Entrambi
funzionano allo stesso modo, ad eccezione di quale fuso orario l'oggetto `Datatype.DateTime` debba essere
interpretato.

Il primo argomento passato a questi metodi deve essere una stringa che rappresenta uno
dei token mostrati di seguito. I token vengono quindi sostituiti con un valore specifico
a seconda della località fornita.

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

-- Il token "dddd" viene sostituito con il giorno della settimana
print("Oggi è " .. dt:FormatLocalTime("dddd", "en-us"))

-- Per la località "en-us", il token "LL" è uguale a "MMMM D, YYYY"
print("La data è " .. dt:FormatLocalTime("LL", "en-us"))
```

##### Token Compositi

A seconda della località, questi token vengono sostituiti con **combinazioni specifiche** dei
**token elementari** descritti nella sezione successiva. Questo produce una corretta
stringa di data/ora a seconda della località. Ad esempio, in inglese, la data
ha il formato "[month]&nbsp;[day]" come in "Giugno&nbsp;11". In francese, la data è in un
formato "[day]&nbsp;[month]" come in "11&nbsp;giugno". Queste regole speciali sono
gestite automaticamente per te tramite i seguenti token compositi, quindi utilizzali
se stai visualizzando semplici informazioni su orari e/o date.

<table>
  <thead>
    <tr>
      <th>Token(i)</th>
      <th>Esempi di Locale (Formato)</th>
    </tr>
  </thead>
    <thead>
    <tr>
      <th colspan=2>Tempo</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>Tempo con Secondi</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>Mese (Numero), Giorno, Anno</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>Mese (Nome), Giorno, Anno</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>LL</code></td>
      <td>
        <div><code>en-us</code> : <code>4 Settembre 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>Mese (Nome), Giorno, Anno, Tempo</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>LLL</code></td>
      <td>
        <div><code>en-us</code> : <code>4 Settembre 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>Giorno della Settimana, Mese (Nome), Giorno, Anno, Tempo</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>LLLL</code></td>
      <td>
        <div><code>en-us</code> : <code>Giovedì, 4 Settembre 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>

##### Token Elementari

Ognuno di questi token sostituisce un **singolo valore** e può essere utilizzato come elemento
in una stringa di tempo più grande. Evita di utilizzare questi se hai bisogno solo di semplici informazioni su date e
tiempo, poiché i **token composti** sono più appropriati per quelle
finalità.

<table>
<thead>
  <tr>
    <th>Token(i)</th>
    <th>Esempi</th>
  </tr>
</thead>
  <thead>
  <tr>
    <th colspan=2>Anno</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>Mese</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>Gen</code>, <code>Feb</code>, &hellip;, <code>Nov</code>, <code>Dic</code></td>
</tr>
<tr>
  <td><code>MMMM</code></td>
  <td><code>Gennaio</code>, <code>Febbraio</code>, &hellip;, <code>Novembre</code>, <code>Dicembre</code></td>
</tr>
</tbody>
  <thead>
  <tr>
    <th colspan=2>Giorno del Mese</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>Giorno dell'Anno</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>Giorno della Settimana</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>Do</code>, <code>Lu</code>, &hellip;, <code>Ve</code>, <code>Sa</code></td>
</tr>
<tr>
  <td><code>ddd</code></td>
  <td><code>Dom</code>, <code>Lun</code>, &hellip;, <code>Ven</code>, <code>Sab</code></td>
</tr>
<tr>
  <td><code>dddd</code></td>
  <td><code>Domenica</code>, <code>Lunedì</code>, &hellip;, <code>Venerdì</code>, <code>Sabato</code></td>
</tr>
</tbody>
  <thead>
  <tr>
    <th colspan=2>Ora</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>Minuto</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>Secondo</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>Secondo Frazionario</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>


Converte il valore di questo oggetto `Datatype.DateTime` in Tempo Coordinato Universale (UTC). La tabella restituita contiene le seguenti chiavi:
`Year`, `Month`, `Day`, `Hour`, `Minute`, `Second`, `Millisecond`. Per
maggiori dettagli, vedi la tabella dei valori temporali nella descrizione di questo tipo di dato.
I valori all'interno di questa tabella potrebbero essere passati a
`Datatype.DateTime.fromUniversalTime()|fromUniversalTime()` per produrre l'oggetto
`Datatype.DateTime` originale.


DateTime:ToUniversalTime

Restituisce i componenti del `Datatype.DateTime` in UTC.


Converte il valore di questo oggetto `Datatype.DateTime` in tempo locale. La
tabella restituita contiene le seguenti chiavi: `Year`, `Month`, `Day`,
`Hour`, `Minute`, `Second`, `Millisecond`. Per maggiori dettagli, vedi la tabella
valori temporali nella descrizione di questo tipo di dato. I valori all'interno di questa tabella
potrebbero essere passati a `Datatype.DateTime.fromLocalTime()|fromLocalTime()` per
generare l'oggetto `Datatype.DateTime` originale.


DateTime:ToLocalTime

Restituisce i componenti del `Datatype.DateTime` in tempo locale.


Formatta una data come una stringa di data-ora ISO 8601. Il valore restituito da questa
funzione potrebbe essere passato a
`Datatype.DateTime.fromIsoDate()|fromIsoDate()` per produrre l'oggetto originale
`Datatype.DateTime`.

Un esempio di stringa di data-ora ISO 8601 sarebbe `2020-01-02T10:30:45Z`,
che rappresenta il 2 gennaio 2020 alle 10:30 AM, 45 secondi.


DateTime:ToIsoDate

Restituisce il `Datatype.DateTime` come una stringa di data-ora ISO 8601.


Genera una stringa dal valore `Datatype.DateTime` interpretato come
Tempo Coordinato Universale (UTC) e una stringa di formato. La stringa di formato
deve contenere token, che verranno sostituiti da determinati valori di data/ora
descritti dall'oggetto `Datatype.DateTime`. Per maggiori dettagli, vedere la sezione
**Formato della Stringa** nella descrizione di questo tipo di dato.

```lua
local dt = DateTime.now()
-- Per en-us, il token "LL" è uguale a "MMM D, YYYY", il che dà "11 Giugno 2020"
print("La data è " .. dt:FormatUniversalTime("LL", "en-us"))
--> "La data è 11 Giugno 2020"
```


DateTime:FormatUniversalTime

format

locale

Restituisce il valore del DateTime in UTC formattato in una stringa.


Genera una stringa dal valore `Datatype.DateTime` interpretato come
**tempo locale** e una stringa di formato. La stringa di formato deve contenere
token, che verranno sostituiti da determinati valori di data/ora descritti dall'oggetto
`Datatype.DateTime`. Per maggiori dettagli, vedere la sezione **Formato della Stringa**
nella descrizione di questo tipo di dato.

```lua
local dt = DateTime.now()
-- Per en-us, il token "LL" è uguale a "MMM D, YYYY", il che dà "11 Giugno 2020"
print("La data è " .. dt:FormatLocalTime("LL", "en-us"))
--> "La data è 11 Giugno 2020"
```


DateTime:FormatLocalTime

Restituisce il valore dell'oggetto `Datatype.DateTime` in tempo locale formattato
in una stringa.


DateTime

Il numero di **secondi** dal 1 gennaio 1970 alle 00:00 UTC (l'epoca Unix). L'intervallo è -17.987.443.200 a 253.402.300.799, circa anni
1400&ndash;9999.


DateTime.UnixTimestamp

Il numero di **secondi** tra il 1 gennaio 1970 alle 00:00 UTC (l'epoca Unix).


Il numero di **millisecondi** dal 1 gennaio 1970 alle 00:00 UTC (l'epoca Unix). L'intervallo è -17.987.443.200.000 a 253.402.300.799.999,
approximatamente anni 1400&ndash;9999.


DateTime.UnixTimestampMillis

Il numero di **millisecondi** tra il 1 gennaio 1970 alle 00:00 UTC (l'epoca Unix).


Un tipo di dato che rappresenta un momento nel tempo.


/reference/engine/datatypes/DateTime.yaml

Luau

Dictionary

Un oggetto che esegue funzioni connesse al verificarsi di un evento specifico.

Data Type

RBXScriptSignal

Un numero a virgola mobile a doppia precisione.

number

Una sequenza di caratteri, come lettere, numeri e simboli.

string

Esperienze

Avatar

Risorse

Campioni e progetti

API Motore

Cloud API aperto

Studio

Analisi

Piattaforma

Tutorial

Programmi per creatori

Istruzione

Corsi

Impara

Questo metodo è asincrono e restituisce un'"operazione", che rappresenta lo stato corrente della stessa. Contiene un percorso endpoint che è possibile sondare per ottenere la risposta reale e i metadati applicabili. Per ulteriori informazioni, consulta la [documentazione]({longRunningOperationsLink}) sulle operazioni di lunga durata.
            
Le sezioni seguenti descrivono gli oggetti di risposta e metadati forniti al completamento di un'operazione.

Gli endpoint beta sono pronti per l'uso del pubblico. Modifiche incompatibili sono possibili ma rare.

Queste pagine di documentazione di Open Cloud verranno rimosse il 31 marzo 2026. Verrai reindirizzato automaticamente alla nuova documentazione di Open Cloud in quel momento. {linkStart}Scopri di più{linkEnd}

Queste vecchie pagine di Open Cloud verranno rimosse e reindirizzate il 31 marzo 2026. {linkStart}Scopri di più{linkEnd}

Gli endpoint sperimentali sono pronti per l'uso pubblico, ma potrebbero subire modifiche incompatibili durante il processo di finalizzazione del contratto API.

Questo endpoint può essere chiamato in-experience tramite {httpServiceLinkStart}HttpService{httpServiceLinkEnd} con una chiave API.

Questo campo può essere impostato durante la creazione di una risorsa, ma non può essere modificato da richieste successive.

È possibile impostare questi campi durante la creazione di una risorsa, ma non modificarli in base a richieste successive.

Questo campo può essere fornito per le richieste, ma non verrà mai incluso nelle risposte.

Metodo di autenticazione legacy. Preferisci sempre l'utilizzo della chiave dell'API o OAuth 2.0 quando disponibile.

Per chiave API: {maxInPeriod} richieste ogni {periodInSeconds} secondi per indirizzo IP

Non richiede un'autenticazione. In genere ha limiti di velocità notevolmente ridotti. Se disponibile, è sempre meglio l'utilizzo della chiave dell'API o OAuth 2.0.

Per ogni raggruppamento, devi inserire solo uno dei campi seguenti nello schema. Gli altri possono essere ignorati.

Puoi riattivarle in qualsiasi momento. {linkStart}Lascia un feedback{linkEnd}.

Stai visualizzando i vecchi documenti. {linkStart}Lascia un feedback{linkEnd}.

Puoi disattivarle in qualsiasi momento e tornare alle vecchie pagine di riferimento. {linkStart}Lascia un feedback.{linkEnd}

Stai visualizzando i documenti rinnovati. {linkStart}Lascia un feedback{linkEnd}.

Questo campo può essere impostato per le risposte, ma verrà ignorato nelle richieste.

Nota: i limiti di velocità possono essere inferiori durante i periodi di traffico elevato. Alcuni endpoint ne hanno di aggiuntivi. [Scopri di più sui limiti di velocità]({link}).

{limit} richieste al giorno su tutte le chiavi dell'API per un utente o un gruppo

{limit} richieste all'ora su tutte le chiavi dell'API per un utente o un gruppo

{limit} richieste al minuto su tutte le chiavi dell'API per un utente o un gruppo

{limit} richieste al secondo su tutte le chiavi dell'API per un utente o un gruppo

{limit} richieste al minuto per proprietario della chiave dell'API

{limit} richieste al giorno per utente dell'app

{limit} richieste all'ora per utente dell'app

{limit} richieste al minuto per utente dell'app

{limit} richieste al secondo per utente dell'app

{limit} richiesta/e al secondo per proprietario della chiave dell'API

Gli obiettivi controllano le autorizzazioni delle tue credenziali. Le tue credenziali possono accedere solo agli endpoint supportati dagli obiettivi selezionati.

Gli endpoint stabili sono pronti per la produzione e raramente subiscono modifiche significative nel corso del loro ciclo di vita.

Questo obiettivo consente di limitare l'accesso della chiave a {requiredParts}

Questo obiettivo consente di limitare l'accesso della chiave a {requiredParts} e {optionalParts}

I tipi di destinazione servono a limitare le risorse su cui le tue credenziali hanno permesso di agire. Solo le risorse selezionate possono essere utilizzate, anche se l'account ha permessi su risorse aggiuntive. Alcuni ambiti non includono parti di destinazione. In questi casi, tutte le risorse pertinenti possono essere utilizzate.

La parte di primo livello dell'universo non dovrebbe essere selezionata per le chiavi dell'API di proprietà dell'utente. In questo modo, la tua chiave dell'API potrà accedere a tutte le esperienze di proprietà dell'utente e del gruppo, a condizione che tu disponga dei permessi corretti per il gruppo.

Provalo non è ancora supportato per gli endpoint che richiedono la chiave dell'API o l'autenticazione OAuth 2.0

L'autenticazione dei cookie è disabilitata per le operazioni ad alto rischio per la sicurezza.

Gli endpoint critici sono altamente sensibili e Provalo è stato disabilitato per ragioni di sicurezza

Nota: le intestazioni di autenticazione non sono incluse in questo esempio di codice. Potrebbe essere necessario aggiungerne una affinché questo comando funzioni.

Questo è un endpoint ad alto rischio che potrebbe causare la modifica o la cancellazione di dati critici. Utilizza estrema cautela in fase di test.

Questo endpoint API è stato classificato come AD ALTO RISCHIO e può influire sui dati in tempo reale o sugli account utente.

Le richieste autenticate alle API ad alto rischio possono apportare modifiche irreversibili. Controlla attentamente i parametri della richiesta prima di procedere.

Effettua il login per utilizzare l'autenticazione tramite cookie

Questo è un endpoint a basso rischio per il recupero dati. Generalmente è sicuro in fase di test.

Questo è un endpoint a rischio medio per la modifica dei dati. Esegui il test con attenzione servendoti di account non critici, poiché le modifiche potrebbero essere permanenti.

Per proteggere il tuo account, non incollare mai qui il testo da altre fonti e non inviare informazioni da questa pagina ad altri.

Stai per testare gli endpoint API live utilizzando le credenziali del tuo account reale.

Procedi solo se comprendi le implicazioni delle chiamate API che stai per effettuare. Esamina attentamente la documentazione dell'API prima di eseguire il test.

Le chiamate API verranno effettuate utilizzando la tua sessione autenticata

Si tratta di chiamate API reali che potrebbero influire sul tuo account o sui tuoi dati

Si applicano limiti di velocità e altre restrizioni API

Alcune operazioni possono modificare o eliminare i dati

Questo endpoint è stato sostituito dai seguenti endpoint alternativi consigliati:

I seguenti ambiti sono necessari per chiamare questo endpoint. Per ulteriori informazioni sulla generazione di chiavi appropriate, consulta l'articolo [Gestire le chiavi API]({apiKeyReferenceDocLink}).

Per ulteriori informazioni sulla generazione di chiavi, consulta l'articolo [Gestire le chiavi API]({apiKeyReferenceDocLink}).

I seguenti endpoint sono disponibili nei percorsi relativi all'URL di base.

Questa stringa è formattata come [Timestamp](/cloud/reference/types#timestamp).

Un valore JSON può essere `null`, `boolean`, `string`, `number`, `array`, or `object`.

I seguenti ambiti sono necessari per l'applicazione OAuth 2.0 per utilizzare questo endpoint. Per ulteriori informazioni su come registrare un'applicazione OAuth 2.0, vedi [Registrazione e revisione dell'app]({oauth2ReferenceDocLink}).

Per ulteriori informazioni su come registrare un'applicazione OAuth 2.0, consulta l'articolo dedicato alla [registrazione e alla revisione dell'app]({oauth2ReferenceDocLink}).

Gli oggetti seguenti descrivono i payloads accettati o restituiti. Per maggiori informazioni su quando vengono utilizzati questi oggetti, consultare ogni singolo endpoint.

Per chiamare questo endpoint sono richiesti i seguenti ambiti.

Percorsi risorse

Per utilizzare questo endpoint sono necessari i seguenti ambiti per la tua applicazione OAuth 2.0. Per ulteriori informazioni su come registrare un'applicazione OAuth 2.0, vedere [Registrazione e revisione dell'app]({oauth2ReferenceDocLink}).

Non consigliato

Stai visualizzando la nuova versione del riferimento Open Cloud.

Hai disattivato il nuovo riferimento Open Cloud.

Visualizza i tuoi account di fatturazione pubblicitaria.

Visualizza le tue campagne pubblicitarie e le loro prestazioni.

Crea, aggiorna e gestisci le tue campagne pubblicitarie.

Questo permette di visualizzare informazioni sui tuoi beni.

Questo permette di caricare e aggiornare gli asset su Roblox.

Consente di visualizzare permessi per le risorse ai soggetti (inclusi gruppi ed esperienze) o risorsa a cui il tuo account ha accesso.

Consente di concedere permessi per le risorse a qualsiasi soggetto (inclusi gruppi ed esperienze) o risorsa a cui il tuo account ha accesso.

Consente di visualizzare lo stato e i risultati delle attività di configurazione automatica dell'avatar per tuo conto.

Consente di creare e gestire attività di configurazione automatica dell'avatar per tuo conto.

Fornisce la possibilità di aggiornare i badge di proprietà dell'utente.

Consente di visualizzare informazioni sui tuoi articoli commerciali.

Consente di apportare modifiche ai tuoi articoli commerciali sincronizzati.

Ciò permette di visualizzare le informazioni sulle tue connessioni commerciali.

Consente la modifica delle tue connessioni commerciali.

Consente di visualizzare le informazioni sui tuoi prodotti del Creator Store.

Consente di modificare le informazioni sui tuoi prodotti del Creator Store.

Consente di visualizzare le informazioni sui tuoi prodotti del Negozio creatore.

Consente di modificare le informazioni sui tuoi salvataggi del Negozio creatore.

Consente l'accesso per creare data store per tuo conto.

Consente l'accesso per eliminare data store per tuo conto.

Consente l'accesso per leggere un elenco di data store.

Consente l'accesso per acquisire un'istantanea dei tuoi data store.

Consente l'accesso per creare voci nei tuoi data store.

Consente l'accesso per contrassegnare specifiche voci ed eliminarle.

Consente l'accesso all'elenco delle voci del tuo data store.

Consente l'accesso per leggere specifiche voci nei tuoi data store.

Consente l'accesso per aggiornare il valore, gli attributi e gli utenti di una voce.

Consente l'accesso per eliminare le revisioni delle voci del tuo data store.

Consente l'accesso alle revisioni dell'elenco delle voci del tuo data store.

Fornisce l'accesso per visualizzare i dettagli di configurazione dei developer product dell'utente autorizzato.

Fornisce l'accesso per modificare i developer product dell'utente autorizzato.

Questo permette di visualizzare informazioni sugli ambienti del tuo universo.

Questo permette di modificare gli ambienti del tuo universo.

Fornisce l'accesso per visualizzare i dettagli di configurazione dei pass di gioco dell'utente autorizzato.

Offre l'accesso per modificare i pass di gioco dell'utente autorizzato.

Offre l'accesso per visualizzare le informazioni sul forum della community per il tuo account.

Offre l'accesso per gestire le informazioni sul forum della community per il tuo account.

Consente di vedere le informazioni sulle tue community.

Consente di gestire le richieste di adesione alla community e gli aggiornamenti dei ruoli dei membri della community di rango inferiore per il tuo account.

Consente di visualizzare i dati delle proprietà di un'istanza.

Consente di modificare i dati delle proprietà delle istanze (attualmente supporta solo script).

Consente l'accesso per gestire le risorse dell'utente.

Offre l'accesso per gestire i tuoi badge.

Offre l'accesso per gestire i tuoi badge e spendere Robux.

Offre l'accesso per aggiornare i badge dell'utente autorizzato.

Consente l'accesso per gestire i tuoi prodotti per sviluppatori.

Consente l'accesso per leggere le informazioni sulle esperienze per le quali hai ricevuto notifiche.

Consente l'accesso per attivare o disattivare le notifiche sulle esperienze per tuo conto.

Consente l'accesso per gestire le tue community.

Fornisce il permesso di leggere le informazioni sulla community.

Concede le autorizzazioni di gestione della community.

Consente l'accesso per leggere e scrivere le tue tabelle di localizzazione

Consente l'accesso per gestire la collaborazione in team per tutte le tue esperienze.

Consente l'accesso per gestire le tue esperienze e determinate informazioni associate alle tue esperienze (ad esempio, informazioni sulla localizzazione).

Offre l'accesso per leggere le informazioni sulla localizzazione delle tue esperienze.

Consente l'accesso per modificare le preferenze di localizzazione delle tue esperienze.

Consente l'accesso per gestire il tuo account utente.

Consente l'accesso per modificare le preferenze di localizzazione dell'utente.

Consente di visualizzare lo stato, i registri e i risultati delle attività di esecuzione Luau per il luogo associato.

Consente di creare nuove attività di esecuzione Luau per il luogo associato.

Concede l'accesso per svuotare in modo asincrono tutte le strutture dati nell'universo.

Consente l'accesso per creare nuovi elementi della coda.

Consente l'accesso per scartare gli elementi letti davanti alla coda.

Consente l'accesso agli elementi letti davanti alla coda.

Consente l'accesso per leggere gli elementi del tuo memory store.

Consente l'accesso per leggere gli elementi della mappa.

Consente l'accesso per creare, aggiornare ed eliminare elementi della mappa.

Ciò garantisce la possibilità di pubblicare messaggi per conto degli utenti.

Consente di inviare notifiche dalla tua esperienza agli utenti.

(Obsoleto) Consente l'accesso per leggere un elenco di voci in un data store ordinato.

(Obsoleto) Consente l'accesso per creare una nuova voce in un data store ordinato.

Consente l'accesso alle voci di elenco da un data store ordinato.

Consente l'accesso per creare voci in un data store ordinato.

Questo permette di elencare i segreti associati alla tua esperienza.

Ciò consente di creare e aggiornare i segreti associati alla tua esperienza.

Questa autorizzazione consente di inviare un lavoro di valutazione e visualizzarne il risultato.

Consente l'accesso per leggere i tuoi prodotti in abbonamento.

Consente di leggere le informazioni sulle miniature per tuo conto.

Offre la possibilità di leggere le analitiche del gioco.

Offre la possibilità di leggere le informazioni sul posto.

Offre la possibilità di modificare le informazioni sul posto.

Permette di pubblicare nuove versioni di esperienze su Roblox.

Offre la possibilità di leggere le informazioni sull'esperienza.

Offre l'accesso per modificare le esperienze dell'utente autorizzato.

Consente di visualizzare le restrizioni degli utenti nell'esperienza.

Ciò consente di visualizzare le notifiche inviate al tuo account.

Offre la possibilità di leggere lo stato premium e verificato dell'utente autorizzato.

Consente di visualizzare gli account social dell'utente autorizzato.

Questa operazione abilita la funzionalità Single Sign-On.

Consente l'accesso alla lettura delle informazioni del tuo profilo.