Pular para o conteúdo principal

Converter texto de data/hora formatado em um carimbo de data/hora (utils.date_from_format)

Declaração

timestamp = utils.date_from_format(format, date[, options])

Parâmetros

  • format
    Texto: formato de data/hora
  • date
    Texto: string de data/hora
  • options
    Tabela: tabela de opções
    {
    tz = "GMT"; -- opção de fuso horário, opcional; o padrão é o fuso do sistema. Consulte a lista em https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
    locale = "en-US"; -- opção de localização, opcional; o padrão é a configuração regional atual do dispositivo
    }

Valor de retorno

  • timestamp
    Número: carimbo de data/hora

Descrição

Esta função está disponível somente a partir da versão 20250220.

Referência de formato

Unicode Date Field Symbol Table

CategoriaPlaceholderExemplo de saídaDescrição
Ano (Year)yyyy2024Ano com 4 dígitos
yy24Ano com 2 dígitos
Mês (Month)MMMMJulyNome completo do mês
MMMJulAbreviação do mês
MM07Mês com 2 dígitos (01-12)
M7Mês com 1 ou 2 dígitos
Dia (Day)dd06Dia com 2 dígitos (01-31)
d6Dia com 1 ou 2 dígitos
Dia da semana (Day of Week)EEEESaturdayNome completo do dia da semana
E, EE, EEESatAbreviação do dia da semana
e, ee7Número localizado do dia da semana (domingo=1, sábado=7)
Hora (Hour)HH15Hora com 2 dígitos no formato de 24 horas (00-23)
H15Hora com 1 ou 2 dígitos no formato de 24 horas
hh03Hora com 2 dígitos no formato de 12 horas (01-12)
h3Hora com 1 ou 2 dígitos no formato de 12 horas
aPMIndicador de manhã/tarde (AM/PM)
Minuto (Minute)mm05Minuto com 2 dígitos (00-59)
m5Minuto com 1 ou 2 dígitos
Segundo (Second)ss09Segundo com 2 dígitos (00-59)
S.1 .12 .123Milissegundos; a quantidade de S determina o número de casas decimais.
Fuso horário (Time Zone)zzzzPacific Daylight TimeNome completo do fuso horário
zzz, zPDTAbreviação do fuso horário
ZZZZZ-07:00Deslocamento de fuso no formato ISO 8601, com dois-pontos
Z, ZZ, ZZZ-0700Deslocamento de fuso no formato RFC 822

Exemplo

nLog(utils.date_from_format("EEE, dd MMM yyyy HH:mm:ss ZZZZ", "Mon, 09 Jun 2025 17:40:00 GMT", {tz = "GMT"; locale = 'en-US'})) -- saída: 1749490800.0