Cette page a été traduite de l'anglais avec l'aide de l'IA. En cas de divergence, la version anglaise fait référence.
Modificateurs de date
Vue d'ensemble
Dans les fonctions de date et d'heure de StackQL, les valeurs de date ou d'heure peuvent être suivies de zéro ou plusieurs modificateurs qui modifient la date et/ou l'heure. Chaque modificateur est une transformation appliquée à la valeur temporelle située à sa gauche. Les modificateurs sont appliqués dans l'ordre, de gauche à droite. Les modificateurs disponibles sont les suivants :
| Modificateur | Description |
|---|---|
| NNN day(s) | Ajoute ±NNN jours à une date et une heure |
| NNN hour(s) | Ajoute ±NNN heures à une date et une heure |
| NNN minute(s) | Ajoute ±NNN minutes à une date et une heure |
| NNN[.NNNN] second(s) | Ajoute ou retranche ±NNN secondes à une date et une heure |
| NNN month(s) | Ajoute ±NNN mois à une date et une heure |
| NNN year(s) | Ajoute ±NNN années à une date et une heure |
| start of month | Revient au début du mois |
| start of year | Revient au début de l'année |
| start of day | Revient au début de la journée |
| weekday N | Avance une date jusqu'à la prochaine date dont le numéro de jour de la semaine est N |
| localtime | Renvoie l'heure locale |
| utc | Renvoie l'heure UTC |
| unixepoch | Heure Unix |
Exemples
Renvoyer la date et l'heure actuelles avec la valeur temporelle now
SELECT name, date('now') as date, time('now') as time
FROM google.storage.buckets WHERE project = 'stackql';
Convertir une heure UTC en heure locale avec le modificateur localtime
SELECT name, timeCreated,
datetime(timeCreated, 'localtime') as local_time_created
FROM google.storage.buckets WHERE project = 'stackql';
Convertir une heure locale en UTC
Le modificateur utc traite son entrée comme une heure locale de la machine qui exécute StackQL et la convertit en UTC. Une valeur déjà exprimée en UTC, comme 'now' ou un horodatage avec le suffixe Z, est renvoyée inchangée.
SELECT datetime('2026-11-20 17:59:24', 'utc') as utc_time;
Sur une machine dont le fuseau horaire est UTC+11, cette requête renvoie 2026-11-20 06:59:24.
Calculer une date par rapport à une autre date
SELECT name, timeCreated,
datetime(timeCreated, '+24 hours') as a_day_later
FROM google.storage.buckets WHERE project = 'stackql';
Obtenir le prochain jour de la semaine spécifié après une date donnée
SELECT name, timeCreated,
datetime(timeCreated, 'weekday 0') as following_sunday
FROM google.storage.buckets WHERE project = 'stackql';
Obtenir le début du mois pour une date donnée
SELECT name, timeCreated,
datetime(timeCreated, 'start of month') as start_of_month
FROM google.storage.buckets WHERE project = 'stackql';
Convertir un horodatage Unix en date et heure
SELECT datetime(1576417943, 'unixepoch') as date_from_ts
FROM google.storage.buckets WHERE project = 'stackql';