Даты

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

Period типы представляют собой дискретные, человекопонятные представления времени.

CompoundPeriod

CompoundPeriod полезен для выражения временных интервалов, которые не являются фиксированным кратным меньших интервалов. Например, «год и день» — это не фиксированное количество дней, но может быть выражено с помощью CompoundPeriod. Фактически, CompoundPeriod автоматически генерируется при сложении различных типов периодов, например, Year(1) + Day(1) дает результат CompoundPeriod.

Instant

Instant типы представляют целочисленные, машинные представления времени как непрерывные временные линии, начинающиеся с эпохи.

UTInstant{T}

UTInstant представляет собой машинную временную шкалу, основанную на UT-времени (1 день = одно вращение Земли). T — это Period параметр, который указывает разрешение или точность момента.

TimeType

TimeType типы оборачивают Instant машинные экземпляры, чтобы предоставить человекопонятные представления машинного момента. Time, DateTime и Date являются подтипами TimeType.

DateTime

DateTime представляет точку во времени в соответствии с пролептическим григорианским календарем. Наименьшее разрешение времени составляет миллисекунда (микросекунды или наносекунды не могут быть представлены этим типом). Тип поддерживает арифметику с плавающей запятой и, следовательно, подвержен подпотоку (и переполнению). Заметным следствием является округление при добавлении Microsecond или Nanosecond:

julia> dt = DateTime(2023, 8, 19, 17, 45, 32, 900)
2023-08-19T17:45:32.900

julia> dt + Millisecond(1)
2023-08-19T17:45:32.901

julia> dt + Microsecond(1000) # 1000us == 1ms
2023-08-19T17:45:32.901

julia> dt + Microsecond(999) # 999us rounded to 1000us
2023-08-19T17:45:32.901

julia> dt + Microsecond(1499) # 1499 rounded to 1000us
2023-08-19T17:45:32.901

Date

Date оборачивает UTInstant{Day} и интерпретирует его в соответствии с пролептическим григорианским календарем.

Time

Time оборачивает Nanosecond и представляет определенный момент в 24-часовом дне.

TimeZone

Географическая зона, обычно основанная на долготе, определяющая время в определенном месте. Некоторые часовые пояса соблюдают летнее время (например, EST —> EDT). Для реализации и дополнительной поддержки см. пакет TimeZones.jl

UTC

UTC, или Координированное универсальное время, является TimeZone, от которого измеряются все остальные. Он связан со временем на 0° долготы. Он не корректируется по летнему времени.

DateTime(y, [m, d, h, mi, s, ms]) -> DateTime

Создать тип DateTime по частям. Аргументы должны быть преобразуемы в Int64.

DateTime(periods::Period...) -> DateTime

Создать тип DateTime по частям типа Period. Аргументы могут быть в любом порядке. Не указанные части DateTime будут по умолчанию иметь значение Dates.default(period).

DateTime(f::Function, y[, m, d, h, mi, s]; step=Day(1), limit=10000) -> DateTime

Создать DateTime с помощью API корректировки. Начальная точка будет построена из предоставленных аргументов y, m, d..., и будет корректироваться до тех пор, пока f::Function не вернет true. Шаг корректировки может быть задан вручную с помощью ключевого слова step. limit устанавливает лимит на максимальное число итераций, которые API корректировки будет выполнять перед ошибкой (в случае, если f::Function никогда не будет удовлетворено).

Примеры

julia> DateTime(dt -> second(dt) == 40, 2010, 10, 20, 10; step = Second(1))
2010-10-20T10:00:40

julia> DateTime(dt -> hour(dt) == 20, 2010, 10, 20, 10; step = Hour(1), limit = 5)
ERROR: ArgumentError: Adjustment limit reached: 5 iterations
Stacktrace:
[...]

DateTime(dt::Date) -> DateTime

Преобразовать Date в DateTime. Часы, минуты, секунды и миллисекунды новой DateTime предполагаются нулевыми.

DateTime(dt::AbstractString, format::AbstractString; locale="english") -> DateTime

Создать DateTime путем разбора строки даты и времени dt в соответствии с шаблоном, заданным в строке format (синтаксис см. в DateFormat).

Примеры

