Devuelve un nuevo `Datatype.DateTime` que representa el momento actual en
el tiempo, usando el reloj local del dispositivo. La mayoría de los sistemas operativos sincronizan automáticamente su hora local con servidores de tiempo en línea, por lo que debería estar dentro de unos pocos cientos de milisegundos. Sin embargo, los usuarios pueden desactivar fácilmente el comportamiento de sincronización y establecer la hora del sistema en cualquier cosa que deseen; para tiempo sincronizado entre cliente y servidor, usa `Class.Workspace:GetServerTimeNow()` en su lugar.

Cuando necesites medir con precisión el tiempo transcurrido entre dos momentos en el tiempo, como al probar el rendimiento, usa `Library.os.clock()` en su lugar.

DateTime.now

Devuelve un `Datatype.DateTime` que representa el momento actual en el tiempo.

Devuelve un nuevo objeto `Datatype.DateTime` de la marca de tiempo Unix dada, o
el número de **segundos** desde el 1 de enero de 1970 a las 00:00 (UTC).

Esta función solo tiene granularidad de 1 segundo. Para representar marcas de tiempo sub-segundo, usa `Datatype.DateTime.fromUnixTimestampMillis()` en su lugar.

DateTime.fromUnixTimestamp

unixTimestamp

Devuelve un `Datatype.DateTime` que representa la marca de tiempo Unix dada.

Devuelve un nuevo objeto `Datatype.DateTime` de la marca de tiempo Unix dada, o
el número de **milisegundos** desde el 1 de enero de 1970 a las 00:00 (UTC).

DateTime.fromUnixTimestampMillis

unixTimestampMillis

Devuelve un `Datatype.DateTime` que representa la marca de tiempo Unix dada en milisegundos.

Devuelve un nuevo `Datatype.DateTime` usando las unidades dadas de un tiempo UTC. Los valores
aceptados son similares a los encontrados en la tabla de valores de tiempo devuelta por
`Datatype.DateTime:ToUniversalTime()|ToUniversalTime()`.

- Las unidades de fecha (año, mes, día) que producen una fecha inválida generarán un error. Por ejemplo, el 32 de enero o el 29 de febrero en un año no bisiesto.
- Las unidades de tiempo (hora, minuto, segundo, milisegundo) que están fuera de su rango normal son válidas. Por ejemplo, 90 minutos hará que la hora se pase en 1; -10 segundos hará que el valor del minuto retroceda en 1.
- Los valores no enteros se redondean hacia abajo. Por ejemplo, proporcionar 2.5 horas será equivalente a proporcionar 2 horas, no 2 horas y 30 minutos.
- Los valores omitidos se asumen como el valor más bajo en su rango normal, excepto para el año que por defecto es 1970.

DateTime.fromUniversalTime

year

month

hour

minute

second

millisecond

Devuelve un nuevo `Datatype.DateTime` usando las unidades dadas de un tiempo UTC.

Devuelve un nuevo `Datatype.DateTime` usando las unidades dadas de un tiempo local. Los
valores aceptados son similares a los encontrados en la tabla de valores de tiempo
devuelta por `Datatype.DateTime:ToLocalTime()|ToLocalTime()`.

- Las unidades de fecha (año, mes, día) que producen una fecha inválida generarán un error. Por ejemplo, el 32 de enero o el 29 de febrero en un año no bisiesto.
- Las unidades de tiempo (hora, minuto, segundo, milisegundo) que están fuera de su rango normal son válidas. Por ejemplo, 90 minutos hará que la hora se pase en 1; -10 segundos hará que el valor del minuto retroceda en 1.
- Los valores no enteros se redondean hacia abajo. Por ejemplo, proporcionar 2.5 horas será equivalente a proporcionar 2 horas, no 2 horas y 30 minutos.
- Los valores omitidos se asumen como el valor más bajo en su rango normal, excepto para el año que por defecto es 1970.

DateTime.fromLocalTime

Devuelve un nuevo `Datatype.DateTime` usando las unidades dadas de un tiempo local.

