Logo
Книга для начинающих
ВходРегистрация
/
Программирование
/
Курс 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]

Полезное

  • Официальная документация Date

  • Официальная документация DateTime

  • Официальная документация NaiveDateTime

  • Официальная документация Time

  • Про базу знаний о часовых поясах tzdata

  • Библиотека tzdata для Elixir

Команда проекта находится в телеграм-сообществе. Там можно задать любой вопрос и повлиять на проект

Если вы зашли в тупик, то самое время поговорить с нашим асситентом Тота во вкладке "ИИ-помощник":

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

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

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

Нашли ошибку? Есть что добавить? Пулреквесты приветствуются
/
Программирование
/
Курс 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]

Полезное

  • Официальная документация Date

  • Официальная документация DateTime

  • Официальная документация NaiveDateTime

  • Официальная документация Time

  • Про базу знаний о часовых поясах tzdata

  • Библиотека tzdata для Elixir

Команда проекта находится в телеграм-сообществе. Там можно задать любой вопрос и повлиять на проект

Если вы зашли в тупик, то самое время поговорить с нашим асситентом Тота во вкладке "ИИ-помощник":

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

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

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

Нашли ошибку? Есть что добавить? Пулреквесты приветствуются
← ПредыдущийСледующий →
← ПредыдущийСледующий →
← ПредыдущийСледующий →

Ваше упражнение проверяется по этим тестам

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

waiting_clock
← ПредыдущийСледующий →