Retorna um novo `Datatype.DateTime` representando o momento atual no
tempo, usando o relógio local do dispositivo. A maioria dos sistemas operacionais sincroniza
automaticamente sua hora local contra servidores de tempo online, então isso deve estar
dentro de algumas centenas de milissegundos. No entanto, os usuários podem facilmente desativar
o comportamento de sincronização e definir a hora do sistema para qualquer valor desejado; para
tempo sincronizado entre cliente e servidor, use
`Class.Workspace:GetServerTimeNow()` em vez disso.

Quando você precisa medir com precisão o tempo decorrido entre dois pontos no
tempo, como ao testar desempenho, use `Library.os.clock()` em vez disso.

DateTime.now

Retorna um `Datatype.DateTime` representando o momento atual no tempo.

Retorna um novo objeto `Datatype.DateTime` do timestamp Unix fornecido, ou
o número de **segundos** desde 1º de janeiro de 1970 às 00:00 (UTC).

Esta função possui granularidade apenas para 1 segundo. Para representar timestamps sub-segundo,
use `Datatype.DateTime.fromUnixTimestampMillis()` em vez disso.

DateTime.fromUnixTimestamp

unixTimestamp

Retorna um `Datatype.DateTime` representando o timestamp Unix fornecido.

Retorna um novo objeto `Datatype.DateTime` do timestamp Unix fornecido, ou
o número de **milissegundos** desde 1º de janeiro de 1970 às 00:00 (UTC).

DateTime.fromUnixTimestampMillis

unixTimestampMillis

Retorna um `Datatype.DateTime` representando o timestamp Unix fornecido em milissegundos.

Retorna um novo `Datatype.DateTime` usando as unidades fornecidas a partir de um tempo UTC. Os valores
aceitos são semelhantes aos encontrados na tabela de valores de tempo retornada por
`Datatype.DateTime:ToUniversalTime()|ToUniversalTime()`.

- Unidades de data (ano, mês, dia) que produzem uma data inválida causarão um erro. Por exemplo, 32 de janeiro ou 29 de fevereiro em um ano não bissexto.
- Unidades de tempo (hora, minuto, segundo, milissegundo) que estão fora de seu intervalo normal são válidas. Por exemplo, 90 minutos fará a hora rolar por 1; -10 segundos fará o valor do minuto retroceder em 1.
- Valores não inteiros são arredondados para baixo. Por exemplo, fornecer 2.5 horas será equivalente a fornecer 2 horas, não 2 horas 30 minutos.
- Valores omitidos são assumidos como seus menores valores em seu intervalo normal, exceto para o ano que tem como padrão 1970.

DateTime.fromUniversalTime

year

month

hour

minute

second

millisecond

Retorna um novo `Datatype.DateTime` usando as unidades fornecidas a partir de um tempo UTC.

Retorna um novo `Datatype.DateTime` usando as unidades fornecidas a partir de um tempo local. Os
valores aceitos são semelhantes aos encontrados na tabela de valores de tempo
retornada por `Datatype.DateTime:ToLocalTime()|ToLocalTime()`.

- Unidades de data (ano, mês, dia) que produzem uma data inválida causarão um erro. Por exemplo, 32 de janeiro ou 29 de fevereiro em um ano não bissexto.
- Unidades de tempo (hora, minuto, segundo, milissegundo) que estão fora de seu intervalo normal são válidas. Por exemplo, 90 minutos fará a hora rolar por 1; -10 segundos fará o valor do minuto retroceder em 1.
- Valores não inteiros são arredondados para baixo. Por exemplo, fornecer 2.5 horas será equivalente a fornecer 2 horas, não 2 horas 30 minutos.
- Valores omitidos são assumidos como seus menores valores em seu intervalo normal, exceto para o ano que tem como padrão 1970.

DateTime.fromLocalTime

Retorna um novo `Datatype.DateTime` usando as unidades fornecidas a partir de um tempo local.

Retorna um `Datatype.DateTime` de uma string de data-hora ISO 8601 em UTC
time, como aquelas retornadas por `Datatype.DateTime:ToIsoDate()|ToIsoDate()`. Se a análise da string falhar,
a função retorna `nil`.