julia> DateTime("2020-01-01", "yyyy-mm-dd")
2020-01-01T00:00:00

julia> a = ("2020-01-01", "2020-01-02");

julia> [DateTime(d, dateformat"yyyy-mm-dd") for d ∈ a] # preferred
2-element Vector{DateTime}:
 2020-01-01T00:00:00
 2020-01-02T00:00:00

format(dt::TimeType, format::AbstractString; locale="english") -> AbstractString

Создать строку, используя объект TimeType и применяя предоставленный format. Следующие символы кода могут быть использованы для построения строки format:

Количество последовательных символов кода указывает ширину кода. Формат yyyy-mm указывает, что код y должен иметь ширину четыре, а m — две. Коды, которые генерируют числовые цифры, имеют связанный режим: фиксированной ширины или минимальной ширины. Режим фиксированной ширины слева заполняет значение нулями, если оно короче указанной ширины, и обрезает значение, если оно длиннее. Режим минимальной ширины работает так же, как режим фиксированной ширины, за исключением того, что он не обрезает значения, которые длиннее ширины.

При создании format вы можете использовать любые символы, отличные от кода, в качестве разделителей. Например, для создания строки «1996-01-15T00:00:00» вы можете использовать format: «гггг-мм-ддЧЧ:ММ:СС». Обратите внимание, что если вам нужно использовать символ кода как буквенный символ, вы можете использовать символ экранирования обратный слэш. Строка «1996y01m» может быть создана с форматом «гггг\мм\м».

DateFormat(format::AbstractString, locale="english") -> DateFormat

Создайте объект форматирования даты, который можно использовать для парсинга строк даты или форматирования объекта даты в виде строки. Следующие символьные коды могут быть использованы для построения строки format:

Символы, не указанные выше, обычно рассматриваются как разделители между частями даты и времени. Например, строка "1996-01-15T00:00:00.0" будет иметь строку формата "y-m-dTH:M:S.s". Если вам нужно использовать символ кода в качестве разделителя, вы можете экранировать его с помощью обратного слэша. Дата "1995y01m" будет иметь формат "y\ym\m".

Обратите внимание, что 12:00AM соответствует 00:00 (полночь), а 12:00PM соответствует 12:00 (полдень). При парсинге времени с указателем p, любой час (как H или I) интерпретируется как 12-часовой формат, поэтому код I в основном полезен для вывода.

Создание объекта DateFormat затратно. По возможности создавайте его один раз и используйте многократно или попробуйте макрос строки dateformat"". Использование этого макроса создает объект DateFormat один раз во время расширения макроса и повторно использует его позже. Также существуют несколько предварительно определенных форматировщиков, перечисленных позже.

См. DateTime и format для информации о том, как использовать объект DateFormat для парсинга и записи строк дат соответственно.

dateformat"Y-m-d H:M:S"

Создайте объект DateFormat. Похоже на DateFormat("Y-m-d H:M:S"), но создает объект DateFormat один раз во время расширения макроса.

См. DateFormat для подробностей о спецификаторах формата.

DateTime(dt::AbstractString, df::DateFormat=ISODateTimeFormat) -> DateTime

Создайте DateTime, разобрав строку даты и времени dt по шаблону, заданному в объекте DateFormat, или dateformat"yyyy-mm-dd\THH:MM:SS.s" при отсутствии.

Аналогично DateTime(::AbstractString, ::AbstractString), но более эффективно при многократном парсинге строк даты и времени с предварительно созданным объектом DateFormat.

Date(y, [m, d]) -> Date

Создайте тип Date по частям. Аргументы должны быть преобразуемы в Int64.

Date(period::Period...) -> Date

Создайте тип Date по частям типа Period. Аргументы могут быть в любом порядке. Date отсутствующие части будут по умолчанию иметь значение Dates.default(period).

Date(f::Function, y[, m, d]; step=Day(1), limit=10000) -> Date

Создайте Date с помощью API настройки. Точка отсчёта будет построена из предоставленных аргументов y, m, d, и будет корректироваться, пока f::Function не вернёт true. Размер шага при настройке можно задать вручную через ключевое слово step . limit задаёт ограничение на максимальное число итераций, которые API настройки будет выполнять, прежде чем выбросит ошибку (в случае, если f::Function никогда не будет удовлетворён).

