TO_DATE() Funzione in Oracle

In Oracle Database, il TO_DATE() la funzione converte il suo argomento in un valore di DATE tipo di dati.

Sintassi

La sintassi è questa:

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

Il char argomento può essere qualsiasi espressione che restituisce una stringa di caratteri di CHAR , VARCHAR2 , NCHAR o NVARCHAR2 tipo di dati.

Il fmt opzionale specifica il formato di char . Se ometti fmt , quindi char deve essere nel formato della data predefinito. Il formato della data predefinito è determinato da NLS_DATE_FORMAT parametro di inizializzazione, che a sua volta è impostato implicitamente da NLS_TERRITORY parametro, ma può anche essere impostato in modo esplicito (vedi Come controllare il formato della data della tua sessione Oracle).

Il 'nlsparam' facoltativo argomento specifica la lingua in cui vengono forniti i nomi e le abbreviazioni di mese e giorno. Ha la forma seguente:

'NLS_DATE_LANGUAGE = language'

Esempio

Ecco un esempio di base da dimostrare:

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

Risultato:

25/AUG/30

Il formato del risultato è determinato dal NLS_DATE_FORMAT della tua sessione parametro. Possiamo controllare il valore di NLS_DATE_FORMAT parametro interrogando il V$NLS_PARAMETERS visualizza:

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

Risultato:

DD/MON/RR

Il valore predefinito di NLS_TIMESTAMP_FORMAT il parametro è derivato da NLS_TERRITORY parametro. Nel mio caso il NLS_TERRITORY il parametro è AUSTRALIA .

Ecco cosa succede quando cambio NLS_TERRITORY parametro in un altro territorio, quindi chiama TO_TIMESTAMP() ancora:

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

Risultato:

25-AUG-30

Questa volta il risultato viene restituito in un formato diverso.

In alternativa puoi modificare il valore di NLS_TIMESTAMP_FORMAT parametro direttamente. Questo cambierà quel parametro senza influenzare altri parametri. Per ulteriori informazioni ed esempi, vedere Come modificare il formato della data nella sessione Oracle.

Formato predefinito

In questo esempio ometto fmt argomento:

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

Risultato:

25-AUG-30

Quando si esegue questa operazione, l'argomento deve essere nel formato predefinito di DATE tipo di dati, determinato da NLS_DATE_FORMAT parametro di inizializzazione.

Ecco un esempio di cosa succede quando passiamo un valore che non è conforme a questo formato:

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

Risultato:

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

Per risolvere questo problema, dovrei cambiare il mio input o cambiare il valore di NLS_DATE_FORMAT parametro.

In genere non è buona norma omettere il modello di formato. In altre parole, è buona norma fornire sempre un modello di formato quando si utilizza questa funzione. Ecco un elenco completo di elementi di formato datetime che possono essere utilizzati durante la costruzione di un modello di formato.

Fornire un valore predefinito in caso di errore di conversione

Hai anche la possibilità di fornire un valore da restituire nel caso in cui si verifichi un errore durante la conversione dell'argomento in DATE digitare.

Esempio:

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

Risultato:

null

In questo caso ho specificato che null deve essere restituito ogni volta che si verifica un errore di conversione.

Per impostazione predefinita, SQLcl e SQL*Plus restituiscono uno spazio vuoto ogni volta che null si verifica come risultato di un SQL SELECT dichiarazione.

Tuttavia, puoi utilizzare SET NULL per specificare una stringa diversa da restituire. Qui ho specificato che la stringa null deve essere restituito.

Il 'nlsparam' Argomento

Il 'nlsparam' facoltativo argomento specifica la lingua in cui vengono forniti i nomi e le abbreviazioni di mese e giorno. Ha la forma seguente:

'NLS_DATE_LANGUAGE = language'

Esempio

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

Risultato:

25-AUG-30

Nota che il risultato viene comunque restituito in base al NLS_DATE_FORMAT della sessione corrente parametro. È solo che l'input era in un'altra lingua.

Ecco cosa succede quando cambio August a August utilizzando lo stesso 'nlsparam' valore:

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

Risultato:

Error report -
ORA-01843: not a valid month

Ciò è accaduto perché non ho fornito la data nella lingua specificata da 'nlsparam' argomento (spagnolo).

Cambiandolo in English risolve questo problema:

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

Risultato:

25-AUG-30

Vedi Come restituire un elenco di lingue supportate in Oracle se può essere d'aiuto.

Argomenti nulli

Passaggio null risulta null :

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

Risultato:

null

Conteggio argomenti non valido

La chiamata della funzione senza passare alcun argomento genera un errore:

SELECT TO_DATE()
FROM DUAL;

Risultato:

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

E anche il passaggio di troppi argomenti provoca un errore:

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

Risultato:

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