Ecto v2.2.12 Ecto.DateTime View Source
A deprecated Ecto type that includes a date and a time.
This type is deprecated in favour of the :naive_datetime
type.
Link to this section Summary
Functions
Casts the given value to datetime.
Same as cast/1
but raises Ecto.CastError
on invalid datetimes.
Compare two datetimes.
Converts an Ecto.DateTime
into a {date, time}
tuple.
Converts the given Ecto.Date
into Ecto.DateTime
with the time being
00:00:00.
Converts the given Ecto.Date
and Ecto.Time
into Ecto.DateTime
.
Returns an Ecto.DateTime
from an Erlang datetime tuple.
Converts a {date, time}
tuple into an Ecto.DateTime
.
Converts Ecto.DateTime
into an Ecto.Date
.
Returns an Erlang datetime tuple from an Ecto.DateTime
.
Converts Ecto.DateTime
to its ISO 8601 representation
without timezone specification.
Converts Ecto.DateTime
to its string representation.
Converts Ecto.DateTime
into an Ecto.Time
.
The Ecto primitive type.
Returns an Ecto.DateTime
in UTC.
Link to this section Functions
cast(dt) View Source
Casts the given value to datetime.
It supports:
- a binary in the "YYYY-MM-DD HH:MM:SS" format
(may be separated by T and/or followed by "Z", as in
2014-04-17T14:00:00Z
) - a binary in the "YYYY-MM-DD HH:MM:SS.USEC" format
(may be separated by T and/or followed by "Z", as in
2014-04-17T14:00:00.030Z
) - a map with
"year"
,"month"
,"day"
,"hour"
,"minute"
keys with"second"
and"microsecond"
as optional keys and values are integers or binaries - a map with
:year
,:month
,:day
,:hour
,:minute
keys with:second
and:microsecond
as optional keys and values are integers or binaries - a tuple with
{{year, month, day}, {hour, min, sec}}
as integers or binaries - a tuple with
{{year, month, day}, {hour, min, sec, usec}}
as integers or binaries - an
Ecto.DateTime
struct itself
cast!(value) View Source
Same as cast/1
but raises Ecto.CastError
on invalid datetimes.
compare(t1, t2) View Source
Compare two datetimes.
Receives two datetimes and compares the t1
against t2
and returns :lt
, :eq
or :gt
.
dump(arg1) View Source
Converts an Ecto.DateTime
into a {date, time}
tuple.
from_date(date) View Source
Converts the given Ecto.Date
into Ecto.DateTime
with the time being
00:00:00.
from_date_and_time(date, time) View Source
Converts the given Ecto.Date
and Ecto.Time
into Ecto.DateTime
.
from_erl(arg) View Source
Returns an Ecto.DateTime
from an Erlang datetime tuple.
from_unix!(integer, unit) View Source
load(datetime) View Source
Converts a {date, time}
tuple into an Ecto.DateTime
.
to_date(date_time) View Source
Converts Ecto.DateTime
into an Ecto.Date
.
to_erl(date_time) View Source
Returns an Erlang datetime tuple from an Ecto.DateTime
.
to_iso8601(date_time) View Source
Converts Ecto.DateTime
to its ISO 8601 representation
without timezone specification.
to_string(date_time) View Source
Converts Ecto.DateTime
to its string representation.
to_time(date_time) View Source
Converts Ecto.DateTime
into an Ecto.Time
.
type() View Source
The Ecto primitive type.
utc(precision \\ :sec) View Source
Returns an Ecto.DateTime
in UTC.
precision
can be :sec
or :usec
.