# This file is a part of Julia. License is MIT: https://julialang.org/license # Instant arithmetic (+)(x::Instant) = x (-)(x::T, y::T) where {T<:Instant} = x.periods - y.periods # TimeType arithmetic (+)(x::TimeType) = x (-)(x::T, y::T) where {T<:TimeType} = x.instant - y.instant # Date-Time arithmetic """ dt::Date + t::Time -> DateTime The addition of a `Date` with a `Time` produces a `DateTime`. The hour, minute, second, and millisecond parts of the `Time` are used along with the year, month, and day of the `Date` to create the new `DateTime`. Non-zero microseconds or nanoseconds in the `Time` type will result in an `InexactError` being thrown. """ function (+)(dt::Date, t::Time) (microsecond(t) > 0 || nanosecond(t) > 0) && throw(InexactError()) y, m, d = yearmonthday(dt) return DateTime(y, m, d, hour(t), minute(t), second(t), millisecond(t)) end (+)(t::Time, dt::Date) = dt + t # TimeType-Year arithmetic function (+)(dt::DateTime, y::Year) oy, m, d = yearmonthday(dt); ny = oy + value(y); ld = daysinmonth(ny, m) return DateTime(ny, m, d <= ld ? d : ld, hour(dt), minute(dt), second(dt), millisecond(dt)) end function (+)(dt::Date,y::Year) oy, m, d = yearmonthday(dt); ny = oy + value(y); ld = daysinmonth(ny, m) return Date(ny, m, d <= ld ? d : ld) end function (-)(dt::DateTime,y::Year) oy, m, d = yearmonthday(dt); ny = oy - value(y); ld = daysinmonth(ny, m) return DateTime(ny, m, d <= ld ? d : ld, hour(dt), minute(dt), second(dt), millisecond(dt)) end function (-)(dt::Date,y::Year) oy, m, d = yearmonthday(dt); ny = oy - value(y); ld = daysinmonth(ny, m) return Date(ny, m, d <= ld ? d : ld) end # TimeType-Month arithmetic # monthwrap adds two months with wraparound behavior (i.e. 12 + 1 == 1) monthwrap(m1, m2) = (v = mod1(m1 + m2, 12); return v < 0 ? 12 + v : v) # yearwrap takes a starting year/month and a month to add and returns # the resulting year with wraparound behavior (i.e. 2000-12 + 1 == 2001) yearwrap(y, m1, m2) = y + fld(m1 + m2 - 1, 12) function (+)(dt::DateTime, z::Month) y,m,d = yearmonthday(dt) ny = yearwrap(y, m, value(z)) mm = monthwrap(m, value(z)); ld = daysinmonth(ny, mm) return DateTime(ny, mm, d <= ld ? d : ld, hour(dt), minute(dt), second(dt), millisecond(dt)) end function (+)(dt::Date, z::Month) y,m,d = yearmonthday(dt) ny = yearwrap(y, m, value(z)) mm = monthwrap(m, value(z)); ld = daysinmonth(ny, mm) return Date(ny, mm, d <= ld ? d : ld) end function (-)(dt::DateTime, z::Month) y,m,d = yearmonthday(dt) ny = yearwrap(y, m, -value(z)) mm = monthwrap(m, -value(z)); ld = daysinmonth(ny, mm) return DateTime(ny, mm, d <= ld ? d : ld, hour(dt), minute(dt), second(dt), millisecond(dt)) end function (-)(dt::Date, z::Month) y,m,d = yearmonthday(dt) ny = yearwrap(y, m, -value(z)) mm = monthwrap(m, -value(z)); ld = daysinmonth(ny, mm) return Date(ny, mm, d <= ld ? d : ld) end (+)(x::Date, y::Week) = return Date(UTD(value(x) + 7 * value(y))) (-)(x::Date, y::Week) = return Date(UTD(value(x) - 7 * value(y))) (+)(x::Date, y::Day) = return Date(UTD(value(x) + value(y))) (-)(x::Date, y::Day) = return Date(UTD(value(x) - value(y))) (+)(x::DateTime, y::Period) = return DateTime(UTM(value(x) + toms(y))) (-)(x::DateTime, y::Period) = return DateTime(UTM(value(x) - toms(y))) (+)(x::Time, y::TimePeriod) = return Time(Nanosecond(value(x) + tons(y))) (-)(x::Time, y::TimePeriod) = return Time(Nanosecond(value(x) - tons(y))) (+)(y::Period, x::TimeType) = x + y (+)(x::AbstractArray{<:TimeType}, y::GeneralPeriod) = x .+ y (+)(x::StridedArray{<:GeneralPeriod}, y::TimeType) = x .+ y (+)(y::GeneralPeriod, x::AbstractArray{<:TimeType}) = x .+ y (+)(y::TimeType, x::StridedArray{<:GeneralPeriod}) = x .+ y (-)(x::AbstractArray{<:TimeType}, y::GeneralPeriod) = x .- y (-)(x::StridedArray{<:GeneralPeriod}, y::TimeType) = x .- y # TimeType, AbstractArray{TimeType} (-)(x::AbstractArray{T}, y::T) where {T<:TimeType} = x .- y (-)(y::T, x::AbstractArray{T}) where {T<:TimeType} = y .- x # AbstractArray{TimeType}, AbstractArray{TimeType} (-)(x::OrdinalRange{T}, y::OrdinalRange{T}) where {T<:TimeType} = collect(x) - collect(y) (-)(x::Range{T}, y::Range{T}) where {T<:TimeType} = collect(x) - collect(y)