Summary : dans ce tutoriel, vous apprendrez à utiliser la fonction SQLite datetime() pour manipuler des valeurs de datetime.

Introduction à la fonction SQLite datetime()

La fonction datetime() accepte une chaîne de temps et un ou plusieurs modificateurs. La syntaxe de la fonction datetime() est la suivante :

Code language: SQL (Structured Query Language) (sql)

Dans cette syntaxe :

• Le time_string spécifie une date-heure spécifique, par exemple now pour la date-heure courante.
• Chaque modificateur modifie la valeur de la date-heure à sa gauche. La fonction évalue les arguments de gauche à droite, par conséquent, l’ordre des arguments est important.

La fonction datetime() renvoie une valeur de datetime dans ce format : YYYY-MM-DD HH:MM:SS

Par exemple, l’instruction suivante renvoie l’heure actuelle d’hier:

Code language: SQL (Structured Query Language) (sql)

Dans cette instruction:

• Premièrement, la chaîne de temps now renvoie la date et l’heure actuelles.
• Deuxièmement, le modificateur -1 day est appliqué à la date-heure actuelle qui donne l’heure actuelle d’hier.
• Troisièmement, le modificateur localtime demande à la fonction de retourner l’heure locale.

Exemples de la fonction SQLite datetime()

L’instruction suivante renvoie la date et l’heure actuelles en heure locale:

Code language: SQL (Structured Query Language) (sql)

Pour renvoyer la date et l’heure actuelles en UTC, vous utilisez l’instruction suivante:

Code language: SQL (Structured Query Language) (sql)

L’instruction suivante crée une nouvelle table nommée referrals avec trois colonnes : id, source et created_at.

Code language: SQL (Structured Query Language) (sql)

La colonne created_at a une valeur par défaut de la CURRENT_TIMESTAMP qui est la date et l’heure actuelles en UTC.

Pour insérer des données dans la table referrals, vous utilisez l’instruction INSERT suivante :

Code language: SQL (Structured Query Language) (sql)

La requête suivante renvoie les données de la table referrals :

Code language: SQL (Structured Query Language) (sql)

Comme le montre clairement la sortie, les données de la colonne created_at dans l’heure créée en UTC.

Pour convertir ces valeurs d’heure créée en heure locale, vous utilisez la fonction datetime() comme indiqué dans la requête suivante:

.