Примеры

julia> Date(date -> week(date) == 20, 2010, 01, 01)
2010-05-17

julia> Date(date -> year(date) == 2010, 2000, 01, 01)
2010-01-01

julia> Date(date -> month(date) == 10, 2000, 01, 01; limit = 5)
ERROR: ArgumentError: Adjustment limit reached: 5 iterations
Stacktrace:
[...]

Date(dt::DateTime) -> Date

Преобразуйте DateTime в Date. Часть часа, минуты, секунды и миллисекунды DateTime отбрасываются, так что при построении используются только год, месяц и день.

Date(d::AbstractString, format::AbstractString; locale="english") -> Date

Создайте Date, разобрав строку даты d по шаблону, заданному в строке format (см. DateFormat для синтаксиса).

Примеры

julia> Date("2020-01-01", "yyyy-mm-dd")
2020-01-01

julia> a = ("2020-01-01", "2020-01-02");

julia> [Date(d, dateformat"yyyy-mm-dd") for d ∈ a] # preferred
2-element Vector{Date}:
 2020-01-01
 2020-01-02

Date(d::AbstractString, df::DateFormat=ISODateFormat) -> Date

Создайте Date, разобрав строку даты d по шаблону, заданному в объекте DateFormat, или dateformat"yyyy-mm-dd" при отсутствии.

Аналогично Date(::AbstractString, ::AbstractString), но более эффективно при многократном парсинге строк даты с предварительно созданным объектом DateFormat.

Time(h, [mi, s, ms, us, ns]) -> Time

Создайте тип Time по частям. Аргументы должны быть преобразуемы в Int64.

Time(period::TimePeriod...) -> Time

Создайте тип Time по частям типа Period . Аргументы могут быть в любом порядке. Time отсутствующие части будут по умолчанию иметь значение Dates.default(period).

Time(f::Function, h, mi=0; step::Period=Second(1), limit::Int=10000)
Time(f::Function, h, mi, s; step::Period=Millisecond(1), limit::Int=10000)
Time(f::Function, h, mi, s, ms; step::Period=Microsecond(1), limit::Int=10000)
Time(f::Function, h, mi, s, ms, us; step::Period=Nanosecond(1), limit::Int=10000)

Создайте Time с помощью API настройки. Точка отсчёта будет построена из предоставленных аргументов h, mi, s, ms, us, и будет корректироваться, пока f::Function не вернёт true. Размер шага при настройке можно задать вручную через ключевое слово step. limit задаёт ограничение на максимальное число итераций, которые API настройки будет выполнять, прежде чем выбросить ошибку (в случае, если f::Function никогда не будет удовлетворён). Обратите внимание, что по умолчанию шаг будет настраиваться для обеспечения большей точности для заданных аргументов; например, если указаны часы, минуты и секунды, по умолчанию шаг будет Millisecond(1) вместо Second(1).

Примеры

julia> Time(t -> minute(t) == 30, 20)
20:30:00

julia> Time(t -> minute(t) == 0, 20)
20:00:00

julia> Time(t -> hour(t) == 10, 3; limit = 5)
ERROR: ArgumentError: Adjustment limit reached: 5 iterations
Stacktrace:
[...]

Time(dt::DateTime) -> Time

Преобразуйте DateTime в Time. Части часа, минуты, секунды и миллисекунды DateTime используются для создания нового Time. Микросекунды и наносекунды по умолчанию равны нулю.

Time(t::AbstractString, format::AbstractString; locale="english") -> Time

Создайте Time, разобрав строку времени t по шаблону, заданному в строке format (см. DateFormat для синтаксиса).

Примеры

julia> Time("12:34pm", "HH:MMp")
12:34:00

julia> a = ("12:34pm", "2:34am");

julia> [Time(d, dateformat"HH:MMp") for d ∈ a] # preferred
2-element Vector{Time}:
 12:34:00
 02:34:00

Time(t::AbstractString, df::DateFormat=ISOTimeFormat) -> Time

Создайте Time, разобрав строку даты и времени t по шаблону, заданному в объекте DateFormat, или по умолчанию "HH:MM:SS.s".