Um exemplo de string de data-hora ISO 8601 seria `2020-01-02T10:30:45Z`,
que representa 2 de janeiro de 2020 às 10:30 AM, 45 segundos.

DateTime.fromIsoDate

isoDate

Retorna um `Datatype.DateTime` de uma string de data-hora ISO 8601 (em UTC).

O tipo de dado **DateTime** representa um momento no tempo usando um timestamp Unix.
Ele pode ser usado para formatar datas e horários facilmente em locais específicos. Quando
convertido para uma string, uma conversão de string do inteiro timestamp armazenado é
retornada. Eles não armazenam valores de fuso horário. Em vez disso, os fusos horários são considerados
quando se constrói e se usa objetos **DateTime**.

Os objetos **DateTime** são iguais se e somente se suas
propriedades `Datatype.DateTime.UnixTimestampMillis|UnixTimestampMillis` são
iguais.

#### Tabela de Valores de Tempo

Os métodos `Datatype.DateTime:ToUniversalTime()|ToUniversalTime()` e
`Datatype.DateTime:ToLocalTime()|ToLocalTime()` retornam uma tabela de
valores relacionados ao tempo, como `Year`, `Month`, e `Day`. O formato da
tabela retornada por essas funções é descrito abaixo, com cada elemento inteiro
em ordem decrescente de tamanho.

<table>
<thead>
  <tr>
    <td>Nome</td>
    <td>Intervalo</td>
    <td>Notas</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>Normalmente
  0&ndash;59, às vezes 60 para acomodar segundos intercalares em determinados
  sistemas.</td>
</tr> <tr>
  <td><code>Millisecond</code></td><td>0&ndash;999</td><td >&mdash;</td>
</tr>
</tbody>
</table>

#### Formato da String

O objeto `Datatype.DateTime` suporta conversão de data/hora em uma string
através dos métodos `Datatype.DateTime:FormatUniversalTime()|FormatUniversalTime()`
e `Datatype.DateTime:FormatLocalTime()|FormatLocalTime()`. Ambos
funcionam da mesma forma, exceto pelo fuso horário em que o `Datatype.DateTime`
deveria ser interpretado.

O primeiro argumento passado para esses métodos deve ser uma string representando um
 dos tokens mostrados abaixo. Os tokens são então substituídos por um valor específico
de acordo com o local fornecido.

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

-- O token "dddd" é substituído pelo dia completo da semana
print("Hoje é " .. dt:FormatLocalTime("dddd", "en-us"))

