Ecto v2.0.0-rc.1 Ecto.Time

An Ecto type for time.

Summary

Functions

Casts the given value to time

Same as cast/1 but raises on invalid times

Compare two times

Converts an Ecto.Time into a time tuple (in the form {hour, min, sec, usec})

Returns an Ecto.Time from an Erlang time tuple

Converts a time tuple like the one returned by dump/1 into an Ecto.Time

Returns an Erlang time tuple from an Ecto.Time

Converts Ecto.Time to its ISO 8601 representation

Converts Ecto.Time to a string representation

The Ecto primitive type

Returns an Ecto.Time in UTC

Functions

cast(t)

Casts the given value to time.

It supports:

  • a binary in the “HH:MM:SS” format (may be followed by “Z”, as in 12:00:00Z)
  • a binary in the “HH:MM:SS.USEC” format (may be followed by “Z”, as in 12:00:00.005Z)
  • a map with "hour", "min" keys with "sec" and "usec" as optional keys and values are integers or binaries
  • a map with :hour, :min keys with :sec and :usec as optional keys and values are integers or binaries
  • a tuple with {hour, min, sec} as integers or binaries
  • a tuple with {hour, min, sec, usec} as integers or binaries
  • an Ecto.Time struct itself
cast!(value)

Same as cast/1 but raises on invalid times.

compare(t1, t2)

Compare two times.

Receives two times and compares the t1 against t2 and returns :lt, :eq or :gt.

dump(arg1)

Converts an Ecto.Time into a time tuple (in the form {hour, min, sec, usec}).

from_erl(arg)

Returns an Ecto.Time from an Erlang time tuple.

load(time)

Converts a time tuple like the one returned by dump/1 into an Ecto.Time.

to_erl(time)

Returns an Erlang time tuple from an Ecto.Time.

to_iso8601(time)

Converts Ecto.Time to its ISO 8601 representation.

to_string(time)

Converts Ecto.Time to a string representation.

type()

The Ecto primitive type.

utc(precision \\ :sec)

Returns an Ecto.Time in UTC.

precision can be :sec or :usec.