Elixir DateTime.convert用法及代碼示例

@spec convert(Calendar.datetime(), Calendar.calendar()) ::
  {:ok, t()} | {:error, :incompatible_calendars}

將給定的datetime 從一個日曆轉換為另一個。

如果無法在日曆之間進行明確轉換(請參閱 Calendar.compatible_calendars?/2 )，則返回 {:error, :incompatible_calendars} 元組。

例子

想象一下，有人實現了 Calendar.Holocene ，這是一個基於公曆的日曆，它在當前公曆年的基礎上增加了 10,000 年：

iex> dt1 = %DateTime{year: 2000, month: 2, day: 29, zone_abbr: "AMT",
...>                 hour: 23, minute: 0, second: 7, microsecond: {0, 0},
...>                 utc_offset: -14400, std_offset: 0, time_zone: "America/Manaus"}
iex> DateTime.convert(dt1, Calendar.Holocene)
{:ok, %DateTime{calendar: Calendar.Holocene, day: 29, hour: 23,
                microsecond: {0, 0}, minute: 0, month: 2, second: 7, std_offset: 0,
                time_zone: "America/Manaus", utc_offset: -14400, year: 12000,
                zone_abbr: "AMT"}}