-- Para o local "en-us", o token "LL" é igual a "MMMM D, YYYY"
print("A data é " .. dt:FormatLocalTime("LL", "en-us"))
```

##### Tokens Compostos

Dependendo do local, esses tokens se substituem por **combinações específicas** dos
**tokens elementares** descritos na próxima seção. Isso produz uma string de data/hora
correta, dependendo do local. Por exemplo, em inglês, a data tem o formato
"[month]&nbsp;[day]" como em "June&nbsp;11". Em francês, a data está em um
formato "[day]&nbsp;[month]" como em "11&nbsp;juin". Essas regras especiais são
tratadas automaticamente por meio dos seguintes tokens compostos, portanto use
esses se você estiver exibindo informações simples de tempo e/ou data.

<table>
  <thead>
    <tr>
      <th>Token(s)</th>
      <th>Exemplos de Locale (Formato)</th>
    </tr>
  </thead>
    <thead>
    <tr>
      <th colspan=2>Hora</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>Hora com Segundos</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>Mês (Número), Dia, Ano</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>Mês (Nome), Dia, Ano</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>Mês (Nome), Dia, Ano, Hora</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>Dia da Semana, Mês (Nome), Dia, Ano, Hora</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>LLLL</code></td>
      <td>
        <div><code>en-us</code> : <code>Thursday, September 4, 1986 8:30 PM</code> (<code>dddd, MMMM D, YYYY h:mm A</code>)</div>
        <div><code>zh-cn</code> : <code>1986年9月4日星期四晚上8点30分</code> (<code>YYYY年M月D日ddddAh点mm分</code>)</div>
      </td>
    </tr>
    <tr>
      <td><code>llll</code></td>
      <td>
        <div><code>en-us</code> : <code>Thu, Sep 4, 1986 8:30 PM</code> (<code>ddd, MMM D, YYYY h:mm A</code>)</div>
        <div><code>zh-cn</code> : <code>1986年9月4日星期四 20:30</code> (<code>YYYY年M月D日dddd HH:mm</code>)</div>
      </td>
    </tr>
  </tbody>
</table>

##### Tokens Elementares

Cada um desses tokens se substitui por um **único valor** e pode ser usado como elementos
de uma string de tempo maior. Evite usar esses se você só precisa de informações simples de data e
hora, pois os **tokens compostos** são mais apropriados para esses
propósitos.

<table>
<thead>
  <tr>
    <th>Token(s)</th>
    <th>Exemplos</th>
  </tr>
</thead>
  <thead>
  <tr>
    <th colspan=2>Ano</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>Mês</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>Janeiro</code>, <code>Fevereiro</code>, &hellip;, <code>Novembro</code>, <code>Dezembro</code></td>
</tr>
</tbody>
  <thead>
  <tr>
    <th colspan=2>Dia do Mês</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>Dia do Ano</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>Dia da Semana</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>Se</code>, &hellip;, <code>Fr</code>, <code>Sa</code></td>
</tr>
<tr>
  <td><code>ddd</code></td>
  <td><code>Dom</code>, <code>Seg</code>, &hellip;, <code>Sex</code>, <code>Sab</code></td>
</tr>
<tr>
  <td><code>dddd</code></td>
  <td><code>Domingo</code>, <code>Segunda-feira</code>, &hellip;, <code>Sexta-feira</code>, <code>Sábado</code></td>
</tr>
</tbody>
  <thead>
  <tr>
    <th colspan=2>Hora</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>Segundo</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>Segundo Fracionário</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 o valor deste objeto `Datatype.DateTime` para Hora Coordenada Universal
(UTC). A tabela retornada contém as seguintes chaves:
`Year`, `Month`, `Day`, `Hour`, `Minute`, `Second`, `Millisecond`. Para
mais detalhes, veja a tabela de valores de tempo na descrição deste tipo de dado.
Os valores dentro desta tabela podem ser passados para
`Datatype.DateTime.fromUniversalTime()|fromUniversalTime()` para produzir o
objeto `Datatype.DateTime` original.


DateTime:ToUniversalTime

Retorna os componentes do `Datatype.DateTime` em UTC.


Converte o valor deste objeto `Datatype.DateTime` para hora local. A
tabela retornada contém as seguintes chaves: `Year`, `Month`, `Day`,
`Hour`, `Minute`, `Second`, `Millisecond`. Para mais detalhes, veja a tabela de tempo
na descrição deste tipo de dado. Os valores dentro desta tabela
podem ser passados para `Datatype.DateTime.fromLocalTime()|fromLocalTime()` para
produzir o objeto `Datatype.DateTime` original.


DateTime:ToLocalTime

Retorna os componentes do `Datatype.DateTime` em hora local.


Formata uma data como uma string de data-hora ISO 8601. O valor retornado por esta
função pode ser passado para
`Datatype.DateTime.fromIsoDate()|fromIsoDate()` para produzir o objeto
`Datatype.DateTime` original.

Um exemplo de string de data-hora ISO 8601 seria `2020-01-02T10:30:45Z`,
que representa 2 de janeiro de 2020 às 10:30 AM, 45 segundos.


DateTime:ToIsoDate

Retorna o `Datatype.DateTime` como uma string de data-hora ISO 8601.


Gera uma string do valor `Datatype.DateTime` interpretado como
Hora Coordenada Universal (UTC) e uma string de formato. A string de formato
deve conter tokens, que serão substituídos por certos valores de data/hora
descritos pelo objeto `Datatype.DateTime`. Para mais detalhes, veja a
seção **Formato da String** na descrição deste tipo de dado.

```lua
local dt = DateTime.now()
-- Para en-us, o token "LL" é igual a "MMM D, YYYY", que dá "June 11, 2020"
print("A data é " .. dt:FormatUniversalTime("LL", "en-us"))
--> "A data é June 11, 2020"
```


DateTime:FormatUniversalTime

format

locale

Retorna o valor do DateTime em UTC formatado em uma string.


Gera uma string do valor `Datatype.DateTime` interpretado como
**hora local** e uma string de formato. A string de formato deve conter
tokens, que serão substituídos por certos valores de data/hora descritos pelo
objeto `Datatype.DateTime`. Para mais detalhes, veja a seção **Formato da String**
na descrição deste tipo de dado.

```lua
local dt = DateTime.now()
-- Para en-us, o token "LL" é igual a "MMM D, YYYY", que dá "June 11, 2020"
print("A data é " .. dt:FormatLocalTime("LL", "en-us"))
--> "A data é June 11, 2020"
```


DateTime:FormatLocalTime

Retorna o valor do objeto `Datatype.DateTime` em hora local formatado
em uma string.


DateTime

O número de **segundos** desde 1º de janeiro de 1970 às 00:00 UTC (a
época Unix). O intervalo é de -17.987.443.200 a 253.402.300.799, aproximadamente anos
1400&ndash;9999.


DateTime.UnixTimestamp

O número de **segundos** entre 1º de janeiro de 1970 às 00:00 UTC (a
época Unix).


O número de **milissegundos** desde 1º de janeiro de 1970 às 00:00 UTC (a
época Unix). O intervalo é de -17.987.443.200.000 a 253.402.300.799.999,
aproximadamente anos 1400&ndash;9999.


DateTime.UnixTimestampMillis

O número de **milissegundos** entre 1º de janeiro de 1970 às 00:00 UTC (a
época Unix).


Um tipo de dado que representa um momento no tempo.


/reference/engine/datatypes/DateTime.yaml

Luau

Dictionary

Um objeto que executa funções conectadas ao ocorrer um evento específico.

Data Type

RBXScriptSignal

Um número em ponto flutuante de dupla precisão.

number

Uma sequência de caracteres, como letras, números e símbolos.

string

Experiências

Avatar

Ativos

Amostras e projetos

API de motor

API de nuvem aberta

Studio

Dados analíticos

Plataforma

Tutoriais

Programas de Criador

Educação

Cursos

Aprender

Este método é assíncrono e retorna uma "Operação", que representa o estado atual da operação. Ele contém um caminho de endpoint que você pode solicitar para obter a resposta real e os metadados aplicáveis. Veja o [documentation]({longRunningOperationsLink}) em operações de longo prazo para obter mais informações.
            
As seções a seguir descrevem os objetos de resposta e metadados que são fornecidos quando uma operação se completa.

Pontos de extremidade beta estão prontos para uso público. Alterações  danosas são possíveis mas raras.

Estas páginas de documentação do Open Cloud serão removidas em 31 de março de 2026. A partir dessa data, vamos redirecionar você automaticamente para a nova documentação do Open Cloud. {linkStart}Saiba mais{linkEnd}.

Estas páginas antigas da Open Cloud serão removidas e redirecionadas em 31 de março de 2026. {linkStart}Saiba mais{linkEnd}.

Os endpoints experimentais estão prontos para uso público, mas podem sofrer alterações ocasionais à medida que o contrato da API é finalizado.

Este endpoint pode ser chamado na experiência por meio do {httpServiceLinkStart}HttpService{httpServiceLinkEnd} com uma chave API.

Este campo pode ser definido ao criar um recurso, mas não pode ser modificado por solicitações subsequentes.

Esses campos podem ser definidos ao criar um recurso, mas não podem ser modificados por solicitações subsequentes.

Este campo pode ser fornecido em solicitações, mas nunca será incluído em respostas.

Método de autenticação legado. Sempre prefira usar a chave API ou OAuth 2.0 quando disponível.

Por chave de API: {maxInPeriod} solicitações a cada {periodInSeconds} segundos por endereço IP

Não requer autenticação para ser chamado. Costuma ter limites de taxa significativamente reduzidos. Sempre prefira usar a chave API ou OAuth 2.0 quando disponível.

Para cada agrupamento, apenas um dos seguintes campos no esquema deve ser fornecido; o restante pode ser excluído.

Você pode voltar a qualquer momento. {linkStart}Deixe um comentário.{linkEnd}

Você está visualizando os documentos antigos. {linkStart}Deixe um comentário.{linkEnd}

Você pode desativar a qualquer momento e seguir de volta para as páginas de referência antigas. {linkStart}Deixe um comentário.{linkEnd}

Você está visualizando os documentos renovados. {linkStart}Deixe um comentário.{linkEnd}

Este campo pode ser definido como respostas, mas será ignorado em solicitações.

Nota: Os limites de taxa podem ser menores durante períodos de alto tráfego. Alguns pontos de extremidade têm limites de taxa adicionais. [Saiba mais sobre os limites da taxa]({link}).

{limit} solicitações por segundo em todas as chaves API para um usuário ou grupo

{limit} solicitações por hora em todas as chaves API para um usuário ou grupo

{limit} solicitações por segundo em todas as chaves de API para um usuário ou grupo

{limit} solicitações por minuto por proprietário de chave API

{limit} solicitações por dia por usuário do aplicativo

{limit} solicitações por hora por usuário do aplicativo

{limit} solicitações por minuto por usuário do aplicativo

{limit} solicitações por segundo por usuário do aplicativo

{limit} solicitações por segundo por proprietário de chave API

Escopos controlam quais permissões suas credenciais tem. Suas credenciais só podem acessar os endpoints suportados pelos escopos selecionados.

Os endpoints estáveis estão prontos para uso em produção e quase nunca sofrerão alterações significativas durante sua vida útil.

Este alvo permite limitar o acesso da chave às {requiredParts} selecionadas

Este alvo permite limitar o acesso da chave aos {requiredParts} selecionados e {optionalParts}

Os tipos de destino são usados para restringir os recursos para os quais suas credenciais têm permissões. Apenas os recursos selecionados podem ser acionados, mesmo que sua conta tenha permissões para recursos adicionais. Alguns escopos não têm partes de destino. Nesses casos, todos os seus recursos relevantes podem ser acionados.

A parte de nível superior do universo não precisa ser selecionada para chaves API que pertencem ao usuário. Nesse caso, sua chave API terá acesso a todas as suas experiências que pertencem ao usuário ou ao grupo para as quais você tem as permissões de grupo corretas.

A função Try It Out ainda não é suportada com endpoints que exigem chave API ou autenticação OAuth 2.0

Por segurança, a autenticação de cookies está desabilitada para operações de alto risco.

Os endpoints de risco crítico são extremamente sensíveis, por isso, a função Try It Out está desativada por motivos de segurança

Observação: este exemplo de código não inclui cabeçalhos de autenticação. Pode ser necessário adicionar um cabeçalho de autenticação para que este comando funcione.

Este é um endpoint de alto risco que pode modificar ou excluir dados críticos. Tenha muito cuidado ao testar.

Este endpoint de API foi classificado como ALTO RISCO e pode afetar dados em operação ou contas de usuário.

Solicitações autenticadas para APIs de alto risco podem resultar em alterações que não podem ser desfeitas. Revise os parâmetros da sua solicitação cuidadosamente antes de prosseguir.

Entre na sua conta para usar a autenticação de cookies

Este é um endpoint de baixo risco que recupera dados. Geralmente, é seguro para testes.

Este é um endpoint de risco médio que modifica dados. Teste com cuidado com contas que não tenham grande importância, pois as alterações podem ser permanentes.

Para manter sua conta segura, nunca cole texto de outras fontes aqui ou envie informações desta página para outras pessoas.

Você está prestes a testar endpoints de API em operação usando suas credenciais de conta reais.

Prossiga apenas se você estiver ciente das consequências das chamadas de API que você está prestes a fazer. Revise a documentação da API cuidadosamente antes de fazer os testes.

As chamadas de API serão feitas usando sua sessão autenticada

Essas chamadas de API são reais e podem afetar sua conta ou dados

Limites de taxa e outras restrições de API se aplicam

Algumas ações podem modificar ou excluir dados

Este endpoint foi substituído por estes endpoints alternativos recomendados:

Os seguintes escopos são necessários para chamar este endpoint. Para mais
informações sobre como gerar chaves adequadas, consulte [Gerenciar chaves API]({apiKeyReferenceDocLink}).

Para mais informações sobre como gerar chaves, consulte [Gerenciar chaves de API]({apiKeyReferenceDocLink}).

Os seguintes endpoints estão disponíveis em caminhos relativos à URL base.

Esta cadeia de caracteres está formatada como um [FieldMask](/cloud/reference/types#fieldmask).

Um valor JSON pode ser `null`, `boolean`, `string`, `number`, `array`, ou `object`.

Os seguintes escopos são necessários para que seu aplicativo OAuth 2.0 use este endpoint. Para obter mais informações sobre como registrar um aplicativo OAuth 2.0, consulte [Registro e revisão de aplicativos]({oauth2ReferenceDocLink}).

Para mais informações sobre como registrar um aplicativo OAuth 2.0, consulte [Registro e revisão de aplicativos]({oauth2ReferenceDocLink}).

Os seguintes objetos descrevem payloads que são aceitos ou retornados. Veja cada endpoint para mais informações sobre quando esses objetos são usados.

Os seguintes escopos são necessários para chamar este endpoint.

Caminhos de recursos

Esta cadeia de caracteres é formatada como um [Timestamp](/cloud/reference/types#timestamp).

Os seguintes escopos são necessários para que sua aplicação OAuth 2.0 use este endpoint. Para obter mais informações sobre como registrar um aplicativo OAuth 2.0, consulte [Registro e revisão do aplicativo]({oauth2ReferenceDocLink}).

Não recomendado

Você está visualizando a referência renovada do Open Cloud.

Você optou por não participar da nova referência do Open Cloud.

Ver suas contas de faturamento de publicidade.

Ver suas campanhas de anúncios e o desempenho delas.

Crie, atualize e gerencie suas campanhas de anúncios.

Isto permite visualizar informações sobre seus ativos.

Isto permite enviar e atualizar ativos para a Roblox.

Isso permite visualizar as permissões de ativos de elementos (incluindo grupos e experiências) e ativos que sua conta tem acesso.

Isso permite conceder permissões de ativos a todos os participantes (incluindo grupos e experiências) e aos ativos que sua conta tem acesso.

Isso permite que você visualize o status e os resultados de tarefas de configuração automática de avatar em seu nome.

Isso permite que você crie e gerencie tarefas de configuração automática de avatar em seu nome.

Concede a capacidade de atualizar emblemas de propriedade do usuário.

Isso permite visualizar informações sobre seus itens de comércio.

Isso permite fazer alterações nos itens de comércio sincronizados.

Isto permite visualizar informações sobre suas conexões de comerciante.

Isso permite editar suas conexões de comerciante.

Isso permite que você visualize informações sobre seus produtos da Loja do Criador.

Isso permite que você modifique informações sobre seus produtos da Loja de Criadores.

Isso permite que você veja informações dos elementos que salvou da Loja do Criador.

Isso permite que você modifique informações dos elementos que salvou da Loja do Criador.

Concede acesso à criação de armazenamento de dados em seu nome.

Concede acesso para excluir armazenamentos de dados em seu nome.

Concede acesso para ler uma lista de armazenamento de dados.

Concede acesso para tirar uma captura de seu armazenamento de dados.

Concede acesso para criar entradas em seu armazenamento de dados.

Concede acesso para marcar entradas especificadas para exclusão.

Concede acesso à lista de entradas de seu armazenamento de dados.

Concede acesso a entradas especificadas em seu armazenamento de dados.

Concede acesso para atualizar o valor, atributos e usuários de uma entrada.

Concede acesso para excluir revisões de entradas de seu armazenamento de dados.

Concede acesso a revisões de lista de entradas de seu armazenamento de dados.

Concede acesso para ver os detalhes da configuração dos produtos do desenvolvedor do usuário autorizado.

Concede acesso para editar os produtos do desenvolvedor do usuário autorizado.

Isto permite visualizar informações sobre os ambientes do seu universo.

Isto permite editar os ambientes do seu universo.

Concede acesso para ver os detalhes da configuração dos passes de jogo do usuário autorizado.

Concede acesso para editar os passes de jogo do usuário autorizado.

Concede acesso para ver as informações dos fóruns da comunidade para sua conta.

Concede acesso para gerenciar as informações dos fóruns da comunidade para sua conta.

Isso permite visualizar informações sobre suas comunidades

Isso permite que você gerencie solicitações de participação na comunidade e atualizações de cargos de membros da comunidade de níveis inferiores para sua conta.

Permite que você veja os dados da instância de propriedade.

Permite modificar os dados de propriedade de instâncias (atualmente suporta apenas scripts).

Isto permite visualizar informações sobre seu inventário.

Conceda acesso para gerenciar seus ativos.

Concede acesso para gerenciar seus emblemas.

Concede acesso para gerenciar seus emblemas e gastar Robux.

Concede acesso para atualizar os emblemas do usuário autorizado.

Concede acesso para gerenciar seus produtos de desenvolvedor.

Concede acesso para ler informações sobre as experiências nas quais você tem notificações ligadas.

Concede acesso às notificações para as experiências em seu nome.

Concede acesso para gerenciar seus passes.

Concede acesso para gerenciar suas comunidades.

Concede permissão para ler informações da comunidade.

Concede permissões de gerenciamento de comunidade.

Concede acesso para ler e escrever suas tabelas de localização

Concede acesso para gerenciar a colaboração de equipe para todas as experiências que você possui.

Concede acesso para gerenciar suas experiências e certas informações associadas a suas experiências (por exemplo, informações de localização).

Concede acesso para ler as informações de localização das suas experiências.

Concede acesso para modificar as preferências de localização das suas experiências.

Concede acesso para gerenciar sua conta de usuário.

Concede acesso para modificar as preferências de localização do usuário.

Permite que você veja o status, registros e resultados de tarefas de execução Luau para o local associado.

Permite criar novas tarefas de execução Luau para o lugar associado.

Concede acesso a liberar assíncronamente todas as estruturas de dados no universo.

Concede acesso para criar novos itens da fila.

Concede acesso para descartar itens lidos do começo da fila.

Concede acesso para ler itens no começo da fila.

Concede acesso para ler os itens do armazenamento de memória.

Concede acesso para criar, atualizar e excluir itens de mapa.

Isto permite publicar mensagens em nome de um usuário.

Isto permite o envio de notificações da sua experiência aos usuários.

(Obsoleto) Concede acesso para ler uma lista de entradas em um armazenamento de dados ordenado.

(Obsoleto) Concede acesso para criar uma nova entrada em um armazenamento de dados ordenado.

Concede acesso a entradas de lista de um armazenamento de dados ordenado.

Concede acesso para criar entradas em um armazenamento de dados ordenado.

Isto permite listar segredos aliados à sua experiência.

Isto permite criar e atualizar segredos relacionados à sua experiência.

Esta permissão permite que você envie um trabalho de avaliação e visualize o resultado da tarefa.

Concede acesso para ler sobre seus produtos de assinatura.

Isso permite que você leia informações de miniaturas em seu nome.

Concede a capacidade de ler dados analíticos do jogo.

Concede a capacidade de ler informações do local.

Concede a capacidade de editar as informações do local.

Concede acesso para publicar novas versões de experiências na Roblox.

Concede a capacidade de ler informações da experiência.

Concede acesso para editar as experiências do usuário autorizado.

Permite que você veja restrições de usuário na experiência.

Permite que você edite restrições de usuário na experiência.

Isso permite ver as notificações enviadas para sua conta.

Concede a capacidade de ler o status premium e verificado do usuário autorizado.

Isso permite que você veja as contas sociais do usuário autorizado.

Isto habilita a funcionalidade de entrada única.

Isso permite acesso à leitura das informações do seu perfil.