Дата и время в Julia

Julia предоставляет следующие три функции для работы с датой и временем через модуль Dates:

  • Date: обозначает дату с точностью до дня и отображает только дату.
  • DateTime: обозначает дату и время с точностью до миллисекунд.
  • DateTime: обозначает время суток с точностью до наносекунд, представляя конкретный момент в течение 24 часов дня.

Перед использованием нам нужно сначала импортировать модуль Dates:

import Dates

Типы Date и DateTime можно разобрать из целых чисел или типов Period.

Period основан на значениях даты и представляет годы, месяцы, дни и т. д.:

Period
Year
Quarter
Month
Week
Day
Hour
Minute
Second
Millisecond
Microsecond
Nanosecond

И Date, и DateTime являются подтипами абстрактного типа TimeType.

На следующей диаграмме показаны связи между типами дат; щёлкните по изображению, чтобы увеличить его:

Вывод даты и времени:

Пример

julia> import Dates

julia> rightnow = Dates.Time(Dates.now()) # Время
08:41:15.917

julia> theday = Dates.Date(2022,5,6) # Дата
2022-05-06

julia> today_date = Dates.today()
2022-05-11

julia> Dates.now(Dates.UTC)
2022-05-11T00:44:20.136

# Форматирование времени
julia> Dates.DateTime("20220429 120000", "yyyymmdd HHMMSS")
2022-04-29T12:00:00


julia> Dates.DateTime("19/04/2022 17:42", "dd/mm/yyyy HH:MM")
2022-04-19T17:42:00

В следующей таблице приведены коды формата даты, с помощью которых можно форматировать даты:

Символ Элемент даты/времени
Y Представляет год, например: yyyy => 1984, yy => 84
m Представляет месяц, например: m => 7 или 07
u Представляет сокращённое название месяца, например: Jun
U Представляет полное название месяца, например: January
e Представляет сокращённое название дня недели, например: Mon
E Представляет полное название дня недели, например: Monday
d Представляет день, например: 1 или 01
H Представляет час, например: HH => 00
M Представляет минуту, например: MM => 00
S Представляет секунду, например: S => 00
s Обозначает миллисекунду, например: .000

Пример

julia> Dates.Date("Sun, 27 Sep 2022", "e, d u y")
2022-09-27

julia> Dates.DateTime("Sun, 27 Sep 2022 10:25:10", "e, d u y H:M:S")
2022-09-27T10:25:10

С помощью приведённых выше примеров мы создали несколько объектов даты/времени. Далее мы можем использовать эти объекты для получения данных (включая год, месяц, день, минуту, секунду, час и т. д.):

Пример

julia> theday = Dates.Date(2022,5,6) # Создать объект даты
2022-05-06

# Далее получите данные из theday
julia> Dates.year(theday)
2022

julia> Dates.month(theday)
5

# Получить текущие данные времени
julia> rightnow = Dates.now()
2022-05-11T08:51:45.342

julia> Dates.minute(rightnow)
51

julia> Dates.hour(rightnow)
8

julia> Dates.second(rightnow)
45

# Получить месяц и день недели
julia> Dates.dayofweek(theday)
5

julia> Dates.dayname(theday)
"Friday"

julia> Dates.yearmonthday(theday)
(2022, 5, 6)

julia> Dates.dayofweekofmonth(theday)
1

Арифметика дат

Мы можем выполнять арифметические операции над объектами дат.

Например, вычислим количество дней между двумя датами:

Пример

julia> day1 = Dates.Date(2022,1,17)
2022-01-17

julia> day2 = Dates.Date(2022,3,23)
2022-03-23

julia> day2 - day1
65 days

# Использовать разные единицы времени
julia> Dates.canonicalize(Dates.CompoundPeriod(day2 - day1))
9 weeks, 2 days

Мы также можем добавлять к датам, например, вычислить дату через 2 года и 6 месяцев:

Пример

julia> rightnow = Dates.now()
2022-05-11T09:01:07.946

julia> rightnow + Dates.Year(20) + Dates.Month(6)
2042-11-11T09:01:07.946

# Дата через 6 дней
julia> rightnow + Dates.Day(6)
2022-05-17T09:01:07.946

Диапазоны дат

Julia может создавать даты для заданного интервала, используя итерируемые объекты диапазонов. В приведённом ниже примере мы создадим итератор, который генерирует первый день каждого месяца.

Пример

date_range = Dates.Date(2011,1,1):Dates.Month(1):Dates.Date(2022,1,1)
Dates.Date("2011-01-01"):Dates.Month(1):Dates.Date("2022-01-01")

В объекте диапазона выше мы можем найти, какие из них являются будними днями. Здесь нам нужно создать анонимную функцию для filter(), которая определяет, является ли она будним днём на основе заданной даты:

