View Source Moar.NaiveDateTime (Moar v1.14.0)

NaiveDateTime-related functions. See also Moar.DateTime.

Link to this section Summary

Functions

Like NaiveDateTime.from_iso8601/1 but raises if the string cannot be parsed.

Like NaiveDateTime.to_iso8601/1 but rounds to the nearest second first.

Link to this section Functions

Link to this function

add(date_time, duration)

View Source

Like NaiveDateTime.add/2 but takes a Moar.Duration.

See also Moar.DateTime.add/2.

Note

This function is naive and intentionally doesn't account for real-world calendars and all of their complexity, such as leap years, leap days, daylight saving time, past and future calendar oddities, etc.

As "Falsehoods programmers believe about time" says, "If you think you understand everything about time, you're probably doing it wrong."

See Cldr.Calendar.plus/2 for one example of a function that is far more likely to be correct.

iex> start = ~N[2022-01-01T00:00:00]
iex> Moar.NaiveDateTime.add(start, {3, :minute})
~N[2022-01-01T00:03:00]
Link to this function

from_iso8601!(date_time_string)

View Source
@spec from_iso8601!(date_time_string :: String.t()) :: NaiveDateTime.t()

Like NaiveDateTime.from_iso8601/1 but raises if the string cannot be parsed.

iex> Moar.NaiveDateTime.from_iso8601!("2022-01-01T00:00:00")
~N[2022-01-01T00:00:00]

iex> Moar.NaiveDateTime.from_iso8601!("2022-01-01T00:00:00+0800")
~N[2022-01-01T00:00:00]

iex> Moar.NaiveDateTime.from_iso8601!("Next Thursday after lunch")
** (ArgumentError) Invalid ISO8601 format: "Next Thursday after lunch"
Link to this function

to_iso8601_rounded(date)

View Source
@spec to_iso8601_rounded(date_time :: NaiveDateTime.t()) :: String.t()

Like NaiveDateTime.to_iso8601/1 but rounds to the nearest second first.

iex> Moar.NaiveDateTime.to_iso8601_rounded(~N[2022-01-01T01:02:03.456789])
"2022-01-01T01:02:03"