Devuelve un `Datatype.DateTime` de una cadena de fecha-hora ISO 8601 en UTC
tiempo, como las que devuelve `Datatype.DateTime:ToIsoDate()|ToIsoDate()`. Si el análisis de la cadena falla,
la función devuelve `nil`.

Un ejemplo de cadena de fecha-hora ISO 8601 sería `2020-01-02T10:30:45Z`,
que representa el 2 de enero de 2020 a las 10:30 AM, 45 segundos.

DateTime.fromIsoDate

isoDate

Devuelve un `Datatype.DateTime` de una cadena de fecha-hora ISO 8601 (en UTC).

El **DateTime** tipo de dato representa un momento en el tiempo usando una marca de tiempo Unix.
Se puede usar para formatear fácilmente fechas y horas en locales específicos. Cuando
se convierte en una cadena, se devuelve una conversión de cadena del entero de marca de tiempo almacenado.
No almacenan valores de zona horaria. En su lugar, las zonas horarias se consideran
al construir y usar objetos **DateTime**.

Los objetos **DateTime** son iguales si y solo si sus
`Datatype.DateTime.UnixTimestampMillis|UnixTimestampMillis` propiedades son
eguales.

#### Tabla de Valores de Tiempo

Los métodos `Datatype.DateTime:ToUniversalTime()|ToUniversalTime()` y
`Datatype.DateTime:ToLocalTime()|ToLocalTime()` devuelven una tabla de
valores relacionados con el tiempo, como `Año`, `Mes`, y `Día`. El formato de la
tabla devuelta por estas funciones se describe a continuación, con cada elemento entero
en orden de tamaño descendente.

<table>
<thead>
  <tr>
    <td>Nombre</td>
    <td>Rango</td>
    <td>Notas</td>
  </tr>
</thead>
<tbody>
<tr>
  <td><code>Año</code></td><td>1400&ndash;9999</td><td>&mdash;</td>
</tr>
<tr>
  <td><code>Mes</code></td><td>1&ndash;12</td><td >&mdash;</td>
</tr>
<tr>
  <td><code>Día</code></td><td>1&ndash;31</td><td >&mdash;</td>
</tr>
<tr>
  <td><code>Hora</code></td><td>0&ndash;23</td><td >&mdash;</td>
</tr>
<tr>
  <td><code>Minuto</code></td><td>0&ndash;59</td><td >&mdash;</td>
</tr>
<tr>
  <td><code>Segundo</code></td><td>0&ndash;60</td><td>Usualmente
  0&ndash;59, a veces 60 para acomodar los segundos intercalados en ciertos
  sistemas.</td>
</tr> <tr>
  <td><code>Milisegundo</code></td><td>0&ndash;999</td><td >&mdash;</td>
</tr>
</tbody>
</table>

#### Formato de Cadena

El objeto `Datatype.DateTime` admite la conversión de fecha/hora a una cadena
a través de los métodos `Datatype.DateTime:FormatUniversalTime()|FormatUniversalTime()`
y `Datatype.DateTime:FormatLocalTime()|FormatLocalTime()`. Ambos
funcionan de la misma manera excepto por la zona horaria en la que se debe interpretar el `Datatype.DateTime`.

El primer argumento pasado a estos métodos debe ser una cadena que represente uno
de los tokens mostrados a continuación. Los tokens se reemplazan con un valor específico
dependiendo del locale proporcionado.

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

-- El token "dddd" se reemplaza con el día de la semana completo
print("Hoy es " .. dt:FormatLocalTime("dddd", "en-us"))

