TO_DATE() Functie in Oracle

In Oracle Database, de TO_DATE() functie converteert zijn argument naar een waarde van DATE gegevenstype.

Syntaxis

De syntaxis gaat als volgt:

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

Het char argument kan elke expressie zijn die resulteert in een tekenreeks van CHAR , VARCHAR2 , NCHAR , of NVARCHAR2 gegevenstype.

De optionele fmt specificeert het formaat van char . Als u fmt weglaat , dan char moet de standaard datumnotatie hebben. Het standaard datumformaat wordt bepaald door de NLS_DATE_FORMAT initialisatieparameter, die zelf impliciet wordt ingesteld door de NLS_TERRITORY parameter, maar kan ook expliciet worden ingesteld (zie Het datumformaat van uw Oracle-sessie controleren).

De optionele 'nlsparam' argument specificeert de taal waarin maand- en dagnamen en afkortingen worden gegeven. Het heeft de volgende vorm:

'NLS_DATE_LANGUAGE = language'

Voorbeeld

Hier is een eenvoudig voorbeeld om te demonstreren:

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

Resultaat:

25/AUG/30

Het formaat van het resultaat wordt bepaald door de NLS_DATE_FORMAT . van uw sessie parameter. We kunnen de waarde van de NLS_DATE_FORMAT . controleren parameter door de V$NLS_PARAMETERS . op te vragen bekijken:

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

Resultaat:

DD/MON/RR

De standaardwaarde van de NLS_TIMESTAMP_FORMAT parameter is afgeleid van de NLS_TERRITORY parameter. In mijn geval de NLS_TERRITORY parameter is AUSTRALIA .

Dit gebeurt er als ik de NLS_TERRITORY wijzig parameter naar een ander gebied en roep dan TO_TIMESTAMP() . aan nogmaals:

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

Resultaat:

25-AUG-30

Deze keer wordt het resultaat in een ander formaat geretourneerd.

U kunt ook de waarde van de NLS_TIMESTAMP_FORMAT . wijzigen parameter direct. Hierdoor wordt die parameter gewijzigd zonder andere parameters te beïnvloeden. Zie Het datumformaat wijzigen in uw Oracle-sessie voor meer informatie en voorbeelden.

Standaardformaat

In dit voorbeeld laat ik de fmt . weg argument:

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

Resultaat:

25-AUG-30

Wanneer u dit doet, moet het argument de standaardindeling hebben van de DATE gegevenstype, dat wordt bepaald door de NLS_DATE_FORMAT initialisatieparameter.

Hier is een voorbeeld van wat er gebeurt als we een waarde doorgeven die niet aan dit formaat voldoet:

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

Resultaat:

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

Om dit op te lossen, moet ik ofwel mijn invoer wijzigen, of de waarde van de NLS_DATE_FORMAT wijzigen parameter.

Het is over het algemeen geen goede gewoonte om het formaatmodel weg te laten. Met andere woorden, het is een goede gewoonte om altijd een formaatmodel op te geven bij het gebruik van deze functie. Hier is een volledige lijst van datetime-indelingselementen die kunnen worden gebruikt bij het maken van een indelingsmodel.

Geef een standaardwaarde op bij conversiefout

Je hebt ook de mogelijkheid om een ​​waarde op te geven die moet worden geretourneerd in het geval dat er een fout optreedt tijdens het converteren van het argument naar een DATE typ.

Voorbeeld:

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

Resultaat:

null

In dit geval heb ik gespecificeerd dat null moet worden geretourneerd wanneer er een conversiefout is.

Standaard retourneren SQLcl en SQL*Plus een spatie wanneer null treedt op als resultaat van een SQL SELECT uitspraak.

U kunt echter SET NULL . gebruiken om een ​​andere tekenreeks op te geven die moet worden geretourneerd. Hier heb ik gespecificeerd dat de string null moet worden geretourneerd.

De 'nlsparam' Argument

De optionele 'nlsparam' argument specificeert de taal waarin maand- en dagnamen en afkortingen worden gegeven. Het heeft de volgende vorm:

'NLS_DATE_LANGUAGE = language'

Voorbeeld

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

Resultaat:

25-AUG-30

Merk op dat het resultaat nog steeds wordt geretourneerd volgens de NLS_DATE_FORMAT van de huidige sessie parameter. Het is alleen dat de invoer was in een andere taal.

Dit gebeurt er als ik agosto verander tot August terwijl je dezelfde 'nlsparam' . gebruikt waarde:

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

Resultaat:

Error report -
ORA-01843: not a valid month

Dit gebeurde omdat ik de datum niet heb opgegeven in de taal gespecificeerd door de 'nlsparam' argument (Spaans).

Veranderen in English lost dit probleem op:

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

Resultaat:

25-AUG-30

Zie Hoe u een lijst met ondersteunde talen in Oracle kunt retourneren als dit helpt.

Nullargumenten

Doorgeven van null resulteert in null :

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

Resultaat:

null

Ongeldig aantal argumenten

Het aanroepen van de functie zonder het doorgeven van argumenten resulteert in een fout:

SELECT TO_DATE()
FROM DUAL;

Resultaat:

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

En het doorgeven van te veel argumenten resulteert ook in een fout:

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

Resultaat:

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