<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Data.Time.Clock</title><link href="ocean.css" rel="stylesheet" type="text/css" title="Ocean" /><script src="haddock-util.js" type="text/javascript"></script><script type="text/javascript">//<![CDATA[
window.onload = function () {pageLoad();setSynopsis("mini_Data-Time-Clock.html");};
//]]>
</script></head><body><div id="package-header"><ul class="links" id="page-menu"><li><a href="index.html">Contents</a></li><li><a href="doc-index.html">Index</a></li></ul><p class="caption">time-1.4: A time library</p></div><div id="content"><div id="module-header"><table class="info"><tr><th>Safe Haskell</th><td>None</td></tr></table><p class="caption">Data.Time.Clock</p></div><div id="table-of-contents"><p class="caption">Contents</p><ul><li><a href="#g:1">Universal Time
</a></li><li><a href="#g:2">Absolute intervals
</a></li><li><a href="#g:3">UTC
</a></li></ul></div><div id="description"><p class="caption">Description</p><div class="doc"><p>Types and functions for UTC and UT1
</p></div></div><div id="synopsis"><p id="control.syn" class="caption expander" onclick="toggleSection('syn')">Synopsis</p><ul id="section.syn" class="hide" onclick="toggleSection('syn')"><li class="src short"><span class="keyword">newtype</span> <a href="#t:UniversalTime">UniversalTime</a> = <a href="#v:ModJulianDate">ModJulianDate</a> {<ul class="subs"><li><a href="#v:getModJulianDate">getModJulianDate</a> :: <a href="../base-4.5.1.0/Prelude.html#t:Rational">Rational</a></li></ul>}</li><li class="src short"><span class="keyword">data</span> <a href="#t:DiffTime">DiffTime</a> </li><li class="src short"><a href="#v:secondsToDiffTime">secondsToDiffTime</a> :: <a href="../base-4.5.1.0/Prelude.html#t:Integer">Integer</a> -> <a href="Data-Time-Clock.html#t:DiffTime">DiffTime</a></li><li class="src short"><a href="#v:picosecondsToDiffTime">picosecondsToDiffTime</a> :: <a href="../base-4.5.1.0/Prelude.html#t:Integer">Integer</a> -> <a href="Data-Time-Clock.html#t:DiffTime">DiffTime</a></li><li class="src short"><span class="keyword">data</span> <a href="#t:UTCTime">UTCTime</a> = <a href="#v:UTCTime">UTCTime</a> {<ul class="subs"><li><a href="#v:utctDay">utctDay</a> :: <a href="Data-Time-Calendar.html#t:Day">Day</a></li><li><a href="#v:utctDayTime">utctDayTime</a> :: <a href="Data-Time-Clock.html#t:DiffTime">DiffTime</a></li></ul>}</li><li class="src short"><span class="keyword">data</span> <a href="#t:NominalDiffTime">NominalDiffTime</a> </li><li class="src short"><a href="#v:addUTCTime">addUTCTime</a> :: <a href="Data-Time-Clock.html#t:NominalDiffTime">NominalDiffTime</a> -> <a href="Data-Time-Clock.html#t:UTCTime">UTCTime</a> -> <a href="Data-Time-Clock.html#t:UTCTime">UTCTime</a></li><li class="src short"><a href="#v:diffUTCTime">diffUTCTime</a> :: <a href="Data-Time-Clock.html#t:UTCTime">UTCTime</a> -> <a href="Data-Time-Clock.html#t:UTCTime">UTCTime</a> -> <a href="Data-Time-Clock.html#t:NominalDiffTime">NominalDiffTime</a></li><li class="src short"><a href="#v:getCurrentTime">getCurrentTime</a> :: <a href="../base-4.5.1.0/System-IO.html#t:IO">IO</a> <a href="Data-Time-Clock.html#t:UTCTime">UTCTime</a></li></ul></div><div id="interface"><h1 id="g:1">Universal Time
</h1><div class="doc"><p>Time as measured by the earth.
</p></div><div class="top"><p class="src"><span class="keyword">newtype</span> <a name="t:UniversalTime" class="def">UniversalTime</a> </p><div class="doc"><p>The Modified Julian Date is the day with the fraction of the day, measured from UT midnight.
It's used to represent UT1, which is time as measured by the earth's rotation, adjusted for various wobbles.
</p></div><div class="subs constructors"><p class="caption">Constructors</p><table><tr><td class="src"><a name="v:ModJulianDate" class="def">ModJulianDate</a></td><td class="doc empty"> </td></tr><tr><td colspan="2"><div class="subs fields"><p class="caption">Fields</p><dl><dt class="src"><a name="v:getModJulianDate" class="def">getModJulianDate</a> :: <a href="../base-4.5.1.0/Prelude.html#t:Rational">Rational</a></dt><dd class="doc empty"> </dd></dl><div class="clear"></div></div></td></tr></table></div><div class="subs instances"><p id="control.i:UniversalTime" class="caption collapser" onclick="toggleSection('i:UniversalTime')">Instances</p><div id="section.i:UniversalTime" class="show"><table><tr><td class="src"><a href="../base-4.5.1.0/Data-Eq.html#t:Eq">Eq</a> <a href="Data-Time-Clock.html#t:UniversalTime">UniversalTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="../base-4.5.1.0/Data-Data.html#t:Data">Data</a> <a href="Data-Time-Clock.html#t:UniversalTime">UniversalTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="../base-4.5.1.0/Data-Ord.html#t:Ord">Ord</a> <a href="Data-Time-Clock.html#t:UniversalTime">UniversalTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="../base-4.5.1.0/Data-Typeable-Internal.html#t:Typeable">Typeable</a> <a href="Data-Time-Clock.html#t:UniversalTime">UniversalTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="../deepseq-1.3.0.0/Control-DeepSeq.html#t:NFData">NFData</a> <a href="Data-Time-Clock.html#t:UniversalTime">UniversalTime</a></td><td class="doc empty"> </td></tr></table></div></div></div><h1 id="g:2">Absolute intervals
</h1><div class="top"><p class="src"><span class="keyword">data</span> <a name="t:DiffTime" class="def">DiffTime</a> </p><div class="doc"><p>This is a length of time, as measured by a clock.
Conversion functions will treat it as seconds.
It has a precision of 10^-12 s.
</p></div><div class="subs instances"><p id="control.i:DiffTime" class="caption collapser" onclick="toggleSection('i:DiffTime')">Instances</p><div id="section.i:DiffTime" class="show"><table><tr><td class="src"><a href="../base-4.5.1.0/Prelude.html#t:Enum">Enum</a> <a href="Data-Time-Clock.html#t:DiffTime">DiffTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="../base-4.5.1.0/Data-Eq.html#t:Eq">Eq</a> <a href="Data-Time-Clock.html#t:DiffTime">DiffTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="../base-4.5.1.0/Prelude.html#t:Fractional">Fractional</a> <a href="Data-Time-Clock.html#t:DiffTime">DiffTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="../base-4.5.1.0/Data-Data.html#t:Data">Data</a> <a href="Data-Time-Clock.html#t:DiffTime">DiffTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="../base-4.5.1.0/Prelude.html#t:Num">Num</a> <a href="Data-Time-Clock.html#t:DiffTime">DiffTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="../base-4.5.1.0/Data-Ord.html#t:Ord">Ord</a> <a href="Data-Time-Clock.html#t:DiffTime">DiffTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="../base-4.5.1.0/Prelude.html#t:Real">Real</a> <a href="Data-Time-Clock.html#t:DiffTime">DiffTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="../base-4.5.1.0/Prelude.html#t:RealFrac">RealFrac</a> <a href="Data-Time-Clock.html#t:DiffTime">DiffTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="../base-4.5.1.0/Text-Show.html#t:Show">Show</a> <a href="Data-Time-Clock.html#t:DiffTime">DiffTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="../base-4.5.1.0/Data-Typeable-Internal.html#t:Typeable">Typeable</a> <a href="Data-Time-Clock.html#t:DiffTime">DiffTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="../deepseq-1.3.0.0/Control-DeepSeq.html#t:NFData">NFData</a> <a href="Data-Time-Clock.html#t:DiffTime">DiffTime</a></td><td class="doc empty"> </td></tr></table></div></div></div><div class="top"><p class="src"><a name="v:secondsToDiffTime" class="def">secondsToDiffTime</a> :: <a href="../base-4.5.1.0/Prelude.html#t:Integer">Integer</a> -> <a href="Data-Time-Clock.html#t:DiffTime">DiffTime</a></p><div class="doc"><p>Create a <code><a href="Data-Time-Clock.html#t:DiffTime">DiffTime</a></code> which represents an integral number of seconds.
</p></div></div><div class="top"><p class="src"><a name="v:picosecondsToDiffTime" class="def">picosecondsToDiffTime</a> :: <a href="../base-4.5.1.0/Prelude.html#t:Integer">Integer</a> -> <a href="Data-Time-Clock.html#t:DiffTime">DiffTime</a></p><div class="doc"><p>Create a <code><a href="Data-Time-Clock.html#t:DiffTime">DiffTime</a></code> from a number of picoseconds.
</p></div></div><h1 id="g:3">UTC
</h1><div class="doc"><p>UTC is time as measured by a clock, corrected to keep pace with the earth by adding or removing
occasional seconds, known as "leap seconds".
These corrections are not predictable and are announced with six month's notice.
No table of these corrections is provided, as any program compiled with it would become
out of date in six months.
</p><p>If you don't care about leap seconds, use UTCTime and NominalDiffTime for your clock calculations,
and you'll be fine.
</p></div><div class="top"><p class="src"><span class="keyword">data</span> <a name="t:UTCTime" class="def">UTCTime</a> </p><div class="doc"><p>This is the simplest representation of UTC.
It consists of the day number, and a time offset from midnight.
Note that if a day has a leap second added to it, it will have 86401 seconds.
</p></div><div class="subs constructors"><p class="caption">Constructors</p><table><tr><td class="src"><a name="v:UTCTime" class="def">UTCTime</a></td><td class="doc empty"> </td></tr><tr><td colspan="2"><div class="subs fields"><p class="caption">Fields</p><dl><dt class="src"><a name="v:utctDay" class="def">utctDay</a> :: <a href="Data-Time-Calendar.html#t:Day">Day</a></dt><dd class="doc"><p>the day
</p></dd><dt class="src"><a name="v:utctDayTime" class="def">utctDayTime</a> :: <a href="Data-Time-Clock.html#t:DiffTime">DiffTime</a></dt><dd class="doc"><p>the time from midnight, 0 <= t < 86401s (because of leap-seconds)
</p></dd></dl><div class="clear"></div></div></td></tr></table></div><div class="subs instances"><p id="control.i:UTCTime" class="caption collapser" onclick="toggleSection('i:UTCTime')">Instances</p><div id="section.i:UTCTime" class="show"><table><tr><td class="src"><a href="../base-4.5.1.0/Data-Eq.html#t:Eq">Eq</a> <a href="Data-Time-Clock.html#t:UTCTime">UTCTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="../base-4.5.1.0/Data-Data.html#t:Data">Data</a> <a href="Data-Time-Clock.html#t:UTCTime">UTCTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="../base-4.5.1.0/Data-Ord.html#t:Ord">Ord</a> <a href="Data-Time-Clock.html#t:UTCTime">UTCTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="../base-4.5.1.0/Text-Read.html#t:Read">Read</a> <a href="Data-Time-Clock.html#t:UTCTime">UTCTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="../base-4.5.1.0/Text-Show.html#t:Show">Show</a> <a href="Data-Time-Clock.html#t:UTCTime">UTCTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="../base-4.5.1.0/Data-Typeable-Internal.html#t:Typeable">Typeable</a> <a href="Data-Time-Clock.html#t:UTCTime">UTCTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="../deepseq-1.3.0.0/Control-DeepSeq.html#t:NFData">NFData</a> <a href="Data-Time-Clock.html#t:UTCTime">UTCTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="Data-Time-Format.html#t:ParseTime">ParseTime</a> <a href="Data-Time-Clock.html#t:UTCTime">UTCTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="Data-Time-Format.html#t:FormatTime">FormatTime</a> <a href="Data-Time-Clock.html#t:UTCTime">UTCTime</a></td><td class="doc empty"> </td></tr></table></div></div></div><div class="top"><p class="src"><span class="keyword">data</span> <a name="t:NominalDiffTime" class="def">NominalDiffTime</a> </p><div class="doc"><p>This is a length of time, as measured by UTC.
Conversion functions will treat it as seconds.
It has a precision of 10^-12 s.
It ignores leap-seconds, so it's not necessarily a fixed amount of clock time.
For instance, 23:00 UTC + 2 hours of NominalDiffTime = 01:00 UTC (+ 1 day),
regardless of whether a leap-second intervened.
</p></div><div class="subs instances"><p id="control.i:NominalDiffTime" class="caption collapser" onclick="toggleSection('i:NominalDiffTime')">Instances</p><div id="section.i:NominalDiffTime" class="show"><table><tr><td class="src"><a href="../base-4.5.1.0/Prelude.html#t:Enum">Enum</a> <a href="Data-Time-Clock.html#t:NominalDiffTime">NominalDiffTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="../base-4.5.1.0/Data-Eq.html#t:Eq">Eq</a> <a href="Data-Time-Clock.html#t:NominalDiffTime">NominalDiffTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="../base-4.5.1.0/Prelude.html#t:Fractional">Fractional</a> <a href="Data-Time-Clock.html#t:NominalDiffTime">NominalDiffTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="../base-4.5.1.0/Data-Data.html#t:Data">Data</a> <a href="Data-Time-Clock.html#t:NominalDiffTime">NominalDiffTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="../base-4.5.1.0/Prelude.html#t:Num">Num</a> <a href="Data-Time-Clock.html#t:NominalDiffTime">NominalDiffTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="../base-4.5.1.0/Data-Ord.html#t:Ord">Ord</a> <a href="Data-Time-Clock.html#t:NominalDiffTime">NominalDiffTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="../base-4.5.1.0/Prelude.html#t:Real">Real</a> <a href="Data-Time-Clock.html#t:NominalDiffTime">NominalDiffTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="../base-4.5.1.0/Prelude.html#t:RealFrac">RealFrac</a> <a href="Data-Time-Clock.html#t:NominalDiffTime">NominalDiffTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="../base-4.5.1.0/Text-Show.html#t:Show">Show</a> <a href="Data-Time-Clock.html#t:NominalDiffTime">NominalDiffTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="../base-4.5.1.0/Data-Typeable-Internal.html#t:Typeable">Typeable</a> <a href="Data-Time-Clock.html#t:NominalDiffTime">NominalDiffTime</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="../deepseq-1.3.0.0/Control-DeepSeq.html#t:NFData">NFData</a> <a href="Data-Time-Clock.html#t:NominalDiffTime">NominalDiffTime</a></td><td class="doc empty"> </td></tr></table></div></div></div><div class="top"><p class="src"><a name="v:addUTCTime" class="def">addUTCTime</a> :: <a href="Data-Time-Clock.html#t:NominalDiffTime">NominalDiffTime</a> -> <a href="Data-Time-Clock.html#t:UTCTime">UTCTime</a> -> <a href="Data-Time-Clock.html#t:UTCTime">UTCTime</a></p><div class="doc"><p>addUTCTime a b = a + b
</p></div></div><div class="top"><p class="src"><a name="v:diffUTCTime" class="def">diffUTCTime</a> :: <a href="Data-Time-Clock.html#t:UTCTime">UTCTime</a> -> <a href="Data-Time-Clock.html#t:UTCTime">UTCTime</a> -> <a href="Data-Time-Clock.html#t:NominalDiffTime">NominalDiffTime</a></p><div class="doc"><p>diffUTCTime a b = a - b
</p></div></div><div class="top"><p class="src"><a name="v:getCurrentTime" class="def">getCurrentTime</a> :: <a href="../base-4.5.1.0/System-IO.html#t:IO">IO</a> <a href="Data-Time-Clock.html#t:UTCTime">UTCTime</a></p><div class="doc"><p>Get the current UTC time from the system clock.
</p></div></div></div></div><div id="footer"><p>Produced by <a href="http://www.haskell.org/haddock/">Haddock</a> version 2.11.0</p></div></body></html>
distrib
>
Mageia
>
5
>
i586
>
media
>
core-release
>
by-pkgid
>
6e204a966e8c42d976f99a1700ce5f20
>
files
>
4164