Аналогично Time(::AbstractString, ::AbstractString), но более эффективно при многократном разборе строк времени с похожим форматом с помощью предварительно созданного объекта DateFormat.

now() -> DateTime

Возвращает DateTime, соответствующий системному времени пользователя, включая системную часовую зону и локаль.

now(::Type{UTC}) -> DateTime

Возвращает DateTime, соответствующий системному времени пользователя в формате UTC/GMT. Для других часовых поясов используйте пакет TimeZones.jl.

Примеры

julia> now(UTC)
2023-01-04T10:52:24.864

eps(::Type{DateTime}) -> Millisecond
eps(::Type{Date}) -> Day
eps(::Type{Time}) -> Nanosecond
eps(::TimeType) -> Period

Возвращает наименьшее значение единицы, поддерживаемое TimeType.

Примеры

julia> eps(DateTime)
1 millisecond

julia> eps(Date)
1 day

julia> eps(Time)
1 nanosecond

year(dt::TimeType) -> Int64

Год Date или DateTime в виде Int64.

month(dt::TimeType) -> Int64

Месяц Date или DateTime в виде Int64.

week(dt::TimeType) -> Int64

Возвращает номер недели ISO Date или DateTime в виде Int64. Обратите внимание, что первая неделя года — это неделя, содержащая первый четверг года, что может привести к тому, что даты до 4 января будут относиться к последней неделе предыдущего года. Например, week(Date(2005, 1, 1)) — это 53-я неделя 2004 года.

Примеры

julia> week(Date(1989, 6, 22))
25

julia> week(Date(2005, 1, 1))
53

julia> week(Date(2004, 12, 31))
53

day(dt::TimeType) -> Int64

День месяца Date или DateTime в виде Int64.

hour(dt::DateTime) -> Int64

Час DateTime в виде Int64.

hour(t::Time) -> Int64

Час Time в виде Int64.

minute(dt::DateTime) -> Int64

Минута DateTime в виде Int64.

minute(t::Time) -> Int64

Минута Time в виде Int64.

second(dt::DateTime) -> Int64

Секунда DateTime в виде Int64.

second(t::Time) -> Int64

Секунда Time в виде Int64.

millisecond(dt::DateTime) -> Int64

Миллисекунда DateTime в виде Int64.

millisecond(t::Time) -> Int64

Миллисекунда Time в виде Int64.

microsecond(t::Time) -> Int64

Микросекунда Time в виде Int64.

nanosecond(t::Time) -> Int64

Наносекунда Time в виде Int64.

Year(v)

Создаёт объект Year со значением v. Вход должен быть без потерь преобразуем в Int64.

Month(v)

Создаёт объект Month со значением v. Вход должен быть без потерь преобразуем в Int64.

Week(v)

Создаёт объект Week со значением v. Вход должен быть без потерь преобразуем в Int64.

Day(v)

Создаёт объект Day со значением v. Вход должен быть без потерь преобразуем в Int64.

Hour(dt::DateTime) -> Hour

Часовая часть DateTime в виде Hour.

Minute(dt::DateTime) -> Minute

Минутная часть DateTime в виде Minute.

Second(dt::DateTime) -> Second

Секундная часть DateTime в виде Second.

Millisecond(dt::DateTime) -> Millisecond

Миллисекундная часть DateTime в виде Millisecond.

Microsecond(dt::Time) -> Microsecond

Микросекундная часть Time в виде Microsecond.

Nanosecond(dt::Time) -> Nanosecond

Наносекундная часть Time в виде Nanosecond.

yearmonth(dt::TimeType) -> (Int64, Int64)

Одновременно возвращает год и месяц Date или DateTime.

monthday(dt::TimeType) -> (Int64, Int64)

Одновременно возвращает месяц и день Date или DateTime.

yearmonthday(dt::TimeType) -> (Int64, Int64, Int64)

Одновременно возвращает год, месяц и день Date или DateTime.

dayname(dt::TimeType; locale="english") -> String
dayname(day::Integer; locale="english") -> String

Возвращает полное название дня недели для Date или DateTime в заданной locale. Также принимает Integer.

Примеры

julia> dayname(Date("2000-01-01"))
"Saturday"

julia> dayname(4)
"Thursday"

