Aller au contenu principal
Page traduite

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 :

ModificateurDescription
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 monthRevient au début du mois
start of yearRevient au début de l'année
start of dayRevient au début de la journée
weekday NAvance une date jusqu'à la prochaine date dont le numéro de jour de la semaine est N
localtimeRenvoie l'heure locale
utcRenvoie l'heure UTC
unixepochHeure Unix

Exemples​

Renvoyer la date et l'heure actuelles avec le modificateur 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 date et heure en UTC​

SELECT name, timeCreated,
datetime('now', 'utc') as now_utc
FROM google.storage.buckets WHERE project = 'stackql';

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';
astuce

Pour convertir une date et heure en horodatage epoch Unix, consultez STRFTIME. Pour calculer la différence entre deux objets de date et d'heure, consultez STRFTIME ou JULIANDAY.