Elixir: Даты и время
В Эликсире есть несколько модулей для работы с датами и временем, рассмотрим их.
Первым в списке модуль Time
, исходя из его названия, модуль предоставляет структуру данных и функции для работы со временем:
current_time = Time.utc_now()
# => ~T[13:40:18.506292]
current_time.hour # => 13
current_time.minute # => 40
current_time.second # => 18
current_time.calendar # => Calendar.ISO
current_time.day
# => ** (KeyError) key :day not found in: ~T[13:40:18.506292]
Time.add(current_time, 20, :minute)
# => ~T[14:00:18.506292]
Time.add(current_time, 2, :hour)
# => ~T[15:40:18.506292]
Второй модуль Date
, он работает только с датами, без информации о времени:
current_date = Date.utc_today()
# => ~D[2023-11-18]
current_date.day # => 18
current_date.month # => 11
current_date.year # => 2023
Date.add(current_date, 5)
# => ~D[2023-11-23]
Date.add(current_date, -2)
# => ~D[2023-11-16]
Date.beginning_of_week(current_date)
# => ~D[2023-11-13]
Date.end_of_week(current_date)
# => ~D[2023-11-19]
Date.leap_year?(current_date)
# => false
Третий модуль называется NaiveDateTime
, он уже поддерживает и дату и время, однако, этот модуль не поддерживает часовые пояса:
current = NaiveDateTime.utc_now()
# => ~N[2023-11-18 15:08:23.108947]
NaiveDateTime.add(current, 5, :second)
# => ~N[2023-11-18 15:08:28.108947]
NaiveDateTime.add(current, -30, :millisecond)
# => ~N[2023-11-18 15:08:23.078947]
NaiveDateTime.add(current, 5, :day)
# => ~N[2023-11-23 15:08:23.108947]
NaiveDateTime.end_of_day(current)
# => ~N[2023-11-18 23:59:59.999999]
NaiveDateTime.beginning_of_day(current)
# => ~N[2023-11-18 00:00:00.000000]
Четвертый модуль DateTime
не имеет такого недостатка, как NaiveDateTime
, то есть DateTime
поддерживает часовые пояса, но за этим нужно следить. Многие функции из этого модуля требуют базу данных часовых поясов. По умолчанию они используют базу данных, которую возвращает функция Calendar.get_time_zone_database
, а эта база поддерживает только пояс “Etc/UTC”
. Если нужно менять часовые пояса, советую присмотреться к библиотеке tzdata. Теперь изучим DateTime
:
current = DateTime.utc_now()
# => ~U[2023-11-18 15:16:12.046038Z]
future = DateTime.add(current, 2, :day)
# => ~U[2023-11-20 15:16:12.046038Z]
DateTime.compare(current, future) # => :lt
DateTime.diff(current, future) # => -172800
DateTime.from_naive!(NaiveDateTime.utc_now(), "Etc/UTC")
# => ~U[2023-11-18 15:18:54.394424Z]
DateTime.to_date(current)
# => ~D[2023-11-18]
Как было видно из примеров, время и даты можно задавать через строковые метки (сигили), для Time
- ~T
, для Date
- ~D
, для NaiveDateTime
- ~N
, для DateTime
- ~U
соответственно:
~T[13:40:18.506292]
# => ~T[13:40:18.506292]
~D[2023-11-18]
# => ~D[2023-11-18]
Задание
Создайте функцию shift_days
, которая принимает структуры Time
, DateTime
, NaiveDateTime
, Date
и смещает ее на количество переданных дней. Дни могут быть отрицательным числом:
naive_time = NaiveDateTime.utc_now()
# => ~N[2023-11-17 18:24:21.345116]
Solution.shift_days(naive_time, -2)
# => ~N[2023-11-15 18:24:21.345116]
Solution.shift_days(naive_time, 1)
# => ~N[2023-11-18 18:24:21.345116]
Solution.shift_days(naive_time, 0)
# => ~N[2023-11-17 18:24:21.345116]
date = Date.utc_today()
# => ~D[2023-11-17]
Solution.shift_days(date, -2)
# => ~D[2023-11-15]
Solution.shift_days(date, 1)
# => ~D[2023-11-18]
Solution.shift_days(date, 0)
# => ~D[2023-11-17]
Полезное
Команда проекта находится в телеграм-сообществе. Там можно задать любой вопрос и повлиять на проект
Если вы зашли в тупик, то самое время поговорить с нашим асситентом Тота во вкладке "ИИ-помощник":
Тесты устроены таким образом, что они проверяют решение разными способами и на разных данных. Часто решение работает с одними входными данными, но не работает с другими. Чтобы разобраться с этим моментом, изучите вкладку «Тесты» и внимательно посмотрите на вывод ошибок, в котором есть подсказки.
Это нормально 🙆, в программировании одну задачу можно выполнить множеством способов. Если ваш код прошел проверку, то он соответствует условиям задачи. В редких случаях бывает, что решение подогнано под тесты, но это видно сразу.
Создавать обучающие материалы, понятные для всех без исключения, довольно сложно. Мы очень стараемся, но всегда есть что улучшать. Если вы встретили материал, который вам непонятен, опишите проблему в обратной связи нашего сообщества
Ваше упражнение проверяется по этим тестам
defmodule Test do
use ExUnit.Case
describe "shift_days work" do
test "with Date" do
time = Date.utc_today()
assert Date.add(time, -2) == Solution.shift_days(time, -2)
assert Date.add(time, 2) == Solution.shift_days(time, 2)
assert Date.add(time, 1) == Solution.shift_days(time, 1)
assert Date.add(time, 0) == Solution.shift_days(time, 0)
end
test "with NaiveDateTime" do
time = NaiveDateTime.utc_now()
assert NaiveDateTime.add(time, days_to_seconds(-2), :second) ==
Solution.shift_days(time, -2)
assert NaiveDateTime.add(time, days_to_seconds(2), :second) == Solution.shift_days(time, 2)
assert NaiveDateTime.add(time, days_to_seconds(1), :second) == Solution.shift_days(time, 1)
assert NaiveDateTime.add(time, 0, :second) == Solution.shift_days(time, 0)
end
test "with DateTime" do
time = DateTime.utc_now()
assert DateTime.add(time, days_to_seconds(-2), :second) == Solution.shift_days(time, -2)
assert DateTime.add(time, days_to_seconds(2), :second) == Solution.shift_days(time, 2)
assert DateTime.add(time, days_to_seconds(1), :second) == Solution.shift_days(time, 1)
assert DateTime.add(time, 0, :second) == Solution.shift_days(time, 0)
end
test "with Time" do
time = Time.utc_now()
assert Time.add(time, days_to_seconds(-2), :second) == Solution.shift_days(time, -2)
assert Time.add(time, days_to_seconds(2), :second) == Solution.shift_days(time, 2)
assert Time.add(time, days_to_seconds(1), :second) == Solution.shift_days(time, 1)
assert Time.add(time, 0, :second) == Solution.shift_days(time, 0)
end
defp days_to_seconds(amount) do
amount * 24 * 60 * 60
end
end
end
Решение учителя откроется через:
20:00
