日期和时间

This translation is up to date.

Elixir 中有关时间和日期的处理

目录

Time

Elixir 内置了几个处理时间的模块。不过需要注意的是,这些模块只能处理 UTC 时间。

首先,我们可以获取当前的 UTC 时间:

iex> Time.utc_now
~T[19:39:31.056226]

我们也可以通过魔符 ~T 来创建时间 Time

iex> ~T[19:39:31.056226]
~T[19:39:31.056226]

魔符 一课中有更多关于魔符的介绍。

下面的例子展示了从一个 Time 结构体中获取时分秒等部分的方法:

iex> t = ~T[19:39:31.056226]
~T[19:39:31.056226]
iex> t.hour
19
iex> t.minute
39
iex> t.day
** (KeyError) key :day not found in: ~T[19:39:31.056226]

你也许已经注意到了,Time 结构中只有在一天内的时间信息,没有具体的某天,某月,某日的信息。

Date

Time 相对的是 Date 结构体,它只有日期的信息,而没有时间的信息。

iex> Date.utc_today
~D[2028-10-21]

Date 模块有一些实用的日期处理函数:

iex> {:ok, date} = Date.new(2020, 12, 12)
{:ok, ~D[2020-12-12]}
iex> Date.day_of_week date
6
iex> Date.leap_year? date
true

day_of_week/1 计算某天是一个星期中的第几天。上面的例子中的日期是星期六。 leap_year?/1 检查某天的年份是不是一个闰年。更多有关日期的函数请参考文档

NaiveDateTime

Elixir 中有两中结构体既包含时间信息,又包含日期信息。我们首先来看 NaiveDateTime。 它的一个不足是缺少时区的信息。

iex(15)> NaiveDateTime.utc_now
~N[2029-01-21 19:55:10.008965]

但是因为它同时有时间和日期,所以你可以对它进行时间的运算,下面的例子展示了对一个 NaiveDateTime 结构加 30 秒的操作:

iex> NaiveDateTime.add(~N[2018-10-01 00:00:14], 30)
~N[2018-10-01 00:00:44]

DateTime

你可能已经猜到了,Elixir 内置的第二个既有时间,又有日期的模块是 DateTime,而且它还有时区的信息。需要注意的是,有关时区,官方文档做的特别的说明:

本模块只包括了一些转换函数和处理 UTC 的函数。这是因为要完整实现 DateTime 需要一个时区数据库,但是目前 Elixir 还未提供此数据库。

原文是:

You will notice this module only contains conversion functions as well as functions that work on UTC. This is because a proper DateTime implementation requires a time zone database which currently is not provided as part of Elixir.

另外,你也可以通过一个 NaiveDateTime 的值来创建一个 DateTime,只需要通过 from_naive/2 加上时区信息即可:

iex> DateTime.from_naive(~N[2016-05-24 13:26:08.003], "Etc/UTC")
{:ok, #DateTime<2016-05-24 13:26:08.003Z>}

如果你想了解更多有关时间,日期的更高级的用法,请参考这些文档: Time, Date, DateTime。你也可以考虑 TimexCalendar 。它们都是很强大的处理时间的库。