{{tag>tutotriel sql postgresql db database}}


====== PostgreSQL BETWEEN ======

Notes et traduction du tutoriel [[https://neon.tech/postgresql/tutorial|PostgreSQL Tutorial]]

L'opérateur ''BETWEEN'' permet de vérifier si une valeur se trouve dans un intervalle.

<code sql>
value BETWEEN low AND high;
</code>

Si "value" est supérieure ou égale à "low" et inférieure ou égale à "high" l'opérateur ''BETWEEN'' retourne vrai, sinon il retourne faux.

On peut employer un équivalent à ''BETWEEN'' en utilisant les opérateurs de comparaisons et l'opérateur ''AND'' :

<code sql>
value BETWEEN low AND high;

-- Equivaut à
value >= low AND value <= high
</code>

Si l'on souhaite vérifier au contraire qu'une valeur se trouve hors intervalle :
<code sql>
value NOT BETWEEN low AND high

-- Equivaut à
value < low OR value > high
</code>

En pratique on utilise fréquemment l'opérateur ''BETWEEN'' dans la clause WHERE des instructions SELECT, INSERT, UPDATE ou DELETE.

<code sql>
SELECT
  payment_id,
  amount
FROM
  payment
WHERE
  payment_id BETWEEN 17503 AND 17505
ORDER BY
  payment_id;
  
-- hors intervalle
SELECT
  payment_id,
  amount
FROM
  payment
WHERE
  payment_id NOT BETWEEN 17503 AND 17505
ORDER BY
  payment_id;
</code>

Un usage particulier de ''BETWEEN'' concerne les dates. Notez qu'il faut utiliser le format de date ISO 8601 (YYYY-MM-DD) pour que la comparaison puisse être valide.

L'exemple ci-dessous utilise l'opérateur ''BETWEEN'' pour sélectionner tous les paiements qui ont eu lieu entre le 15 et le 20 février 2007 :

<code sql>
SELECT
  payment_id,
  amount,
  payment_date
FROM
  payment
WHERE
  payment_date BETWEEN '2007-02-15' AND '2007-02-20'
  AND amount > 10
ORDER BY
  payment_date;
</code> 


===== Résumé =====

  * Utiliser l'opérateur ''BETWEEN'' pour vérifier qu'une valeur appartient à un intervalle ;
  * Utiliser l’opérateur ''NOT BETWEEN'' au contraire pour vérifier qu'une valeur se trouve hors intervalle.

[[235_operateur_in|◁ Précédent]] |
[[000_start|⌂ Retour au sommaire]] |
[[245_like|Suivant ▷]]