TO_DATE() Funktion i Oracle

I Oracle Database, TO_DATE() funktion konverterar sitt argument till värdet DATE datatyp.

Syntax

Syntaxen ser ut så här:

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

char argument kan vara vilket uttryck som helst som utvärderas till en teckensträng av CHAR , VARCHAR2 , NCHAR , eller NVARCHAR2 datatyp.

Den valfria fmt anger formatet för char . Om du utelämnar fmt , sedan char måste vara i standarddatumformatet. Standarddatumformatet bestäms av NLS_DATE_FORMAT initialiseringsparameter, som själv är implicit inställd av NLS_TERRITORY parameter, men kan också ställas in explicit (se Hur du kontrollerar datumformatet för din Oracle-session).

Den valfria 'nlsparam' argument anger det språk som månads- och dagnamn och förkortningar tillhandahålls på. Den har följande form:

'NLS_DATE_LANGUAGE = language'

Exempel

Här är ett grundläggande exempel att visa:

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

Resultat:

25/AUG/30

Formatet på resultatet bestäms av din sessions NLS_DATE_FORMAT parameter. Vi kan kontrollera värdet på NLS_DATE_FORMAT parameter genom att fråga V$NLS_PARAMETERS visa:

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

Resultat:

DD/MON/RR

Standardvärdet för NLS_TIMESTAMP_FORMAT parametern härleds från NLS_TERRITORY parameter. I mitt fall NLS_TERRITORY parametern är AUSTRALIA .

Här är vad som händer när jag ändrar NLS_TERRITORY parametern till ett annat territorium, anrop sedan TO_TIMESTAMP() igen:

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

Resultat:

25-AUG-30

Den här gången returneras resultatet i ett annat format.

Du kan alternativt ändra värdet på NLS_TIMESTAMP_FORMAT parameter direkt. Detta kommer att ändra den parametern utan att påverka andra parametrar. Se Hur du ändrar datumformatet i din Oracle-session för mer information och exempel.

Standardformat

I det här exemplet utelämnar jag fmt argument:

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

Resultat:

25-AUG-30

När du gör detta måste argumentet vara i standardformatet DATE datatyp, som bestäms av NLS_DATE_FORMAT initieringsparameter.

Här är ett exempel på vad som händer när vi skickar ett värde som inte överensstämmer med detta format:

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

Resultat:

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

För att fixa detta måste jag antingen ändra min inmatning eller ändra värdet på NLS_DATE_FORMAT parameter.

Det är i allmänhet inte bra att utelämna formatmodellen. Med andra ord är det bra att alltid tillhandahålla en formatmodell när du använder den här funktionen. Här är en fullständig lista över datetime-formatelement som kan användas när man konstruerar en formatmodell.

Ange ett standardvärde vid konverteringsfel

Du har också möjlighet att ange ett värde som ska returneras i händelse av att det uppstår ett fel när argumentet konverteras till en DATE typ.

Exempel:

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

Resultat:

null

I det här fallet angav jag att null ska returneras när det finns ett konverteringsfel.

Som standard returnerar SQLcl och SQL*Plus ett tomt utrymme när null uppstår som ett resultat av en SQL SELECT påstående.

Du kan dock använda SET NULL för att ange en annan sträng som ska returneras. Här specificerade jag att strängen null bör returneras.

'nlsparam' Argument

Den valfria 'nlsparam' argument anger det språk som månads- och dagnamn och förkortningar tillhandahålls på. Den har följande form:

'NLS_DATE_LANGUAGE = language'

Exempel

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

Resultat:

25-AUG-30

Observera att resultatet fortfarande returneras enligt den aktuella sessionens NLS_DATE_FORMAT parameter. Det är bara ingången var på ett annat språk.

Här är vad som händer när jag ändrar agosto till August samtidigt som du använder samma 'nlsparam' värde:

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

Resultat:

Error report -
ORA-01843: not a valid month

Detta hände eftersom jag inte angav datumet på språket som anges av 'nlsparam' argument (spanska).

Ändra den till English löser detta problem:

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

Resultat:

25-AUG-30

Se hur du returnerar en lista över språk som stöds i Oracle om det hjälper.

Nollargument

Skickar null resulterar i null :

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

Resultat:

null

Ogiltigt antal argument

Att anropa funktionen utan att skicka några argument resulterar i ett fel:

SELECT TO_DATE()
FROM DUAL;

Resultat:

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

Och att skicka för många argument resulterar också i ett fel:

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

Resultat:

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