Fonction TO_DATE() dans Oracle

Dans Oracle Database, le TO_DATE() la fonction convertit son argument en une valeur de DATE type de données.

Syntaxe

La syntaxe ressemble à ceci :

TO_DATE(char [ DEFAULT return_value ON CONVERSION ERROR ]
  [, fmt [, 'nlsparam' ] ])

Le char l'argument peut être n'importe quelle expression qui correspond à une chaîne de caractères de CHAR , VARCHAR2 , NCHAR , ou NVARCHAR2 type de données.

Le fmt facultatif spécifie le format de char . Si vous omettez fmt , puis char doit être dans le format de date par défaut. Le format de date par défaut est déterminé par le NLS_DATE_FORMAT paramètre d'initialisation, lui-même défini implicitement par le NLS_TERRITORY paramètre, mais peut également être défini explicitement (voir Comment vérifier le format de date de votre session Oracle).

Le 'nlsparam' facultatif L'argument spécifie la langue dans laquelle les noms et abréviations des mois et des jours sont fournis. Il prend la forme suivante :

'NLS_DATE_LANGUAGE = language'

Exemple

Voici un exemple de base pour illustrer :

SELECT 
    TO_DATE(
        '25-Aug-2030', 
        'DD-Mon-RRRR'
    )
FROM DUAL;

Résultat :

25/AUG/30

Le format du résultat est déterminé par le NLS_DATE_FORMAT de votre session paramètre. Nous pouvons vérifier la valeur du NLS_DATE_FORMAT paramètre en interrogeant le V$NLS_PARAMETERS afficher :

SELECT VALUE
FROM V$NLS_PARAMETERS
WHERE PARAMETER = 'NLS_DATE_FORMAT';

Résultat :

DD/MON/RR

La valeur par défaut du NLS_TIMESTAMP_FORMAT le paramètre est dérivé du NLS_TERRITORY paramètre. Dans mon cas, le NLS_TERRITORY le paramètre est AUSTRALIA .

Voici ce qui se passe lorsque je modifie le NLS_TERRITORY paramètre vers un autre territoire, puis appelez TO_TIMESTAMP() encore :

ALTER SESSION SET NLS_TERRITORY = 'AMERICA';
SELECT 
    TO_DATE(
        '25-Aug-2030', 
        'DD-Mon-RRRR'
    )
FROM DUAL;

Résultat :

25-AUG-30

Cette fois, le résultat est renvoyé dans un format différent.

Vous pouvez également modifier la valeur du NLS_TIMESTAMP_FORMAT paramètre directement. Cela modifiera ce paramètre sans affecter les autres paramètres. Voir Comment changer le format de date dans votre session Oracle pour plus d'informations et d'exemples.

Format par défaut

Dans cet exemple, j'omets le fmt argument :

SELECT 
    TO_DATE(
        '25-AUG-30'
    )
FROM DUAL;

Résultat :

25-AUG-30

Lorsque vous faites cela, l'argument doit être dans le format par défaut de la DATE type de données, qui est déterminé par le NLS_DATE_FORMAT paramètre d'initialisation.

Voici un exemple de ce qui se passe lorsque nous passons une valeur qui n'est pas conforme à ce format :

SELECT 
    TO_DATE(
        '2030-08-25'
    )
FROM DUAL;

Résultat :

Error report -
ORA-01861: literal does not match format string

Pour résoudre ce problème, je devrais soit modifier mon entrée, soit modifier la valeur du NLS_DATE_FORMAT paramètre.

Il n'est généralement pas recommandé d'omettre le modèle de format. En d'autres termes, il est recommandé de toujours fournir un modèle de format lors de l'utilisation de cette fonction. Voici une liste complète des éléments de format datetime qui peuvent être utilisés lors de la construction d'un modèle de format.

Fournir une valeur par défaut en cas d'erreur de conversion

Vous avez également la possibilité de fournir une valeur à renvoyer en cas d'erreur lors de la conversion de l'argument en DATE saisir.

Exemple :

SET NULL 'null';
SELECT 
    TO_DATE(
    'Oops!'
    DEFAULT null ON CONVERSION ERROR
    )
FROM DUAL;

Résultat :

null

Dans ce cas, j'ai spécifié que null doit être renvoyé en cas d'erreur de conversion.

Par défaut, SQLcl et SQL*Plus renvoient un espace vide chaque fois que null se produit à la suite d'un SQL SELECT déclaration.

Cependant, vous pouvez utiliser SET NULL pour spécifier une autre chaîne à renvoyer. Ici, j'ai précisé que la chaîne null doit être retourné.

Le 'nlsparam' Argumentation

Le 'nlsparam' facultatif L'argument spécifie la langue dans laquelle les noms et abréviations des mois et des jours sont fournis. Il prend la forme suivante :

'NLS_DATE_LANGUAGE = language'

Exemple

SELECT 
    TO_DATE(
        '25-agosto-2030', 
        'DD-Month-RRRR',
        'NLS_DATE_LANGUAGE = SPANISH'
    )
FROM DUAL;

Résultat :

25-AUG-30

Notez que le résultat est toujours renvoyé en fonction du NLS_DATE_FORMAT de la session en cours paramètre. C'est juste que l'entrée était dans une autre langue.

Voici ce qui se passe lorsque je change agosto au August tout en utilisant le même 'nlsparam' valeur :

SELECT 
    TO_DATE(
        '25-August-2030', 
        'DD-Month-RRRR',
        'NLS_DATE_LANGUAGE = SPANISH'
    )
FROM DUAL;

Résultat :

Error report -
ORA-01843: not a valid month

Cela s'est produit parce que je n'ai pas fourni la date dans la langue spécifiée par le 'nlsparam' argument (espagnol).

Le changer en English résout ce problème :

SELECT 
    TO_DATE(
        '25-August-2030', 
        'DD-Month-RRRR',
        'NLS_DATE_LANGUAGE = English'
    )
FROM DUAL;

Résultat :

25-AUG-30

Voir Comment renvoyer une liste des langues prises en charge dans Oracle si cela vous aide.

Arguments nuls

Passer null donne null :

SET NULL 'null';
SELECT 
    TO_DATE(null)
FROM DUAL;

Résultat :

null

Nombre d'arguments non valides

L'appel de la fonction sans passer d'arguments entraîne une erreur :

SELECT TO_DATE()
FROM DUAL;

Résultat :

SQL Error: ORA-00938: not enough arguments for function
00938. 00000 -  "not enough arguments for function"

Et passer trop d'arguments entraîne également une erreur :

SELECT 
    TO_DATE(
        '25-Aug-2030', 
        'DD-Mon-RRRR',
        'NLS_DATE_LANGUAGE = English',
        'Gosh',
        'Dang'
    )
FROM DUAL;

Résultat :

SQL Error: ORA-00939: too many arguments for function
00939. 00000 -  "too many arguments for function"