Hàm TO_TIMESTAMP () trong Oracle

Trong Cơ sở dữ liệu Oracle, TO_TIMESTAMP() hàm chuyển đổi đối số của nó thành giá trị TIMESTAMP kiểu dữ liệu.

Cú pháp

Cú pháp như sau:

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

Các ký tự char đối số có thể là bất kỳ biểu thức nào đánh giá thành một chuỗi ký tự của CHAR , VARCHAR2 , NCHAR hoặc NVARCHAR2 kiểu dữ liệu.

fmt tùy chọn chỉ định định dạng của char . Nếu bạn bỏ qua fmt , rồi đến char phải ở định dạng mặc định của TIMESTAMP kiểu dữ liệu, được xác định bởi NLS_TIMESTAMP_FORMAT tham số khởi tạo (xem Cách Kiểm tra Định dạng Ngày của Phiên Oracle của bạn).

'nlsparam' tùy chọn đối số chỉ định ngôn ngữ mà tên tháng và ngày và chữ viết tắt được cung cấp. Nó có dạng sau:

'NLS_DATE_LANGUAGE = language'

Ví dụ

Dưới đây là một ví dụ cơ bản để chứng minh:

SELECT 
    TO_TIMESTAMP(
        '25-Aug-2030 18:10:35.123456789', 
        'DD-Mon-RRRR HH24:MI:SS.FF'
    )
FROM DUAL;

Kết quả:

25/AUG/30 06:10:35.123456789 PM

Định dạng của kết quả được xác định bởi NLS_TIMESTAMP_FORMAT trong phiên của bạn tham số. Chúng tôi có thể kiểm tra giá trị của NLS_TIMESTAMP_FORMAT bằng cách truy vấn V$NLS_PARAMETERS xem:

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

Kết quả:

DD/MON/RR HH12:MI:SSXFF AM

Giá trị mặc định của NLS_TIMESTAMP_FORMAT tham số bắt nguồn từ NLS_TERRITORY tham số. Trong trường hợp của tôi, NLS_TERRITORY tham số là AUSTRALIA .

Đây là những gì sẽ xảy ra khi tôi thay đổi NLS_TERRITORY đến một lãnh thổ khác, sau đó gọi TO_TIMESTAMP() một lần nữa:

ALTER SESSION SET NLS_TERRITORY = 'AMERICA';
SELECT 
    TO_TIMESTAMP(
        '25-Aug-2030 18:10:35.123456789', 
        'DD-Mon-RRRR HH24:MI:SS.FF'
    )
FROM DUAL;

Kết quả:

25-AUG-30 06.10.35.123456789 PM

Lần này, kết quả được trả về ở một định dạng khác.

Ngoài ra, bạn có thể thay đổi giá trị của NLS_TIMESTAMP_FORMAT tham số trực tiếp. Thao tác này sẽ thay đổi tham số đó mà không ảnh hưởng đến các tham số khác. Xem Cách Thay đổi Định dạng Ngày trong Phiên Oracle của bạn để biết thêm thông tin và ví dụ.

Định dạng mặc định

Trong ví dụ này, tôi bỏ qua fmt đối số:

SELECT 
    TO_TIMESTAMP(
        '25-AUG-30 06.10.35.123456789 PM'
    )
FROM DUAL;

Kết quả:

25-AUG-30 06.10.35.123456789 PM

Khi thực hiện việc này, đối số phải ở định dạng mặc định của TIMESTAMP kiểu dữ liệu, được xác định bởi NLS_TIMESTAMP_FORMAT tham số khởi tạo.

Dưới đây là một ví dụ về những gì sẽ xảy ra khi chúng tôi chuyển một giá trị không tuân theo định dạng này:

SELECT 
    TO_TIMESTAMP(
        '25-Aug-2030 18:10:35.123456789'
    )
FROM DUAL;

Kết quả:

ORA-01849: hour must be between 1 and 12
01849. 00000 -  "hour must be between 1 and 12"
*Cause:    
*Action:

Trong trường hợp này, tôi đã chuyển một giá trị sử dụng thời gian 24 giờ, nhưng NLS_TIMESTAMP_FORMAT của tôi tham số chỉ định đồng hồ 12 giờ với bộ chỉ định AM / PM.