dayabbr(dt::TimeType; locale="english") -> String
dayabbr(day::Integer; locale="english") -> String

Возвращает сокращённое название дня недели для Date или DateTime в заданной locale. Также принимает Integer.

Примеры

julia> dayabbr(Date("2000-01-01"))
"Sat"

julia> dayabbr(3)
"Wed"

dayofweek(dt::TimeType) -> Int64

Возвращает номер дня недели в виде Int64 с 1 = Monday, 2 = Tuesday, etc..

Примеры

julia> dayofweek(Date("2000-01-01"))
6

dayofmonth(dt::TimeType) -> Int64

День месяца Date или DateTime в виде Int64.

dayofweekofmonth(dt::TimeType) -> Int

Для дня недели dt, вернуть его номер в месяце dt. Таким образом, если день недели dt — понедельник, то 1 = First Monday of the month, 2 = Second Monday of the month, etc. В диапазоне от 1 до 5.

Примеры

julia> dayofweekofmonth(Date("2000-02-01"))
1

julia> dayofweekofmonth(Date("2000-02-08"))
2

julia> dayofweekofmonth(Date("2000-02-15"))
3

daysofweekinmonth(dt::TimeType) -> Int

Для дня недели dt, вернуть общее количество этого дня недели в месяце dt. Возвращает 4 или 5. Полезно в временных выражениях для указания последнего дня недели в месяце, включив dayofweekofmonth(dt) == daysofweekinmonth(dt) в функцию корректировки.

Примеры

julia> daysofweekinmonth(Date("2005-01-01"))
5

julia> daysofweekinmonth(Date("2005-01-04"))
4

monthname(dt::TimeType; locale="english") -> String
monthname(month::Integer, locale="english") -> String

Вернуть полное имя месяца Date или DateTime или Integer в заданном locale.

Примеры

julia> monthname(Date("2005-01-04"))
"January"

julia> monthname(2)
"February"

monthabbr(dt::TimeType; locale="english") -> String
monthabbr(month::Integer, locale="english") -> String

Вернуть сокращенное имя месяца Date или DateTime или Integer в заданном locale.

Примеры

julia> monthabbr(Date("2005-01-04"))
"Jan"

julia> monthabbr(2)
"Feb"

daysinmonth(dt::TimeType) -> Int

Вернуть количество дней в месяце dt. Значение будет 28, 29, 30 или 31.

Примеры

julia> daysinmonth(Date("2000-01"))
31

julia> daysinmonth(Date("2001-02"))
28

julia> daysinmonth(Date("2000-02"))
29

isleapyear(dt::TimeType) -> Bool

Вернуть true, если год dt является високосным.

Примеры

julia> isleapyear(Date("2004"))
true

julia> isleapyear(Date("2005"))
false

dayofyear(dt::TimeType) -> Int

Вернуть день года для dt, где 1 января — день 1.

daysinyear(dt::TimeType) -> Int

Вернуть 366, если год dt високосный, иначе вернуть 365.

Примеры

julia> daysinyear(1999)
365

julia> daysinyear(2000)
366

quarterofyear(dt::TimeType) -> Int

Вернуть квартал, в котором находится dt. Диапазон значений — от 1 до 4.

dayofquarter(dt::TimeType) -> Int

Вернуть день текущего квартала dt. Диапазон значений — от 1 до 92.

trunc(dt::TimeType, ::Type{Period}) -> TimeType

Округляет значение dt в соответствии с предоставленным типом Period.

Примеры

julia> trunc(DateTime("1996-01-01T12:30:00"), Day)
1996-01-01T00:00:00

firstdayofweek(dt::TimeType) -> TimeType

Корректирует dt до понедельника своей недели.

Примеры

julia> firstdayofweek(DateTime("1996-01-05T12:30:00"))
1996-01-01T00:00:00

lastdayofweek(dt::TimeType) -> TimeType

Корректирует dt до воскресенья своей недели.

Примеры

julia> lastdayofweek(DateTime("1996-01-05T12:30:00"))
1996-01-07T00:00:00

firstdayofmonth(dt::TimeType) -> TimeType

Корректирует dt к первому дню месяца.

Примеры

julia> firstdayofmonth(DateTime("1996-05-20"))
1996-05-01T00:00:00

