Funções de tempo - Edge Security Acceleration: Central de Documentação do Alibaba Cloud

O EdgeScript oferece as seguintes funções de tempo para uso no CDN EdgeScript.

Função	Descrição
today()	Retorna a data atual como string (`yyyy-mm-dd`)
time()	Retorna o timestamp UNIX atual em segundos inteiros
now()	Retorna o timestamp UNIX atual com precisão de milissegundos
localtime()	Retorna a data e hora locais atuais como string (`yyyy-mm-dd hh:mm:ss`)
utctime()	Retorna a data e hora UTC atuais como string (`yyyy-mm-dd hh:mm:ss`)
cookie_time(sec)	Converte um timestamp UNIX em uma string de horário GMT no formato de cookie
http_time(sec)	Converte um timestamp UNIX em uma string de horário GMT no formato de cabeçalho HTTP
parse_http_time(str)	Analisa uma string de horário no formato HTTP e retorna o timestamp UNIX correspondente
unixtime(year, month, day, hour, min, sec)	Converte uma data e hora em um timestamp UNIX

today

Campo	Detalhe
Sintaxe	`today()`
Descrição	Retorna a data atual (hora local) no formato `yyyy-mm-dd`.
Parâmetros	Nenhum
Valor de retorno	String: data local atual no formato `yyyy-mm-dd`

Exemplo

say(concat('today:', today()))
# Output: today:2019-05-23

time

Campo	Detalhe
Sintaxe	`time()`
Descrição	Retorna o timestamp UNIX atual como um inteiro de segundos completos. Use `now()` caso precise de precisão de milissegundos.
Parâmetros	Nenhum
Valor de retorno	Inteiro: timestamp UNIX atual em segundos

Nota

O timestamp UNIX representa o número de segundos decorridos desde 00:00:00 UTC de 1º de janeiro de 1970 (época Unix). Esse valor é independente de fusos horários.

Exemplo

say(concat('time:', time()))
# Output: time:1559109666

now

Campo	Detalhe
Sintaxe	`now()`
Descrição	Obtém o timestamp UNIX atual, sem a parte fracionária dos milissegundos. Unidade: segundos.
Parâmetros	Nenhum
Valor de retorno	Timestamp UNIX atual, sem a parte fracionária dos milissegundos. Unidade: segundos.

Nota

O timestamp UNIX representa o número de segundos decorridos desde 00:00:00 UTC de 1º de janeiro de 1970 (época Unix). Esse valor é independente de fusos horários.

Exemplo

say(concat('now:', now()))
# Output: now:1559109666.644

localtime

Campo	Detalhe
Sintaxe	`localtime()`
Descrição	Retorna a data e hora locais atuais no formato `yyyy-mm-dd hh:mm:ss`.
Parâmetros	Nenhum
Valor de retorno	String: data e hora locais atuais no formato `yyyy-mm-dd hh:mm:ss`

Exemplo

say(concat('localtime:', localtime()))
# Output: localtime:2019-05-29 14:02:41

utctime

Campo	Detalhe
Sintaxe	`utctime()`
Descrição	Retorna a data e hora UTC atuais no formato `yyyy-mm-dd hh:mm:ss`.
Parâmetros	Nenhum
Valor de retorno	String: data e hora UTC atuais no formato `yyyy-mm-dd hh:mm:ss`

Exemplo

say(concat('utctime:', utctime()))
# Output: utctime:2019-05-29 06:02:41

cookie_time

Campo	Detalhe
Sintaxe	`cookie_time(sec)`
Descrição	Converte um timestamp UNIX em uma string de horário GMT no formato de cookie.
Parâmetros	`sec`: timestamp UNIX (inteiro). Chame `time()` para obter o timestamp atual.
Valor de retorno	String: horário GMT no formato de cookie: `Wed, 29-May-19 06:02:41 GMT`

Exemplo

say(concat('cookie_time:', cookie_time(time())))
# Output: cookie_time:Wed, 29-May-19 06:02:41 GMT

http_time

Campo	Detalhe
Sintaxe	`http_time(sec)`
Descrição	Converte um timestamp UNIX em uma string de horário GMT para uso em cabeçalhos HTTP, como `Last-Modified`.
Parâmetros	`sec`: timestamp UNIX (inteiro). Chame `time()` para obter o timestamp atual.
Valor de retorno	String: horário GMT no formato HTTP-date: `Wed, 29 May 2019 06:02:41 GMT`

Importante

A string de horário está sempre em GMT.

Exemplo

say(concat('http_time:', http_time(time())))
# Output: http_time:Wed, 29 May 2019 06:02:41 GMT

parse_http_time

Campo	Detalhe
Sintaxe	`parse_http_time(str)`
Descrição	Analisa uma string de horário no formato HTTP e retorna o timestamp UNIX correspondente. Retorna `false` se a análise falhar.
Parâmetros	`str`: string de horário no formato `Wed, 29 May 2019 06:02:41 GMT`. Chame `http_time()` para gerar uma string de entrada válida.
Valor de retorno	Inteiro: timestamp UNIX se a análise for bem-sucedida; `false` se a análise falhar

Importante

Esta função não realiza conversão de fuso horário. Converta o horário para GMT antes de passá-lo à função.

Exemplos

# Successful parse
say(concat('parse_http_time:', parse_http_time(http_time(time()))))
# Output: parse_http_time:1559109761

# Failed parse — invalid input returns false
say(concat('parse_http_time:', parse_http_time('not-a-valid-time')))
# Output: parse_http_time:false

unixtime

Campo	Detalhe
Sintaxe	`unixtime(year, month, day, hour, min, sec)`
Descrição	Converte uma data e hora em um timestamp UNIX.
Parâmetros	`year`, `month`, `day`, `hour`, `min`, `sec`: valores inteiros que especificam os componentes de data e hora
Valor de retorno	Inteiro: timestamp UNIX correspondente à data e hora especificadas

Nota

O timestamp UNIX representa o número de segundos decorridos desde 00:00:00 UTC de 1º de janeiro de 1970 (época Unix). Esse valor é independente de fusos horários.

Exemplos

t = unixtime(1970, 1, 1, 8, 0, 0)
say(concat('unixtime()=', t))
# Output: unixtime()=0

# 2021-12-23 00:00:00
t = unixtime(2021, 12, 23, 0, 0, 0)
say(concat('unixtime()=', t))
# Output: unixtime()=1640188800