Time functions - CDN - Centro de documentación de Alibaba Cloud

EdgeScript proporciona a continuación las funciones de tiempo disponibles para su uso en CDN EdgeScript.

Función	Descripción
today()	Devuelve la fecha actual como una cadena (`yyyy-mm-dd`)
time()	Devuelve la marca de tiempo UNIX actual en segundos enteros
now()	Devuelve la marca de tiempo UNIX actual con precisión de milisegundos
localtime()	Devuelve la fecha y hora local actual como una cadena (`yyyy-mm-dd hh:mm:ss`)
utctime()	Devuelve la fecha y hora UTC actual como una cadena (`yyyy-mm-dd hh:mm:ss`)
cookie_time(sec)	Convierte una marca de tiempo UNIX en una cadena de hora GMT con formato de cookie
http_time(sec)	Convierte una marca de tiempo UNIX en una cadena de hora GMT con formato de encabezado HTTP
parse_http_time(str)	Analiza sintácticamente una cadena de hora con formato HTTP y devuelve la marca de tiempo UNIX correspondiente
unixtime(year, month, day, hour, min, sec)	Convierte una fecha y hora en una marca de tiempo UNIX

today

Campo	Detalle
Sintaxis	`today()`
Descripción	Devuelve la fecha actual (hora local) con el formato `yyyy-mm-dd`.
Parámetros	Ninguna
Valor devuelto	Cadena: fecha local actual con el formato `yyyy-mm-dd`

Ejemplo

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

time

Campo	Detalle
Sintaxis	`time()`
Descripción	Devuelve la marca de tiempo UNIX actual como un entero de segundos completos. Si necesita precisión de milisegundos, utilice `now()`.
Parámetros	Ninguna
Valor devuelto	Entero: marca de tiempo UNIX actual en segundos

Nota

La marca de tiempo UNIX representa el número de segundos transcurridos desde las 00:00:00 UTC del 1 de enero de 1970 (época Unix). Este valor es independiente de las zonas horarias.

Ejemplo

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

now

Campo	Detalle
Sintaxis	`now()`
Descripción	Consulta la marca de tiempo UNIX actual y excluye la parte fraccionaria de los milisegundos. Unidad: segundos.
Parámetros	Ninguna
Valor devuelto	Marca de tiempo UNIX actual que excluye la parte fraccionaria de los milisegundos. Unidad: segundos.

Nota

La marca de tiempo UNIX representa el número de segundos transcurridos desde las 00:00:00 UTC del 1 de enero de 1970 (época Unix). Este valor es independiente de las zonas horarias.

Ejemplo

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

localtime

Campo	Detalle
Sintaxis	`localtime()`
Descripción	Devuelve la fecha y hora local actual con el formato `yyyy-mm-dd hh:mm:ss`.
Parámetros	Ninguna
Valor devuelto	Cadena: fecha y hora local actual con el formato `yyyy-mm-dd hh:mm:ss`

Ejemplo

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

utctime

Campo	Detalle
Sintaxis	`utctime()`
Descripción	Devuelve la fecha y hora UTC actual con el formato `yyyy-mm-dd hh:mm:ss`.
Parámetros	Ninguna
Valor devuelto	Cadena: fecha y hora UTC actual con el formato `yyyy-mm-dd hh:mm:ss`

Ejemplo

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

cookie_time

Campo	Detalle
Sintaxis	`cookie_time(sec)`
Descripción	Convierte una marca de tiempo UNIX en una cadena de hora GMT con formato de cookie.
Parámetros	`sec`: marca de tiempo UNIX (entero). Llame a `time()` para obtener la marca de tiempo actual.
Valor devuelto	Cadena: hora GMT con formato de cookie: `Wed, 29-May-19 06:02:41 GMT`

Ejemplo

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

http_time

Campo	Detalle
Sintaxis	`http_time(sec)`
Descripción	Convierte una marca de tiempo UNIX en una cadena de hora GMT para usarla en encabezados HTTP, como `Last-Modified`.
Parámetros	`sec`: marca de tiempo UNIX (entero). Llame a `time()` para obtener la marca de tiempo actual.
Valor devuelto	Cadena: hora GMT con formato HTTP-date: `Wed, 29 May 2019 06:02:41 GMT`

Importante

La cadena de hora siempre se expresa en GMT.

Ejemplo

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

parse_http_time

Campo	Detalle
Sintaxis	`parse_http_time(str)`
Descripción	Analiza sintácticamente una cadena de hora con formato HTTP y devuelve la marca de tiempo UNIX correspondiente. Si el análisis termina con errores, devuelve `false`.
Parámetros	`str`: cadena de hora con el formato `Wed, 29 May 2019 06:02:41 GMT`. Llame a `http_time()` para generar una cadena de entrada válida.
Valor devuelto	Entero: marca de tiempo UNIX si el análisis se completa correctamente; `false` si termina con errores

Importante

Esta función no gestiona la conversión de zonas horarias. Convierta la hora a GMT antes de pasarla a esta función.

Ejemplos

# 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	Detalle
Sintaxis	`unixtime(year, month, day, hour, min, sec)`
Descripción	Convierte una fecha y hora en una marca de tiempo UNIX.
Parámetros	`year`, `month`, `day`, `hour`, `min`, `sec`: valores enteros que especifican los componentes de la fecha y la hora
Valor devuelto	Entero: marca de tiempo UNIX correspondiente a la fecha y hora especificadas

Nota

La marca de tiempo UNIX representa el número de segundos transcurridos desde las 00:00:00 UTC del 1 de enero de 1970 (época Unix). Este valor es independiente de las zonas horarias.

Ejemplos

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