Даты

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 обертывает UTInstant{Millisecond} и интерпретирует его в соответствии с пролептическим григорианским календарём.

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. Аргументы могут быть в любом порядке. Части Dates.default(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: "yyyy-mm-ddTHH:MM:SS". Обратите внимание, что если вам нужно использовать кодовый символ как литерал, вы можете использовать символ обратного слэша в качестве escape-символа. Строка "1996y01m" может быть получена с форматом "yyyy\ymm\m".

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

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

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

Обратите внимание, что 12:00 AM соответствует 00:00 (полночь), а 12:00 PM соответствует 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, или "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, или по умолчанию "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 до первого dow месяца. В качестве альтернативы, of=Year корректирует до первого dow года.

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

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

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 Periods. Все 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 Periods, составляющих заданный 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"