(abs a)
Returns the absolute value of a temporal amount:
(abs (negate x)) == (abs x)
Returns the absolute value of a temporal amount: (abs (negate x)) == (abs x)
(abuts? i oi)
True if this interval abut with the other one
True if this interval abut with the other one
(adjust entity adjuster & args)
Adjusts the temporal entity
using the provided adjuster
with optional args
.
The adjuster should either be a keyword which resolves to one of the
predefined adjusters (see java-time.repl/show-adjusters
) an instance of
TemporalAdjuster
or a function which returns another temporal entity when
applied to the given one:
(adjust (local-date 2015 1 1) :next-working-day) => #<LocalDate 2015-1-2>
(adjust (local-date 2015 1 1) :first-in-month :monday) => #<LocalDate 2015-1-5>
(adjust (local-date 2015 1 1) plus (days 1)) => #<LocalDate 2015-1-2>
Adjusts the temporal `entity` using the provided `adjuster` with optional `args`. The adjuster should either be a keyword which resolves to one of the predefined adjusters (see `java-time.repl/show-adjusters`) an instance of `TemporalAdjuster` or a function which returns another temporal entity when applied to the given one: (adjust (local-date 2015 1 1) :next-working-day) => #<LocalDate 2015-1-2> (adjust (local-date 2015 1 1) :first-in-month :monday) => #<LocalDate 2015-1-5> (adjust (local-date 2015 1 1) plus (days 1)) => #<LocalDate 2015-1-2>
(advance-clock! clock amount)
Advances the clock
by the given time amount
.
This mutates the mock clock.
Advances the `clock` by the given time `amount`. This mutates the mock clock.
(after? x)
(after? x y)
(after? x y & more)
Returns non-nil if time entities are ordered from the latest to the earliest
(same semantics as >
):
(after? (local-date 2011) (local-date 2010) (local-date 2009)) => truthy...
(after? (instant 99999999) (interval (instant 10000) (instant 1000000))) => truthy...
Returns non-nil if time entities are ordered from the latest to the earliest (same semantics as `>`): (after? (local-date 2011) (local-date 2010) (local-date 2009)) => truthy... (after? (instant 99999999) (interval (instant 10000) (instant 1000000))) => truthy...
(am-pm)
(am-pm v__3938__auto__)
(am-pm fmt__3939__auto__ arg__3940__auto__)
Returns the AmPm
for the given keyword name (:am
or :pm
),
ordinal or entity. Current AM/PM if no arguments given.
Returns the `AmPm` for the given keyword name (`:am` or `:pm`), ordinal or entity. Current AM/PM if no arguments given.
(as o k)
(as o k1 k2)
(as o k1 k2 & ks)
Values of property/unit identified by keys/objects ks
of the temporal
entity o
, e.g.
(as (duration 1 :hour) :minutes) => 60
(as (local-date 2015 9) :year :month-of-year) => [2015 9]
Values of property/unit identified by keys/objects `ks` of the temporal entity `o`, e.g. (as (duration 1 :hour) :minutes) => 60 (as (local-date 2015 9) :year :month-of-year) => [2015 9]
(as-map e)
(as-map e value-fn)
Converts a time entity to a map of property key -> value as defined by the
passed in value-fn
. By default the actual value of the unit/field is
produced.
(as-map (duration)) => {:nanos 0, :seconds 0}
(as-map (local-date 2015 1 1)) => {:year 2015, :month-of-year 1, :day-of-month 1, ...}
Converts a time entity to a map of property key -> value as defined by the passed in `value-fn`. By default the actual value of the unit/field is produced. (as-map (duration)) => {:nanos 0, :seconds 0} (as-map (local-date 2015 1 1)) => {:year 2015, :month-of-year 1, :day-of-month 1, ...}
(before? x)
(before? x y)
(before? x y & more)
Returns non-nil if time entities are ordered from the earliest to the latest
(same semantics as <
):
(before? (local-date 2009) (local-date 2010) (local-date 2011)) => truthy...
(before? (interval (instant 10000) (instant 1000000)) (instant 99999999)) => truthy...
Returns non-nil if time entities are ordered from the earliest to the latest (same semantics as `<`): (before? (local-date 2009) (local-date 2010) (local-date 2011)) => truthy... (before? (interval (instant 10000) (instant 1000000)) (instant 99999999)) => truthy...
(chronology o)
The Chronology
of the entity
The `Chronology` of the entity
(clock? x)
Returns true if x
is an instance of java.time.Clock
.
Returns true if `x` is an instance of `java.time.Clock`.
(contains? i o)
True if the interval contains the given instant or interval
True if the interval contains the given instant or interval
(convert-amount amount from-unit to-unit)
Converts an amount from one unit to another. Returns a map of:
:whole
- the whole part of the conversion in the to
unit:remainder
- the remainder in the from
unitArguments may be keywords or instances of TemporalUnit
.
Converts between precise units - nanos up to weeks, treating days as exact
multiples of 24 hours. Also converts between imprecise units - months up to
millenia. See ChronoUnit
and IsoFields
for all of the supported units.
Does not convert between precise and imprecise units.
Throws ArithmeticException
if long overflow occurs during computation.
(convert-amount 10000 :seconds :hours) => {:remainder 2800 :whole 2}
Converts an amount from one unit to another. Returns a map of: * `:whole` - the whole part of the conversion in the `to` unit * `:remainder` - the remainder in the `from` unit Arguments may be keywords or instances of `TemporalUnit`. Converts between precise units - nanos up to weeks, treating days as exact multiples of 24 hours. Also converts between imprecise units - months up to millenia. See `ChronoUnit` and `IsoFields` for all of the supported units. Does not convert between precise and imprecise units. Throws `ArithmeticException` if long overflow occurs during computation. (convert-amount 10000 :seconds :hours) => {:remainder 2800 :whole 2}
(day-of-month)
(day-of-month G__4146)
(day-of-month fmt__3971__auto__ arg__3972__auto__)
Returns the DayOfMonth
for the given entity, clock, zone or day of month.
Current day of month if no arguments given.
Returns the `DayOfMonth` for the given entity, clock, zone or day of month. Current day of month if no arguments given.
(day-of-week)
(day-of-week v__3938__auto__)
(day-of-week fmt__3939__auto__ arg__3940__auto__)
Returns the DayOfWeek
for the given day keyword name (e.g. :monday
),
ordinal or entity. Current day if no arguments given.
Returns the `DayOfWeek` for the given day keyword name (e.g. `:monday`), ordinal or entity. Current day if no arguments given.
(day-of-year)
(day-of-year G__4157)
(day-of-year fmt__3971__auto__ arg__3972__auto__)
Returns the DayOfYear
for the given entity, clock, zone or day of year.
Current day of year if no arguments given.
Returns the `DayOfYear` for the given entity, clock, zone or day of year. Current day of year if no arguments given.
(duration)
(duration arg_1_3362)
(duration arg_1_3363 arg_2_3364)
Creates a duration - a temporal entity representing standard days, hours, minutes, millis, micros and nanos. The duration itself contains only seconds and nanos as properties.
Given one argument will
TemporalAmount
Given two arguments will
Temporal
s(duration 100 :seconds)
Creates a duration - a temporal entity representing standard days, hours, minutes, millis, micros and nanos. The duration itself contains only seconds and nanos as properties. Given one argument will * interpret as millis if a number * try to parse from the standard format if a string * extract supported units from another `TemporalAmount` * convert from a Joda Period/Duration Given two arguments will * get a duration between two `Temporal`s * get a duration of a specified unit, e.g. `(duration 100 :seconds)`
(duration? v__2432__auto__)
True if an instance of Duration.
True if an instance of Duration.
(end i)
Gets the end instant of the interval
Gets the end instant of the interval
(field k)
(field entity k)
Returns a TemporalField
for the given key k
or extracts the field from
the given temporal entity
.
You can see predefined fields via java-time.repl/show-fields
.
If you want to make your own custom TemporalFields resolvable, you need to rebind the
java-time.properties/*fields*
to a custom java-time.properties.FieldGroup
.
Returns a `TemporalField` for the given key `k` or extracts the field from the given temporal `entity`. You can see predefined fields via `java-time.repl/show-fields`. If you want to make your own custom TemporalFields resolvable, you need to rebind the `java-time.properties/*fields*` to a custom `java-time.properties.FieldGroup`.
(field? o)
True if this is a TemporalField
.
True if this is a `TemporalField`.
(fields o)
Fields present in this temporal entity
Fields present in this temporal entity
(fixed-clock)
(fixed-clock i)
(fixed-clock i z)
Creates a fixed clock either at the current instant or at the supplied instant/instant + zone.
Creates a fixed clock either at the current instant or at the supplied instant/instant + zone.
(format o)
(format fmt o)
Formats the given time entity as a string.
Accepts something that can be converted to a DateTimeFormatter
as a first
argument. Given one argument uses the default format.
Formats the given time entity as a string. Accepts something that can be converted to a `DateTimeFormatter` as a first argument. Given one argument uses the default format.
(formatter fmt)
(formatter fmt {:keys [resolver-style]})
Constructs a DateTimeFormatter out of a
Accepts a map of options as an optional second argument:
resolver-style
- either :strict
, :smart
or :lenient
Constructs a DateTimeFormatter out of a * format string - "YYYY/mm/DD", "YYY HH:MM", etc. * formatter name - :date, :time-no-millis, etc. Accepts a map of options as an optional second argument: * `resolver-style` - either `:strict`, `:smart `or `:lenient`
(friday? o__4702__auto__)
Returns true if the given time entity with the
day-of-week
property falls on a friday.
Returns true if the given time entity with the `day-of-week` property falls on a friday.
(gap i oi)
Gets the gap between this interval and the other one or nil
Gets the gap between this interval and the other one or `nil`
(hours v__3388__auto__)
Duration of a specified number of hours.
Duration of a specified number of hours.
(instant)
(instant arg_1_2958)
(instant arg_1_2959 arg_2_2960)
Creates an Instant
. The following arguments are supported:
Creates an `Instant`. The following arguments are supported: * no arguments - current instant * one argument + clock + java.util.Date/Calendar + another temporal entity + string representation + millis from epoch * two arguments + formatter (format) and a string
(instant->sql-timestamp instant-or-millis)
Creates a java.sql.Timestamp
from the provided instant-or-millis
- a
millisecond numeric time value or something convertible to an Instant
.
Please consider using the JSR-310 Java Time types instead of
java.sql.Timestamp
if your drivers support them.
java.sql.Timestamp
is a version of a java.util.Date
supposed to be used
as a local date-time (no timezone) for the purposes of conversion from/to native
JDBC driver TIMESTAMP types.
Creates a `java.sql.Timestamp` from the provided `instant-or-millis` - a millisecond numeric time value or something convertible to an `Instant`. Please consider using the JSR-310 Java Time types instead of `java.sql.Timestamp` if your drivers support them. `java.sql.Timestamp` is a version of a `java.util.Date` supposed to be used as a local date-time (no timezone) for the purposes of conversion from/to native JDBC driver TIMESTAMP types.
(instant? v__2432__auto__)
True if an instance of Instant.
True if an instance of Instant.
(interval o)
(interval a b)
Constructs an interval out of a string, start and end instants or a start
(j/interval "2010-01-01T00:00:00Z/2013-01-01T00:00:00Z") => #<Interval 2010-01-01T00:00:00Z/2013-01-01T00:00:00Z>
(j/interval (j/instant 100000) (j/instant 1000000)) => #<Interval 1970-01-01T00:01:40Z/1970-01-01T00:16:40Z>
(j/interval (j/instant 100000) (j/duration 15 :minutes)) => #<Interval 1970-01-01T00:01:40Z/1970-01-01T00:16:40Z>
Constructs an interval out of a string, start and end instants or a start + duration: (j/interval "2010-01-01T00:00:00Z/2013-01-01T00:00:00Z") => #<Interval 2010-01-01T00:00:00Z/2013-01-01T00:00:00Z> (j/interval (j/instant 100000) (j/instant 1000000)) => #<Interval 1970-01-01T00:01:40Z/1970-01-01T00:16:40Z> (j/interval (j/instant 100000) (j/duration 15 :minutes)) => #<Interval 1970-01-01T00:01:40Z/1970-01-01T00:16:40Z>
(iterate f initial v & vs)
Returns a lazy sequence of initial
, (apply f initial v vs)
, etc.
Useful when you want to produce a sequence of temporal entities, for example:
(iterate plus (days 0) 1) => (#<Period P0D> #<Period P1D> #<Period P2D> ...)
(iterate plus (local-date 2010 1 1) (years 1)) => (#<LocalDate 2010-01-01> #<LocalDate 2011-01-01> ...)
(iterate adjust (local-date 2010 1 1) :next-working-day) => (#<LocalDate 2010-01-01> #<LocalDate 2010-01-04> ...)
Returns a lazy sequence of `initial` , `(apply f initial v vs)`, etc. Useful when you want to produce a sequence of temporal entities, for example: (iterate plus (days 0) 1) => (#<Period P0D> #<Period P1D> #<Period P2D> ...) (iterate plus (local-date 2010 1 1) (years 1)) => (#<LocalDate 2010-01-01> #<LocalDate 2011-01-01> ...) (iterate adjust (local-date 2010 1 1) :next-working-day) => (#<LocalDate 2010-01-01> #<LocalDate 2010-01-04> ...)
(java-date)
(java-date a)
(java-date a b)
Creates a java.util.Date
out of any combination of arguments valid for
java-time/instant
or the Instant itself.
A java.util.Date
represents an instant in time. It's a direct analog of the
java.time.Instant
type introduced in the JSR-310. Please consider using the
java.time.Instant
(through java-time/instant
) directly.
Creates a `java.util.Date` out of any combination of arguments valid for `java-time/instant` or the Instant itself. A `java.util.Date` represents an instant in time. It's a direct analog of the `java.time.Instant` type introduced in the JSR-310. Please consider using the `java.time.Instant` (through `java-time/instant`) directly.
(largest-min-value p)
Largest minimum value of this property
Largest minimum value of this property
(leap? o)
True if the year of this entity is a leap year.
True if the year of this entity is a leap year.
(local-date)
(local-date arg_1_2997)
(local-date arg_1_2998 arg_2_2999)
(local-date arg_1_3000 arg_2_3001 arg_3_3002)
Creates a LocalDate
. The following arguments are supported:
Creates a `LocalDate`. The following arguments are supported: * no arguments - current local-date * one argument + clock + another temporal entity + string representation + year * two arguments + formatter (format) and a string + an instant and a zone id + another temporal entity and an offset (preserves local time) + year and month * three arguments + year, month and date
(local-date-time)
(local-date-time arg_1_3077)
(local-date-time arg_1_3078 arg_2_3079)
(local-date-time arg_1_3080 arg_2_3081 arg_3_3082)
(local-date-time y m d h)
(local-date-time y m d h mm)
(local-date-time y m d h mm ss)
(local-date-time y m d h mm ss n)
Creates a LocalDateTime
. The following arguments are supported:
three and more arguments - year/month/day/...
Creates a `LocalDateTime`. The following arguments are supported: * no arguments - current local date-time * one argument + clock + another temporal entity + string representation + year * two arguments + local date and local time + an instant and a zone id + formatter (format) and a string + year and month three and more arguments - year/month/day/...
(local-date-time? v__2432__auto__)
True if an instance of LocalDateTime.
True if an instance of LocalDateTime.
(local-date? v__2432__auto__)
True if an instance of LocalDate.
True if an instance of LocalDate.
(local-time)
(local-time arg_1_3037)
(local-time arg_1_3038 arg_2_3039)
(local-time arg_1_3040 arg_2_3041 arg_3_3042)
(local-time h m s nn)
Creates a LocalTime
. The following arguments are supported:
Creates a `LocalTime`. The following arguments are supported: * no arguments - current local time * one argument + clock + another temporal entity + string representation + hours * two arguments + formatter (format) and a string + an instant and a zone id + hours and minutes * three/four arguments - hour, minute, second, nanos
(local-time? v__2432__auto__)
True if an instance of LocalTime.
True if an instance of LocalTime.
(max o & os)
Latest/longest of the given time entities. Entities should be of the same type
Latest/longest of the given time entities. Entities should be of the same type
(max-value p)
Maximum value of this property, e.g. 29th of February for months
Maximum value of this property, e.g. 29th of February for months
(micros micros)
Duration of a specified number of microseconds.
Duration of a specified number of microseconds.
(millis v__3388__auto__)
Duration of a specified number of millis.
Duration of a specified number of millis.
(min o & os)
Earliest/shortest of the given time entities. Entities should be of the same type
Earliest/shortest of the given time entities. Entities should be of the same type
(min-value p)
Minimum value of this property
Minimum value of this property
(minus o & os)
Subtracts all of the os
from the time entity o
(j/minus (j/local-date 2015) (j/years 1)) => <java.time.LocalDate "2014-01-01">
Subtracts all of the `os` from the time entity `o` (j/minus (j/local-date 2015) (j/years 1)) => <java.time.LocalDate "2014-01-01">
(minutes v__3388__auto__)
Duration of a specified number of minutes.
Duration of a specified number of minutes.
(mock-clock)
(mock-clock instant)
(mock-clock instant zone)
Returns a mock implementation of the java.time.Clock
. The mock supports
advance-clock!
operation which allows to move the time in the clock, e.g.:
(let [clock (mock-clock 0 "UTC")] (with-clock clock (is (= (value clock) 0)) (is (= (instant) (instant 0))) (advance-clock! clock (j/millis 1)) (is (= (value clock) 1)) (is (= (instant) (instant 1)))))
You can move the clock back via advancing by a negative temporal amount.
Creates a clock at epoch in the default timezone when called without arguments.
Returns a mock implementation of the `java.time.Clock`. The mock supports `advance-clock!` operation which allows to move the time in the clock, e.g.: (let [clock (mock-clock 0 "UTC")] (with-clock clock (is (= (value clock) 0)) (is (= (instant) (instant 0))) (advance-clock! clock (j/millis 1)) (is (= (value clock) 1)) (is (= (instant) (instant 1))))) You can move the clock back via advancing by a negative temporal amount. Creates a clock at epoch in the default timezone when called without arguments.
(monday? o__4702__auto__)
Returns true if the given time entity with the
day-of-week
property falls on a monday.
Returns true if the given time entity with the `day-of-week` property falls on a monday.
(month)
(month v__3938__auto__)
(month fmt__3939__auto__ arg__3940__auto__)
Returns the Month
for the given month keyword name (e.g. :january
),
ordinal or entity. Current month if no arguments given.
Returns the `Month` for the given month keyword name (e.g. `:january`), ordinal or entity. Current month if no arguments given.
(month-day)
(month-day G__4064)
(month-day a__3984__auto__ b__3985__auto__)
Returns the MonthDay
for the given entity, string, clock, zone or
month/day combination. Current month-day if no arguments given.
Returns the `MonthDay` for the given entity, string, clock, zone or month/day combination. Current month-day if no arguments given.
(move-end-by i & os)
Moves the end instant of the interval by the sum of given periods/durations/numbers of milliseconds.
(move-start-by (interval 0 10000) (millis 1000) (seconds 1)) => #<Interval ...:00Z/...:12Z>
Fails if the new end instant falls before the start instant.
(move-end-by (interval 0 10000) (millis -11000)) => DateTimeException...
Moves the end instant of the interval by the sum of given periods/durations/numbers of milliseconds. (move-start-by (interval 0 10000) (millis 1000) (seconds 1)) => #<Interval ...:00Z/...:12Z> Fails if the new end instant falls before the start instant. (move-end-by (interval 0 10000) (millis -11000)) => DateTimeException...
(move-end-to i new-end)
Moves the end of the interval to the given instant (or something convertible to an instant):
(move-end-to (interval 0 10000) (instant 15000)) => #<Interval ...:00Z/...:15Z>
Fails if the new end instant falls before the start instant:
(move-end-to (interval 0 10000) (millis -1)) => DateTimeException...
Moves the end of the interval to the given instant (or something convertible to an instant): (move-end-to (interval 0 10000) (instant 15000)) => #<Interval ...:00Z/...:15Z> Fails if the new end instant falls before the start instant: (move-end-to (interval 0 10000) (millis -1)) => DateTimeException...
(move-start-by i & os)
Moves the start instant of the interval by the sum of given periods/durations/numbers of milliseconds:
(move-start-by (interval 0 10000) (millis 1000) (seconds 1)) => #<Interval ...:02Z/...:10Z>
Fails if the new start instant falls after the end instant.
(move-start-by (interval 0 10000) (millis 11000)) ; => DateTimeException...
Moves the start instant of the interval by the sum of given periods/durations/numbers of milliseconds: (move-start-by (interval 0 10000) (millis 1000) (seconds 1)) => #<Interval ...:02Z/...:10Z> Fails if the new start instant falls after the end instant. (move-start-by (interval 0 10000) (millis 11000)) ; => DateTimeException...
(move-start-to i new-start)
Moves the start instant of the interval to the given instant (or something convertible to an instant):
(move-start-to (interval 0 10000) (instant 5000)) => #<Interval ...:05Z/...:10Z>
Fails if the new start instant falls after the end instant:
(move-start-to (interval 0 10000) (millis 15000)) => DateTimeException...
Moves the start instant of the interval to the given instant (or something convertible to an instant): (move-start-to (interval 0 10000) (instant 5000)) => #<Interval ...:05Z/...:10Z> Fails if the new start instant falls after the end instant: (move-start-to (interval 0 10000) (millis 15000)) => DateTimeException...
(multiply-by o v)
Entity o
mutlitplied by the value v
Entity `o` mutlitplied by the value `v`
(nanos v__3388__auto__)
Duration of a specified number of nanos.
Duration of a specified number of nanos.
(negate a)
Negates a temporal amount:
(negate (negate x)) == x
Negates a temporal amount: (negate (negate x)) == x
(negative? a)
True if the amount is negative
True if the amount is negative
(offset-clock d)
(offset-clock c d)
Creates a clock offset from the current/provided clock by a given
duration
.
Creates a clock offset from the current/provided clock by a given `duration`.
(offset-date-time)
(offset-date-time arg_1_3581)
(offset-date-time arg_1_3582 arg_2_3583)
(offset-date-time arg_1_3584 arg_2_3585 arg_3_3586)
(offset-date-time y m d h)
(offset-date-time y mo d h m)
(offset-date-time y mo d h m s)
(offset-date-time y mo d h m s n)
(offset-date-time y mo d h m s n o)
Creates an OffsetDateTime
. The following arguments are supported:
If zone offset is not specified, default will be used. You can check the
default offset by invoking (zone-offset)
.
Creates an `OffsetDateTime`. The following arguments are supported: * no arguments - current date-time with the default offset * one argument + clock + another temporal entity + string representation + year * two arguments + formatter (format) and a string + local date-time and an offset + another temporal entity and an offset (preserves local time) + year and month * three arguments + local date, local time and an offset + year, month and date * four up to seven arguments - position date-time constructors * eight arguments - time fields up to nanoseconds and a zone offset If zone offset is not specified, default will be used. You can check the default offset by invoking `(zone-offset)`.
(offset-date-time? v__2432__auto__)
True if an instance of OffsetDateTime.
True if an instance of OffsetDateTime.
(offset-time)
(offset-time arg_1_3621)
(offset-time arg_1_3622 arg_2_3623)
(offset-time h m s)
(offset-time h m s n)
(offset-time h m s n o)
Creates an OffsetTime
. The following arguments are supported:
If zone offset is not specified, default will be used. You can check the
default offset by invoking (zone-offset)
.
Creates an `OffsetTime`. The following arguments are supported: * no arguments - current time with the default offset * one argument + clock + zone id + another temporal entity + string representation + hour * two arguments + formatter (format) and a string + local time and an offset + instant and an offset + hour and minutes * three arguments - hours, minutes, seconds * four arguments - hours, minutes, seconds, nanos * five arguments - last is the offset If zone offset is not specified, default will be used. You can check the default offset by invoking `(zone-offset)`.
(offset-time? v__2432__auto__)
True if an instance of OffsetTime.
True if an instance of OffsetTime.
(overlap i oi)
Gets the overlap between this interval and the other one or nil
Gets the overlap between this interval and the other one or `nil`
(overlaps? i oi)
True if this interval overlaps the other one
True if this interval overlaps the other one
(period)
(period arg_1_3422)
(period arg_1_3423 arg_2_3424)
(period arg_1_3425 arg_2_3426 arg_3_3427)
Creates a period - a temporal entity consisting of years, months and days.
Given one argument will
TemporalAmount
Given two arguments will
(period 10 :months)
Given three arguments will create a year/month/day period.
Creates a period - a temporal entity consisting of years, months and days. Given one argument will * interpret as years if a number * try to parse from the standard format if a string * extract supported units from another `TemporalAmount` * convert from a Joda Period Given two arguments will * get a period of a specified unit, e.g. `(period 10 :months)` * get a period between two temporals by converting them to local dates * get a period of a specified number of years and months Given three arguments will create a year/month/day period.
(period? v__2432__auto__)
True if an instance of Period.
True if an instance of Period.
(plus o & os)
Adds all of the os
to the time entity o
(j/plus (j/local-date 2015) (j/years 1)) => <java.time.LocalDate "2016-01-01">
Adds all of the `os` to the time entity `o` (j/plus (j/local-date 2015) (j/years 1)) => <java.time.LocalDate "2016-01-01">
(properties o)
Map of properties present in this temporal entity
Map of properties present in this temporal entity
(property o k)
Property of this temporal entity under key k
Property of this temporal entity under key `k`
(quarter)
(quarter v__3938__auto__)
(quarter fmt__3939__auto__ arg__3940__auto__)
Returns the Quarter
for the given quarter keyword name (e.g. :q1
),
ordinal or entity. Current quarter if no arguments given.
Returns the `Quarter` for the given quarter keyword name (e.g. `:q1`), ordinal or entity. Current quarter if no arguments given.
(range p)
Range of values for this property
Range of values for this property
(saturday? o__4702__auto__)
Returns true if the given time entity with the
day-of-week
property falls on a saturday.
Returns true if the given time entity with the `day-of-week` property falls on a saturday.
(seconds v__3388__auto__)
Duration of a specified number of seconds.
Duration of a specified number of seconds.
(set-clock! clock time)
Sets the clock
to the given time
.
This mutates the mock clock.
Sets the `clock` to the given `time`. This mutates the mock clock.
(smallest-max-value p)
Smallest maximum value of this property, e.g. 28th of February for months
Smallest maximum value of this property, e.g. 28th of February for months
(sql-date)
(sql-date G__4582)
(sql-date G__4583 G__4584)
(sql-date G__4585 G__4586 G__4587)
Creates a java.sql.Date
out of any combination of arguments valid for
java-time/local-date
or the LocalDate
itself.
Please consider using the JSR-310 Java Time types instead of java.sql.Date
if your drivers support them.
Even though java.sql.Date
extends a java.util.Date
, it's supposed to be
used as a local date (no time component or timezone) for the purposes of
conversion from/to native JDBC driver DATE types.
Creates a `java.sql.Date` out of any combination of arguments valid for `java-time/local-date` or the `LocalDate` itself. Please consider using the JSR-310 Java Time types instead of `java.sql.Date` if your drivers support them. Even though `java.sql.Date` extends a `java.util.Date`, it's supposed to be used as a local date (no time component or timezone) for the purposes of conversion from/to native JDBC driver DATE types.
(sql-time)
(sql-time G__4619)
(sql-time G__4620 G__4621)
(sql-time G__4622 G__4623 G__4624)
Creates a java.sql.Time
out of any combination of arguments valid for
java-time/local-time
(except the nanos constructor) or the LocalTime
itself.
Please consider using the JSR-310 Java Time types instead of java.sql.Time
if your drivers support them.
Even though java.sql.Time
extends a java.util.Date
, it's supposed to be
used as a local time (no date component or timezone) for the purposes of
conversion from/to native JDBC driver TIME types.
Creates a `java.sql.Time` out of any combination of arguments valid for `java-time/local-time` (except the nanos constructor) or the `LocalTime` itself. Please consider using the JSR-310 Java Time types instead of `java.sql.Time` if your drivers support them. Even though `java.sql.Time` extends a `java.util.Date`, it's supposed to be used as a local time (no date component or timezone) for the purposes of conversion from/to native JDBC driver TIME types.
(sql-timestamp)
(sql-timestamp G__4589)
(sql-timestamp G__4590 G__4591)
(sql-timestamp G__4592 G__4593 G__4594)
(sql-timestamp G__4595 G__4596 G__4597 G__4598)
(sql-timestamp G__4599 G__4600 G__4601 G__4602 G__4603)
(sql-timestamp G__4604 G__4605 G__4606 G__4607 G__4608 G__4609)
(sql-timestamp G__4610 G__4611 G__4612 G__4613 G__4614 G__4615 G__4616)
Creates a java.sql.Timestamp
in the local timezone out of any combination
of arguments valid for java-time/local-date-time
or the LocalDateTime
itself.
The sql-timestamp
constructor function does not support Timestamp
construction from an Instant
or a long millis value. Please use
instant->sql-timestamp
for this purpose.
Please consider using the JSR-310 Java Time types instead of
java.sql.Timestamp
if your drivers support them.
java.sql.Timestamp
is a version of a java.util.Date
supposed to be used
as a local date-time (no timezone) for the purposes of conversion from/to native
JDBC driver TIMESTAMP types.
Creates a `java.sql.Timestamp` in the local timezone out of any combination of arguments valid for `java-time/local-date-time` or the `LocalDateTime` itself. The `sql-timestamp` constructor function does not support `Timestamp` construction from an `Instant` or a long millis value. Please use `instant->sql-timestamp` for this purpose. Please consider using the JSR-310 Java Time types instead of `java.sql.Timestamp` if your drivers support them. `java.sql.Timestamp` is a version of a `java.util.Date` supposed to be used as a local date-time (no timezone) for the purposes of conversion from/to native JDBC driver TIMESTAMP types.
(standard-days v__3388__auto__)
Duration of a specified number of days.
Duration of a specified number of days.
(start i)
Gets the start instant of the interval
Gets the start instant of the interval
(sunday? o__4702__auto__)
Returns true if the given time entity with the
day-of-week
property falls on a sunday.
Returns true if the given time entity with the `day-of-week` property falls on a sunday.
(supports? o p)
True if the o
entity supports the p
property
True if the `o` entity supports the `p` property
(system-clock)
(system-clock k)
Creates a system clock. In the default timezone if called without arguments, otherwise accepts a Zone Id.
Creates a system clock. In the default timezone if called without arguments, otherwise accepts a Zone Id.
(thursday? o__4702__auto__)
Returns true if the given time entity with the
day-of-week
property falls on a thursday.
Returns true if the given time entity with the `day-of-week` property falls on a thursday.
(tick-clock d)
(tick-clock c d)
Creates a clock wrapping system/provided clock that only ticks as per specified duration.
Creates a clock wrapping system/provided clock that only ticks as per specified duration.
(time-between o e u)
Time between temporal entities o
and e
in unit u
.
(j/time-between (j/local-date 2015) (j/local-date 2016) :days) => 365
(j/time-between :days (j/local-date 2015) (j/local-date 2016)) => 365
Time between temporal entities `o` and `e` in unit `u`. (j/time-between (j/local-date 2015) (j/local-date 2016) :days) => 365 (j/time-between :days (j/local-date 2015) (j/local-date 2016)) => 365
(to-java-date o)
Converts a date entity to a java.util.Date
.
Deprecated:
This function only has a single arity and works for entities directly
convertible to java.time.Instant
. Please consider using java-date
instead.
Converts a date entity to a `java.util.Date`. *Deprecated*: This function only has a single arity and works for entities directly convertible to `java.time.Instant`. Please consider using `java-date` instead.
(to-millis-from-epoch o)
Converts a date entity to a long
representing the number of milliseconds
from epoch.
Converts a date entity to a `long` representing the number of milliseconds from epoch.
(to-sql-date o)
Converts a local date entity to a java.sql.Date
.
Deprecated:
This function only has a single arity and works for entities directly
convertible to java.time.LocalDate
. Please consider using sql-date
instead.
Converts a local date entity to a `java.sql.Date`. *Deprecated*: This function only has a single arity and works for entities directly convertible to `java.time.LocalDate`. Please consider using `sql-date` instead.
(to-sql-timestamp o)
Converts a date entity to a java.sql.Timestamp
.
Deprecated:
This function only has a single arity and works for entities directly
convertible to java.time.Instant
. Please consider using sql-timestamp
instead.
Converts a date entity to a `java.sql.Timestamp`. *Deprecated*: This function only has a single arity and works for entities directly convertible to `java.time.Instant`. Please consider using `sql-timestamp` instead.
(truncate-to o u)
Truncates this entity to the specified time unit. Only works for units that
divide into the length of standard day without remainder (up to :days
).
Truncates this entity to the specified time unit. Only works for units that divide into the length of standard day without remainder (up to `:days`).
(tuesday? o__4702__auto__)
Returns true if the given time entity with the
day-of-week
property falls on a tuesday.
Returns true if the given time entity with the `day-of-week` property falls on a tuesday.
(unit k)
(unit entity k)
Returns a TemporalUnit
for the given key k
or extracts the field from
the given temporal entity
.
You can see predefined units via java-time.repl/show-units
.
If you want to make your own custom TemporalUnits resolvable, you need to rebind the
java-time.properties/*units*
to a custom java-time.properties.UnitGroup
.
Returns a `TemporalUnit` for the given key `k` or extracts the field from the given temporal `entity`. You can see predefined units via `java-time.repl/show-units`. If you want to make your own custom TemporalUnits resolvable, you need to rebind the `java-time.properties/*units*` to a custom `java-time.properties.UnitGroup`.
(unit? o)
True if this is a TemporalUnit
.
True if this is a `TemporalUnit`.
(units o)
Units present in this temporal entity.
Units present in this temporal entity.
(value-range {:keys [min-smallest min-largest max-smallest max-largest]})
(value-range min max)
Creates a ValueRange
given the min
and max
amounts or a map of
:min-smallest
, :max-smallest
, :min-largest
and :max-largest
.
Creates a `ValueRange` given the `min` and `max` amounts or a map of `:min-smallest`, `:max-smallest`, `:min-largest` and `:max-largest`.
(wednesday? o__4702__auto__)
Returns true if the given time entity with the
day-of-week
property falls on a wednesday.
Returns true if the given time entity with the `day-of-week` property falls on a wednesday.
(when-joda-time-loaded & body)
Execute the body
when Joda-Time classes are found on the classpath.
Take care - when AOT-compiling code using this macro, the Joda-Time classes must be on the classpath at compile time!
Execute the `body` when Joda-Time classes are found on the classpath. Take care - when AOT-compiling code using this macro, the Joda-Time classes must be on the classpath at compile time!
(with-clock c & forms)
Executes the given forms
in the scope of the provided clock
.
All the temporal entities that get created without parameters will inherit their values from the clock:
(with-clock (system-clock "Europe/London") (zone-id)) => #<java.time.ZoneRegion Europe/London>
Executes the given `forms` in the scope of the provided `clock`. All the temporal entities that get created without parameters will inherit their values from the clock: (with-clock (system-clock "Europe/London") (zone-id)) => #<java.time.ZoneRegion Europe/London>
(with-clock-fn c f)
Executes the given function in the scope of the provided clock. All the temporal entities that get created without parameters will inherit their values from the clock.
Executes the given function in the scope of the provided clock. All the temporal entities that get created without parameters will inherit their values from the clock.
(with-largest-min-value p)
Underlying temporal entity with the value set to the largest minimum available for this property
Underlying temporal entity with the value set to the largest minimum available for this property
(with-max-value p)
Underlying temporal entity with the value set to the maximum available for this property
Underlying temporal entity with the value set to the maximum available for this property
(with-min-value p)
Underlying temporal entity with the value set to the minimum available for this property
Underlying temporal entity with the value set to the minimum available for this property
(with-offset o offset)
Sets the offset to the specified value ensuring that the local time stays the same.
(offset-time 10 30 0 0 +2) => #<java.time.OffsetTime 10:30+02:00> (with-offset *1 +3) => #<java.time.OffsetTime 10:30+03:00>
Sets the offset to the specified value ensuring that the local time stays the same. (offset-time 10 30 0 0 +2) => #<java.time.OffsetTime 10:30+02:00> (with-offset *1 +3) => #<java.time.OffsetTime 10:30+03:00>
(with-offset-same-instant o offset)
Sets the offset to the specified value ensuring that the result has the same instant, e.g.:
(offset-time 10 30 0 0 +2) => #<java.time.OffsetTime 10:30+02:00> (with-offset-same-instant *1 +3) => #<java.time.OffsetTime 11:30+03:00>
Sets the offset to the specified value ensuring that the result has the same instant, e.g.: (offset-time 10 30 0 0 +2) => #<java.time.OffsetTime 10:30+02:00> (with-offset-same-instant *1 +3) => #<java.time.OffsetTime 11:30+03:00>
(with-smallest-max-value p)
Underlying temporal entity with the value set to the smallest maximum available for this property
Underlying temporal entity with the value set to the smallest maximum available for this property
(with-value p v)
Underlying temporal entity with the value of this property set to v
Underlying temporal entity with the value of this property set to `v`
(with-zone o z)
Returns this temporal entity with the specified ZoneId
Returns this temporal entity with the specified `ZoneId`
(with-zone-same-instant zdt z)
Sets the zone to the specified value ensuring that the result has the same instant, e.g.:
(zoned-date-time 2015) => #<java.time.ZonedDateTime 2015-01-01T00:00+00:00[Europe/London]> (with-zone-same-instant *1 "America/New_York") => #<java.time.ZonedDateTime 2014-12-31T18:00-05:00[America/New_York]>
Sets the zone to the specified value ensuring that the result has the same instant, e.g.: (zoned-date-time 2015) => #<java.time.ZonedDateTime 2015-01-01T00:00+00:00[Europe/London]> (with-zone-same-instant *1 "America/New_York") => #<java.time.ZonedDateTime 2014-12-31T18:00-05:00[America/New_York]>
(year)
(year G__4053)
(year fmt__3971__auto__ arg__3972__auto__)
Returns the Year
for the given entity, string, clock, zone or number.
Current year if no arguments given.
Returns the `Year` for the given entity, string, clock, zone or number. Current year if no arguments given.
(year-month)
(year-month G__4081)
(year-month a__3984__auto__ b__3985__auto__)
Returns the YearMonth
for the given entity, string, clock, zone or
month/day combination. Current year-month if no arguments given.
Returns the `YearMonth` for the given entity, string, clock, zone or month/day combination. Current year-month if no arguments given.
(year-quarter)
(year-quarter G__4169)
(year-quarter a__3984__auto__ b__3985__auto__)
Returns the YearQuarter
for the given entity, clock, zone or year with quarter.
Current year quarter if no arguments given.
Returns the `YearQuarter` for the given entity, clock, zone or year with quarter. Current year quarter if no arguments given.
(zone-id)
(zone-id arg_1_3553)
(zone-id arg_1_3554 arg_2_3555)
Creates a ZoneId
from a string identifier, java.util.TimeZone
or extracts
from another temporal entity.
Returns default system zone id if no arguments provided.
Given two arguments will use the second as the offset.
Creates a `ZoneId` from a string identifier, `java.util.TimeZone` or extracts from another temporal entity. Returns default system zone id if no arguments provided. Given two arguments will use the second as the offset.
(zone-id? v__2432__auto__)
True if an instance of ZoneId.
True if an instance of ZoneId.
(zone-offset)
(zone-offset o)
(zone-offset h m)
(zone-offset h m s)
Creates a ZoneOffset
from a string identifier (e.g. "+01"), a number of
hours/hours and minutes/hours, minutes and seconds or extracts from another
temporal entity.
Returns default system zone offset if no arguments provided.
Creates a `ZoneOffset` from a string identifier (e.g. "+01"), a number of hours/hours and minutes/hours, minutes and seconds or extracts from another temporal entity. Returns default system zone offset if no arguments provided.
(zoned-date-time)
(zoned-date-time arg_1_3648)
(zoned-date-time arg_1_3649 arg_2_3650)
(zoned-date-time arg_1_3651 arg_2_3652 arg_3_3653)
(zoned-date-time y m d h)
(zoned-date-time y mo d h m)
(zoned-date-time y mo d h m s)
(zoned-date-time y mo d h m s n)
(zoned-date-time y mo d h m s n o)
Creates a ZonedDateTime
. The following arguments are supported:
If zone id is not specified, default zone id will be used. You can check the
default zone by invoking (zone-id)
.
Creates a `ZonedDateTime`. The following arguments are supported: * no arguments - current date-time in the default zone * one argument + clock + zone id + another temporal entity + string representation + year * two arguments + formatter and a string + local date-time and a zone id + year and month * three arguments + local date, local time and a zone id + year, month and day * four to seven arguments - date-time fields * eight arguments - last is the zone id If zone id is not specified, default zone id will be used. You can check the default zone by invoking `(zone-id)`.
(zoned-date-time? v__2432__auto__)
True if an instance of ZonedDateTime.
True if an instance of ZonedDateTime.
cljdoc is a website building & hosting documentation for Clojure/Script libraries
× close