Бесплатный курс по Elixir. Зарегистрируйтесь для отслеживания прогресса →

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]
Упражнение не проходит проверку — что делать? 😶

Если вы зашли в тупик, то самое время задать вопрос в «Обсуждениях». Как правильно задать вопрос:

  • Обязательно приложите вывод тестов, без него практически невозможно понять что не так, даже если вы покажете свой код. Программисты плохо исполняют код в голове, но по полученной ошибке почти всегда понятно, куда смотреть.
В моей среде код работает, а здесь нет 🤨

Тесты устроены таким образом, что они проверяют решение разными способами и на разных данных. Часто решение работает с одними входными данными, но не работает с другими. Чтобы разобраться с этим моментом, изучите вкладку «Тесты» и внимательно посмотрите на вывод ошибок, в котором есть подсказки.

Мой код отличается от решения учителя 🤔

Это нормально 🙆, в программировании одну задачу можно выполнить множеством способов. Если ваш код прошел проверку, то он соответствует условиям задачи.

В редких случаях бывает, что решение подогнано под тесты, но это видно сразу.

Прочитал урок — ничего не понятно 🙄

Создавать обучающие материалы, понятные для всех без исключения, довольно сложно. Мы очень стараемся, но всегда есть что улучшать. Если вы встретили материал, который вам непонятен, опишите проблему в «Обсуждениях». Идеально, если вы сформулируете непонятные моменты в виде вопросов. Обычно нам нужно несколько дней для внесения правок.

Кстати, вы тоже можете участвовать в улучшении курсов: внизу есть ссылка на исходный код уроков, который можно править прямо из браузера.

Полезное


Нашли ошибку? Есть что добавить? Пулреквесты приветствуются https://github.com/hexlet-basics
Если вы столкнулись с трудностями и не знаете, что делать, задайте вопрос в нашем большом и дружном сообществе