This documentation is for the unreleased development version of jOOQ. Click on the above version links to get this documentation for a supported version of jOOQ.
LOCALDATETIMESUB
Applies to ✅ Open Source Edition ✅ Express Edition ✅ Professional Edition ✅ Enterprise Edition
Subtract an interval of type java.lang.Number (number of days) or org.jooq.types.Interval (SQL interval type) from a timestamp (represented by java.time.LocalDateTime).
This does the same as TIMESTAMPSUB except that the client type representation uses JSR-310 types.
SELECT DATE '2020-02-03 15:30:45' - INTERVAL 2 DAYS;
create.select(localDateTimeSub(LocalDateTime.parse("2020-02-03T15:30:45"), 2)).fetch();
The result being
+---------------------+ | timestamp_sub | +---------------------+ | 2020-02-01 15:30:45 | +---------------------+
Dialect support
This example using jOOQ:
localDateTimeSub(LocalDateTime.parse("2020-02-03T15:30:45"), 2)
Translates to the following dialect specific expressions:
-- ACCESS
dateadd('d', -2, #2020/02/03 15:30:45#)
-- ASE, SYBASE
dateadd(DAY, -2, '2020-02-03 15:30:45.0')
-- AURORA_MYSQL, MEMSQL, MYSQL
date_add({ts '2020-02-03 15:30:45.0'}, INTERVAL -2 DAY)
-- AURORA_POSTGRES, COCKROACHDB, POSTGRES, REDSHIFT, YUGABYTEDB
(TIMESTAMP '2020-02-03 15:30:45.0' + -2 * INTERVAL '1 day')
-- BIGQUERY
timestamp_sub(DATETIME '2020-02-03 15:30:45.0', INTERVAL 2 DAY)
-- DB2, HSQLDB
(TIMESTAMP '2020-02-03 15:30:45.0' - (2) day)
-- DERBY
CAST({fn timestampadd(SQL_TSI_DAY, -2, TIMESTAMP('2020-02-03 15:30:45.0')) } AS TIMESTAMP)
-- DUCKDB, EXASOL, H2, ORACLE, VERTICA
(TIMESTAMP '2020-02-03 15:30:45.0' - 2)
-- FIREBIRD, SNOWFLAKE
dateadd(DAY, -2, TIMESTAMP '2020-02-03 15:30:45.0')
-- HANA
add_days(TIMESTAMP '2020-02-03 15:30:45.0', -2)
-- INFORMIX
(DATETIME(2020-02-03 15:30:45.0) YEAR TO FRACTION - 2 UNITS DAY)
-- MARIADB
date_add(TIMESTAMP '2020-02-03 15:30:45.0', INTERVAL -2 DAY)
-- SQLDATAWAREHOUSE, SQLSERVER
dateadd(DAY, -2, CAST('2020-02-03 15:30:45.0' AS DATETIME2))
-- SQLITE
strftime('%Y-%m-%d %H:%M:%f', '2020-02-03 15:30:45.0', (CAST(-2 AS varchar) || ' day'))
-- TERADATA
TIMESTAMP '2020-02-03 15:30:45.0' - CAST(2 || ' 00:00:00' AS INTERVAL DAY TO SECOND)
-- TRINO
date_add('day', -2, TIMESTAMP '2020-02-03 15:30:45.0')
(These are currently generated with jOOQ 3.19, see #10141), or translate your own on our website
Feedback
Do you have any feedback about this page? We'd love to hear it!