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

Visão geral

Guias

Tutoriais

Referência

Recursos

Arte

Design

Motor

Avatar

Nuvem

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

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

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

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

As seguintes permissões de chave API são requeridas para chamar este endpoint. Para mais informações sobre gerar chaves apropriadas, veja [Gerenciando chaves 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 sua aplicação OAuth 2.0 use este endpoint. Para obter mais informações sobre como registrar um aplicativo OAuth 2.0, consulte [Registro do aplicativo e revisão]({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.

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}).

Isto permite visualizar informações sobre seus ativos.

Isto permite enviar e atualizar ativos para a Roblox.

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ê gerencie solicitações de adesão de grupos para sua conta.

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

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

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

Isto permite listar segredos aliados à sua experiência.

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

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

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

Esta operação permite acesso para publicar novas versões de experiências para a Roblox.

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

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

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

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

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

Isso permite que você veja as contas sociais de um usuário.

Isto habilita a funcionalidade de logon único

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

Valor padrão: {defaultValueStart}{defaultValueEnd}

Um array é uma lista ordenada de valores. Arrays são úteis para armazenar coleções de dados.

Um conjunto de pares chave-valor, onde as chaves podem ser qualquer número, string ou objeto.

Essa função retorna imediatamente, se possível, mas pode gerar a sequência que a chamou até que possa retornar um valor.

{nameStart}nome{nameEnd} não é mais suportado ou mantido pela Roblox.

Essa operação matemática não é mais suportada ou mantida pela Roblox.

Este membro não aparece no navegador de objetos e não é para uso geral.

Este membro só é acessível somente através da barra de comandos. Tentar acessar este membro a partir de scripts causa um erro.

Esta função não pode pausar o tópico Lua que a chamou.

Tentar acessar este membro em scripts causa um erro. Você pode ser capaz de acessar este membro na janela de propriedades do Roblox Studio.

Este membro não aparece no Navegador de Objetos do Roblox Studio.

Não é possível criar uma instância desta classe com o construtor Instance.new.

A Roblox não replica este membro além do limite do seu servidor-cliente.

O código Lua não pode acessar este membro. Você pode ser capaz de alterar o valor dele na janela de propriedades do Roblox Studio.

O comportamento de replicação do objeto depende do jogador que o possui.

Este membro é acessível somente através da barra de comandos e plugins. Tentar acessar este membro a partir de scripts causa um erro.

Esta propriedade é somente leitura e é segura para ler em tópicos não sincronizados. Tentar escrever nela causa um erro.

Esta propriedade é somente leitura e é segura para ler em threads não sincronizadas. Tentar escrever nela causa um erro.

Este membro é somente leitura. Tentar escrever para este membro causa um erro.

Este membro é acessível somente no CoreScripts.

Somente o Roblox CoreScripts pode acessar este membro e ele não é utilizável por jogadores.

Você pode ler e escrever para esta propriedade com segurança a partir de várias threads.

Esta classe é uma singleton de alto nível. Recupere uma instância desta classe com a função GetService.

Várias threads podem potencialmente escrever para esta propriedade, então não é seguro ler a partir de threads não sincronizadas.

Você pode ler e escrever para esta propriedade com segurança a partir de vários tópicos.

Esta função pausa a thread Lua que a chamou até que ela retorne um resultado. Isto não interrompe outros scripts.

Aprenda a criar conteúdo bem-sucedido no Roblox com guias abrangentes, amostras de código, referência e tutoriais.


{pageTitle} | {SiteName}

título

Não é possível adicionar ao inventário

A amostra de código {title} foi adicionada ao seu inventário.

A versão {versionNumber} inclui melhorias gerais de desempenho e correções de bugs. Confira as nossas outras notas de lançamento sobre melhorias específicas e erros.

Não inclua informações privadas ou pessoais. No máximo {maxDescriptionLength} palavras.

Mínimo de {minDescriptionLength} palavras necessárias na descrição.

Notas de Lançamento para o Roblox Studio versão {versionNumber}

Estamos tornando as coisas ainda mais incríveis. Agradecemos sua paciência.

Clicando em "Continuar", você será direcionado(a) para {redirectLinkStart}{redirectLinkEnd}

Este site não pertence ou é operado pela Roblox. Ele pode ter diferentes termos e políticas de privacidade.

os

Resumo

Funções

Funções

time

Parâmetros

Devolução

difftime

Parâmetros

Devolução

date

Parâmetros

Devolução

clock

Devolução