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. Аргументы могут быть в любом порядке. Неуказанные части 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 -> Dates.second(dt) == 40, 2010, 10, 20, 10; step = Dates.Second(1))
2010-10-20T10:00:40

julia> DateTime(dt -> Dates.hour(dt) == 20, 2010, 10, 20, 10; step = Dates.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". Обратите внимание, что если вам нужно использовать символ кода как литеранльный, вы можете использовать символ обратного слеша. Строка "1996y01m" может быть получена с форматом "yyyy\ymm\m".

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

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

Символы, не указанные выше, обычно обрабатываются как разделители между частями даты и времени. Например, dt строка "1996-01-15T00:00:00.0" будет иметь format строку типа "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-ddTHH: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 -> Dates.week(date) == 20, 2010, 01, 01)
2010-05-17

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

julia> Date(date -> Dates.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> Dates.Time(t -> Dates.minute(t) == 30, 20)
20:30:00

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

julia> Dates.Time(t -> Dates.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, или с форматом "ЧЧ:ММ:СС.мс" по умолчанию.

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

now() -> DateTime

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

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

Возвращает DateTime, соответствующий системному времени пользователя в формате UTC/GMT.

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> Dates.week(Date(1989, 6, 22))
25

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

julia> Dates.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> Dates.dayname(Date("2000-01-01"))
"Saturday"

julia> Dates.dayname(4)
"Thursday"

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

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

Примеры

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

julia> Dates.dayabbr(3)
"Wed"

dayofweek(dt::TimeType) -> Int64

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

Примеры

julia> Dates.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> Dates.dayofweekofmonth(Date("2000-02-01"))
1

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

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

daysofweekinmonth(dt::TimeType) -> Int

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

Примеры

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

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

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

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

Примеры

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

julia> Dates.monthname(2)
"February"

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

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

Примеры

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

julia> monthabbr(2)
"Feb"

daysinmonth(dt::TimeType) -> Int

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

Примеры

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

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

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

isleapyear(dt::TimeType) -> Bool

Возвращает true, если год dt високосный.

Примеры

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

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

dayofyear(dt::TimeType) -> Int

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

daysinyear(dt::TimeType) -> Int

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

Примеры

julia> Dates.daysinyear(1999)
365

julia> Dates.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(Dates.DateTime("1996-01-01T12:30:00"), Dates.Day)
1996-01-01T00:00:00

firstdayofweek(dt::TimeType) -> TimeType

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

Примеры

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

lastdayofweek(dt::TimeType) -> TimeType

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

Примеры

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

firstdayofmonth(dt::TimeType) -> TimeType

Корректирует dt на первый день своего месяца.

Примеры

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

lastdayofmonth(dt::TimeType) -> TimeType

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

Примеры

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

firstdayofyear(dt::TimeType) -> TimeType

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

Примеры

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

lastdayofyear(dt::TimeType) -> TimeType

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

Примеры

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

firstdayofquarter(dt::TimeType) -> TimeType

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

Примеры

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

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

lastdayofquarter(dt::TimeType) -> TimeType

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

Примеры

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

julia> Dates.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 периодов 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 к канонической форме, применяя следующие правила:

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

Примеры

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

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

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

julia> Dates.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), Dates.Month)
1985-08-01

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

julia> floor(DateTime(2016, 8, 6, 12, 0, 0), Dates.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), Dates.Month)
1985-09-01

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

julia> ceil(DateTime(2016, 8, 6, 12, 0, 0), Dates.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), Dates.Month)
1985-08-01

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

julia> round(DateTime(2016, 8, 6, 12, 0, 0), Dates.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(Dates.Day(16), Dates.Week)
2 weeks

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

julia> floor(Dates.Hour(36), Dates.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(Dates.Day(16), Dates.Week)
3 weeks

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

julia> ceil(Dates.Hour(36), Dates.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(Dates.Day(16), Dates.Week)
2 weeks

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

julia> round(Dates.Hour(36), Dates.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

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

datetime2rata(dt::TimeType) -> Int64

Возвращает количество дней Рата Дие с эпохи от заданной 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"