Elixir DateTime.convert!用法及代碼示例

@spec convert!(Calendar.datetime(), Calendar.calendar()) :: t()

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

如果無法在日曆之間進行明確轉換(請參閱 Calendar.compatible_calendars?/2 )，則會引發 ArgumentError。

例子

想象一下，有人實現了 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)
%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"}