lastdayofmonth(dt::TimeType) -> TimeType

Корректирует dt к последнему дню месяца.

Примеры

julia> lastdayofmonth(DateTime("1996-05-20"))
1996-05-31T00:00:00

firstdayofyear(dt::TimeType) -> TimeType

Корректирует dt к первому дню года.

Примеры

julia> firstdayofyear(DateTime("1996-05-20"))
1996-01-01T00:00:00

lastdayofyear(dt::TimeType) -> TimeType

Корректирует dt к последнему дню года.

Примеры

julia> lastdayofyear(DateTime("1996-05-20"))
1996-12-31T00:00:00

firstdayofquarter(dt::TimeType) -> TimeType

Корректирует dt к первому дню квартала.

Примеры

julia> firstdayofquarter(DateTime("1996-05-20"))
1996-04-01T00:00:00

julia> firstdayofquarter(DateTime("1996-08-20"))
1996-07-01T00:00:00

lastdayofquarter(dt::TimeType) -> TimeType

Корректирует dt к последнему дню квартала.

Примеры

julia> lastdayofquarter(DateTime("1996-05-20"))
1996-06-30T00:00:00

julia> lastdayofquarter(DateTime("1996-08-20"))
1996-09-30T00:00:00

tonext(dt::TimeType, dow::Int; same::Bool=false) -> TimeType

Корректирует dt к следующему дню недели, соответствующему dow, с шагом 1 = Monday, 2 = Tuesday, etc. Установка same=true позволяет рассматривать текущий dt как следующий dow, что не приведет к корректировке.

toprev(dt::TimeType, dow::Int; same::Bool=false) -> TimeType

Корректирует dt к предыдущему дню недели, соответствующему dow, с шагом 1 = Monday, 2 = Tuesday, etc. Установка same=true позволяет рассматривать текущий dt как предыдущий dow, что не приведет к корректировке.

tofirst(dt::TimeType, dow::Int; of=Month) -> TimeType

Корректирует dt к первому дню месяца. В качестве альтернативы, of=Year будет скорректировано к первому дню года.

tolast(dt::TimeType, dow::Int; of=Month) -> TimeType

Корректирует dt к последнему дню месяца. В качестве альтернативы, of=Year будет скорректировано к последнему дню года.

tonext(func::Function, dt::TimeType; step=Day(1), limit=10000, same=false) -> TimeType

Корректирует dt путем итерации не более limit итераций с шагом step до тех пор, пока func не вернет true. func должна принимать один аргумент TimeType и возвращать Bool. same позволяет рассматривать dt как удовлетворяющее func.

toprev(func::Function, dt::TimeType; step=Day(-1), limit=10000, same=false) -> TimeType

Корректирует dt путем итерации не более limit итераций с шагом step до тех пор, пока func не вернет true. func должна принимать один аргумент TimeType и возвращать Bool. same позволяет рассматривать dt как удовлетворяющее func.

Year(v)
Quarter(v)
Month(v)
Week(v)
Day(v)
Hour(v)
Minute(v)
Second(v)
Millisecond(v)
Microsecond(v)
Nanosecond(v)

Создать тип Period со значением v. Ввод должен быть без потерь преобразуем в Int64.

CompoundPeriod(periods) -> CompoundPeriod

Создать CompoundPeriod из Vector Period. Все Period одного типа будут складываться.

Примеры

julia> Dates.CompoundPeriod(Dates.Hour(12), Dates.Hour(13))
25 hours

julia> Dates.CompoundPeriod(Dates.Hour(-1), Dates.Minute(1))
-1 hour, 1 minute

julia> Dates.CompoundPeriod(Dates.Month(1), Dates.Week(-2))
1 month, -2 weeks

julia> Dates.CompoundPeriod(Dates.Minute(50000))
50000 minutes

canonicalize(::CompoundPeriod) -> CompoundPeriod

Сводит CompoundPeriod к канонической форме, применяя следующие правила:

• Любой Period достаточно большой, чтобы частично представиться более грубым Period, будет разбит на несколько Period (например, Hour(30) становится Day(1) + Hour(6))
• Period с противоположными знаками будут объединены, когда это возможно (например, Hour(1) - Day(1) становится -Hour(23))

