65 lines
90 KiB
HTML
65 lines
90 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en"><head><meta charset="UTF-8"/><meta name="viewport" content="width=device-width, initial-scale=1.0"/><title>Dates and Time · The Julia Language</title><script>(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
|
|
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
|
|
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
|
|
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
|
|
|
|
ga('create', 'UA-28835595-6', 'auto');
|
|
ga('send', 'pageview');
|
|
</script><link href="https://cdnjs.cloudflare.com/ajax/libs/normalize/4.2.0/normalize.min.css" rel="stylesheet" type="text/css"/><link href="https://fonts.googleapis.com/css?family=Lato|Roboto+Mono" rel="stylesheet" type="text/css"/><link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css" rel="stylesheet" type="text/css"/><link href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/default.min.css" rel="stylesheet" type="text/css"/><script>documenterBaseURL=".."</script><script src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.2.0/require.min.js" data-main="../assets/documenter.js"></script><script src="../siteinfo.js"></script><script src="../../versions.js"></script><link href="../assets/documenter.css" rel="stylesheet" type="text/css"/><link href="../assets/julia-manual.css" rel="stylesheet" type="text/css"/></head><body><nav class="toc"><a href="../index.html"><img class="logo" src="../assets/logo.png" alt="The Julia Language logo"/></a><h1>The Julia Language</h1><select id="version-selector" onChange="window.location.href=this.value" style="visibility: hidden"></select><form class="search" id="search-form" action="../search.html"><input id="search-query" name="q" type="text" placeholder="Search docs"/></form><ul><li><a class="toctext" href="../index.html">Home</a></li><li><span class="toctext">Manual</span><ul><li><a class="toctext" href="../manual/introduction.html">Introduction</a></li><li><a class="toctext" href="../manual/getting-started.html">Getting Started</a></li><li><a class="toctext" href="../manual/variables.html">Variables</a></li><li><a class="toctext" href="../manual/integers-and-floating-point-numbers.html">Integers and Floating-Point Numbers</a></li><li><a class="toctext" href="../manual/mathematical-operations.html">Mathematical Operations and Elementary Functions</a></li><li><a class="toctext" href="../manual/complex-and-rational-numbers.html">Complex and Rational Numbers</a></li><li><a class="toctext" href="../manual/strings.html">Strings</a></li><li><a class="toctext" href="../manual/functions.html">Functions</a></li><li><a class="toctext" href="../manual/control-flow.html">Control Flow</a></li><li><a class="toctext" href="../manual/variables-and-scoping.html">Scope of Variables</a></li><li><a class="toctext" href="../manual/types.html">Types</a></li><li><a class="toctext" href="../manual/methods.html">Methods</a></li><li><a class="toctext" href="../manual/constructors.html">Constructors</a></li><li><a class="toctext" href="../manual/conversion-and-promotion.html">Conversion and Promotion</a></li><li><a class="toctext" href="../manual/interfaces.html">Interfaces</a></li><li><a class="toctext" href="../manual/modules.html">Modules</a></li><li><a class="toctext" href="../manual/documentation.html">Documentation</a></li><li><a class="toctext" href="../manual/metaprogramming.html">Metaprogramming</a></li><li><a class="toctext" href="../manual/arrays.html">Multi-dimensional Arrays</a></li><li><a class="toctext" href="../manual/linear-algebra.html">Linear algebra</a></li><li><a class="toctext" href="../manual/networking-and-streams.html">Networking and Streams</a></li><li><a class="toctext" href="../manual/parallel-computing.html">Parallel Computing</a></li><li><a class="toctext" href="../manual/dates.html">Date and DateTime</a></li><li><a class="toctext" href="../manual/interacting-with-julia.html">Interacting With Julia</a></li><li><a class="toctext" href="../manual/running-external-programs.html">Running External Programs</a></li><li><a class="toctext" href="../manual/calling-c-and-fortran-code.html">Calling C and Fortran Code</a></li><li><a class="toctext" href="../manual/handling-operating-system-variation.html">Handling Operating System Variation</a></li><li><a class="toctext" href="../manual/environment-variables.html">Environment Variables</a></li><li><a class="toctext" href="../manual/embedding.html">Embedding Julia</a></li><li><a class="toctext" href="../manual/packages.html">Packages</a></li><li><a class="toctext" href="../manual/profile.html">Profiling</a></li><li><a class="toctext" href="../manual/stacktraces.html">Stack Traces</a></li><li><a class="toctext" href="../manual/performance-tips.html">Performance Tips</a></li><li><a class="toctext" href="../manual/workflow-tips.html">Workflow Tips</a></li><li><a class="toctext" href="../manual/style-guide.html">Style Guide</a></li><li><a class="toctext" href="../manual/faq.html">Frequently Asked Questions</a></li><li><a class="toctext" href="../manual/noteworthy-differences.html">Noteworthy Differences from other Languages</a></li><li><a class="toctext" href="../manual/unicode-input.html">Unicode Input</a></li></ul></li><li><span class="toctext">Standard Library</span><ul><li><a class="toctext" href="base.html">Essentials</a></li><li><a class="toctext" href="collections.html">Collections and Data Structures</a></li><li><a class="toctext" href="math.html">Mathematics</a></li><li><a class="toctext" href="numbers.html">Numbers</a></li><li><a class="toctext" href="strings.html">Strings</a></li><li><a class="toctext" href="arrays.html">Arrays</a></li><li><a class="toctext" href="parallel.html">Tasks and Parallel Computing</a></li><li><a class="toctext" href="linalg.html">Linear Algebra</a></li><li><a class="toctext" href="constants.html">Constants</a></li><li><a class="toctext" href="file.html">Filesystem</a></li><li><a class="toctext" href="io-network.html">I/O and Network</a></li><li><a class="toctext" href="punctuation.html">Punctuation</a></li><li><a class="toctext" href="sort.html">Sorting and Related Functions</a></li><li><a class="toctext" href="pkg.html">Package Manager Functions</a></li><li class="current"><a class="toctext" href="dates.html">Dates and Time</a><ul class="internal"><li><a class="toctext" href="#Dates-and-Time-Types-1">Dates and Time Types</a></li><li><a class="toctext" href="#Dates-Functions-1">Dates Functions</a></li></ul></li><li><a class="toctext" href="iterators.html">Iteration utilities</a></li><li><a class="toctext" href="test.html">Unit Testing</a></li><li><a class="toctext" href="c.html">C Interface</a></li><li><a class="toctext" href="libc.html">C Standard Library</a></li><li><a class="toctext" href="libdl.html">Dynamic Linker</a></li><li><a class="toctext" href="profile.html">Profiling</a></li><li><a class="toctext" href="stacktraces.html">StackTraces</a></li><li><a class="toctext" href="simd-types.html">SIMD Support</a></li></ul></li><li><span class="toctext">Developer Documentation</span><ul><li><a class="toctext" href="../devdocs/reflection.html">Reflection and introspection</a></li><li><span class="toctext">Documentation of Julia's Internals</span><ul><li><a class="toctext" href="../devdocs/init.html">Initialization of the Julia runtime</a></li><li><a class="toctext" href="../devdocs/ast.html">Julia ASTs</a></li><li><a class="toctext" href="../devdocs/types.html">More about types</a></li><li><a class="toctext" href="../devdocs/object.html">Memory layout of Julia Objects</a></li><li><a class="toctext" href="../devdocs/eval.html">Eval of Julia code</a></li><li><a class="toctext" href="../devdocs/callconv.html">Calling Conventions</a></li><li><a class="toctext" href="../devdocs/compiler.html">High-level Overview of the Native-Code Generation Process</a></li><li><a class="toctext" href="../devdocs/functions.html">Julia Functions</a></li><li><a class="toctext" href="../devdocs/cartesian.html">Base.Cartesian</a></li><li><a class="toctext" href="../devdocs/meta.html">Talking to the compiler (the <code>:meta</code> mechanism)</a></li><li><a class="toctext" href="../devdocs/subarrays.html">SubArrays</a></li><li><a class="toctext" href="../devdocs/sysimg.html">System Image Building</a></li><li><a class="toctext" href="../devdocs/llvm.html">Working with LLVM</a></li><li><a class="toctext" href="../devdocs/stdio.html">printf() and stdio in the Julia runtime</a></li><li><a class="toctext" href="../devdocs/boundscheck.html">Bounds checking</a></li><li><a class="toctext" href="../devdocs/locks.html">Proper maintenance and care of multi-threading locks</a></li><li><a class="toctext" href="../devdocs/offset-arrays.html">Arrays with custom indices</a></li><li><a class="toctext" href="../devdocs/libgit2.html">Base.LibGit2</a></li><li><a class="toctext" href="../devdocs/require.html">Module loading</a></li></ul></li><li><span class="toctext">Developing/debugging Julia's C code</span><ul><li><a class="toctext" href="../devdocs/backtraces.html">Reporting and analyzing crashes (segfaults)</a></li><li><a class="toctext" href="../devdocs/debuggingtips.html">gdb debugging tips</a></li><li><a class="toctext" href="../devdocs/valgrind.html">Using Valgrind with Julia</a></li><li><a class="toctext" href="../devdocs/sanitizers.html">Sanitizer support</a></li></ul></li></ul></li></ul></nav><article id="docs"><header><nav><ul><li>Standard Library</li><li><a href="dates.html">Dates and Time</a></li></ul><a class="edit-page" href="https://github.com/JuliaLang/julia/blob/master/doc/src/stdlib/dates.md"><span class="fa"></span> Edit on GitHub</a></nav><hr/><div id="topbar"><span>Dates and Time</span><a class="fa fa-bars" href="#"></a></div></header><h1><a class="nav-anchor" id="stdlib-dates-1" href="#stdlib-dates-1">Dates and Time</a></h1><h2><a class="nav-anchor" id="Dates-and-Time-Types-1" href="#Dates-and-Time-Types-1">Dates and Time Types</a></h2><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.Period" href="#Base.Dates.Period"><code>Base.Dates.Period</code></a> — <span class="docstring-category">Type</span>.</div><div><pre><code class="language-none">Period
|
|
Year
|
|
Month
|
|
Week
|
|
Day
|
|
Hour
|
|
Minute
|
|
Second
|
|
Millisecond
|
|
Microsecond
|
|
Nanosecond</code></pre><p><code>Period</code> types represent discrete, human representations of time.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/types.jl#L5-L19">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.CompoundPeriod" href="#Base.Dates.CompoundPeriod"><code>Base.Dates.CompoundPeriod</code></a> — <span class="docstring-category">Type</span>.</div><div><pre><code class="language-none">CompoundPeriod</code></pre><p>A <code>CompoundPeriod</code> is useful for expressing time periods that are not a fixed multiple of smaller periods. For example, "a year and a day" is not a fixed number of days, but can be expressed using a <code>CompoundPeriod</code>. In fact, a <code>CompoundPeriod</code> is automatically generated by addition of different period types, e.g. <code>Year(1) + Day(1)</code> produces a <code>CompoundPeriod</code> result.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/periods.jl#L152-L160">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.Instant" href="#Base.Dates.Instant"><code>Base.Dates.Instant</code></a> — <span class="docstring-category">Type</span>.</div><div><pre><code class="language-none">Instant</code></pre><p><code>Instant</code> types represent integer-based, machine representations of time as continuous timelines starting from an epoch.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/types.jl#L54-L59">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.UTInstant" href="#Base.Dates.UTInstant"><code>Base.Dates.UTInstant</code></a> — <span class="docstring-category">Type</span>.</div><div><pre><code class="language-none">UTInstant{T}</code></pre><p>The <code>UTInstant</code> represents a machine timeline based on UT time (1 day = one revolution of the earth). The <code>T</code> is a <code>Period</code> parameter that indicates the resolution or precision of the instant.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/types.jl#L62-L68">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.TimeType" href="#Base.Dates.TimeType"><code>Base.Dates.TimeType</code></a> — <span class="docstring-category">Type</span>.</div><div><pre><code class="language-none">TimeType</code></pre><p><code>TimeType</code> types wrap <code>Instant</code> machine instances to provide human representations of the machine instant. <code>Time</code>, <code>DateTime</code> and <code>Date</code> are subtypes of <code>TimeType</code>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/types.jl#L89-L94">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.DateTime" href="#Base.Dates.DateTime"><code>Base.Dates.DateTime</code></a> — <span class="docstring-category">Type</span>.</div><div><pre><code class="language-none">DateTime</code></pre><p><code>DateTime</code> wraps a <code>UTInstant{Millisecond}</code> and interprets it according to the proleptic Gregorian calendar.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/types.jl#L97-L102">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.Date" href="#Base.Dates.Date"><code>Base.Dates.Date</code></a> — <span class="docstring-category">Type</span>.</div><div><pre><code class="language-none">Date</code></pre><p><code>Date</code> wraps a <code>UTInstant{Day}</code> and interprets it according to the proleptic Gregorian calendar.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/types.jl#L108-L112">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.Time" href="#Base.Dates.Time"><code>Base.Dates.Time</code></a> — <span class="docstring-category">Type</span>.</div><div><pre><code class="language-none">Time</code></pre><p><code>Time</code> wraps a <code>Nanosecond</code> and represents a specific moment in a 24-hour day.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/types.jl#L118-L122">source</a></section><h2><a class="nav-anchor" id="Dates-Functions-1" href="#Dates-Functions-1">Dates Functions</a></h2><p>All Dates functions are defined in the <code>Dates</code> module; note that only the <code>Date</code>, <code>DateTime</code>, and <code>now</code> functions are exported; to use all other <code>Dates</code> functions, you'll need to prefix each function call with an explicit <code>Dates.</code>, e.g. <code>Dates.dayofweek(dt)</code>. Alternatively, you can write <code>using Base.Dates</code> to bring all exported functions into <code>Main</code> to be used without the <code>Dates.</code> prefix.</p><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.DateTime-NTuple{7,Int64}" href="#Base.Dates.DateTime-NTuple{7,Int64}"><code>Base.Dates.DateTime</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">DateTime(y, [m, d, h, mi, s, ms]) -> DateTime</code></pre><p>Construct a <code>DateTime</code> type by parts. Arguments must be convertible to <a href="numbers.html#Core.Int64"><code>Int64</code></a>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/types.jl#L173-L177">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.DateTime-Tuple{Vararg{Base.Dates.Period,N} where N}" href="#Base.Dates.DateTime-Tuple{Vararg{Base.Dates.Period,N} where N}"><code>Base.Dates.DateTime</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">DateTime(periods::Period...) -> DateTime</code></pre><p>Construct a <code>DateTime</code> type by <code>Period</code> type parts. Arguments may be in any order. DateTime parts not provided will default to the value of <code>Dates.default(period)</code>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/types.jl#L253-L258">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.DateTime-Tuple{Function,Vararg{Any,N} where N}" href="#Base.Dates.DateTime-Tuple{Function,Vararg{Any,N} where N}"><code>Base.Dates.DateTime</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">DateTime(f::Function, y[, m, d, h, mi, s]; step=Day(1), limit=10000) -> DateTime</code></pre><p>Create a <code>DateTime</code> through the adjuster API. The starting point will be constructed from the provided <code>y, m, d...</code> arguments, and will be adjusted until <code>f::Function</code> returns <code>true</code>. The step size in adjusting can be provided manually through the <code>step</code> keyword. <code>limit</code> provides a limit to the max number of iterations the adjustment API will pursue before throwing an error (in the case that <code>f::Function</code> is never satisfied).</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/adjusters.jl#L167-L175">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.DateTime-Tuple{Base.Dates.TimeType}" href="#Base.Dates.DateTime-Tuple{Base.Dates.TimeType}"><code>Base.Dates.DateTime</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">DateTime(dt::Date) -> DateTime</code></pre><p>Converts a <code>Date</code> to a <code>DateTime</code>. The hour, minute, second, and millisecond parts of the new <code>DateTime</code> are assumed to be zero.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/conversions.jl#L14-L19">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.DateTime-Tuple{AbstractString,AbstractString}" href="#Base.Dates.DateTime-Tuple{AbstractString,AbstractString}"><code>Base.Dates.DateTime</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">DateTime(dt::AbstractString, format::AbstractString; locale="english") -> DateTime</code></pre><p>Construct a <code>DateTime</code> by parsing the <code>dt</code> date string following the pattern given in the <code>format</code> string.</p><p>This method creates a <code>DateFormat</code> object each time it is called. If you are parsing many date strings of the same format, consider creating a <a href="dates.html#Base.Dates.DateFormat"><code>DateFormat</code></a> object once and using that as the second argument instead.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/io.jl#L400-L409">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.format-Tuple{Base.Dates.TimeType,AbstractString}" href="#Base.Dates.format-Tuple{Base.Dates.TimeType,AbstractString}"><code>Base.Dates.format</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">format(dt::TimeType, format::AbstractString; locale="english") -> AbstractString</code></pre><p>Construct a string by using a <code>TimeType</code> object and applying the provided <code>format</code>. The following character codes can be used to construct the <code>format</code> string:</p><table><tr><th>Code</th><th>Examples</th><th>Comment</th></tr><tr><td><code>y</code></td><td>6</td><td>Numeric year with a fixed width</td></tr><tr><td><code>Y</code></td><td>1996</td><td>Numeric year with a minimum width</td></tr><tr><td><code>m</code></td><td>1, 12</td><td>Numeric month with a minimum width</td></tr><tr><td><code>u</code></td><td>Jan</td><td>Month name shortened to 3-chars according to the <code>locale</code></td></tr><tr><td><code>U</code></td><td>January</td><td>Full month name according to the <code>locale</code> keyword</td></tr><tr><td><code>d</code></td><td>1, 31</td><td>Day of the month with a minimum width</td></tr><tr><td><code>H</code></td><td>0, 23</td><td>Hour (24-hour clock) with a minimum width</td></tr><tr><td><code>M</code></td><td>0, 59</td><td>Minute with a minimum width</td></tr><tr><td><code>S</code></td><td>0, 59</td><td>Second with a minimum width</td></tr><tr><td><code>s</code></td><td>000, 500</td><td>Millisecond with a minimum width of 3</td></tr><tr><td><code>e</code></td><td>Mon, Tue</td><td>Abbreviated days of the week</td></tr><tr><td><code>E</code></td><td>Monday</td><td>Full day of week name</td></tr></table><p>The number of sequential code characters indicate the width of the code. A format of <code>yyyy-mm</code> specifies that the code <code>y</code> should have a width of four while <code>m</code> a width of two. Codes that yield numeric digits have an associated mode: fixed-width or minimum-width. The fixed-width mode left-pads the value with zeros when it is shorter than the specified width and truncates the value when longer. Minimum-width mode works the same as fixed-width except that it does not truncate values longer than the width.</p><p>When creating a <code>format</code> you can use any non-code characters as a separator. For example to generate the string "1996-01-15T00:00:00" you could use <code>format</code>: "yyyy-mm-ddTHH:MM:SS". Note that if you need to use a code character as a literal you can use the escape character backslash. The string "1996y01m" can be produced with the format "yyyy\ymm\m".</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/io.jl#L459-L491">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.DateFormat" href="#Base.Dates.DateFormat"><code>Base.Dates.DateFormat</code></a> — <span class="docstring-category">Type</span>.</div><div><pre><code class="language-none">DateFormat(format::AbstractString, locale="english") -> DateFormat</code></pre><p>Construct a date formatting object that can be used for parsing date strings or formatting a date object as a string. The following character codes can be used to construct the <code>format</code> string:</p><table><tr><th>Code</th><th>Matches</th><th>Comment</th></tr><tr><td><code>y</code></td><td>1996, 96</td><td>Returns year of 1996, 0096</td></tr><tr><td><code>Y</code></td><td>1996, 96</td><td>Returns year of 1996, 0096. Equivalent to <code>y</code></td></tr><tr><td><code>m</code></td><td>1, 01</td><td>Matches 1 or 2-digit months</td></tr><tr><td><code>u</code></td><td>Jan</td><td>Matches abbreviated months according to the <code>locale</code> keyword</td></tr><tr><td><code>U</code></td><td>January</td><td>Matches full month names according to the <code>locale</code> keyword</td></tr><tr><td><code>d</code></td><td>1, 01</td><td>Matches 1 or 2-digit days</td></tr><tr><td><code>H</code></td><td>00</td><td>Matches hours</td></tr><tr><td><code>M</code></td><td>00</td><td>Matches minutes</td></tr><tr><td><code>S</code></td><td>00</td><td>Matches seconds</td></tr><tr><td><code>s</code></td><td>.500</td><td>Matches milliseconds</td></tr><tr><td><code>e</code></td><td>Mon, Tues</td><td>Matches abbreviated days of the week</td></tr><tr><td><code>E</code></td><td>Monday</td><td>Matches full name days of the week</td></tr><tr><td><code>yyyymmdd</code></td><td>19960101</td><td>Matches fixed-width year, month, and day</td></tr></table><p>Characters not listed above are normally treated as delimiters between date and time slots. For example a <code>dt</code> string of "1996-01-15T00:00:00.0" would have a <code>format</code> string like "y-m-dTH:M:S.s". If you need to use a code character as a delimiter you can escape it using backslash. The date "1995y01m" would have the format "y\ym\m".</p><p>Creating a DateFormat object is expensive. Whenever possible, create it once and use it many times or try the <code>dateformat""</code> string macro. Using this macro creates the DateFormat object once at macro expansion time and reuses it later. see <a href="dates.html#Base.Dates.@dateformat_str"><code>@dateformat_str</code></a>.</p><p>See <a href="dates.html#Base.Dates.DateTime"><code>DateTime</code></a> and <a href="dates.html#Base.Dates.format-Tuple{Base.Dates.TimeType,AbstractString}"><code>format</code></a> for how to use a DateFormat object to parse and write Date strings respectively.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/io.jl#L285-L319">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.@dateformat_str" href="#Base.Dates.@dateformat_str"><code>Base.Dates.@dateformat_str</code></a> — <span class="docstring-category">Macro</span>.</div><div><pre><code class="language-none">dateformat"Y-m-d H:M:S"</code></pre><p>Create a <a href="dates.html#Base.Dates.DateFormat"><code>DateFormat</code></a> object. Similar to <code>DateFormat("Y-m-d H:M:S")</code> but creates the DateFormat object once during macro expansion.</p><p>See <a href="dates.html#Base.Dates.DateFormat"><code>DateFormat</code></a> for details about format specifiers.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/io.jl#L376-L383">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.DateTime-Tuple{AbstractString,DateFormat}" href="#Base.Dates.DateTime-Tuple{AbstractString,DateFormat}"><code>Base.Dates.DateTime</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">DateTime(dt::AbstractString, df::DateFormat) -> DateTime</code></pre><p>Construct a <code>DateTime</code> by parsing the <code>dt</code> date string following the pattern given in the <a href="dates.html#Base.Dates.DateFormat"><code>DateFormat</code></a> object. Similar to <code>DateTime(::AbstractString, ::AbstractString)</code> but more efficient when repeatedly parsing similarly formatted date strings with a pre-created <code>DateFormat</code> object.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/io.jl#L414-L421">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.Date-Tuple{Int64,Int64,Int64}" href="#Base.Dates.Date-Tuple{Int64,Int64,Int64}"><code>Base.Dates.Date</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">Date(y, [m, d]) -> Date</code></pre><p>Construct a <code>Date</code> type by parts. Arguments must be convertible to <a href="numbers.html#Core.Int64"><code>Int64</code></a>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/types.jl#L197-L201">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.Date-Tuple{Vararg{Base.Dates.Period,N} where N}" href="#Base.Dates.Date-Tuple{Vararg{Base.Dates.Period,N} where N}"><code>Base.Dates.Date</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">Date(period::Period...) -> Date</code></pre><p>Construct a <code>Date</code> type by <code>Period</code> type parts. Arguments may be in any order. <code>Date</code> parts not provided will default to the value of <code>Dates.default(period)</code>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/types.jl#L274-L279">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.Date-Tuple{Function,Any,Any,Any}" href="#Base.Dates.Date-Tuple{Function,Any,Any,Any}"><code>Base.Dates.Date</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">Date(f::Function, y[, m, d]; step=Day(1), limit=10000) -> Date</code></pre><p>Create a <code>Date</code> through the adjuster API. The starting point will be constructed from the provided <code>y, m, d</code> arguments, and will be adjusted until <code>f::Function</code> returns <code>true</code>. The step size in adjusting can be provided manually through the <code>step</code> keyword. <code>limit</code> provides a limit to the max number of iterations the adjustment API will pursue before throwing an error (given that <code>f::Function</code> is never satisfied).</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/adjusters.jl#L153-L161">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.Date-Tuple{Base.Dates.TimeType}" href="#Base.Dates.Date-Tuple{Base.Dates.TimeType}"><code>Base.Dates.Date</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">Date(dt::DateTime) -> Date</code></pre><p>Converts a <code>DateTime</code> to a <code>Date</code>. The hour, minute, second, and millisecond parts of the <code>DateTime</code> are truncated, so only the year, month and day parts are used in construction.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/conversions.jl#L5-L11">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.Date-Tuple{AbstractString,AbstractString}" href="#Base.Dates.Date-Tuple{AbstractString,AbstractString}"><code>Base.Dates.Date</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">Date(dt::AbstractString, format::AbstractString; locale="english") -> Date</code></pre><p>Construct a <code>Date</code> object by parsing a <code>dt</code> date string following the pattern given in the <code>format</code> string. Follows the same conventions as <code>DateTime(::AbstractString, ::AbstractString)</code>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/io.jl#L424-L430">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.Date-Tuple{AbstractString,DateFormat}" href="#Base.Dates.Date-Tuple{AbstractString,DateFormat}"><code>Base.Dates.Date</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">Date(dt::AbstractString, df::DateFormat) -> Date</code></pre><p>Parse a date from a date string <code>dt</code> using a <code>DateFormat</code> object <code>df</code>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/io.jl#L435-L439">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.Time-NTuple{5,Int64}" href="#Base.Dates.Time-NTuple{5,Int64}"><code>Base.Dates.Time</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">Time(h, [mi, s, ms, us, ns]) -> Time</code></pre><p>Construct a <code>Time</code> type by parts. Arguments must be convertible to <a href="numbers.html#Core.Int64"><code>Int64</code></a>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/types.jl#L214-L218">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.Time-Tuple{Vararg{Base.Dates.TimePeriod,N} where N}" href="#Base.Dates.Time-Tuple{Vararg{Base.Dates.TimePeriod,N} where N}"><code>Base.Dates.Time</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">Time(period::TimePeriod...) -> Time</code></pre><p>Construct a <code>Time</code> type by <code>Period</code> type parts. Arguments may be in any order. <code>Time</code> parts not provided will default to the value of <code>Dates.default(period)</code>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/types.jl#L290-L295">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.Time-Tuple{Function,Vararg{Any,N} where N}" href="#Base.Dates.Time-Tuple{Function,Vararg{Any,N} where N}"><code>Base.Dates.Time</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">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)</code></pre><p>Create a <code>Time</code> through the adjuster API. The starting point will be constructed from the provided <code>h, mi, s, ms, us</code> arguments, and will be adjusted until <code>f::Function</code> returns <code>true</code>. The step size in adjusting can be provided manually through the <code>step</code> keyword. <code>limit</code> provides a limit to the max number of iterations the adjustment API will pursue before throwing an error (in the case that <code>f::Function</code> is never satisfied). Note that the default step will adjust to allow for greater precision for the given arguments; i.e. if hour, minute, and second arguments are provided, the default step will be <code>Millisecond(1)</code> instead of <code>Second(1)</code>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/adjusters.jl#L199-L212">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.Time-Tuple{DateTime}" href="#Base.Dates.Time-Tuple{DateTime}"><code>Base.Dates.Time</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">Time(dt::DateTime) -> Time</code></pre><p>Converts a <code>DateTime</code> to a <code>Time</code>. The hour, minute, second, and millisecond parts of the <code>DateTime</code> are used to create the new <code>Time</code>. Microsecond and nanoseconds are zero by default.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/conversions.jl#L22-L27">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.now-Tuple{}" href="#Base.Dates.now-Tuple{}"><code>Base.Dates.now</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">now() -> DateTime</code></pre><p>Returns a <code>DateTime</code> corresponding to the user's system time including the system timezone locale.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/conversions.jl#L60-L65">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.now-Tuple{Type{Base.Dates.UTC}}" href="#Base.Dates.now-Tuple{Type{Base.Dates.UTC}}"><code>Base.Dates.now</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">now(::Type{UTC}) -> DateTime</code></pre><p>Returns a <code>DateTime</code> corresponding to the user's system time as UTC/GMT.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/conversions.jl#L79-L83">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.eps" href="#Base.eps"><code>Base.eps</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">eps(::DateTime) -> Millisecond
|
|
eps(::Date) -> Day
|
|
eps(::Time) -> Nanosecond</code></pre><p>Returns <code>Millisecond(1)</code> for <code>DateTime</code> values, <code>Day(1)</code> for <code>Date</code> values, and <code>Nanosecond(1)</code> for <code>Time</code> values.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/types.jl#L320-L326">source</a></section><h3><a class="nav-anchor" id="Accessor-Functions-1" href="#Accessor-Functions-1">Accessor Functions</a></h3><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.year" href="#Base.Dates.year"><code>Base.Dates.year</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">year(dt::TimeType) -> Int64</code></pre><p>The year of a <code>Date</code> or <code>DateTime</code> as an <a href="numbers.html#Core.Int64"><code>Int64</code></a>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/accessors.jl#L74-L78">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.month" href="#Base.Dates.month"><code>Base.Dates.month</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">month(dt::TimeType) -> Int64</code></pre><p>The month of a <code>Date</code> or <code>DateTime</code> as an <a href="numbers.html#Core.Int64"><code>Int64</code></a>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/accessors.jl#L74-L78">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.week" href="#Base.Dates.week"><code>Base.Dates.week</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">week(dt::TimeType) -> Int64</code></pre><p>Return the <a href="https://en.wikipedia.org/wiki/ISO_week_date">ISO week date</a> of a <code>Date</code> or <code>DateTime</code> as an <a href="numbers.html#Core.Int64"><code>Int64</code></a>. Note that the first week of a year is the week that contains the first Thursday of the year which can result in dates prior to January 4th being in the last week of the previous year. For example <code>week(Date(2005,1,1))</code> is the 53rd week of 2004.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/accessors.jl#L82-L90">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.day" href="#Base.Dates.day"><code>Base.Dates.day</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">day(dt::TimeType) -> Int64</code></pre><p>The day of month of a <code>Date</code> or <code>DateTime</code> as an <a href="numbers.html#Core.Int64"><code>Int64</code></a>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/accessors.jl#L96-L100">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.hour" href="#Base.Dates.hour"><code>Base.Dates.hour</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">hour(dt::DateTime) -> Int64</code></pre><p>The hour of day of a <code>DateTime</code> as an <a href="numbers.html#Core.Int64"><code>Int64</code></a>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/accessors.jl#L104-L108">source</a><div><pre><code class="language-none">hour(t::Time) -> Int64</code></pre><p>The hour of a <code>Time</code> as an <a href="numbers.html#Core.Int64"><code>Int64</code></a>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/accessors.jl#L138-L142">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.minute" href="#Base.Dates.minute"><code>Base.Dates.minute</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">minute(dt::DateTime) -> Int64</code></pre><p>The minute of a <code>DateTime</code> as an <a href="numbers.html#Core.Int64"><code>Int64</code></a>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/accessors.jl#L114-L118">source</a><div><pre><code class="language-none">minute(t::Time) -> Int64</code></pre><p>The minute of a <code>Time</code> as an <a href="numbers.html#Core.Int64"><code>Int64</code></a>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/accessors.jl#L138-L142">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.second" href="#Base.Dates.second"><code>Base.Dates.second</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">second(dt::DateTime) -> Int64</code></pre><p>The second of a <code>DateTime</code> as an <a href="numbers.html#Core.Int64"><code>Int64</code></a>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/accessors.jl#L114-L118">source</a><div><pre><code class="language-none">second(t::Time) -> Int64</code></pre><p>The second of a <code>Time</code> as an <a href="numbers.html#Core.Int64"><code>Int64</code></a>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/accessors.jl#L138-L142">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.millisecond" href="#Base.Dates.millisecond"><code>Base.Dates.millisecond</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">millisecond(dt::DateTime) -> Int64</code></pre><p>The millisecond of a <code>DateTime</code> as an <a href="numbers.html#Core.Int64"><code>Int64</code></a>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/accessors.jl#L114-L118">source</a><div><pre><code class="language-none">millisecond(t::Time) -> Int64</code></pre><p>The millisecond of a <code>Time</code> as an <a href="numbers.html#Core.Int64"><code>Int64</code></a>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/accessors.jl#L138-L142">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.microsecond" href="#Base.Dates.microsecond"><code>Base.Dates.microsecond</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">microsecond(t::Time) -> Int64</code></pre><p>The microsecond of a <code>Time</code> as an <a href="numbers.html#Core.Int64"><code>Int64</code></a>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/accessors.jl#L138-L142">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.nanosecond" href="#Base.Dates.nanosecond"><code>Base.Dates.nanosecond</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">nanosecond(t::Time) -> Int64</code></pre><p>The nanosecond of a <code>Time</code> as an <a href="numbers.html#Core.Int64"><code>Int64</code></a>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/accessors.jl#L138-L142">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.Year-Tuple{Base.Dates.TimeType}" href="#Base.Dates.Year-Tuple{Base.Dates.TimeType}"><code>Base.Dates.Year</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">Year(v)</code></pre><p>Construct a <code>Year</code> object with the given <code>v</code> value. Input must be losslessly convertible to an <a href="numbers.html#Core.Int64"><code>Int64</code></a>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/periods.jl#L32-L37">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.Month-Tuple{Base.Dates.TimeType}" href="#Base.Dates.Month-Tuple{Base.Dates.TimeType}"><code>Base.Dates.Month</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">Month(v)</code></pre><p>Construct a <code>Month</code> object with the given <code>v</code> value. Input must be losslessly convertible to an <a href="numbers.html#Core.Int64"><code>Int64</code></a>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/periods.jl#L32-L37">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.Week-Tuple{Base.Dates.TimeType}" href="#Base.Dates.Week-Tuple{Base.Dates.TimeType}"><code>Base.Dates.Week</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">Week(v)</code></pre><p>Construct a <code>Week</code> object with the given <code>v</code> value. Input must be losslessly convertible to an <a href="numbers.html#Core.Int64"><code>Int64</code></a>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/periods.jl#L32-L37">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.Day-Tuple{Base.Dates.TimeType}" href="#Base.Dates.Day-Tuple{Base.Dates.TimeType}"><code>Base.Dates.Day</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">Day(v)</code></pre><p>Construct a <code>Day</code> object with the given <code>v</code> value. Input must be losslessly convertible to an <a href="numbers.html#Core.Int64"><code>Int64</code></a>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/periods.jl#L32-L37">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.Hour-Tuple{DateTime}" href="#Base.Dates.Hour-Tuple{DateTime}"><code>Base.Dates.Hour</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">Hour(dt::DateTime) -> Hour</code></pre><p>The hour part of a DateTime as a <code>Hour</code>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/periods.jl#L24-L28">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.Minute-Tuple{DateTime}" href="#Base.Dates.Minute-Tuple{DateTime}"><code>Base.Dates.Minute</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">Minute(dt::DateTime) -> Minute</code></pre><p>The minute part of a DateTime as a <code>Minute</code>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/periods.jl#L24-L28">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.Second-Tuple{DateTime}" href="#Base.Dates.Second-Tuple{DateTime}"><code>Base.Dates.Second</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">Second(dt::DateTime) -> Second</code></pre><p>The second part of a DateTime as a <code>Second</code>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/periods.jl#L24-L28">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.Millisecond-Tuple{DateTime}" href="#Base.Dates.Millisecond-Tuple{DateTime}"><code>Base.Dates.Millisecond</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">Millisecond(dt::DateTime) -> Millisecond</code></pre><p>The millisecond part of a DateTime as a <code>Millisecond</code>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/periods.jl#L24-L28">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.Microsecond-Tuple{Base.Dates.Time}" href="#Base.Dates.Microsecond-Tuple{Base.Dates.Time}"><code>Base.Dates.Microsecond</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">Microsecond(dt::Time) -> Microsecond</code></pre><p>The microsecond part of a Time as a <code>Microsecond</code>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/periods.jl#L24-L28">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.Nanosecond-Tuple{Base.Dates.Time}" href="#Base.Dates.Nanosecond-Tuple{Base.Dates.Time}"><code>Base.Dates.Nanosecond</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">Nanosecond(dt::Time) -> Nanosecond</code></pre><p>The nanosecond part of a Time as a <code>Nanosecond</code>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/periods.jl#L24-L28">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.yearmonth" href="#Base.Dates.yearmonth"><code>Base.Dates.yearmonth</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">yearmonth(dt::TimeType) -> (Int64, Int64)</code></pre><p>Simultaneously return the year and month parts of a <code>Date</code> or <code>DateTime</code>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/accessors.jl#L126-L131">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.monthday" href="#Base.Dates.monthday"><code>Base.Dates.monthday</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">monthday(dt::TimeType) -> (Int64, Int64)</code></pre><p>Simultaneously return the month and day parts of a <code>Date</code> or <code>DateTime</code>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/accessors.jl#L126-L131">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.yearmonthday" href="#Base.Dates.yearmonthday"><code>Base.Dates.yearmonthday</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">yearmonthday(dt::TimeType) -> (Int64, Int64, Int64)</code></pre><p>Simultaneously return the year, month and day parts of a <code>Date</code> or <code>DateTime</code>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/accessors.jl#L126-L131">source</a></section><h3><a class="nav-anchor" id="Query-Functions-1" href="#Query-Functions-1">Query Functions</a></h3><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.dayname" href="#Base.Dates.dayname"><code>Base.Dates.dayname</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">dayname(dt::TimeType; locale="english") -> AbstractString</code></pre><p>Return the full day name corresponding to the day of the week of the <code>Date</code> or <code>DateTime</code> in the given <code>locale</code>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/query.jl#L116-L121">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.dayabbr" href="#Base.Dates.dayabbr"><code>Base.Dates.dayabbr</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">dayabbr(dt::TimeType; locale="english") -> AbstractString</code></pre><p>Return the abbreviated name corresponding to the day of the week of the <code>Date</code> or <code>DateTime</code> in the given <code>locale</code>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/query.jl#L126-L131">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.dayofweek" href="#Base.Dates.dayofweek"><code>Base.Dates.dayofweek</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">dayofweek(dt::TimeType) -> Int64</code></pre><p>Returns the day of the week as an <a href="numbers.html#Core.Int64"><code>Int64</code></a> with <code>1 = Monday, 2 = Tuesday, etc.</code>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/query.jl#L101-L105">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.dayofmonth" href="#Base.Dates.dayofmonth"><code>Base.Dates.dayofmonth</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">dayofmonth(dt::TimeType) -> Int64</code></pre><p>The day of month of a <code>Date</code> or <code>DateTime</code> as an <a href="numbers.html#Core.Int64"><code>Int64</code></a>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/accessors.jl#L96-L100">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.dayofweekofmonth" href="#Base.Dates.dayofweekofmonth"><code>Base.Dates.dayofweekofmonth</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">dayofweekofmonth(dt::TimeType) -> Int</code></pre><p>For the day of week of <code>dt</code>, returns which number it is in <code>dt</code>'s month. So if the day of the week of <code>dt</code> is Monday, then <code>1 = First Monday of the month, 2 = Second Monday of the month, etc.</code> In the range 1:5.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/query.jl#L146-L152">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.daysofweekinmonth" href="#Base.Dates.daysofweekinmonth"><code>Base.Dates.daysofweekinmonth</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">daysofweekinmonth(dt::TimeType) -> Int</code></pre><p>For the day of week of <code>dt</code>, returns the total number of that day of the week in <code>dt</code>'s month. Returns 4 or 5. Useful in temporal expressions for specifying the last day of a week in a month by including <code>dayofweekofmonth(dt) == daysofweekinmonth(dt)</code> in the adjuster function.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/query.jl#L164-L171">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.monthname" href="#Base.Dates.monthname"><code>Base.Dates.monthname</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">monthname(dt::TimeType; locale="english") -> AbstractString</code></pre><p>Return the full name of the month of the <code>Date</code> or <code>DateTime</code> in the given <code>locale</code>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/query.jl#L190-L194">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.monthabbr" href="#Base.Dates.monthabbr"><code>Base.Dates.monthabbr</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">monthabbr(dt::TimeType; locale="english") -> AbstractString</code></pre><p>Return the abbreviated month name of the <code>Date</code> or <code>DateTime</code> in the given <code>locale</code>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/query.jl#L199-L203">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.daysinmonth" href="#Base.Dates.daysinmonth"><code>Base.Dates.daysinmonth</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">daysinmonth(dt::TimeType) -> Int</code></pre><p>Returns the number of days in the month of <code>dt</code>. Value will be 28, 29, 30, or 31.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/query.jl#L208-L212">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.isleapyear" href="#Base.Dates.isleapyear"><code>Base.Dates.isleapyear</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">isleapyear(dt::TimeType) -> Bool</code></pre><p>Returns <code>true</code> if the year of <code>dt</code> is a leap year.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/query.jl#L216-L220">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.dayofyear" href="#Base.Dates.dayofyear"><code>Base.Dates.dayofyear</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">dayofyear(dt::TimeType) -> Int</code></pre><p>Returns the day of the year for <code>dt</code> with January 1st being day 1.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/query.jl#L223-L227">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.daysinyear" href="#Base.Dates.daysinyear"><code>Base.Dates.daysinyear</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">daysinyear(dt::TimeType) -> Int</code></pre><p>Returns 366 if the year of <code>dt</code> is a leap year, otherwise returns 365.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/query.jl#L89-L93">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.quarterofyear" href="#Base.Dates.quarterofyear"><code>Base.Dates.quarterofyear</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">quarterofyear(dt::TimeType) -> Int</code></pre><p>Returns the quarter that <code>dt</code> resides in. Range of value is 1:4.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/query.jl#L233-L237">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.dayofquarter" href="#Base.Dates.dayofquarter"><code>Base.Dates.dayofquarter</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">dayofquarter(dt::TimeType) -> Int</code></pre><p>Returns the day of the current quarter of <code>dt</code>. Range of value is 1:92.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/query.jl#L244-L248">source</a></section><h3><a class="nav-anchor" id="Adjuster-Functions-1" href="#Adjuster-Functions-1">Adjuster Functions</a></h3><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.trunc-Tuple{Base.Dates.TimeType,Type{Base.Dates.Period}}" href="#Base.trunc-Tuple{Base.Dates.TimeType,Type{Base.Dates.Period}}"><code>Base.trunc</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">trunc(dt::TimeType, ::Type{Period}) -> TimeType</code></pre><p>Truncates the value of <code>dt</code> according to the provided <code>Period</code> type. E.g. if <code>dt</code> is <code>1996-01-01T12:30:00</code>, then <code>trunc(dt,Day) == 1996-01-01T00:00:00</code>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/adjusters.jl#L23-L28">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.firstdayofweek" href="#Base.Dates.firstdayofweek"><code>Base.Dates.firstdayofweek</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">firstdayofweek(dt::TimeType) -> TimeType</code></pre><p>Adjusts <code>dt</code> to the Monday of its week.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/adjusters.jl#L32-L36">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.lastdayofweek" href="#Base.Dates.lastdayofweek"><code>Base.Dates.lastdayofweek</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">lastdayofweek(dt::TimeType) -> TimeType</code></pre><p>Adjusts <code>dt</code> to the Sunday of its week.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/adjusters.jl#L42-L46">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.firstdayofmonth" href="#Base.Dates.firstdayofmonth"><code>Base.Dates.firstdayofmonth</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">firstdayofmonth(dt::TimeType) -> TimeType</code></pre><p>Adjusts <code>dt</code> to the first day of its month.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/adjusters.jl#L52-L56">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.lastdayofmonth" href="#Base.Dates.lastdayofmonth"><code>Base.Dates.lastdayofmonth</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">lastdayofmonth(dt::TimeType) -> TimeType</code></pre><p>Adjusts <code>dt</code> to the last day of its month.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/adjusters.jl#L62-L66">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.firstdayofyear" href="#Base.Dates.firstdayofyear"><code>Base.Dates.firstdayofyear</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">firstdayofyear(dt::TimeType) -> TimeType</code></pre><p>Adjusts <code>dt</code> to the first day of its year.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/adjusters.jl#L75-L79">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.lastdayofyear" href="#Base.Dates.lastdayofyear"><code>Base.Dates.lastdayofyear</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">lastdayofyear(dt::TimeType) -> TimeType</code></pre><p>Adjusts <code>dt</code> to the last day of its year.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/adjusters.jl#L85-L89">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.firstdayofquarter" href="#Base.Dates.firstdayofquarter"><code>Base.Dates.firstdayofquarter</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">firstdayofquarter(dt::TimeType) -> TimeType</code></pre><p>Adjusts <code>dt</code> to the first day of its quarter.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/adjusters.jl#L98-L102">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.lastdayofquarter" href="#Base.Dates.lastdayofquarter"><code>Base.Dates.lastdayofquarter</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">lastdayofquarter(dt::TimeType) -> TimeType</code></pre><p>Adjusts <code>dt</code> to the last day of its quarter.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/adjusters.jl#L112-L116">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.tonext-Tuple{Base.Dates.TimeType,Int64}" href="#Base.Dates.tonext-Tuple{Base.Dates.TimeType,Int64}"><code>Base.Dates.tonext</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">tonext(dt::TimeType, dow::Int; same::Bool=false) -> TimeType</code></pre><p>Adjusts <code>dt</code> to the next day of week corresponding to <code>dow</code> with <code>1 = Monday, 2 = Tuesday, etc</code>. Setting <code>same=true</code> allows the current <code>dt</code> to be considered as the next <code>dow</code>, allowing for no adjustment to occur.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/adjusters.jl#L242-L248">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.toprev-Tuple{Base.Dates.TimeType,Int64}" href="#Base.Dates.toprev-Tuple{Base.Dates.TimeType,Int64}"><code>Base.Dates.toprev</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">toprev(dt::TimeType, dow::Int; same::Bool=false) -> TimeType</code></pre><p>Adjusts <code>dt</code> to the previous day of week corresponding to <code>dow</code> with <code>1 = Monday, 2 = Tuesday, etc</code>. Setting <code>same=true</code> allows the current <code>dt</code> to be considered as the previous <code>dow</code>, allowing for no adjustment to occur.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/adjusters.jl#L264-L270">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.tofirst" href="#Base.Dates.tofirst"><code>Base.Dates.tofirst</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">tofirst(dt::TimeType, dow::Int; of=Month) -> TimeType</code></pre><p>Adjusts <code>dt</code> to the first <code>dow</code> of its month. Alternatively, <code>of=Year</code> will adjust to the first <code>dow</code> of the year.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/adjusters.jl#L286-L291">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.tolast" href="#Base.Dates.tolast"><code>Base.Dates.tolast</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">tolast(dt::TimeType, dow::Int; of=Month) -> TimeType</code></pre><p>Adjusts <code>dt</code> to the last <code>dow</code> of its month. Alternatively, <code>of=Year</code> will adjust to the last <code>dow</code> of the year.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/adjusters.jl#L298-L303">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.tonext-Tuple{Function,Base.Dates.TimeType}" href="#Base.Dates.tonext-Tuple{Function,Base.Dates.TimeType}"><code>Base.Dates.tonext</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">tonext(func::Function, dt::TimeType; step=Day(1), limit=10000, same=false) -> TimeType</code></pre><p>Adjusts <code>dt</code> by iterating at most <code>limit</code> iterations by <code>step</code> increments until <code>func</code> returns <code>true</code>. <code>func</code> must take a single <code>TimeType</code> argument and return a <a href="numbers.html#Core.Bool"><code>Bool</code></a>. <code>same</code> allows <code>dt</code> to be considered in satisfying <code>func</code>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/adjusters.jl#L252-L258">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.toprev-Tuple{Function,Base.Dates.TimeType}" href="#Base.Dates.toprev-Tuple{Function,Base.Dates.TimeType}"><code>Base.Dates.toprev</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">toprev(func::Function, dt::TimeType; step=Day(-1), limit=10000, same=false) -> TimeType</code></pre><p>Adjusts <code>dt</code> by iterating at most <code>limit</code> iterations by <code>step</code> increments until <code>func</code> returns <code>true</code>. <code>func</code> must take a single <code>TimeType</code> argument and return a <a href="numbers.html#Core.Bool"><code>Bool</code></a>. <code>same</code> allows <code>dt</code> to be considered in satisfying <code>func</code>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/adjusters.jl#L273-L279">source</a></section><h3><a class="nav-anchor" id="Periods-1" href="#Periods-1">Periods</a></h3><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.Period-Tuple{Any}" href="#Base.Dates.Period-Tuple{Any}"><code>Base.Dates.Period</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">Year(v)
|
|
Month(v)
|
|
Week(v)
|
|
Day(v)
|
|
Hour(v)
|
|
Minute(v)
|
|
Second(v)
|
|
Millisecond(v)
|
|
Microsecond(v)
|
|
Nanosecond(v)</code></pre><p>Construct a <code>Period</code> type with the given <code>v</code> value. Input must be losslessly convertible to an <a href="numbers.html#Core.Int64"><code>Int64</code></a>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/types.jl#L37-L51">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.CompoundPeriod-Tuple{Array{#s27,1} where #s27<:Base.Dates.Period}" href="#Base.Dates.CompoundPeriod-Tuple{Array{#s27,1} where #s27<:Base.Dates.Period}"><code>Base.Dates.CompoundPeriod</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">CompoundPeriod(periods) -> CompoundPeriod</code></pre><p>Construct a <code>CompoundPeriod</code> from a <code>Vector</code> of <code>Period</code>s. All <code>Period</code>s of the same type will be added together.</p><p><strong>Examples</strong></p><pre><code class="language-julia-repl">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</code></pre></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/periods.jl#L195-L215">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.default" href="#Base.Dates.default"><code>Base.Dates.default</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">default(p::Period) -> Period</code></pre><p>Returns a sensible "default" value for the input Period by returning <code>T(1)</code> for Year, Month, and Day, and <code>T(0)</code> for Hour, Minute, Second, and Millisecond.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/periods.jl#L50-L55">source</a></section><h3><a class="nav-anchor" id="Rounding-Functions-1" href="#Rounding-Functions-1">Rounding Functions</a></h3><p><code>Date</code> and <code>DateTime</code> values can be rounded to a specified resolution (e.g., 1 month or 15 minutes) with <code>floor</code>, <code>ceil</code>, or <code>round</code>.</p><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.floor-Tuple{Base.Dates.TimeType,Base.Dates.Period}" href="#Base.floor-Tuple{Base.Dates.TimeType,Base.Dates.Period}"><code>Base.floor</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">floor(dt::TimeType, p::Period) -> TimeType</code></pre><p>Returns the nearest <code>Date</code> or <code>DateTime</code> less than or equal to <code>dt</code> at resolution <code>p</code>.</p><p>For convenience, <code>p</code> may be a type instead of a value: <code>floor(dt, Dates.Hour)</code> is a shortcut for <code>floor(dt, Dates.Hour(1))</code>.</p><pre><code class="language-julia-repl">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</code></pre></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/rounding.jl#L79-L97">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.ceil-Tuple{Base.Dates.TimeType,Base.Dates.Period}" href="#Base.ceil-Tuple{Base.Dates.TimeType,Base.Dates.Period}"><code>Base.ceil</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">ceil(dt::TimeType, p::Period) -> TimeType</code></pre><p>Returns the nearest <code>Date</code> or <code>DateTime</code> greater than or equal to <code>dt</code> at resolution <code>p</code>.</p><p>For convenience, <code>p</code> may be a type instead of a value: <code>ceil(dt, Dates.Hour)</code> is a shortcut for <code>ceil(dt, Dates.Hour(1))</code>.</p><pre><code class="language-julia-repl">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</code></pre></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/rounding.jl#L100-L118">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.round-Tuple{Base.Dates.TimeType,Base.Dates.Period,RoundingMode{:NearestTiesUp}}" href="#Base.round-Tuple{Base.Dates.TimeType,Base.Dates.Period,RoundingMode{:NearestTiesUp}}"><code>Base.round</code></a> — <span class="docstring-category">Method</span>.</div><div><pre><code class="language-none">round(dt::TimeType, p::Period, [r::RoundingMode]) -> TimeType</code></pre><p>Returns the <code>Date</code> or <code>DateTime</code> nearest to <code>dt</code> at resolution <code>p</code>. By default (<code>RoundNearestTiesUp</code>), ties (e.g., rounding 9:30 to the nearest hour) will be rounded up.</p><p>For convenience, <code>p</code> may be a type instead of a value: <code>round(dt, Dates.Hour)</code> is a shortcut for <code>round(dt, Dates.Hour(1))</code>.</p><pre><code class="language-julia-repl">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</code></pre><p>Valid rounding modes for <code>round(::TimeType, ::Period, ::RoundingMode)</code> are <code>RoundNearestTiesUp</code> (default), <code>RoundDown</code> (<code>floor</code>), and <code>RoundUp</code> (<code>ceil</code>).</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/rounding.jl#L135-L157">source</a></section><p>The following functions are not exported:</p><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.floorceil" href="#Base.Dates.floorceil"><code>Base.Dates.floorceil</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">floorceil(dt::TimeType, p::Period) -> (TimeType, TimeType)</code></pre><p>Simultaneously return the <code>floor</code> and <code>ceil</code> of a <code>Date</code> or <code>DateTime</code> at resolution <code>p</code>. More efficient than calling both <code>floor</code> and <code>ceil</code> individually.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/rounding.jl#L124-L129">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.epochdays2date" href="#Base.Dates.epochdays2date"><code>Base.Dates.epochdays2date</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">epochdays2date(days) -> Date</code></pre><p>Takes the number of days since the rounding epoch (<code>0000-01-01T00:00:00</code>) and returns the corresponding <code>Date</code>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/rounding.jl#L10-L15">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.epochms2datetime" href="#Base.Dates.epochms2datetime"><code>Base.Dates.epochms2datetime</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">epochms2datetime(milliseconds) -> DateTime</code></pre><p>Takes the number of milliseconds since the rounding epoch (<code>0000-01-01T00:00:00</code>) and returns the corresponding <code>DateTime</code>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/rounding.jl#L18-L23">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.date2epochdays" href="#Base.Dates.date2epochdays"><code>Base.Dates.date2epochdays</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">date2epochdays(dt::Date) -> Int64</code></pre><p>Takes the given <code>Date</code> and returns the number of days since the rounding epoch (<code>0000-01-01T00:00:00</code>) as an <a href="numbers.html#Core.Int64"><code>Int64</code></a>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/rounding.jl#L26-L31">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.datetime2epochms" href="#Base.Dates.datetime2epochms"><code>Base.Dates.datetime2epochms</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">datetime2epochms(dt::DateTime) -> Int64</code></pre><p>Takes the given <code>DateTime</code> and returns the number of milliseconds since the rounding epoch (<code>0000-01-01T00:00:00</code>) as an <a href="numbers.html#Core.Int64"><code>Int64</code></a>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/rounding.jl#L34-L39">source</a></section><h3><a class="nav-anchor" id="Conversion-Functions-1" href="#Conversion-Functions-1">Conversion Functions</a></h3><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.today" href="#Base.Dates.today"><code>Base.Dates.today</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">today() -> Date</code></pre><p>Returns the date portion of <code>now()</code>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/conversions.jl#L72-L76">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.unix2datetime" href="#Base.Dates.unix2datetime"><code>Base.Dates.unix2datetime</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">unix2datetime(x) -> DateTime</code></pre><p>Takes the number of seconds since unix epoch <code>1970-01-01T00:00:00</code> and converts to the corresponding <code>DateTime</code>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/conversions.jl#L42-L47">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.datetime2unix" href="#Base.Dates.datetime2unix"><code>Base.Dates.datetime2unix</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">datetime2unix(dt::DateTime) -> Float64</code></pre><p>Takes the given <code>DateTime</code> and returns the number of seconds since the unix epoch <code>1970-01-01T00:00:00</code> as a <a href="numbers.html#Core.Float64"><code>Float64</code></a>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/conversions.jl#L52-L57">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.julian2datetime" href="#Base.Dates.julian2datetime"><code>Base.Dates.julian2datetime</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">julian2datetime(julian_days) -> DateTime</code></pre><p>Takes the number of Julian calendar days since epoch <code>-4713-11-24T12:00:00</code> and returns the corresponding <code>DateTime</code>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/conversions.jl#L104-L109">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.datetime2julian" href="#Base.Dates.datetime2julian"><code>Base.Dates.datetime2julian</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">datetime2julian(dt::DateTime) -> Float64</code></pre><p>Takes the given <code>DateTime</code> and returns the number of Julian calendar days since the julian epoch <code>-4713-11-24T12:00:00</code> as a <a href="numbers.html#Core.Float64"><code>Float64</code></a>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/conversions.jl#L115-L120">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.rata2datetime" href="#Base.Dates.rata2datetime"><code>Base.Dates.rata2datetime</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">rata2datetime(days) -> DateTime</code></pre><p>Takes the number of Rata Die days since epoch <code>0000-12-31T00:00:00</code> and returns the corresponding <code>DateTime</code>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/conversions.jl#L86-L91">source</a></section><section class="docstring"><div class="docstring-header"><a class="docstring-binding" id="Base.Dates.datetime2rata" href="#Base.Dates.datetime2rata"><code>Base.Dates.datetime2rata</code></a> — <span class="docstring-category">Function</span>.</div><div><pre><code class="language-none">datetime2rata(dt::TimeType) -> Int64</code></pre><p>Returns the number of Rata Die days since epoch from the given <code>Date</code> or <code>DateTime</code>.</p></div><a class="source-link" target="_blank" href="https://github.com/JuliaLang/julia/blob/d55cadc350d426a95fd967121ba77494d08364c8/base/dates/conversions.jl#L94-L98">source</a></section><h3><a class="nav-anchor" id="Constants-1" href="#Constants-1">Constants</a></h3><p>Days of the Week:</p><table><tr><th>Variable</th><th>Abbr.</th><th>Value (Int)</th></tr><tr><td><code>Monday</code></td><td><code>Mon</code></td><td>1</td></tr><tr><td><code>Tuesday</code></td><td><code>Tue</code></td><td>2</td></tr><tr><td><code>Wednesday</code></td><td><code>Wed</code></td><td>3</td></tr><tr><td><code>Thursday</code></td><td><code>Thu</code></td><td>4</td></tr><tr><td><code>Friday</code></td><td><code>Fri</code></td><td>5</td></tr><tr><td><code>Saturday</code></td><td><code>Sat</code></td><td>6</td></tr><tr><td><code>Sunday</code></td><td><code>Sun</code></td><td>7</td></tr></table><p>Months of the Year:</p><table><tr><th>Variable</th><th>Abbr.</th><th>Value (Int)</th></tr><tr><td><code>January</code></td><td><code>Jan</code></td><td>1</td></tr><tr><td><code>February</code></td><td><code>Feb</code></td><td>2</td></tr><tr><td><code>March</code></td><td><code>Mar</code></td><td>3</td></tr><tr><td><code>April</code></td><td><code>Apr</code></td><td>4</td></tr><tr><td><code>May</code></td><td><code>May</code></td><td>5</td></tr><tr><td><code>June</code></td><td><code>Jun</code></td><td>6</td></tr><tr><td><code>July</code></td><td><code>Jul</code></td><td>7</td></tr><tr><td><code>August</code></td><td><code>Aug</code></td><td>8</td></tr><tr><td><code>September</code></td><td><code>Sep</code></td><td>9</td></tr><tr><td><code>October</code></td><td><code>Oct</code></td><td>10</td></tr><tr><td><code>November</code></td><td><code>Nov</code></td><td>11</td></tr><tr><td><code>December</code></td><td><code>Dec</code></td><td>12</td></tr></table><footer><hr/><a class="previous" href="pkg.html"><span class="direction">Previous</span><span class="title">Package Manager Functions</span></a><a class="next" href="iterators.html"><span class="direction">Next</span><span class="title">Iteration utilities</span></a></footer></article></body></html>
|