Optional namespace that extends next.jdbc.prepare/SettableParameter
to various date/time types so that they will all be treated as SQL
timestamps (which also supports date and time column types) and has
functions to extend next.jdbc.result-set/ReadableColumn
.
Simply requiring this namespace will extend the SettableParameter
protocol
to the four types listed below.
In addition, there are several read-as-*
functions here that will
extend next.jdbc.result-set/ReadableColumn
to allow java.sql.Date
and java.sql.Timestamp
columns to be read as (converted to) various
Java Time types automatically. The expectation is that you will call at
most one of these, at application startup, to enable the behavior you want.
Database support for Java Time:
Instant
, LocalDate
,
LocalDateTime
) out of the box,java.util.Date
out of
the box -- except PostgreSQL apparently!Types supported by this namespace:
java.time.Instant
java.time.LocalDate
java.time.LocalDateTime
java.util.Date
-- mainly for PostgreSQLPostgreSQL does not seem able to convert java.util.Date
to a SQL
timestamp by default (every other database can!) so you'll probably
need to require this namespace, even if you don't use Java Time, when
working with PostgreSQL.
Optional namespace that extends `next.jdbc.prepare/SettableParameter` to various date/time types so that they will all be treated as SQL timestamps (which also supports date and time column types) and has functions to extend `next.jdbc.result-set/ReadableColumn`. Simply requiring this namespace will extend the `SettableParameter` protocol to the four types listed below. In addition, there are several `read-as-*` functions here that will extend `next.jdbc.result-set/ReadableColumn` to allow `java.sql.Date` and `java.sql.Timestamp` columns to be read as (converted to) various Java Time types automatically. The expectation is that you will call at most one of these, at application startup, to enable the behavior you want. Database support for Java Time: * H2 and SQLite support conversion of Java Time (`Instant`, `LocalDate`, `LocalDateTime`) out of the box, * Nearly all databases support conversion of `java.util.Date` out of the box -- except PostgreSQL apparently! Types supported by this namespace: * `java.time.Instant` * `java.time.LocalDate` * `java.time.LocalDateTime` * `java.util.Date` -- mainly for PostgreSQL PostgreSQL does not seem able to convert `java.util.Date` to a SQL timestamp by default (every other database can!) so you'll probably need to require this namespace, even if you don't use Java Time, when working with PostgreSQL.
(read-as-default)
After calling this function, next.jdbc.result-set/ReadableColumn
will be extended to java.sql.Date
and java.sql.Timestamp
so that any
date or timestamp columns will be read as-is. This is provided for
completeness, to undo the effects of read-as-instant
or read-as-local
.
After calling this function, `next.jdbc.result-set/ReadableColumn` will be extended to `java.sql.Date` and `java.sql.Timestamp` so that any date or timestamp columns will be read as-is. This is provided for completeness, to undo the effects of `read-as-instant` or `read-as-local`.
(read-as-instant)
After calling this function, next.jdbc.result-set/ReadableColumn
will be extended to (java.sql.Date
and) java.sql.Timestamp
so that any
timestamp columns will automatically be read as java.time.Instant
.
Note that java.sql.Date
columns will still be returned as-is because they
cannot be converted to an instant (they lack a time component).
After calling this function, `next.jdbc.result-set/ReadableColumn` will be extended to (`java.sql.Date` and) `java.sql.Timestamp` so that any timestamp columns will automatically be read as `java.time.Instant`. Note that `java.sql.Date` columns will still be returned as-is because they cannot be converted to an instant (they lack a time component).
(read-as-local)
After calling this function, next.jdbc.result-set/ReadableColumn
will be extended to java.sql.Date
and java.sql.Timestamp
so that any
date or timestamp columns will automatically be read as java.time.LocalDate
or java.time.LocalDateTime
respectively.
After calling this function, `next.jdbc.result-set/ReadableColumn` will be extended to `java.sql.Date` and `java.sql.Timestamp` so that any date or timestamp columns will automatically be read as `java.time.LocalDate` or `java.time.LocalDateTime` respectively.
cljdoc is a website building & hosting documentation for Clojure/Script libraries
× close