puppetlabs.puppetdb.time — org.openvoxproject/puppetdb 8.13.0

Time-related Utility Functions

This namespace contains utility functions for working with time objects, built on java.time.Instant (timestamps) and java.time.Duration (periods).

after? clj

(after? a b)

ago clj

(ago d)

attempt-date-time-parse clj

(attempt-date-time-parse formatter timestamp-str)

Inputs: [formatter :- DateTimeFormatter timestamp-str :- String]

Parses timestamp-str using formatter. Returns nil if parsing fails.

before? clj

(before? a b)

date-time clj

(date-time year month day)

(date-time year month day hour)

(date-time year month day hour minute)

(date-time year month day hour minute second)

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

Construct an Instant from year/month/day/hour/minute/second/millis (all UTC).

date-time? clj

(date-time? x)

days clj

(days n)

ephemeral-now-ns clj

(ephemeral-now-ns)

Returns the current time as signed integer nanoseconds with respect to some ephemeral time line. Values are only comparable within the same process, and the range of values may be limited, but differences between successive calls within no more than 250 years of each other will be correct.

equal? clj

(equal? a b)

format-period clj

(format-period p)

Convert a Duration into a human-readable String, e.g. '2 minutes'. Normalizes to the largest clean unit.

from-long clj

(from-long n)

from-now clj

(from-now d)

from-sql-date clj

(from-sql-date ts)

hours clj

(hours n)

interval clj

(interval start end)

Returns the Duration between two Instants.

millis clj

(millis n)

minus clj

(minus t d)

minutes clj

(minutes n)

now clj

(now)

parse-iso-z clj

(parse-iso-z s)

Returns a pdb instant (UTC timestamp) if s represents an ISO formatted timestamp like "2011-12-03T10:15:30Z" or nil.

parse-offset-iso clj

Returns a pdb instant (UTC timestamp) if s represents an ISO formatted timestamp with offset like "2011-12-03T10:15:30+01:00" or nil.

parse-period clj

(parse-period s)

Parse a String into a Duration. Supported suffixes: d, h, m, s, ms. For example, (parse-period "2d") returns a Duration of 2 days.

period-longer? clj

(period-longer? d1 d2)

Returns true if d1 is longer than d2.

period? clj

(period? x)

periods-equal? clj

(periods-equal? _p)

(periods-equal? p1 p2)

(periods-equal? p1 p2 & more)

Returns true if all given Durations represent the same amount of time.

plus clj

(plus t d)

seconds clj

(seconds n)

to-date-time clj

(to-date-time x)

Coerce x to an Instant. Accepts strings, longs, java.sql.Timestamps, and Instants.

to-days clj

(to-days d)

to-hours clj

(to-hours d)

to-long clj

(to-long t)

Convert a timestamp to epoch milliseconds.

to-millis clj

(to-millis d)

to-minutes clj

(to-minutes d)

to-seconds clj

(to-seconds d)

to-string clj

(to-string t)

Convert a timestamp to ISO-8601 string with mandatory millisecond precision. Accepts Instant, java.sql.Timestamp, or String (parsed and reformatted to normalize timezone offset and precision).

to-timestamp clj

(to-timestamp ts)

Inputs: [ts] Returns: (s/maybe java.sql.Timestamp)

Convert to a java.sql.Timestamp. When ts is a String, attempts parsing with likely date formats first.

ToJavaDate clj protocol

to-java-date clj

(to-java-date x)

Converts x to a java.util.Date.

truncate-to-day clj

(truncate-to-day t)

Truncate an Instant to the start of the day (UTC).

wire-datetime->instant clj

(wire-datetime->instant s)

Parses s as a PuppetDB wire format <datetime> and returns an Instant, or nil if the string cannot be parsed.

wire-datetime? clj

(wire-datetime? s)

wire-format-formatter clj