Để khắc phục điều này, tôi cần phải thay đổi đầu vào của mình hoặc thay đổi giá trị của NLS_TIMESTAMP_FORMAT tham số.

Cung cấp Giá trị Mặc định do Lỗi Chuyển đổi

Bạn cũng có tùy chọn cung cấp giá trị để trả về trong trường hợp có lỗi xảy ra khi chuyển đổi đối số thành TIMESTAMP loại.

Ví dụ:

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

Kết quả:

null

Trong trường hợp này, tôi đã chỉ định rằng null sẽ được trả lại bất cứ khi nào có lỗi chuyển đổi.

Theo mặc định, SQLcl và SQL * Plus trả về một khoảng trống bất cứ khi nào null xảy ra do một SELECT trong SQL tuyên bố.

Tuy nhiên, bạn có thể sử dụng SET NULL để chỉ định một chuỗi khác được trả về. Ở đây tôi đã chỉ định rằng chuỗi null nên được trả lại.

'nlsparam' Đối số

'nlsparam' tùy chọn đối số chỉ định ngôn ngữ mà tên tháng và ngày và chữ viết tắt được cung cấp. Nó có dạng sau:

'NLS_DATE_LANGUAGE = language'

Ví dụ

SELECT 
    TO_TIMESTAMP(
        '25-agosto-2030 18:10:35.123456789', 
        'DD-Month-RRRR HH24:MI:SS.FF',
        'NLS_DATE_LANGUAGE = SPANISH'
    )
FROM DUAL;

Kết quả:

25-AUG-30 06.10.35.123456789 PM

Lưu ý rằng kết quả vẫn được trả về theo NLS_TIMESTAMP_FORMAT của phiên hiện tại tham số. Đó chỉ là đầu vào bằng một ngôn ngữ khác.

Đây là những gì sẽ xảy ra khi tôi thay đổi agosto đến August trong khi sử dụng cùng một 'nlsparam' giá trị:

SELECT 
    TO_TIMESTAMP(
        '25-August-2030 18:10:35.123456789', 
        'DD-Month-RRRR HH24:MI:SS.FF',
        'NLS_DATE_LANGUAGE = SPANISH'
    )
FROM DUAL;

Kết quả:

ORA-01843: not a valid month
01843. 00000 -  "not a valid month"
*Cause:    
*Action:

Điều này xảy ra vì tôi không cung cấp ngày bằng ngôn ngữ được chỉ định bởi 'nlsparam' đối số (tiếng Tây Ban Nha).

Thay đổi nó thành English giải quyết vấn đề này:

SELECT 
    TO_TIMESTAMP(
        '25-August-2030 18:10:35.123456789', 
        'DD-Month-RRRR HH24:MI:SS.FF',
        'NLS_DATE_LANGUAGE = English'
    )
FROM DUAL;

Kết quả:

25-AUG-30 06.10.35.123456789 PM

Xem Cách trả lại danh sách các ngôn ngữ được hỗ trợ trong Oracle nếu nó hữu ích.

Đối số rỗng

Chuyển null kết quả là null :

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

Kết quả:

null

Số lượng đối số không hợp lệ

Việc gọi hàm mà không chuyển bất kỳ đối số nào dẫn đến lỗi:

SELECT TO_TIMESTAMP()
FROM DUAL;

Kết quả:

ORA-00938: not enough arguments for function
00938. 00000 -  "not enough arguments for function"
*Cause:    
*Action:
Error at Line: 8 Column: 8

Tuy nhiên, việc chuyển quá nhiều đối số dường như không gây ra bất kỳ vấn đề nào, miễn là ba đối số đầu tiên hợp lệ:

SELECT 
    TO_TIMESTAMP(
        '25-Aug-2030 18:10:35.123456789', 
        'DD-Mon-RRRR HH24:MI:SS.FF',
        'NLS_DATE_LANGUAGE = English',
        'Oops!',
        'Dang!',
        'Homer',
        'Symptom'
    )
FROM DUAL;

Kết quả:

25-AUG-30 06.10.35.123456789 PM