com.fulcrologic.rad.type-support.date-time — com.fulcrologic/fulcro-rad 0.0.14-alpha

A common set of date/time functions for CLJC. Libraries like tick are promising, and CLJC time is useful (and used by this ns), but cljc-time does not have an interface that is the same between the two languages, and tick is alpha (and often annoying).

*current-timezone* clj/s≠

clj

The current time zone for all date time operations. Defaults to nil. Should be set using set-timezone! in cljs, and should be thread-bound to a processing request using binding in CLJ. The value of this var is a java.time.ZoneId, which can be obtained from a string with cljc.time.zone-id/of.

*current-zone-name* clj/s≠

clj

The current time zone for all date time operations. Defaults to nil. Should be set using set-timezone! in cljs, and should be thread-bound to a processing request using binding in CLJ. The value of this var is a java.time.ZoneId, which can be obtained from a string with cljc.time.zone-id/of.

beginning-of-day clj/s

(beginning-of-day)

(beginning-of-day inst)

Returns an inst? that is adjusted to midnight (local time of current time zone) on the day of the input instant (which defaults to now).

beginning-of-month clj/s

(beginning-of-month)

(beginning-of-month inst)

Returns an inst? that is adjusted to midnight (local time of current time zone) on the first day of the month of the input instant (which defaults to now).

beginning-of-year clj/s

(beginning-of-year)

(beginning-of-year inst)

Returns an inst? that is adjusted to midnight (local time of current time zone) on the first day of January in this year.

date-time? clj/s

date? clj/s

end-of-day clj/s

(end-of-day)

(end-of-day inst)

Returns an inst? that is adjusted to midnight (local time of current time zone) on the next day of the input instant (which defaults to now). This creates an open interval for end.

end-of-month clj/s

(end-of-month)

(end-of-month inst)

Returns an inst? that is adjusted to midnight (local time of current time zone) on the first day of the next month of the input instant (which defaults to now). This creates an open interval for end.

end-of-year clj/s

(end-of-year)

(end-of-year inst)

Returns an inst? that is adjusted to midnight (local time of current time zone) on the first day of January in the next year.

formatter clj/s

(formatter fmt)

(formatter fmt locale)

Constructs a DateTimeFormatter out of either a

• format string - "YYYY/mm/DD" "YYY HH:MM" etc. or
• formatter name - :iso-instant :iso-local-date etc

and a Locale, which is optional.

get-zone-id clj/s

(get-zone-id zone-name)

Returns the ZoneID of zone-name, or current-timezone if zone-name is nil.

html-date->inst clj/s

(html-date->inst html-date local-time)

Convert an HTML date input string to an inst at the given local time, adjusted to the correct current-timezone. Returns now if the string isn't a proper ISO string.

html-date-string->local-date clj/s

(html-date-string->local-date s)

Convert a standard HTML5 date input string to a local date

html-datetime-string->inst clj/s

(html-datetime-string->inst date-time-string)

(html-datetime-string->inst zone-name date-time-string)

inst->html-date clj/s

(inst->html-date inst)

Convert an inst to an HTML date input string. Assumes current-timezone. Always returns a string. Will return today's date if inst is nil or otherwise fails to convert.

inst->html-datetime-string clj/s

(inst->html-datetime-string inst)

(inst->html-datetime-string zone-name inst)

inst->human-readable-date clj/s

(inst->human-readable-date inst)

Converts a UTC Instant into the correctly-offset and human-readable (e.g. America/Los_Angeles) date string.

Uses locale from locale/current-locale.

inst->instant clj/s

(inst->instant i)

inst->local-date clj/s

(inst->local-date inst)

(inst->local-date zone-name inst)

Converts a UTC Instant into the correctly-offset (e.g. America/Los_Angeles) LocalDate.

inst->local-datetime clj/s

(inst->local-datetime inst)

(inst->local-datetime zone-name inst)

Converts a UTC Instant into the correctly-offset (e.g. America/Los_Angeles) LocalDateTime.

inst->zoned-date-time clj/s

(inst->zoned-date-time inst)

(inst->zoned-date-time zone-name inst)

Converts a UTC Instant into the correctly-offset (e.g. America/Los_Angeles) ZonedDateTime.

instant->inst clj/s

(instant->inst i)

local-date->html-date-string clj/s

(local-date->html-date-string d)

Convert a standard HTML5 date input string to a local date

local-date->inst clj/s

(local-date->inst local-dt)

(local-date->inst zone-name local-dt)

(local-date->inst zone-name month day yyyy)

Returns a UTC Clojure inst based on the date given as time in the named (ISO) zone (e.g. America/Los_Angeles). If no zone name (or nil) is given, then the *current-timezone* will be used.

local-datetime->inst clj/s

(local-datetime->inst local-dt)

(local-datetime->inst zone-name local-dt)

(local-datetime->inst zone-name month day yyyy hh mm)

(local-datetime->inst zone-name month day yyyy hh mm ss)

Returns a UTC Clojure inst based on the date/time given as time in the named (ISO) zone (e.g. America/Los_Angeles). If no zone name (or nil) is given, then the *current-timezone* will be used.

mon-to-sunday clj/s

new-date clj/s

(new-date)

(new-date millis)

Create a Date object from milliseconds (defaults to now).

now clj/s

(now)

Returns the current time as an inst.

now-ms clj/s

(now-ms)

Returns the current time in ms.

set-timezone! clj/s

(set-timezone! zone-name)

Set the root binding of timezone, a dynamic var. In CLJS there is a lot of async behavior, but the overall time zone is typically fixed for a user. In CLJ the timezone usually needs to be bound to the local processing thread for a request. Therefore, the typical CLJS code will call this function on start, and the typical CLJ code will do a (binding [*current-timezone* (z/of user-zone)] ...).

tformat clj/s

(tformat format inst)

with-timezone clj/s macro

(with-timezone zone-name & body)

Set the (thread-local) "current time zone"to the given zone-name (a string zone id) for the duration of the rest of the body. Simply a short-hand for (binding [*current-timezone* (zone-id/of zone-name)] ...).

zone-region? clj/s

zoned-date-time->inst clj/s

(zoned-date-time->inst ztm)

Convert a zoned-date-time back to a low-level inst?