tupelo.java-time — tupelo 20.11.23b

*zone-id* clj

->instant clj

(->instant arg)

Coerces an Instant, ZonedDateTime, or org.joda.time.ReadableInstant => Instant

->zoned-date-time clj

(->zoned-date-time arg)

Coerces a org.joda.time.ReadableInstant to java.time.ZonedDateTime

DateTimeStamp clj

fixed-time-point? clj

(fixed-time-point? it)

Returns true iff arg represents a fixed point in time. Examples:

[java.time ZonedDateTime Instant] [org.joda.time DateTime Instant ReadableInstant]

instant clj

(instant)

Wrapper for java.time.Instant/now

instant? clj

(instant? it)

Returns true iff arg is an instance of java.time.Instant

iso-date-str clj deprecated

(iso-date-str & args)

DEPRECATED: use string-date-iso

iso-date-time-str clj deprecated

(iso-date-time-str & args)

DEPRECATED: use string-date-time-iso

iso-str->millis clj

(iso-str->millis iso-datetime-str)

Inputs: [iso-datetime-str :- s/Str]

Convert an ISO 8601 string to a java.sql.Date

iso-str->timestamp clj

(iso-str->timestamp iso-datetime-str)

Inputs: [iso-datetime-str :- s/Str]

Convert an ISO 8601 string to a java.sql.Date

joda-instant? clj

(joda-instant? it)

Returns true iff arg is an instance of org.joda.time.ReadableInstant

millis->instant clj

(millis->instant millis)

Wrapper for java.time.Instant/ofEpochMilli

now->instant clj

(now->instant)

Returns the current time as a java.lang.Instant

now->iso-str clj

(now->iso-str)

Returns an ISO string representation of the current time, like '2019-02-19T18:44:01.123456Z'

now->iso-str-simple clj

(now->iso-str-simple)

Returns a canonical string representation of the current time truncated to the current second, like '2019-02-19 18:44:01Z'

now->zdt clj

(now->zdt)

Returns the current time as a java.lang.ZonedDateTime (UTC)

parse-iso-str-nice clj

(parse-iso-str-nice iso-str)

Inputs: [iso-str :- s/Str] Returns: Instant

Parse a near-iso string like '2019-09-19 18:09:35Z' (it is missing the 'T' between the date & time fields) into an Instant

period? clj

(period? it)

Returns true iff arg is an instance of org.joda.time.ReadablePeriod. Example: (period (days 3)) => true

range clj

(range start-inst stop-inst step-dur)

Returns a vector of instants in the half-open interval [start stop) (both instants) with increment <step> (a period). Not lazy. Example:

 (range (zoned-date-time 2018 9 1)
        (zoned-date-time 2018 9 5)
        (Duration/ofDays 1)))  => <vector of 4 ZonedDateTime's from 2018-9-1 thru 2018-9-4>

same-instant? clj

(same-instant? this & others)

Returns true iff two ZonedDateTime objects represent the same instant of time, regardless of time zone. A thin wrapper over ZonedDateTime/isEqual

secs->instant clj

(secs->instant secs)

Wrapper for java.time.Instant/ofEpochSecs

string-date-compact clj

(string-date-compact timestamp)

Returns a compact date-time string like 2018-09-05 23:05:19.123Z => 20180905

string-date-iso clj

(string-date-iso zdt)

Returns a string like 2018-09-05

string-date-time-compact clj

(string-date-time-compact timestamp)

Returns a compact date-time string like 2018-09-05 23:05:19.123Z => 20180905-230519

string-date-time-hyphens clj

(string-date-time-hyphens timestamp)

Returns a compact date-time string like 2018-09-05 23:05:19.123Z => 2018-09-05-23-05-19

string-date-time-iso clj

(string-date-time-iso timestamp)

Returns a ISO date-time string like 2018-09-05T23:05:19.123Z

string-date-time-nice clj

(string-date-time-nice timestamp)

Returns an ISO date-time string like 2018-09-05 23:05:19.123Z (with a space instead of T)

stringify-times clj

(stringify-times form)

Will recursively walk any data structure, converting any fixed-time-point? object to a string

temporal? clj

(temporal? it)

Returns true iff arg is an instance of java.time.temporal.Temporal

trunc-to-day clj

(trunc-to-day zdt)

Inputs: [zdt :- DateTimeStamp]

