SQLite a un time()
fonction qui vous permet de renvoyer une valeur de temps basée sur une chaîne de temps et tous les modificateurs.
Il renvoie l'heure dans ce format :HH:MM:SS
Pour utiliser cette fonction, vous devez fournir une chaîne d'heure, ainsi que tous les modificateurs (facultatifs). Un modificateur vous permet de modifier l'heure, comme ajouter un nombre d'heures, la régler sur l'heure locale, etc
Syntaxe
La syntaxe du time()
la fonction se présente comme suit :
time(timestring, modifier, modifier, ...)
La timestring
l'argument doit être une chaîne de temps valide.
Le modifier
les arguments sont facultatifs. Vous pouvez fournir un ou plusieurs modificateurs. Si vous fournissez un modificateur, il doit s'agir d'un modificateur valide.
Exemple
Voici un exemple de base pour démontrer le time()
fonction utilisée avec un argument.
SELECT time('now');
Résultat :
03:47:36
Le now
La chaîne d'heure est convertie en date et heure actuelles. Étant donné que j'utilise le time()
fonction, seule la partie heure est renvoyée.
Ajouter un modificateur
Nous pouvons modifier le résultat précédent en utilisant un modificateur. Voici un exemple.
SELECT time('now', '+5 hours');
Résultat :
08:48:24
Dans ce cas, j'ai ajouté cinq heures à l'heure.
Modificateurs multiples
Comme mentionné, vous pouvez ajouter un ou plusieurs modificateurs. Voici un exemple d'ajout d'un autre modificateur à l'exemple précédent.
SELECT time('now', '+5 hours', 'localtime');
Résultat :
18:50:08
L'localtime
Le modificateur suppose que la chaîne d'heure fournie est en temps universel coordonné (UTC). Il ajuste ensuite la chaîne d'heure pour qu'elle affiche l'heure locale.
Par conséquent, vous pouvez obtenir un résultat différent en fonction de votre heure locale.
Chaîne littérale comme chaîne d'heure
Les exemples ci-dessus utilisent now
comme chaîne d'heure, mais vous pouvez fournir n'importe quelle chaîne d'heure valide.
Voici quelques autres exemples.
SELECT time('1999-12-18 17:10:23');
Résultat :
17:10:23
Dans ce cas, il supprime simplement la partie date de la date.
time() contre strftime()
Le time()
La fonction renvoie exactement le même résultat que strftime('%H:%M:%S', ...)
Retour. Le time()
est juste un moyen plus pratique de le faire.
SELECT
time('now'),
strftime('%H:%M:%S', 'now');
Résultat :
time('now') strftime('%H:%M:%S', 'now') ----------- --------------------------- 03:56:09 03:56:09
Plage de dates
Comme avec toutes les fonctions de date et d'heure SQLite, time()
ne fonctionne que pour les dates entre 0000-01-01 00:00:00 et 9999-12-31 23:59:59 (numéros de jour julien 1721059.5 à 5373484.5).
Pour les dates en dehors de cette plage, les résultats ne sont pas définis.