os

Retorna o tempo decorrido em segundos desde uma base arbitrária com precisão de submicrossegundos.Essa função é útil para comparar durações entre dois eventos que ocorrem no mesmo computador e é a melhor opção para benchmarking.

Ao contrário de funções como os.time() ou DateTime.now(), ajustes ao relógio do sistema (como pelo usuário ou NTP) não causam o salto do tempo para frente ou para trás.

-- Grave o tempo inicial:
local startTime = os.clock()
-- Faça algo que você queira medir o desempenho de:
local a, b = 0, 1
for _ = 1, 5000000 do
    a, b = b, a
end
-- Mediça a quantidade de tempo que isso levou:
local deltaTime = os.clock() - startTime
print("Elapsed time: " .. deltaTime)
-->  Elapsed time: 0.044425600033719 (actual number may vary)

Formata o dado formatString com informações de data/hora com base no tempo fornecido, ou se não for fornecido, o valor retornado por os.time().

Essa função deve ser evitada em novo trabalho. Em vez disso, use a API (Interface de Programação para Aplicações)DateTime, que suporta formatação localizada.

Os seguintes especificadores (baseados na função strftime do C) são suportados:

<th>Significado</th>

    <th>Exemplo <sup>†</sup></th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>%a</td>

    <td>Nome de dia da semana abreviado *</td>

    <td>Seg</td>
  </tr>

  <tr>
    <td>%A</td>

    <td>Nome completo de dia útil *</td>

    <td>Segunda-feira</td>
  </tr>

  <tr>
    <td>%b</td>

    <td>Nome do mês abreviado *</td>

    <td>Fev</td>
  </tr>

  <tr>
    <td>%B</td>

    <td>Nome completo do mês *</td>

    <td>Fevereiro</td>
  </tr>

  <tr>
    <td>%c</td>

    <td>Data e hora*</td>

    <td>Seg 12 Fev 14:14:35 2024</td>
  </tr>

  <tr>
    <td>%d</td>

    <td>Dia do mês</td>

    <td>12</td>
  </tr>

  <tr>
    <td>%H</td>

    <td>Hora, usando o relógio de 24 horas</td>

    <td>14</td>
  </tr>

  <tr>
    <td>%I</td>

    <td>Hora, usando o relógio de 12 horas</td>

    <td>02</td>
  </tr>

  <tr>
    <td>%j</td>

    <td>Dia do ano</td>

    <td>043</td>
  </tr>

  <tr>
    <td>%m</td>

    <td>Mês</td>

    <td>02</td>
  </tr>

  <tr>
    <td>%M</td>

    <td>Minutos</td>

    <td>14</td>
  </tr>

  <tr>
    <td>%p</td>

    <td>Ou "AM" ou "PM"</td>

    <td>PM</td>
  </tr>

  <tr>
    <td>%S</td>

    <td>Segunda</td>

    <td>35</td>
  </tr>

  <tr>
    <td>%U</td>

    <td>Número da semana (primeiro domingo como o primeiro dia da semana um)</td>

    <td>06</td>
  </tr>

  <tr>
    <td>%w</td>

    <td>Dia da semana</td>

    <td>1</td>
  </tr>

  <tr>
    <td>%W</td>

    <td>Número da semana (primeiro segunda-feira como o primeiro dia da semana um)</td>

    <td>07</td>
  </tr>

  <tr>
    <td>%x</td>

    <td>Data *</td>

    <td>02/12/24</td>
  </tr>

  <tr>
    <td>%X</td>

    <td>Tempo *</td>

    <td>14:14:35</td>
  </tr>

  <tr>
    <td>%y</td>

    <td>Ano de dois dígitos</td>

    <td>24</td>
  </tr>

  <tr>
    <td>%Y</td>

    <td>Ano inteiro</td>

    <td>2024</td>
  </tr>

  <tr>
    <td>%z</td>

    <td>Deslocamento da ISO 8601 em UTC na zona de tempo (1 minuto = 1, 1 hora = 100)</td>

    <td>-0800</td>
  </tr>

  <tr>
    <td>%Z</td>

    <td>Nome ou abreviação da zona de tempo *</td>

    <td>Tempo de PST</td>
  </tr>

  <tr>
    <td>%%</td>

    <td>O personagem %</td>

    <td>%</td>
  </tr>
</tbody>

:* Esse valor pode variar dependendo do idioma atual.

† O exemplo fornecido é para 12 de fevereiro de 2024 (segunda-feira) às 2:14:35 PM (14:14:35), executado usando o idioma "en-us" no Tempo Padrão do Pacífico (PST).

Se o fornecido formatString for exatamente "*t" (hora local) ou "!*t" (hora UTC), esta função retorna, em vez disso, um dicionário que contém os seguintes componentes, que normalmente estão disponíveis nos especificadores acima.

<th>Tipo</th>

    <th>Descrição</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>ano</td>

    <td>inteiro</td>

    <td>Um inteiro que descreve o ano atual da Era Atual (ex. 2017)</td>
  </tr>

  <tr>
    <td>mês</td>

    <td>inteiro</td>

    <td>Um inteiro entre 1 e 12 (começando em janeiro) que descreve o mês atual.</td>
  </tr>

  <tr>
    <td>dia da semana</td>

    <td>inteiro</td>

    <td>Um inteiro entre 1 e 7 (começando a partir de domingo) que descreve o dia da semana atual.</td>
  </tr>

  <tr>
    <td>dia de hoje</td>

    <td>inteiro</td>

    <td>Um inteiro entre 1 e 366 que descreve quantos dias estamos no ano.Pode haver 366 dias se for um ano bissexto.</td>
  </tr>

  <tr>
    <td>dia</td>

    <td>inteiro</td>

    <td>Um inteiro entre 1 e 31 que descreve o dia atual do mês.</td>
  </tr>

  <tr>
    <td>hora</td>

    <td>inteiro</td>

    <td>Um inteiro entre 1 e 24 que descreve a hora atual do dia.</td>
  </tr>

  <tr>
    <td>mínimo</td>

    <td>inteiro</td>

    <td>Um inteiro entre 0 e 59 que descreve o minuto atual da hora.</td>
  </tr>

  <tr>
    <td>seg</td>

    <td>inteiro</td>

    <td>Um inteiro entre 0 e 60 que descreve o segundo atual da hora.(60 porque a função é descrita para indicar segundos de salto, mas na prática provavelmente não).</td>
  </tr>

  <tr>
    <td>isdst</td>

    <td>bool</td>

    <td>Um booleano que descreve se o tempo de economia de energia do dia está atualmente ativo.</td>
  </tr>
</tbody>

Retorna o número de segundos de t1 a t2.A diferença é calculada assumindo que t1 e t2 sejam corretamente convertidos para o formato time_t.

Retorna quantos segundos passaram desde a era do Unix (1 de janeiro de 1970, 00:00:00), sob o tempo UTC atual.Se fornecido um formulário de tabela formatado de forma semelhante ao retornado por os.date(), ele retornará o número de segundos desde aquele momento, em vez disso.

Observe que o tempo retornado usa o relógio local do dispositivo.A maioria dos sistemas operacionais sincroniza automaticamente seu tempo local contra servidores de tempo online, então isso deve estar dentro de alguns centenares de milisegundos.No entanto, os usuários podem facilmente desativar o comportamento de sincronização e definir o tempo do sistema para qualquer coisa que desejem; para o tempo sincronizado entre cliente e servidor, use Workspace:GetServerTimeNow() em vez disso.

Essa função deve ser evitada em novo trabalho. Em vez disso, use a API (Interface de Programação para Aplicações)DateTime, que suporta formatação localizada.

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