Returns how many seconds have passed since the Unix epoch (1 January 1970,
00:00:00), under current UTC time. If provided a table formatted similarly
to that returned by `Library.os.date()`, it will return the number of
seconds since that time instead.

```lua
print(os.time())  --> 1586982482 (ran at approx. April 15th, 2020 at 1:28 PM PST)
print(os.time{
    year=2020, month=4, day=15,  -- Date components
    hour=16, min=28, sec=0  -- Time components
})  --> 1586968080
```


os.time

time

A dictionary table describing a specific time, similar to that
returned by `Library.os.date()`. If not provided, uses the current UTC
time.


Returns how many seconds have passed since the Unix epoch (1 January 1970,
00:00:00) under current UTC time.


Returns the number of seconds from t1 to t2. The difference is computed
assuming that t1 and t2 are correctly casted to the
[time_t](http://en.cppreference.com/w/cpp/chrono/c/time_t) format.


os.difftime

Returns the number of seconds from t1 to t2, assuming the arguments are
correctly casted to the time_t format.


Formats the given `formatString` with date/time information based on the
given time, or if not provided, the value returned by `Library.os.time()`.
The following specifiers (based on the C function strftime) are supported:

<table>
  <thead>
    <tr>
      <th>Specifier</th>
      <th>Meaning</th>
      <th>Example<sup>&dagger;</sup></th>
     </tr>
  </thead>
<tbody>
<tr>
  <td>%a</td>
  <td>Abbreviated weekday name *</td>
  <td>Mon</td>
</tr>
<tr>
  <td>%A</td>
  <td>Full weekday name *</td>
  <td>Monday</td>
</tr>
<tr>
  <td>%b</td>
  <td>Abbreviated month name *</td>
  <td>Feb</td>
</tr>
<tr>
  <td>%B</td>
  <td>Full month name *</td>
  <td>February</td>
</tr>
<tr>
  <td>%c</td>
  <td>Date and time *</td>
  <td>Mon Feb 12 14:14:35 2024</td>
</tr>
<tr>
  <td>%d</td>
  <td>Day of the month</td>
  <td>12</td>
</tr>
<tr>
  <td>%H</td>
  <td>Hour, using 24-hour clock</td>
  <td>14</td>
</tr>
<tr>
  <td>%I</td>
  <td>Hour, using 12-hour clock</td>
  <td>02</td>
</tr>
<tr>
  <td>%j</td>
  <td>Day of year</td>
  <td>043</td>
</tr>
<tr>
  <td>%m</td>
  <td>Month</td>
  <td>02</td>
</tr>
<tr>
  <td>%M</td>
  <td>Minute</td>
  <td>14</td>
</tr>
<tr>
  <td>%p</td>
  <td>Either "AM" or "PM"</td>
  <td>PM</td>
</tr>
<tr>
  <td>%S</td>
  <td>Second</td>
  <td>35</td>
</tr>
<tr>
  <td>%U</td>
  <td>Week number (first Sunday as the first day of week one)</td>
  <td>06</td>
</tr>
<tr>
  <td>%w</td>
  <td>Weekday</td>
  <td>1</td>
</tr>
<tr>
  <td>%W</td>
  <td>Week number (first Monday as the first day of week one)</td>
  <td>07</td>
</tr>
<tr>
  <td>%x</td>
  <td>Date *</td>
  <td>02/12/24</td>
</tr>
<tr>
  <td>%X</td>
  <td>Time *</td>
  <td>14:14:35</td>
</tr>
<tr>
  <td>%y</td>
  <td>Two-digit year</td>
  <td>24</td>
</tr>
<tr>
  <td>%Y</td>
  <td>Full year</td>
  <td>2024</td>
</tr>
<tr>
  <td>%z</td>
  <td>ISO 8601 offset from UTC in timezone (1 minute = 1, 1 hour = 100)</td>
  <td>-0800</td>
</tr>
<tr>
  <td>%Z</td>
  <td>Timezone name or abbreviation *</td>
  <td>PST</td>
</tr>
<tr>
  <td>%%</td>
  <td>The % character</td>
  <td>%</td>
</tr>
</tbody>
</table>

\* This value can vary depending on the current locale.

&dagger; The example provided is for February 12th, 2024 (Monday) at
2:14:35 PM (14:14:35), run using locale "en-us" in Pacific Standard Time
(PST).

If the provided `formatString` is exactly `"*t"` (local time) or `"!*t"`
(UTC time), this function instead returns a dictionary containing the
following components, which are normally available in the specifiers
above.

<table>
  <thead>
    <tr>
      <th>Field</th>
      <th>Type</th>
      <th>Description</th>
    </tr>
  </thead>
<tbody>
  <tr>
    <td>year</td>
    <td>int</td>
    <td>An integer that describes the current year of the Current Era (ex. 2017)</td>
  </tr>
  <tr>
    <td>month</td>
    <td>int</td>
    <td>An integer between 1 and 12 (starting from January) that describes the current month.</td>
  </tr>
  <tr>
    <td>wday</td>
    <td>int</td>
    <td>An integer between 1 and 7 (starting from Sunday) that describes the current week day.</td>
  </tr>
  <tr>
    <td>yday</td>
    <td>int</td>
    <td>An integer between 1 and 366 describing how many days we are into the year.<br />There can be 366 days if it is a leap year.</td>
  </tr>
  <tr>
    <td>day</td>
    <td>int</td>
    <td>An integer between 1 and 31 describing the current day of the month.</td>
  </tr>
  <tr>
    <td>hour</td>
    <td>int</td>
    <td>An integer between 1 and 24 describing the current hour of the day.</td>
  </tr>
  <tr>
    <td>min</td>
    <td>int</td>
    <td>An integer between 0 and 59 describing the current minute of the hour.</td>
  </tr>
  <tr>
    <td>sec</td>
    <td>int</td>
    <td>An integer between 0 and 60 describing the current second of the hour.<br />(60 because the function is described to indicate leap seconds, but in practice it probably doesn't).</td>
  </tr>
  <tr>
    <td>isdst</td>
    <td>bool</td>
    <td>A boolean describing if daylight savings time is currently active.</td>
  </tr>
</tbody>
</table>


os.date

formatString

Formats the given string with date/time information based on the given
time (or if not provided, the value returned by os.time).


Returns the amount of CPU time used by Lua in seconds. This value has high
precision, about 1 microsecond, and is intended for use in benchmarking.

```lua
-- Record the initial time:
local startTime = os.clock()
-- Do something you want to measure the performance of:
local a, b = 0, 1
for i = 1, 5000000 do
    a, b = b, a
end
-- Measure amount of time this took:
local deltaTime = os.clock() - startTime
print("Elapsed time: " .. deltaTime)
-->  Elapsed time: 0.044425600033719 (actual number may vary)
```


os.clock

Returns a high-precision amount of CPU time used by Lua in seconds,
intended for use in benchmarking.


This library provides functions related to time and date.


Luau

Dictionary

An object that runs connected functions upon a specific occurrence.

Data Type

RBXScriptSignal

A double-precision floating-point number.

number

A sequence of characters, such as letters, numbers, and symbols.

string

Data type which can store multiple values of any non-nil type, including booleans, numbers, strings, functions, and other tables.

table

Vista general

Guías

Tutoriales

Referencia

Recursos

Arte

Diseño

Motor

Avatar

Nube

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

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

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

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

Se requieren los siguientes permisos de clave API para llamar a este extremo. Para obtener más información sobre cómo generar claves adecuadas, consulta [Gestionar 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}).

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.

Esto permite ver información sobre tus recursos.

Esto permite cargar y actualizar recursos a Roblox.

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 permite ver información sobre tus grupos.

Esto te permite gestionar las solicitudes de unión a grupo para tu cuenta.

Esto permite ver información sobre tu inventario.

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

Esto permite enviar notificaciones de tu experiencia a los usuarios

Esto permite enumerar los secretos asociados a tu experiencia.

Esto permite crear y actualizar secretos asociados a tu experiencia.

Permite leer información sobre el lugar.

Permite editar información sobre el lugar.

Esta operación permite el acceso a la publicación de nuevas versiones de experiencias en Roblox.

Permite leer información sobre la experiencia.

Permite editar información sobre la experiencia.

Te permite ver las restricciones de usuario en la experiencia.

Te permite editar las restricciones de usuario en la experiencia.

Permite leer el estado Premium y verificado del usuario.

Esto te permite ver las cuentas sociales de un usuario.

Activa la funcionalidad de inicio de sesión único

Da acceso a leer la información de tu perfil

Valor predeterminado: {defaultValueStart}{defaultValueEnd}

Una matriz es una lista ordenada de valores. Las matrices son útiles para almacenar colecciones de datos.

Un conjunto de pares clave-valor, donde las claves pueden ser cualquier número, cadena u objeto.

Esta función devuelve inmediatamente si es posible, pero puede producir el hilo que la llamó hasta que devuelva un valor.

Roblox ya no soporta o mantiene {nameStart}nombre{nameEnd}

Esta operación matemática ya no es soportada o mantenida por Roblox.

Este miembro no aparece en el navegador de objetos y no está destinado a un uso generalizado.

Solo se puede acceder a este miembro a través de la barra de comandos y de los plugins. Se producirá un error si se intenta acceder a través de los scripts.

Esta función no puede pausar el hilo de Lua que la llamó.

Se producirá un error al intentar acceder a este miembro a través de los scripts. Es posible acceder a él desde la ventana de propiedades de Roblox Studio.

Este miembro no aparece en el navegador de objetos de Roblox Studio.

No se puede crear una instancia de esta clase con el constructor Instance.new.

Roblox no replica este miembro a través de su límite entre servidor y cliente.

El código Lua no puede acceder a este miembro. Puedes cambiar su valor desde la ventana de propiedades en Roblox Studio.

El comportamiento de replicación de este objeto depende del jugador que lo posee.

Esta propiedad es de solo lectura y es segura para leer en hilos no sincronizados. Escribir en ella producirá un error.

Esta propiedad es de solo lectura y es seguro leerla en hilos no sincronizados. Se producirá un error al intentar escribir en ella.

Este miembro es de solo lectura. Se producirá un error al intentar escribir a este miembro.

Se puede acceder a este miembro solo en CoreScripts.

Solo Roblox CoreScripts puede acceder a este miembro y no se puede utilizar por los Jugadores.

Puedes leer y escribir en esta propiedad de forma segura desde múltiples hilos.

Esta clase es un singleton de nivel superior. Recupera una instancia de esta clase con la función GetService.

Múltiples hilos pueden escribir en esta propiedad, por lo que no es seguro leerla desde hilos no sincronizados.

Esta función pausa el hilo Lua que la llamó hasta que devuelva un resultado. Esta acción no interrumpe otros scripts.

Aprende cómo crear contenidos exitosos en Roblox con guías integrales, muestras de código, referencias y tutoriales.


{pageTitle} | {SiteName}

título

No se puede añadir al inventario

La muestra de código {title} se añadió a tu inventario.

La versión {versionNumber} incluye mejoras generales de rendimiento y correcciones de errores. Revisa nuestras otras notas de publicación para ver el estado de las mejoras y errores específicos.

No incluyas información personal o privada. Máximo de {maxDescriptionLength} palabras.

Se requiere un mínimo de {minDescriptionLength} palabras en la descripción.

Notas de lanzamiento para Roblox Studio versión {versionNumber}

Estamos trabajando en cosas aún más increíbles. Gracias por tu paciencia.

Al hacer clic en Continuar, se te dirigirá a {redirectLinkStart}{redirectLinkEnd}

Este sitio no es propiedad de Roblox, ni está gestionado por Roblox. Pueden tener diferentes términos y políticas de privacidad.

os

Resumen

Funciones

Funciones

time

Parámetros

Devuelve

difftime

Parámetros

Devuelve

date

Parámetros

Devuelve

clock

Devuelve