SQLite
 sql >> Base de données >  >> RDS >> SQLite

Comment fonctionne la fonction Time() dans SQLite

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.