Примеры

julia> canonicalize(Dates.CompoundPeriod(Dates.Hour(12), Dates.Hour(13)))
1 day, 1 hour

julia> canonicalize(Dates.CompoundPeriod(Dates.Hour(-1), Dates.Minute(1)))
-59 minutes

julia> canonicalize(Dates.CompoundPeriod(Dates.Month(1), Dates.Week(-2)))
1 month, -2 weeks

julia> canonicalize(Dates.CompoundPeriod(Dates.Minute(50000)))
4 weeks, 6 days, 17 hours, 20 minutes

Dates.value(x::Period) -> Int64

Для данного периода вернуть связанное с ним значение. Например, value(Millisecond(10)) возвращает 10 как целое число.

default(p::Period) -> Period

Вернуть разумное значение "по умолчанию" для входного периода, возвращая T(1) для года, месяца и дня и T(0) для часа, минуты, секунды и миллисекунды.

Dates.periods(::CompoundPeriod) -> Vector{Period}

Вернуть Vector Period составляющих заданный CompoundPeriod.

floor(dt::TimeType, p::Period) -> TimeType

Возвращает ближайшее Date или DateTime значение, меньшее или равное dt с разрешением p.

Для удобства, p может быть типом вместо значения: floor(dt, Dates.Hour) — это сокращение для floor(dt, Dates.Hour(1)).

julia> floor(Date(1985, 8, 16), Month)
1985-08-01

julia> floor(DateTime(2013, 2, 13, 0, 31, 20), Minute(15))
2013-02-13T00:30:00

julia> floor(DateTime(2016, 8, 6, 12, 0, 0), Day)
2016-08-06T00:00:00

ceil(dt::TimeType, p::Period) -> TimeType

Возвращает ближайшее Date или DateTime значение, большее или равное dt с разрешением p.

Для удобства, p может быть типом вместо значения: ceil(dt, Dates.Hour) — это сокращение для ceil(dt, Dates.Hour(1)).

julia> ceil(Date(1985, 8, 16), Month)
1985-09-01

julia> ceil(DateTime(2013, 2, 13, 0, 31, 20), Minute(15))
2013-02-13T00:45:00

julia> ceil(DateTime(2016, 8, 6, 12, 0, 0), Day)
2016-08-07T00:00:00

round(dt::TimeType, p::Period, [r::RoundingMode]) -> TimeType

Возвращает Date или DateTime значение, ближайшее к dt с разрешением p. По умолчанию (RoundNearestTiesUp), в случае равенства (например, округление 9:30 до ближайшего часа) округление будет выполняться в большую сторону.

Для удобства, p может быть типом вместо значения: round(dt, Dates.Hour) — это сокращение для round(dt, Dates.Hour(1)).

julia> round(Date(1985, 8, 16), Month)
1985-08-01

julia> round(DateTime(2013, 2, 13, 0, 31, 20), Minute(15))
2013-02-13T00:30:00

julia> round(DateTime(2016, 8, 6, 12, 0, 0), Day)
2016-08-07T00:00:00

Допустимые режимы округления для round(::TimeType, ::Period, ::RoundingMode) — это RoundNearestTiesUp (по умолчанию), RoundDown (floor) и RoundUp (ceil).

floor(x::Period, precision::T) where T <: Union{TimePeriod, Week, Day} -> T

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

Для удобства, precision может быть типом вместо значения: floor(x, Dates.Hour) — это сокращение для floor(x, Dates.Hour(1)).

julia> floor(Day(16), Week)
2 weeks

julia> floor(Minute(44), Minute(15))
30 minutes

julia> floor(Hour(36), Day)
1 day

Округление до кратного precision Month или Year не поддерживается, так как эти Period имеют разную длину.

ceil(x::Period, precision::T) where T <: Union{TimePeriod, Week, Day} -> T

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

Для удобства, precision может быть типом вместо значения: ceil(x, Dates.Hour) — это сокращение для ceil(x, Dates.Hour(1)).

julia> ceil(Day(16), Week)
3 weeks

julia> ceil(Minute(44), Minute(15))
45 minutes

julia> ceil(Hour(36), Day)
2 days

Округление до кратного precision Month или Year не поддерживается, так как эти Period имеют разную длину.

