owned this note
owned this note
Published
Linked with GitHub
# Dates and Time
## Dates and Time Types
> []```@docs
Base.Dates.Period
Base.Dates.CompoundPeriod
Base.Dates.Instant
Base.Dates.UTInstant
Base.Dates.TimeType
Base.Dates.DateTime
Base.Dates.Date
Base.Dates.Time
```
## Dates Functions
All Dates functions are defined in the `Dates` module; note that only the `Date`, `DateTime`,
and `now` functions are exported; to use all other `Dates` functions, you'll need to prefix each
function call with an explicit `Dates.`, e.g. `Dates.dayofweek(dt)`. Alternatively, you can write
`using Base.Dates` to bring all exported functions into `Main` to be used without the `Dates.`
prefix.
```@docs
Base.Dates.DateTime(::Int64, ::Int64, ::Int64, ::Int64, ::Int64, ::Int64, ::Int64)
Base.Dates.DateTime(::Base.Dates.Period...)
Base.Dates.DateTime(::Function, ::Any...)
Base.Dates.DateTime(::Base.Dates.TimeType)
Base.Dates.DateTime(::AbstractString, ::AbstractString)
Base.Dates.format
Base.Dates.DateFormat
Base.Dates.@dateformat_str
Base.Dates.DateTime(::AbstractString, ::Base.Dates.DateFormat)
Base.Dates.Date(::Int64, ::Int64, ::Int64)
Base.Dates.Date(::Base.Dates.Period...)
Base.Dates.Date(::Function, ::Any, ::Any, ::Any)
Base.Dates.Date(::Base.Dates.TimeType)
Base.Dates.Date(::AbstractString, ::AbstractString)
Base.Dates.Date(::AbstractString, ::Base.Dates.DateFormat)
Base.Dates.Time(::Int64::Int64, ::Int64, ::Int64, ::Int64, ::Int64)
Base.Dates.Time(::Base.Dates.TimePeriod...)
Base.Dates.Time(::Function, ::Any...)
Base.Dates.Time(::Base.Dates.DateTime)
Base.Dates.now()
Base.Dates.now(::Type{Base.Dates.UTC})
Base.eps
```
### Accessor Functions
```@docs
Base.Dates.year
Base.Dates.month
Base.Dates.week
Base.Dates.day
Base.Dates.hour
Base.Dates.minute
Base.Dates.second
Base.Dates.millisecond
Base.Dates.microsecond
Base.Dates.nanosecond
Base.Dates.Year(::Base.Dates.TimeType)
Base.Dates.Month(::Base.Dates.TimeType)
Base.Dates.Week(::Base.Dates.TimeType)
Base.Dates.Day(::Base.Dates.TimeType)
Base.Dates.Hour(::DateTime)
Base.Dates.Minute(::DateTime)
Base.Dates.Second(::DateTime)
Base.Dates.Millisecond(::DateTime)
Base.Dates.Microsecond(::Dates.Time)
Base.Dates.Nanosecond(::Dates.Time)
Base.Dates.yearmonth
Base.Dates.monthday
Base.Dates.yearmonthday
```
### Query Functions
```@docs
Base.Dates.dayname
Base.Dates.dayabbr
Base.Dates.dayofweek
Base.Dates.dayofmonth
Base.Dates.dayofweekofmonth
Base.Dates.daysofweekinmonth
Base.Dates.monthname
Base.Dates.monthabbr
Base.Dates.daysinmonth
Base.Dates.isleapyear
Base.Dates.dayofyear
Base.Dates.daysinyear
Base.Dates.quarterofyear
Base.Dates.dayofquarter
```
### Adjuster Functions
```@docs
Base.trunc(::Base.Dates.TimeType, ::Type{Base.Dates.Period})
Base.Dates.firstdayofweek
Base.Dates.lastdayofweek
Base.Dates.firstdayofmonth
Base.Dates.lastdayofmonth
Base.Dates.firstdayofyear
Base.Dates.lastdayofyear
Base.Dates.firstdayofquarter
Base.Dates.lastdayofquarter
Base.Dates.tonext(::Base.Dates.TimeType, ::Int)
Base.Dates.toprev(::Base.Dates.TimeType, ::Int)
Base.Dates.tofirst
Base.Dates.tolast
Base.Dates.tonext(::Function, ::Base.Dates.TimeType)
Base.Dates.toprev(::Function, ::Base.Dates.TimeType)
```
### Periods
```@docs
Base.Dates.Period(::Any)
Base.Dates.CompoundPeriod(::Vector{<:Base.Dates.Period})
Base.Dates.default
```
### Rounding Functions
`Date` and `DateTime` values can be rounded to a specified resolution (e.g., 1 month or 15 minutes)
with `floor`, `ceil`, or `round`.
```@docs
Base.floor(::Base.Dates.TimeType, ::Base.Dates.Period)
Base.ceil(::Base.Dates.TimeType, ::Base.Dates.Period)
Base.round(::Base.Dates.TimeType, ::Base.Dates.Period, ::RoundingMode{:NearestTiesUp})
```
The following functions are not exported:
```@docs
Base.Dates.floorceil
Base.Dates.epochdays2date
Base.Dates.epochms2datetime
Base.Dates.date2epochdays
Base.Dates.datetime2epochms
```
### Conversion Functions
```@docs
Base.Dates.today
Base.Dates.unix2datetime
Base.Dates.datetime2unix
Base.Dates.julian2datetime
Base.Dates.datetime2julian
Base.Dates.rata2datetime
Base.Dates.datetime2rata
```
### Constants
Days of the Week:
| Variable | Abbr. | Value (Int) |
|:----------- |:----- |:----------- |
| `Monday` | `Mon` | 1 |
| `Tuesday` | `Tue` | 2 |
| `Wednesday` | `Wed` | 3 |
| `Thursday` | `Thu` | 4 |
| `Friday` | `Fri` | 5 |
| `Saturday` | `Sat` | 6 |
| `Sunday` | `Sun` | 7 |
Months of the Year:
| Variable | Abbr. | Value (Int) |
|:----------- |:----- |:----------- |
| `January` | `Jan` | 1 |
| `February` | `Feb` | 2 |
| `March` | `Mar` | 3 |
| `April` | `Apr` | 4 |
| `May` | `May` | 5 |
| `June` | `Jun` | 6 |
| `July` | `Jul` | 7 |
| `August` | `Aug` | 8 |
| `September` | `Sep` | 9 |
| `October` | `Oct` | 10 |
| `November` | `Nov` | 11 |
| `December` | `Dec` | 12 |