version | title |
---|---|
1.0.1 |
日期和时间 |
Elixir 中有关时间和日期的处理
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
结构中只有在一天内的时间信息,没有具体的某天,某月,某日的信息。
与 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
检查某天的年份是不是一个闰年。更多有关日期的函数请参考文档。
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]
你可能已经猜到了,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。你也可以考虑 Timex 和 Calendar 。它们都是很强大的处理时间的库。