@spec add(NaiveDateTime.t(), Moar.Duration.t()) :: NaiveDateTime.t()

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

See also subtract/1 and 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.000]
iex> Moar.NaiveDateTime.add(start, {3, :minute})
~N[2022-01-01T00:03:00.000]

@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"

@spec subtract(NaiveDateTime.t(), Moar.Duration.t()) :: NaiveDateTime.t()

Subtracts duration from date_time.

See also add/1 and Moar.DateTime.subtract/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.minus/4 for one example of a function that is far more likely to be correct.

iex> start = ~N[2022-01-01T00:03:00.000]
iex> Moar.NaiveDateTime.subtract(start, {3, :minute})
~N[2022-01-01T00:00:00.000]

@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"

@spec utc_now([{:plus, Moar.Duration.t()}] | [{:minus, Moar.Duration.t()}]) ::
  NaiveDateTime.t()

Returns the current UTC time plus or minus the given duration.

iex> Moar.NaiveDateTime.utc_now(plus: {10500, :millisecond})
...> |> Moar.Duration.format([:approx, :from_now])
"10 seconds from now"

iex> Moar.NaiveDateTime.utc_now(minus: {10, :second})
...> |> Moar.Duration.format([:approx, :ago])
"10 seconds ago"