Пример

julia> weekdaysfromrange = filter(dy -> Dates.dayname(dy) != "Saturday" && Dates.dayname(dy) != "Sunday" , date_range)
94-element Vector{Dates.Date}:
 2011-02-01
 2011-03-01
 2011-04-01
 2011-06-01
 2011-07-01
 2011-08-01
 2011-09-01
 2011-11-01
 2011-12-01
 2012-02-01
 ⋮
 2021-02-01
 2021-03-01
 2021-04-01
 2021-06-01
 2021-07-01
 2021-09-01
 2021-10-01
 2021-11-01
 2021-12-01

Округление дат и времени

Мы часто используем функции round(), floor() и ceil() для округления параметров вверх или вниз. Аналогично эти функции можно также использовать для округления дат, чтобы сдвигать даты вперёд или назад во времени.

Пример

julia> Dates.now()
2022-05-11T09:17:49.824

julia> Dates.format(round(Dates.DateTime(Dates.now()), Dates.Minute(15)), Dates.RFC1123Format)
"Wed, 11 May 2022 09:15:00"

ceil()Функция скорректирует дату/время вперёд, как показано ниже:

Пример

julia> theday = Dates.Date(2022,5,6)
2022-05-06

# Следующий месяц
julia> ceil(theday, Dates.Month)
2022-06-01

# Следующий год
julia> ceil(theday, Dates.Year)
2023-01-01

# Следующая неделя
julia> ceil(theday, Dates.Week)
2022-05-09

Повторяющиеся даты

Мы можем находить повторяющиеся даты в диапазоне, например, каждое воскресенье:

Пример

# Создать диапазон дат
julia> date_range = Dates.Date(2011,1,1):Dates.Month(1):Dates.Date(2022,1,1)
Dates.Date("2011-01-01"):Dates.Month(1):Dates.Date("2022-01-01")
# Используйте функцию filter(), чтобы исключить все воскресенья
julia> filter(d -> Dates.dayname(d) == "Sunday", date_range)
20-element Vector{Dates.Date}:
 2011-05-01
 2012-01-01
 2012-04-01
 2012-07-01
 2013-09-01
 2013-12-01
 2014-06-01
 2015-02-01
 2015-03-01
 2015-11-01
 2016-05-01
 2017-01-01
 2017-10-01
 2018-04-01
 2018-07-01
 2019-09-01
 2019-12-01
 2020-03-01
 2020-11-01
 2021-08-01
Время Unix

Время UNIX, или время POSIX, — это представление времени, используемое в UNIX или UNIX-подобных системах: общее количество секунд от 0:00:00 1 января 1970 UTC до настоящего момента, без учёта високосных секунд.

Функция time() возвращает значение Unix:

Пример

julia> time()
1.652232489777e9

Функция unix2datetime() преобразует время Unix в объект даты/времени:

Пример

julia> Dates.unix2datetime(time())
2022-05-11T01:28:23.493

Текущее время

Значения DateTime измеряются в миллисекундах; мы можем использовать функцию Dates.value, чтобы получить время в миллисекундах:

Пример

julia> moment=Dates.now()
2022-05-11T09:31:31.037

julia> Dates.value(moment)
63787944691037

julia> moment.instant
Dates.UTInstant{Millisecond}(Millisecond(63787944691037))

Время и мониторинг

Julia предоставляет нам@elapsedмакрос, который возвращает время (в секундах), необходимое для выполнения выражения.

Вычислите время, необходимое для выполнения следующего кода:

Пример

julia> function foo(n)
         for i in 1:n
           x = sin(rand())
         end
       end
foo (generic function with 1 method)


julia> @elapsed foo(100000000)
1.360567967

julia> @time foo(100000000)
  1.363258 seconds

Другие примеры

Пример

julia> DateTime(2013)
2013-01-01T00:00:00

julia> DateTime(2013,7)
2013-07-01T00:00:00

julia> DateTime(2013,7,1)
2013-07-01T00:00:00

julia> DateTime(2013,7,1,12)
2013-07-01T12:00:00

julia> DateTime(2013,7,1,12,30)
2013-07-01T12:30:00

julia> DateTime(2013,7,1,12,30,59)
2013-07-01T12:30:59

julia> DateTime(2013,7,1,12,30,59,1)
2013-07-01T12:30:59.001

julia> Date(2013)
2013-01-01

julia> Date(2013,7)
2013-07-01

julia> Date(2013,7,1)
2013-07-01

julia> Date(Dates.Year(2013),Dates.Month(7),Dates.Day(1))
2013-07-01

julia> Date(Dates.Month(7),Dates.Год(2013))
2013-07-01
Другие расширения