Returns a ZonedDateTime truncated to first instant of the day.

trunc-to-hour clj

(trunc-to-hour zdt)

Inputs: [zdt :- DateTimeStamp]

Returns a ZonedDateTime truncated to first instant of the hour.

trunc-to-midnight-friday clj

(trunc-to-midnight-friday temporal)

Inputs: [temporal :- Temporal]

For an instant T, truncate time to midnight and return the first Friday at or before T.

trunc-to-midnight-monday clj

(trunc-to-midnight-monday temporal)

Inputs: [temporal :- Temporal]

For an instant T, truncate time to midnight and return the first Monday at or before T.

trunc-to-midnight-saturday clj

(trunc-to-midnight-saturday temporal)

Inputs: [temporal :- Temporal]

For an instant T, truncate time to midnight and return the first Saturday at or before T.

trunc-to-midnight-sunday clj

(trunc-to-midnight-sunday temporal)

Inputs: [temporal :- Temporal]

For an instant T, truncate time to midnight and return the first Sunday at or before T.

trunc-to-midnight-thursday clj

(trunc-to-midnight-thursday temporal)

Inputs: [temporal :- Temporal]

For an instant T, truncate time to midnight and return the first thursday at or before T.

trunc-to-midnight-tuesday clj

(trunc-to-midnight-tuesday temporal)

Inputs: [temporal :- Temporal]

For an instant T, truncate time to midnight and return the first Tuesday at or before T.

trunc-to-midnight-wednesday clj

(trunc-to-midnight-wednesday temporal)

Inputs: [temporal :- Temporal]

For an instant T, truncate time to midnight and return the first Wednesday at or before T.

trunc-to-minute clj

(trunc-to-minute zdt)

Inputs: [zdt :- DateTimeStamp]

Returns a ZonedDateTime truncated to first instant of the minute.

trunc-to-month clj

(trunc-to-month zdt)

Inputs: [zdt :- ZonedDateTime]

Returns a ZonedDateTime truncated to first instant of the month.

trunc-to-second clj

(trunc-to-second zdt)

Inputs: [zdt :- DateTimeStamp]

Returns a ZonedDateTime truncated to first instant of the second.

trunc-to-year clj

(trunc-to-year zdt)

Inputs: [zdt :- ZonedDateTime]

Returns a ZonedDateTime truncated to first instant of the year.

walk-instant->str clj

(walk-instant->str tree)

Walks a tree-like data structure, calling .toString on any instances java.time.Instant

walk-instant->timestamp clj

(walk-instant->timestamp tree)

Walks a tree-like data structure, converting any instances of java.sql.Timestamp => java.time.Instant

walk-timestamp->instant clj

(walk-timestamp->instant tree)

Walks a tree-like data structure, converting any instances of java.sql.Timestamp => java.time.Instant

with-zoneid clj macro

(with-zoneid zone-id & forms)

zoned-date-time clj

(zoned-date-time)

(zoned-date-time year)

(zoned-date-time year month)

(zoned-date-time year month day)

(zoned-date-time year month day hour)

(zoned-date-time year month day hour minute)

(zoned-date-time year month day hour minute second)

(zoned-date-time year month day hour minute second nanos)

(zoned-date-time year month day hour minute second nanos zone-id)

Returns a java.time.ZonedDateTime with the specified parameters and truncated values (day/month=1, hour/minute/sec=0) for all other date/time components. Assumes time zone is UTC unless the maximum-arity constructor is used. Usage:

; Assumes UTC time zone (zoned-date-time) => current time (zoned-date-time year) (zoned-date-time year month) (zoned-date-time year month day) (zoned-date-time year month day hour) (zoned-date-time year month day hour minute) (zoned-date-time year month day hour minute second) (zoned-date-time year month day hour minute second nanos)

; Explicit time zone (zoned-date-time year month day hour minute second nanos zone-id)

; Explicit time zone alternate shortcut arities. (with-zoneid zoneid-us-eastern (zoned-date-time year month day ...)) ; any arity w/o zone-id

zoned-date-time? clj

(zoned-date-time? it)

Returns true iff arg is an instance of java.time.ZonedDateTime

zoneid-us-alaska clj

zoneid-us-aleutian clj

zoneid-us-central clj

zoneid-us-eastern clj

zoneid-us-hawaii clj

zoneid-us-mountain clj

zoneid-us-pacific clj

zoneid-utc clj