Fonction TO_DATE

TO_DATE convertit une date représentée par une chaîne de caractères en un type de données DATE.

Syntaxe

TO_DATE(string, format)

TO_DATE(string, format, is_strict)

Arguments

string

Chaîne à convertir.

format

Littéral de chaîne qui définit le format de la chaîne de sortie, en fonction de ses parties de date. Pour obtenir la liste des formats de jour, de mois et d’année valides, consultez Chaînes de format datetime.

is_strict

Valeur booléenne facultative qui spécifie si une erreur est renvoyée lorsqu’une valeur de date d’entrée est hors plage. Quand is_strict est défini sur TRUE, une erreur est renvoyée s’il y a une valeur hors plage. Quand is_strict est défini sur FALSE, qui est la valeur par défaut, les valeurs en dépassement sont acceptées.

Type de retour

TO_DATE renvoie une DATE, selon la valeur de format.

Si la conversion au format échoue, une erreur est renvoyée.

Exemples

L’instruction SQL suivante convertit la date 02 Oct 2001 en type de données de date.

select to_date('02 Oct 2001', 'DD Mon YYYY');

to_date
------------
2001-10-02
(1 row)

L’instruction SQL suivante convertit la chaîne 20010631 en date.

select to_date('20010631', 'YYYYMMDD', FALSE);

Le résultat est le 1er juillet 2001, car il n’y a que 30 jours en juin.

to_date
------------
2001-07-01

L’instruction SQL suivante convertit la chaîne 20010631 en date :

to_date('20010631', 'YYYYMMDD', TRUE);

Le résultat est une erreur car il n’y a que 30 jours en juin.

ERROR:  date/time field date value out of range: 2001-6-31