-- Para el locale "en-us", el token "LL" equivale a "MMMM D, YYYY"
print("La fecha es " .. dt:FormatLocalTime("LL", "en-us"))
```

##### Tokens Compuestos

Dependiendo del locale, estos tokens se reemplazan por **combinaciones específicas** de los
**tokens elementales** descritos en la siguiente sección. Esto produce una cadena correcta de
fecha/hora dependiendo del locale. Por ejemplo, en inglés, la fecha
se presenta como "[month]&nbsp;[day]" como en "June&nbsp;11". En francés, la fecha está en un
formato "[day]&nbsp;[month]" como en "11&nbsp;juin". Estas reglas especiales son
manejadas automáticamente por los siguientes tokens compuestos, así que úsalos
si estás mostrando información simple de hora y/o fecha.

<table>
  <thead>
    <tr>
      <th>Token(s)</th>
      <th>Ejemplos 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 con 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">Mes (Número), Día, Año</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">Mes (Nombre), Día, Año</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">Mes (Nombre), Día, Año, 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">Día de la Semana, Mes (Nombre), Día, Año, 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 Elementales

Cada uno de estos tokens se reemplaza por un **valor único** y se puede usar como elementos
de una cadena de tiempo más grande. Evita usar estos si solo necesitas información simple de fecha y
tiempo, ya que los **tokens compuestos** son más apropiados para esos
propósitos.

<table>
<thead>
  <tr>
    <th>Token(s)</th>
    <th>Ejemplos</th>
  </tr>
</thead>
  <thead>
  <tr>
    <th colspan="2">Año</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">Mes</th>
  </tr>
</thead>
<tbody>
<tr>
  <td><code>M</code></td>
  <td><code>1</code>, <code>2</code>, &hellip;, <code>11</code>, <code>12</code></td>
</tr>
<tr>
  <td><code>MM</code></td>
  <td><code>01</code>, <code>02</code>, &hellip;, <code>11</code>, <code>12</code></td>
</tr>
<tr>
  <td><code>MMM</code></td>
  <td><code>Jan</code>, <code>Feb</code>, &hellip;, <code>Nov</code>, <code>Dec</code></td>
</tr>
<tr>
  <td><code>MMMM</code></td>
  <td><code>January</code>, <code>February</code>, &hellip;, <code>November</code>, <code>December</code></td>
</tr>
</tbody>
  <thead>
  <tr>
    <th colspan="2">Día del Mes</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">Día del Año</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">Día de la 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>Su</code>, <code>Mo</code>, &hellip;, <code>Fr</code>, <code>Sa</code></td>
</tr>
<tr>
  <td><code>ddd</code></td>
  <td><code>Sun</code>, <code>Mon</code>, &hellip;, <code>Fri</code>, <code>Sat</code></td>
</tr>
<tr>
  <td><code>dddd</code></td>
  <td><code>Sunday</code>, <code>Monday</code>, &hellip;, <code>Friday</code>, <code>Saturday</code></td>
</tr>
</tbody>
  <thead>
  <tr>
    <th colspan="2">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 Fraccional</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>


Convierte el valor de este objeto `Datatype.DateTime` a Tiempo Universal
Coordinado (UTC). La tabla devuelta contiene las siguientes claves:
`Año`, `Mes`, `Día`, `Hora`, `Minuto`, `Segundo`, `Milisegundo`. Para
más detalles, consulta la tabla de valores de tiempo en la descripción de este tipo de dato.
Los valores dentro de esta tabla podrían ser pasados a
`Datatype.DateTime.fromUniversalTime()|fromUniversalTime()` para producir el
objeto `Datatype.DateTime` original.


DateTime:ToUniversalTime

Devuelve los componentes del `Datatype.DateTime` en UTC.


Convierte el valor de este objeto `Datatype.DateTime` a tiempo local. La
tabla devuelta contiene las siguientes claves: `Año`, `Mes`, `Día`,
`Hora`, `Minuto`, `Segundo`, `Milisegundo`. Para más detalles, consulta la tabla de tiempo
valores en la descripción de este tipo de dato. Los valores dentro de esta tabla
podrían ser pasados a `Datatype.DateTime.fromLocalTime()|fromLocalTime()` para
producir el objeto `Datatype.DateTime` original.


DateTime:ToLocalTime

Devuelve los componentes del `Datatype.DateTime` en tiempo local.


Formatea una fecha como una cadena de fecha-hora ISO 8601. El valor devuelto por esta
función podría ser pasado a
`Datatype.DateTime.fromIsoDate()|fromIsoDate()` para producir el objeto original
`Datatype.DateTime`.

Un ejemplo de cadena de fecha-hora ISO 8601 sería `2020-01-02T10:30:45Z`,
que representa el 2 de enero de 2020 a las 10:30 AM, 45 segundos.


DateTime:ToIsoDate

Devuelve el `Datatype.DateTime` como una cadena de fecha-hora ISO 8601.


Genera una cadena a partir del valor `Datatype.DateTime` interpretado como
Tiempo Universal Coordinado (UTC) y una cadena de formato. La cadena de formato
debería contener tokens, que se reemplazarán por ciertos valores de fecha/hora
descritos por el objeto `Datatype.DateTime`. Para más detalles, consulta la
sección **Formato de Cadena** en la descripción de este tipo de dato.

```lua
local dt = DateTime.now()
-- Para en-us, el token "LL" equivale a "MMM D, YYYY", que da "June 11, 2020"
print("La fecha es " .. dt:FormatUniversalTime("LL", "en-us"))
--> "La fecha es June 11, 2020"
```


DateTime:FormatUniversalTime

format

locale

Devuelve el valor de DateTime en UTC formateado en una cadena.


Genera una cadena a partir del valor `Datatype.DateTime` interpretado como
**tiempo local** y una cadena de formato. La cadena de formato debería contener
tokens, que se reemplazarán por ciertos valores de fecha/hora descritos por el
objeto `Datatype.DateTime`. Para más detalles, consulta la sección **Formato de Cadena**
en la descripción de este tipo de dato.

```lua
local dt = DateTime.now()
-- Para en-us, el token "LL" equivale a "MMM D, YYYY", que da "June 11, 2020"
print("La fecha es " .. dt:FormatLocalTime("LL", "en-us"))
--> "La fecha es June 11, 2020"
```


DateTime:FormatLocalTime

Devuelve el valor del objeto `Datatype.DateTime` en tiempo local formateado
en una cadena.


DateTime

El número de **segundos** desde el 1 de enero de 1970 a las 00:00 UTC (el Unix
epoch). El rango es -17,987,443,200 a 253,402,300,799, aproximadamente años
1400&ndash;9999.


DateTime.UnixTimestamp

El número de **segundos** entre el 1 de enero de 1970 a las 00:00 UTC (el Unix
epoch).


El número de **milisegundos** desde el 1 de enero de 1970 a las 00:00 UTC (el
Unix epoch). El rango es -17,987,443,200,000 a 253,402,300,799,999,
aproximadamente años 1400&ndash;9999.


DateTime.UnixTimestampMillis

El número de **milisegundos** entre el 1 de enero de 1970 a las 00:00 UTC (el
Unix epoch).


Un tipo de dato que representa un momento en el tiempo.


/reference/engine/datatypes/DateTime.yaml

Luau

Dictionary

Un objeto que ejecuta funciones conectadas ante una ocurrencia específica.

Data Type

RBXScriptSignal

Un número de punto flotante de doble precisión.

number

Una secuencia de caracteres, como letras, números y símbolos.

string

Experiencias

Avatar

Recursos

Muestras y proyectos

API del motor

API de nube abierta

Studio

Análisis

Plataforma

Tutoriales

Programas de creador

Educación

Cursos

Aprender

Este método es asíncrono y devuelve una `Operación`, que representa el estado actual de la operación. Contiene una ruta final que puede sondear para obtener la respuesta real y los metadatos aplicables. Ve la [documentation]({longRunningOperationsLink}) en operaciones de larga duración para más información.
            
Las siguientes secciones describen la respuesta y los objetos metadatos que se proporcionan cuando una operación termina.

Los puntos finales beta están listos para uso público. Los cambios que los puedan estropear son posibles, pero poco frecuentes.

Estas páginas de documentación de Open Cloud se eliminarán el 31 de marzo de 2026. En ese momento, se te redirigirá automáticamente a la nueva documentación de Open Cloud. {linkStart}Más información{linkEnd}

Estas páginas antiguas de Open Cloud se eliminarán y se redirigirán el 31 de marzo de 2026. {linkStart}Más información{linkEnd}

Los puntos de conexión experimentales están listos para su uso público, pero pueden experimentar cambios importantes ocasionalmente a medida que se finaliza el contrato de la API.

Este punto de conexión se puede llamar en la experiencia a través de {httpServiceLinkStart}HttpService{httpServiceLinkEnd} con una clave API.

Este campo se puede establecer al crear un recurso, pero no se puede modificar por solicitudes posteriores.

Estos campos se pueden establecer al crear un recurso, pero no son modificables por solicitudes posteriores.

Este campo se puede proporcionar en las solicitudes, pero nunca se incluirá en las respuestas.

Método de autenticación heredado. Siempre que esté disponible, se recomienda usar la clave API u OAuth 2.0.

Por clave API: {maxInPeriod} solicitudes cada {periodInSeconds} segundos por dirección IP

No requiere autenticación para llamar. Por lo general, tiene límites de velocidad significativamente reducidos. Siempre es preferible usar la clave API u OAuth 2.0 cuando esté disponible.

Para cada agrupación, solo se debe proporcionar uno de los siguientes campos del esquema, el resto se puede excluir.

Puedes volver a participar en cualquier momento. {linkStart}Deja tus comentarios.{linkEnd}

Estás viendo los documentos anteriores. {linkStart}Deja tus comentarios.{linkEnd}

En cualquier momento puedes decidir no usarla y volver a las páginas de referencia anteriores. {linkStart}Agradecemos cualquier comentario que tengas.{linkEnd}

Estás viendo los documentos renovados. {linkStart}Deja tus comentarios.{linkEnd}

Este campo se puede configurar como respuestas, pero se ignorará en las solicitudes.

Nota: Los límites de frecuencia pueden ser más bajos durante los periodos de tráfico alto. Ciertos puntos finales tienen límites de frecuencia adicionales. [Más información sobre los límites de frecuencia]({link}).

{limit} solicitudes por minuto en todas las claves API para un usuario o grupo

{limit} solicitudes por segundo en todas las claves API para un usuario o grupo

{limit} solicitudes por minuto por propietario de la clave API

{limit} solicitudes por día por usuario de la aplicación

{limit} solicitudes por hora por usuario de la aplicación

{limit} solicitudes por minuto por usuario de la aplicación

{limit} solicitudes por segundo por usuario de la aplicación

{limit} solicitudes por segundo por propietario de la clave API

Los alcances controlan qué permisos tienen tus credenciales. Tus credenciales solo pueden acceder a los puntos finales que admitan los alcances que seleccionaste.

Los endpoints estables están listos para producción y casi nunca presentarán cambios que rompan la compatibilidad durante su vida útil.

Este objetivo le permite limitar el acceso de su clave a las {requiredParts} seleccionadas

Este objetivo te permite limitar el acceso de tu clave a las {requiredParts} y las {optionalParts} que elijas

Los tipos de destino se utilizan para restringir los recursos para los que tus credenciales tienen permisos. Solo se puede actuar sobre los recursos seleccionados, incluso si tu cuenta tiene permisos de recursos adicionales. Algunos alcances no tienen partes de destino. En estos casos, se puede actuar sobre todos los recursos relevantes.

No es necesario seleccionar la parte superior del nivel en el universo para las claves API propiedad del usuario. En este caso, tu clave API tendrá acceso a todas tus experiencias propiedad del usuario y a las experiencias propiedad del grupo para las que tengas los permisos de grupo correctos.

La función Prueba aún no es compatible con los puntos de conexión que requieren una clave API o autenticación OAuth 2.0.

La autenticación de cookies está desactivada para operaciones de alto riesgo por motivos de seguridad.

Los puntos finales de riesgo crítico son extremadamente sensibles y la función de Prueba está deshabilitada por motivos de seguridad.

Nota: Los encabezados de autenticación no se incluyen en este ejemplo de código. Es posible que tengas que agregar un encabezado de autenticación para que este comando funcione.

Este es un punto final de alto riesgo que puede modificar o eliminar datos críticos. Ten mucho cuidado al realizar pruebas.

Este punto final de la API se ha clasificado como de ALTO RIESGO y puede afectar a los datos en vivo o a las cuentas de usuario.

Las solicitudes autenticadas a API de alto riesgo pueden realizar cambios que no se pueden deshacer. Revisa cuidadosamente los parámetros de tu solicitud antes de continuar.

Inicia sesión para usar la autenticación de cookies

Este es un punto final de bajo riesgo que recupera datos. Por lo general, es seguro probarlo.

Este es un punto final de riesgo medio que modifica datos. Pruébalo cuidadosamente con cuentas no críticas, ya que los cambios pueden ser permanentes.

Para mantener tu cuenta segura, nunca pegues aquí texto de otras fuentes ni envíes información de esta página a otras personas.

Está a punto de probar los puntos finales de la API en vivo utilizando las credenciales de tu cuenta actual.

Continúa solo si comprendes las implicaciones de las llamadas API que estás a punto de realizar. Revisa la documentación de la API cuidadosamente antes de realizar la prueba.

Las llamadas de API se realizarán utilizando tu sesión autenticada

Estas son llamadas API reales que pueden afectar tu cuenta o tus datos

Se aplican límites de velocidad y otras restricciones de API

Es posible que algunas operaciones modifiquen o eliminen datos

Este punto de conexión se reemplazó por estos puntos de conexión alternativos recomendados:

Se requieren los siguientes alcances para llamar a este punto final. Para obtener más
información sobre cómo generar claves adecuadas, consulta [Administrar claves API]({apiKeyReferenceDocLink}).

Para obtener más información sobre cómo generar claves, consulta [Administrar claves API]({apiKeyReferenceDocLink}).

Los siguientes extremos están disponibles en rutas relativas a la URL base.

Esta cadena está formateada como [Timestamp](/cloud/reference/types#timestamp).

Un valor JSON puede ser `null`, `boolean`, `string`, `number`, `array`, u `object`.

Los siguientes ámbitos son necesarios para que tu aplicación OAuth 2.0 use este extremo. Para obtener más información sobre cómo registrar una aplicación de OAuth 2.0, consulta [Registro y revisión de aplicaciones]({oauth2ReferenceDocLink}).

Para obtener más información sobre cómo registrar una aplicación OAuth 2.0, consulta [Registro y revisión de aplicaciones]({oauth2ReferenceDocLink}).

Los siguientes objetos describen cargas que son aceptadas o devueltas. Ve cada extremo para más información sobre cuándo se utilizan estos objetos.

Se requieren los siguientes alcances para llamar a este punto final.

Rutas de recursos

No recomendado

Estás viendo la referencia renovada de Open Cloud.

Decidiste no usar la nueva referencia de Open Cloud.

Consulta tus cuentas de facturación de anuncios.

Consulta tus campañas de anuncios y su ejecución.

Crea, actualiza y gestiona tus campañas de anuncios.

Esto permite ver información sobre tus recursos.

Esto permite cargar y actualizar recursos a Roblox.

Esto permite ver los permisos de recursos para temas (incluidos grupos y experiencias) y recursos a los que tu cuenta tiene acceso.

Esto permite conceder permisos de recurso a cualquier elemento (incluyendo grupos y experiencias) y recursos a los que tu cuenta tiene acceso.

Esto te permite ver el estado y los resultados de los trabajos de configuración automática de avatares en tu nombre.

Esto te permite crear y administrar trabajos de configuración automática de avatares en tu nombre.

Permite actualizar las insignias de propiedad del usuario.

Esto permite ver información sobre tus objetos de comercio.

Esto te permite realizar cambios en tus objetos comerciales sincronizados.

Esto te permite ver información sobre tus conexiones comerciales.

Esto te permite editar tus conexiones de comerciantes.

Esto te permite ver información sobre tus productos de la Tienda de creadores.

Esto te permite modificar la información sobre tus productos de la Tienda de creadores.

Esto te permite ver información sobre los elementos guardados de tu Tienda de creadores.

Esto te permite modificar la información sobre los elementos guardados de tu Tienda de creadores.

Permite acceder para crear almacenes de datos en tu nombre.

Permite acceder para eliminar almacenes de datos en tu nombre.

Permite acceder a la lectura de una lista de almacenes de datos.

Permite acceder para tomar una instantánea de tus almacenes de datos.

Permite acceder para crear entradas en tus almacenes de datos.

Permite acceder para marcar las entradas especificadas para su eliminación.

Permite enumerar las entradas de tu almacén de datos.

Permite acceder a la lectura de entradas especificadas en tus almacenes de datos.

Permite actualizar el valor, los atributos y los usuarios de una entrada.

Permite acceder para eliminar las revisiones de las entradas de tu almacén de datos.

Permite enumerar las revisiones de las entradas de tu almacén de datos.

Permite leer las revisiones de las entradas de tu almacén de datos.

Permite ver los detalles de configuración de los productos de desarrollador del usuario autorizado.

Permite editar los productos de desarrollador del usuario autorizado.

Esto permite ver información sobre tus entornos de universo.

Esto permite editar tus entornos de universo.

Permite ver los detalles de configuración de los pases de juego del usuario autorizado.

Permite editar los pases de juego del usuario autorizado.

Da acceso para ver la información de los foros de la comunidad de tu cuenta.

Da acceso para gestionar la información de los foros de la comunidad de tu cuenta.

Esto permite ver información sobre tus comunidades.

Esto te permite gestionar las solicitudes de unión a la comunidad y las actualizaciones de roles de los miembros de rango inferior para tu cuenta.

Te permite ver los datos de propiedad de una instancia.

Te permite modificar los datos de propiedad de las instancias (actualmente solo admite Scripts).

Esto permite ver información sobre tu inventario.

Da acceso para administrar los recursos del usuario.

Da acceso para administrar tus insignias.

Da acceso para gestionar tus insignias y gastar Robux.

Permite actualizar las insignias del usuario autorizado.

Da acceso para administrar tus productos de desarrollador.

Permite leer información sobre las experiencias en las que tienes notificaciones.

Permite activar o desactivar las notificaciones de experiencias en tu nombre.

Da acceso para gestionar tus comunidades.

Otorga permiso para leer información de la comunidad.

Otorga permisos de gestión de la comunidad.

Da acceso para leer y escribir tus tablas de localización

Da acceso para gestionar la colaboración en equipo para todas las experiencias de tu propiedad.

Da acceso para gestionar tus experiencias y cierta información asociada a tus experiencias (por ejemplo, información de localización).

Da acceso para leer la información de localización de tus experiencias.

Da acceso para modificar las preferencias de localización de las experiencias.

Da acceso para gestionar tu cuenta de usuario.

Da acceso para modificar las preferencias de localización de usuario.

Te permite ver el estado, los registros y los resultados de las tareas de ejecución de Luau para el lugar asociado.

Te permite crear nuevas tareas de ejecución de Luau para el lugar asociado.

Permite vaciar de forma asincrónica todas las estructuras de datos del universo.

Permite crear nuevos elementos de la cola.

Permite descartar los elementos leídos desde el frente de la cola.

Permite leer los elementos al frente de la cola.

Permite leer los elementos de tu almacén de memoria.

Permite crear, actualizar y eliminar elementos del mapa.

Esta acción permite publicar mensajes en nombre de los usuarios.

Esto permite enviar notificaciones de tu experiencia a los usuarios.

(Obsoleto) Permite acceder a la lectura de una lista de entradas en un almacén de datos ordenado.

(Obsoleto) Permite acceder para crear una nueva entrada en un almacén de datos ordenado.

Permite acceder a las entradas de lista de un almacén de datos ordenado.

Permite crear entradas en un almacén de datos ordenado.

Esto permite enumerar los secretos asociados a tu experiencia.

Esto permite crear y actualizar secretos asociados a tu experiencia.

Este permiso te permite enviar un trabajo de evaluación y ver su resultado.

Da acceso para leer los productos de tu suscripción.

Esto te permite leer la información de las miniaturas en tu nombre.

Permite consultar los análisis del juego.

Permite leer información sobre el lugar.

Permite editar información sobre el lugar.

Permite publicar nuevas versiones de experiencias en Roblox.

Permite leer información sobre la experiencia.

Permite editar las experiencias del usuario autorizado.

Te permite ver las restricciones de usuario en la experiencia.

Te permite editar las restricciones de usuario en la experiencia.

Esto permite ver las notificaciones enviadas a tu cuenta.

Permite consultar el estado Premium y verificado del usuario autorizado.

Esto te permite ver las cuentas de redes sociales del usuario autorizado.

Activa la funcionalidad de inicio de sesión único.

Permite leer la información de tu perfil.