TO_DATE(string, format_mask, [nls_language])

-- ❌ 错误写法，会报 ORA-01810 格式代码出现两次
SELECT TO_DATE('2024-12-11 14:30:45', 'YYYY-MM-DD HH24:mm:ss') FROM dual;

-- ✅ 正确写法
SELECT TO_DATE('2024-12-11 14:30:45', 'YYYY-MM-DD HH24:MI:SS') FROM dual;

-- 将 '2024-12-11' 转换为 DATE 类型
SELECT TO_DATE('2024-12-11', 'YYYY-MM-DD') FROM dual;
-- 结果：11-DEC-24（Oracle默认显示格式）

-- 带时间的转换
SELECT TO_DATE('2024-12-11 14:30:45', 'YYYY-MM-DD HH24:MI:SS') FROM dual;
-- 结果：11-DEC-24 下午 02:30:45

-- 假设有一张用户表 users(id, name, joined_date)
INSERT INTO users (id, name, joined_date) 
VALUES (1, '张三', TO_DATE('2024-12-11', 'YYYY-MM-DD'));

-- 带时间的插入
INSERT INTO users (id, name, joined_date) 
VALUES (2, '李四', TO_DATE('2024-12-11 09:30:00', 'YYYY-MM-DD HH24:MI:SS'));

-- 法语月份 "Mai" = 五月
SELECT TO_DATE('05-Mai-2025', 'DD-Mon-YYYY', 'NLS_DATE_LANGUAGE=FRENCH') FROM dual;
-- 结果：05-MAY-25

-- 中文环境下
SELECT TO_DATE('2024年12月11日', 'YYYY"年"MM"月"DD"日"', 'NLS_DATE_LANGUAGE=SIMPLIFIED CHINESE') FROM dual;

ALTER SESSION SET NLS_DATE_LANGUAGE = 'AMERICAN';
SELECT TO_CHAR(TO_DATE('2002-08-26', 'YYYY-MM-DD'), 'DAY') FROM dual;
-- 结果：MONDAY（而不是中文的"星期一"）

-- 中文环境
SELECT TO_CHAR(TO_DATE('2024-12-11', 'YYYY-MM-DD'), 'DAY', 'NLS_DATE_LANGUAGE=SIMPLIFIED CHINESE') FROM dual;
-- 结果：星期三

-- 英文环境
SELECT TO_CHAR(TO_DATE('2024-12-11', 'YYYY-MM-DD'), 'DAY', 'NLS_DATE_LANGUAGE=AMERICAN') FROM dual;
-- 结果：WEDNESDAY

-- 当前日期减去指定日期
SELECT FLOOR(SYSDATE - TO_DATE('2024-01-01', 'YYYY-MM-DD')) AS days_diff FROM dual;

-- 两个指定日期之间的天数
SELECT TO_DATE('2024-12-31', 'YYYY-MM-DD') - TO_DATE('2024-01-01', 'YYYY-MM-DD') AS days_diff FROM dual;
-- 结果：365

-- 使用 MONTHS_BETWEEN 函数
SELECT MONTHS_BETWEEN(TO_DATE('2024-12-31', 'YYYY-MM-DD'), 
                      TO_DATE('2024-01-01', 'YYYY-MM-DD')) AS months_diff 
FROM dual;
-- 结果：12

-- 非整月的情况
SELECT MONTHS_BETWEEN(TO_DATE('2024-02-01', 'YYYY-MM-DD'), 
                      TO_DATE('2024-01-01', 'YYYY-MM-DD')) AS months_diff 
FROM dual;
-- 结果：1.03225806451613（约1.03个月）

SELECT COUNT(*) AS workdays
FROM (
    SELECT ROWNUM - 1 AS rnum
    FROM all_objects
    WHERE ROWNUM <= TO_DATE('2024-02-28', 'YYYY-MM-DD') - TO_DATE('2024-02-01', 'YYYY-MM-DD') + 1
)
WHERE TO_CHAR(TO_DATE('2024-02-01', 'YYYY-MM-DD') + rnum - 1, 'D') NOT IN ('1', '7');
-- 结果：20（2024年2月1日到28日之间，排除周六周日的工作日天数）

-- 查询时需要用 TO_DATE(NULL) 而不是 NULL
SELECT id, active_date FROM table1
UNION
SELECT 1, TO_DATE(NULL) FROM dual;