round(x::Period, precision::T, [r::RoundingMode]) where T <: Union{TimePeriod, Week, Day} -> T

Округляет x до ближайшего кратного precision. Если x и precision являются различными подтипами Period, возвращаемое значение будет иметь тот же тип, что и precision. По умолчанию (RoundNearestTiesUp), в случае равенства (например, округление 90 минут до ближайшего часа) округление будет выполняться в большую сторону.

Для удобства, precision может быть типом вместо значения: round(x, Dates.Hour) — это сокращение для round(x, Dates.Hour(1)).

julia> round(Day(16), Week)
2 weeks

julia> round(Minute(44), Minute(15))
45 minutes

julia> round(Hour(36), Day)
2 days

Допустимые режимы округления для round(::Period, ::T, ::RoundingMode) — это RoundNearestTiesUp (по умолчанию), RoundDown (floor) и RoundUp (ceil).

Округление до кратного precision Month или Year не поддерживается, так как эти Period имеют разную длину.

floorceil(dt::TimeType, p::Period) -> (TimeType, TimeType)

Одновременно возвращают floor и ceil значения для Date или DateTime с разрешением p. Более эффективно, чем вызов floor и ceil по отдельности.

floorceil(x::Period, precision::T) where T <: Union{TimePeriod, Week, Day} -> (T, T)

Одновременно возвращают floor и ceil значения для Period с разрешением p. Более эффективно, чем вызов floor и ceil по отдельности.

epochdays2date(days) -> Date

Принимает количество дней с эпохи округления (0000-01-01T00:00:00) и возвращает соответствующую Date.

epochms2datetime(milliseconds) -> DateTime

Принимает количество миллисекунд с эпохи округления (0000-01-01T00:00:00) и возвращает соответствующую DateTime.

date2epochdays(dt::Date) -> Int64

Принимает заданную Date и возвращает количество дней с эпохи округления (0000-01-01T00:00:00) как Int64.

datetime2epochms(dt::DateTime) -> Int64

Принимает заданную DateTime и возвращает количество миллисекунд с эпохи округления (0000-01-01T00:00:00) как Int64.

today() -> Date

Возвращает дату из now().

unix2datetime(x) -> DateTime

Принимает количество секунд с эпохи Unix 1970-01-01T00:00:00 и преобразует в соответствующую DateTime.

datetime2unix(dt::DateTime) -> Float64

Принимает заданную DateTime и возвращает количество секунд с эпохи Unix 1970-01-01T00:00:00 как Float64.

julian2datetime(julian_days) -> DateTime

Принимает количество дней юлианского календаря с эпохи -4713-11-24T12:00:00 и возвращает соответствующую DateTime.

datetime2julian(dt::DateTime) -> Float64

Принимает заданную DateTime и возвращает количество дней юлианского календаря с эпохи -4713-11-24T12:00:00 как Float64.

rata2datetime(days) -> DateTime

Принимает количество дней Rata Die с эпохи 0000-12-31T00:00:00 и возвращает соответствующую DateTime.

datetime2rata(dt::TimeType) -> Int64

Возвращает количество дней Rata Die с эпохи для заданной Date или DateTime.

Dates.ISODateTimeFormat

Описание формата ISO8601 для даты и времени. Это значение по умолчанию для Dates.format DateTime.

Примеры

julia> Dates.format(DateTime(2018, 8, 8, 12, 0, 43, 1), ISODateTimeFormat)
"2018-08-08T12:00:43.001"

Dates.ISODateFormat

Описание формата ISO8601 для даты. Это значение по умолчанию для Dates.format Date.

Примеры

julia> Dates.format(Date(2018, 8, 8), ISODateFormat)
"2018-08-08"

Dates.ISOTimeFormat

Описание формата ISO8601 для времени. Это значение по умолчанию для Dates.format Time.

Примеры

julia> Dates.format(Time(12, 0, 43, 1), ISOTimeFormat)
"12:00:43.001"

Dates.RFC1123Format

Описание формата RFC1123 для даты и времени.

Примеры

julia> Dates.format(DateTime(2018, 8, 8, 12, 0, 43, 1), RFC1123Format)
"Wed, 08 Aug 2018 12:00:43"