Elixir Calendar.strftime用法及代码示例

@spec strftime(map(), String.t(), keyword()) :: String.t()

将收到的日期时间格式化为字符串。

日期时间可以是任何日历类型( Time 、 Date 、 NaiveDateTime 和 DateTime )或任何Map，只要它们包含格式化所需的所有相关字段。例如，如果您使用%Y 来格式化年份，则日期时间必须具有:year 字段。因此，如果您将 Time 或没有 :year 字段的映射传递给需要 %Y 的格式，则会引发错误。

选项

• :preferred_datetime - 显示日期时间的首选格式的字符串，它不能包含 %c 格式，如果未收到该选项，则默认为 "%Y-%m-%d %H:%M:%S"

• :preferred_date - 显示日期的首选格式的字符串，它不能包含 %x 格式，如果未收到选项，则默认为 "%Y-%m-%d"

• :preferred_time - 显示时间的首选格式的字符串，它不能包含 %X 格式，如果未收到选项，则默认为 "%H:%M:%S"

• :am_pm_names - 接收 :am 或 :pm 并返回一天中时段名称的函数，如果未收到该选项，则默认为分别返回 "am" 和 "pm" 的函数

• :month_names - 接收数字并返回对应月份名称的函数，如果未接收到该选项，则默认为返回英文月份名称的函数

• :abbreviated_month_names - 接收数字并返回对应月份缩写名称的函数，如果没有接收到该选项则默认为返回英文缩写月份名称的函数

• :day_of_week_names - 接收数字并返回对应星期几名称的函数，如果未接收到该选项则默认为返回英文星期几名称的函数

• :abbreviated_day_of_week_names - 接收数字并返回对应星期几的缩写名称的函数，如果未接收到该选项，则默认为返回英文缩写星期名称的函数

格式化语法

strftime 的格式化语法是以下格式的字符序列：

%<padding><width><format>

其中:

• % ：表示格式化部分的开始
• <padding> ：设置填充(见下文)
• <width> : 一个数字，表示格式化部分的最小大小
• <format> ：格式本身(见下文)

接受的填充选项

• - ：无填充，从格式中删除所有填充
• _：用空格填充
• 0：用零填充

接受的格式

接受的格式是：

任何其他字符都将被解释为无效格式并引发错误

例子

没有选项：

iex> Calendar.strftime(~U[2019-08-26 13:52:06.0Z], "%y-%m-%d %I:%M:%S %p")
"19-08-26 01:52:06 PM"

iex> Calendar.strftime(~U[2019-08-26 13:52:06.0Z], "%a, %B %d %Y")
"Mon, August 26 2019"

iex> Calendar.strftime(~U[2020-04-02 13:52:06.0Z], "%B %-d, %Y")
"April 2, 2020"

iex> Calendar.strftime(~U[2019-08-26 13:52:06.0Z], "%c")
"2019-08-26 13:52:06"

有选项：

iex> Calendar.strftime(~U[2019-08-26 13:52:06.0Z], "%c", preferred_datetime: "%H:%M:%S %d-%m-%y")
"13:52:06 26-08-19"

iex> Calendar.strftime(
...>  ~U[2019-08-26 13:52:06.0Z],
...>  "%A",
...>  day_of_week_names: fn day_of_week ->
...>    {"segunda-feira", "terça-feira", "quarta-feira", "quinta-feira",
...>    "sexta-feira", "sábado", "domingo"}
...>    |> elem(day_of_week - 1)
...>  end
...>)
"segunda-feira"

iex> Calendar.strftime(
...>  ~U[2019-08-26 13:52:06.0Z],
...>  "%B",
...>  month_names: fn month ->
...>    {"январь", "февраль", "март", "апрель", "май", "июнь",
...>    "июль", "август", "сентябрь", "октябрь", "ноябрь", "декабрь"}
...>    |> elem(month - 1)
...>  end
...>)
"август"