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
...>)
"август"