SELECT TO_CHAR(SYSDATE, '"今天是" DD"日" MONTH", "YYYY"年"') AS custom_date FROM dual;
-- 结果：今天是 22日 MAY    , 2026年

SELECT TO_CHAR(SYSDATE, 'YYYY"年"MM"月"DD"日" HH24"时"MI"分"SS"秒"') FROM dual;
-- 结果：2026年05月22日 15时30分45秒

-- 以下写法依赖默认格式，不推荐！
INSERT INTO x VALUES (99, '31-may-98');

-- 推荐写法，显式指定格式
INSERT INTO x VALUES (99, TO_DATE('1998/05/31:12:00:00AM', 'yyyy/mm/dd:hh:mi:ssam'));

-- ✅ 正确：12小时制 + AM/PM
TO_DATE('02:30:00 PM', 'HH:MI:SS AM')

-- ✅ 正确：24小时制，不需要AM/PM
TO_DATE('14:30:00', 'HH24:MI:SS')

-- ❌ 错误：24小时制配了AM/PM，或者12小时制没配AM/PM
TO_DATE('14:30:00 PM', 'HH24:MI:SS AM')  -- 逻辑矛盾！

-- 假设 joined_date 是 DATE 类型，包含时间
-- 以下查询可能不包含 12月31日 12:00:00 之后的记录
SELECT * FROM users 
WHERE joined_date BETWEEN TO_DATE('2024-12-01', 'YYYY-MM-DD') 
                      AND TO_DATE('2024-12-31', 'YYYY-MM-DD');

-- 更精确的写法
SELECT * FROM users 
WHERE joined_date >= TO_DATE('2024-12-01', 'YYYY-MM-DD')
  AND joined_date < TO_DATE('2025-01-01', 'YYYY-MM-DD');

SELECT * FROM NLS_SESSION_PARAMETERS WHERE PARAMETER LIKE '%DATE%';
SELECT * FROM V$NLS_PARAMETERS WHERE PARAMETER LIKE '%DATE%';

-- 当前时间加10天
SELECT SYSDATE + 10 AS future_date FROM dual;

-- 当前时间减5天
SELECT SYSDATE - 5 AS past_date FROM dual;

-- 加3个月
SELECT ADD_MONTHS(SYSDATE, 3) FROM dual;

-- 减7个月
SELECT ADD_MONTHS(SYSDATE, -7) FROM dual;

-- 当前时间减7分钟
SELECT SYSDATE, SYSDATE - INTERVAL '7' MINUTE FROM dual;

-- 当前时间减7小时
SELECT SYSDATE - INTERVAL '7' HOUR FROM dual;

-- 当前时间减7天
SELECT SYSDATE - INTERVAL '7' DAY FROM dual;

-- 当前时间减7月
SELECT SYSDATE - INTERVAL '7' MONTH FROM dual;

-- 获取本月最后一天
SELECT LAST_DAY(SYSDATE) FROM dual;
-- 结果：2026-05-31

-- 获取下一个周五
SELECT NEXT_DAY(SYSDATE, 'FRIDAY') FROM dual;
-- 或使用中文
SELECT NEXT_DAY(SYSDATE, '星期五') FROM dual;

-- 截断到月份第一天
SELECT TRUNC(SYSDATE, 'MM') FROM dual;
-- 结果：2026-05-01

-- 截断到年份第一天
SELECT TRUNC(SYSDATE, 'YYYY') FROM dual;
-- 结果：2026-01-01

-- 截断到当天（去掉时分秒）
SELECT TRUNC(SYSDATE) FROM dual;

SELECT EXTRACT(YEAR FROM SYSDATE) AS current_year,
       EXTRACT(MONTH FROM SYSDATE) AS current_month,
       EXTRACT(DAY FROM SYSDATE) AS current_day
FROM dual;
-- 结果：2026 | 5 | 22

ALTER SESSION SET NLS_DATE_FORMAT = 'YYYY-MM-DD HH24:MI:SS';
ALTER SESSION SET NLS_DATE_LANGUAGE = 'SIMPLIFIED CHINESE';

SELECT TO_CHAR(CURRENT_TIMESTAMP(3), 'YYYY-MM-DD HH24:MI:SS.FF3') FROM dual;
-- 结果：2026-05-22 15:30:45.123

-- ✅ 推荐
SELECT * FROM orders WHERE order_date = TO_DATE(:date_str, 'YYYY-MM-DD');

-- ❌ 不推荐（有SQL注入风险）
SELECT * FROM orders WHERE order_date = '''' || :date_str || '''';