EdgeScript fournit les fonctions temporelles suivantes pour CDN EdgeScript.
| Fonction | Description |
|---|---|
| today() | Renvoie la date actuelle sous forme de chaîne (yyyy-mm-dd) |
| time() | Renvoie l'horodatage UNIX actuel en secondes entières |
| now() | Renvoie l'horodatage UNIX actuel avec une précision à la milliseconde |
| localtime() | Renvoie la date et l'heure locales actuelles sous forme de chaîne (yyyy-mm-dd hh:mm:ss) |
| utctime() | Renvoie la date et l'heure UTC actuelles sous forme de chaîne (yyyy-mm-dd hh:mm:ss) |
| cookie_time(sec) | Convertit un horodatage UNIX en chaîne temporelle GMT au format cookie |
| http_time(sec) | Convertit un horodatage UNIX en chaîne temporelle GMT pour les en-têtes HTTP |
| parse_http_time(str) | Analyse une chaîne temporelle au format HTTP et renvoie l'horodatage UNIX correspondant |
| unixtime(year, month, day, hour, min, sec) | Convertit une date et une heure en horodatage UNIX |
today
| Champ | Détail |
|---|---|
| Syntaxe | today() |
| Description | Renvoie la date actuelle (heure locale) au format yyyy-mm-dd. |
| Paramètres | Aucun |
| Valeur de retour | Chaîne : date locale actuelle au format yyyy-mm-dd |
Exemple
say(concat('today:', today()))
# Output: today:2019-05-23time
| Champ | Détail |
|---|---|
| Syntaxe | time() |
| Description | Renvoie l'horodatage UNIX actuel sous forme d'entier en secondes. Utilisez now() pour obtenir une précision à la milliseconde. |
| Paramètres | Aucun |
| Valeur de retour | Entier : horodatage UNIX actuel en secondes |
Remarque
L'horodatage UNIX correspond au nombre de secondes écoulées depuis le 1er janvier 1970 à 00:00:00 UTC (epoch Unix). Il est indépendant des fuseaux horaires.
Exemple
say(concat('time:', time()))
# Output: time:1559109666now
| Champ | Détail |
|---|---|
| Syntaxe | now() |
| Description | Renvoie l'horodatage UNIX actuel, sans la partie fractionnaire des millisecondes. Unité : secondes. |
| Paramètres | Aucun |
| Valeur de retour | Horodatage UNIX actuel, sans la partie fractionnaire des millisecondes. Unité : secondes. |
Remarque
L'horodatage UNIX correspond au nombre de secondes écoulées depuis le 1er janvier 1970 à 00:00:00 UTC (epoch Unix). Il est indépendant des fuseaux horaires.
Exemple
say(concat('now:', now()))
# Output: now:1559109666.644localtime
| Champ | Détail |
|---|---|
| Syntaxe | localtime() |
| Description | Renvoie la date et l'heure locales actuelles au format yyyy-mm-dd hh:mm:ss. |
| Paramètres | Aucun |
| Valeur de retour | Chaîne : date et heure locales actuelles au format yyyy-mm-dd hh:mm:ss |
Exemple
say(concat('localtime:', localtime()))
# Output: localtime:2019-05-29 14:02:41utctime
| Champ | Détail |
|---|---|
| Syntaxe | utctime() |
| Description | Renvoie la date et l'heure UTC actuelles au format yyyy-mm-dd hh:mm:ss. |
| Paramètres | Aucun |
| Valeur de retour | Chaîne : date et heure UTC actuelles au format yyyy-mm-dd hh:mm:ss |
Exemple
say(concat('utctime:', utctime()))
# Output: utctime:2019-05-29 06:02:41cookie_time
| Champ | Détail |
|---|---|
| Syntaxe | cookie_time(sec) |
| Description | Convertit un horodatage UNIX en chaîne temporelle GMT au format cookie. |
| Paramètres | sec : horodatage UNIX (entier). Appelez time() pour obtenir l'horodatage actuel. |
| Valeur de retour | Chaîne : chaîne temporelle GMT au format cookie : Wed, 29-May-19 06:02:41 GMT |
Exemple
say(concat('cookie_time:', cookie_time(time())))
# Output: cookie_time:Wed, 29-May-19 06:02:41 GMThttp_time
| Champ | Détail |
|---|---|
| Syntaxe | http_time(sec) |
| Description | Convertit un horodatage UNIX en chaîne temporelle GMT pour les en-têtes HTTP, tels que Last-Modified. |
| Paramètres | sec : horodatage UNIX (entier). Appelez time() pour obtenir l'horodatage actuel. |
| Valeur de retour | Chaîne : chaîne temporelle GMT au format HTTP-date : Wed, 29 May 2019 06:02:41 GMT |
Important
La chaîne temporelle est toujours exprimée en GMT.
Exemple
say(concat('http_time:', http_time(time())))
# Output: http_time:Wed, 29 May 2019 06:02:41 GMTparse_http_time
| Champ | Détail |
|---|---|
| Syntaxe | parse_http_time(str) |
| Description | Analyse une chaîne temporelle au format HTTP et renvoie l'horodatage UNIX correspondant. Renvoie false en cas d'échec de l'analyse. |
| Paramètres | str : chaîne temporelle au format Wed, 29 May 2019 06:02:41 GMT. Utilisez http_time() pour générer une chaîne d'entrée valide. |
| Valeur de retour | Entier : horodatage UNIX si l'analyse réussit ; false si elle échoue |
Important
Cette fonction ne gère pas la conversion des fuseaux horaires. Convertissez l'heure en GMT avant de la transmettre à cette fonction.
Exemples
# 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:falseunixtime
| Champ | Détail |
|---|---|
| Syntaxe | unixtime(year, month, day, hour, min, sec) |
| Description | Convertit une date et une heure en horodatage UNIX. |
| Paramètres | year, month, day, hour, min, sec : valeurs entières définissant les composantes de la date et de l'heure |
| Valeur de retour | Entier : horodatage UNIX correspondant à la date et à l'heure spécifiées |
Remarque
L'horodatage UNIX correspond au nombre de secondes écoulées depuis le 1er janvier 1970 à 00:00:00 UTC (epoch Unix). Il est indépendant des fuseaux horaires.
Exemples
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