Функция TO_DATE() в Oracle

В Oracle Database, TO_DATE() функцията преобразува своя аргумент в стойност DATE тип данни.

Синтаксис

Синтаксисът е така:

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

Знакът char Аргументът може да бъде всеки израз, който се оценява до символен низ от CHAR , VARCHAR2 , NCHAR или NVARCHAR2 тип данни.

Незадължителният fmt определя формата на char . Ако пропуснете fmt , след това char трябва да е във формат за дата по подразбиране. Форматът на датата по подразбиране се определя от NLS_DATE_FORMAT параметър за инициализация, който сам по себе си е имплицитно зададен от NLS_TERRITORY параметър, но може да бъде зададен и изрично (вижте Как да проверите формата на датата на вашата Oracle сесия).

Незадължителният 'nlsparam' аргумент определя езика, на който са предоставени имената и съкращенията на месеците и дните. Приема следната форма:

'NLS_DATE_LANGUAGE = language'

Пример

Ето основен пример за демонстрация:

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

Резултат:

25/AUG/30

Форматът на резултата се определя от NLS_DATE_FORMAT на вашата сесия параметър. Можем да проверим стойността на NLS_DATE_FORMAT параметър чрез заявка за V$NLS_PARAMETERS изглед:

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

Резултат:

DD/MON/RR

Стойността по подразбиране на NLS_TIMESTAMP_FORMAT параметърът е извлечен от NLS_TERRITORY параметър. В моя случай NLS_TERRITORY параметърът е AUSTRALIA .

Ето какво се случва, когато променя NLS_TERRITORY параметър към друга територия, след което извикайте TO_TIMESTAMP() отново:

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

Резултат:

25-AUG-30

Този път резултатът се връща в различен формат.

Като алтернатива можете да промените стойността на NLS_TIMESTAMP_FORMAT параметър директно. Това ще промени този параметър, без да засяга други параметри. Вижте Как да промените формата на датата във вашата сесия на Oracle за повече информация и примери.

Формат по подразбиране

В този пример пропускам fmt аргумент:

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

Резултат:

25-AUG-30

Когато правите това, аргументът трябва да е във формат по подразбиране на DATE тип данни, който се определя от NLS_DATE_FORMAT параметър за инициализация.

Ето пример за това какво се случва, когато предадем стойност, която не отговаря на този формат:

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

Резултат:

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

За да поправя това, ще трябва или да променя въведените си данни, или да променя стойността на NLS_DATE_FORMAT параметър.

Обикновено не е добра практика да се пропуска моделът на форматиране. С други думи, добра практика е винаги да предоставяте модел на формат, когато използвате тази функция. Ето пълен списък с елементи на формат за дата и час, които могат да се използват при конструирането на модел на формат.

Предоставете стойност по подразбиране при грешка при преобразуване

Също така имате възможност да предоставите стойност, която да се върне, в случай че има грешка при преобразуването на аргумента в DATE тип.

Пример:

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

Резултат:

null

В този случай посочих, че null трябва да се връща всеки път, когато има грешка при преобразуване.

По подразбиране SQLcl и SQL*Plus връщат празно пространство всеки път, когато null възниква в резултат на SQL SELECT изявление.

Можете обаче да използвате SET NULL за да посочите различен низ, който да бъде върнат. Тук посочих, че низът null трябва да бъдат върнати.

'nlsparam' Аргумент

Незадължителният 'nlsparam' аргумент определя езика, на който са предоставени имената и съкращенията на месеците и дните. Приема следната форма:

'NLS_DATE_LANGUAGE = language'

Пример

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

Резултат:

25-AUG-30

Имайте предвид, че резултатът все още се връща според NLS_DATE_FORMAT на текущата сесия параметър. Просто входът беше на различен език.

Ето какво се случва, когато променя agosto до August докато използвате същия 'nlsparam' стойност:

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

Резултат:

Error report -
ORA-01843: not a valid month

Това се случи, защото не предоставих датата на езика, посочен от 'nlsparam' аргумент (испански).

Променете го на English решава този проблем:

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

Резултат:

25-AUG-30

Вижте как да върнете списък с поддържани езици в Oracle, ако това помага.

Нулеви аргументи

Предаването на null води до null :

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

Резултат:

null

Невалиден брой аргументи

Извикването на функцията без предаване на аргументи води до грешка:

SELECT TO_DATE()
FROM DUAL;

Резултат:

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

И предаването на твърде много аргументи също води до грешка:

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

Резултат:

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