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 -> 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». Обратите внимание, что если вам нужно использовать символ кода как литерный символ, вы можете использовать символ экранирования обратный слэш. Строка «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.

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 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"