Sophie

Sophie

distrib > Mandriva > 2010.0 > i586 > media > contrib-release > by-pkgid > 1f2b142b9d2ef4849a6f5316fa1c5b12 > files > 2925

ghc-6.10.4-1mdv2010.0.i586.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!--Rendered using the Haskell Html Library v0.2-->
<HTML
><HEAD
><META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=UTF-8"
><TITLE
>Data.Time.Format</TITLE
><LINK HREF="haddock.css" REL="stylesheet" TYPE="text/css"
><SCRIPT SRC="haddock-util.js" TYPE="text/javascript"
></SCRIPT
><SCRIPT TYPE="text/javascript"
>window.onload = function () {setSynopsis("mini_Data-Time-Format.html")};</SCRIPT
></HEAD
><BODY
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="topbar"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD
><IMG SRC="haskell_icon.gif" WIDTH="16" HEIGHT="16" ALT=" "
></TD
><TD CLASS="title"
>time-1.1.4: A time library</TD
><TD CLASS="topbut"
><A HREF="index.html"
>Contents</A
></TD
><TD CLASS="topbut"
><A HREF="doc-index.html"
>Index</A
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="modulebar"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD
><FONT SIZE="6"
>Data.Time.Format</FONT
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="section4"
><B
>Contents</B
></TD
></TR
><TR
><TD
><DL
><DT
><A HREF="#1"
>UNIX-style formatting
</A
></DT
><DT
><A HREF="#2"
>UNIX-style parsing
</A
></DT
></DL
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="section1"
>Synopsis</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="body"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="decl"
><SPAN CLASS="keyword"
>type</SPAN
> <A HREF="#t%3ANumericPadOption"
>NumericPadOption</A
> = <A HREF="../base/Data-Maybe.html#t%3AMaybe"
>Maybe</A
> <A HREF="../ghc-prim/GHC-Types.html#t%3AChar"
>Char</A
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><SPAN CLASS="keyword"
>class</SPAN
>  <A HREF="#t%3AFormatTime"
>FormatTime</A
> t  <SPAN CLASS="keyword"
>where</SPAN
></TD
></TR
><TR
><TD CLASS="body"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="decl"
><A HREF="#v%3AformatCharacter"
>formatCharacter</A
> :: <A HREF="../ghc-prim/GHC-Types.html#t%3AChar"
>Char</A
> -&gt; <A HREF="../base/Data-Maybe.html#t%3AMaybe"
>Maybe</A
> (<A HREF="../old-locale/System-Locale.html#t%3ATimeLocale"
>TimeLocale</A
> -&gt; <A HREF="../base/Data-Maybe.html#t%3AMaybe"
>Maybe</A
> <A HREF="Data-Time-Format.html#t%3ANumericPadOption"
>NumericPadOption</A
> -&gt; t -&gt; <A HREF="../base/Data-Char.html#t%3AString"
>String</A
>)</TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AformatTime"
>formatTime</A
> :: <A HREF="Data-Time-Format.html#t%3AFormatTime"
>FormatTime</A
> t =&gt; <A HREF="../old-locale/System-Locale.html#t%3ATimeLocale"
>TimeLocale</A
> -&gt; <A HREF="../base/Data-Char.html#t%3AString"
>String</A
> -&gt; t -&gt; <A HREF="../base/Data-Char.html#t%3AString"
>String</A
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AparseTime"
>parseTime</A
> :: <A HREF="Data-Time-Format.html#t%3AParseTime"
>ParseTime</A
> t =&gt; <A HREF="../old-locale/System-Locale.html#t%3ATimeLocale"
>TimeLocale</A
> -&gt; <A HREF="../base/Data-Char.html#t%3AString"
>String</A
> -&gt; <A HREF="../base/Data-Char.html#t%3AString"
>String</A
> -&gt; <A HREF="../base/Data-Maybe.html#t%3AMaybe"
>Maybe</A
> t</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AreadTime"
>readTime</A
> :: <A HREF="Data-Time-Format.html#t%3AParseTime"
>ParseTime</A
> t =&gt; <A HREF="../old-locale/System-Locale.html#t%3ATimeLocale"
>TimeLocale</A
> -&gt; <A HREF="../base/Data-Char.html#t%3AString"
>String</A
> -&gt; <A HREF="../base/Data-Char.html#t%3AString"
>String</A
> -&gt; t</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AreadsTime"
>readsTime</A
> :: <A HREF="Data-Time-Format.html#t%3AParseTime"
>ParseTime</A
> t =&gt; <A HREF="../old-locale/System-Locale.html#t%3ATimeLocale"
>TimeLocale</A
> -&gt; <A HREF="../base/Data-Char.html#t%3AString"
>String</A
> -&gt; <A HREF="../base/Text-ParserCombinators-ReadP.html#t%3AReadS"
>ReadS</A
> t</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><SPAN CLASS="keyword"
>class</SPAN
>  <A HREF="#t%3AParseTime"
>ParseTime</A
> t  <SPAN CLASS="keyword"
>where</SPAN
></TD
></TR
><TR
><TD CLASS="body"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="decl"
><A HREF="#v%3AbuildTime"
>buildTime</A
> :: <A HREF="../old-locale/System-Locale.html#t%3ATimeLocale"
>TimeLocale</A
> -&gt; [(<A HREF="../ghc-prim/GHC-Types.html#t%3AChar"
>Char</A
>, <A HREF="../base/Data-Char.html#t%3AString"
>String</A
>)] -&gt; t</TD
></TR
></TABLE
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="section1"
><A NAME="1"
><A NAME="1"
>UNIX-style formatting
</A
></A
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><SPAN CLASS="keyword"
>type</SPAN
> <A NAME="t:NumericPadOption"
><A NAME="t%3ANumericPadOption"
></A
></A
><B
>NumericPadOption</B
> = <A HREF="../base/Data-Maybe.html#t%3AMaybe"
>Maybe</A
> <A HREF="../ghc-prim/GHC-Types.html#t%3AChar"
>Char</A
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><SPAN CLASS="keyword"
>class</SPAN
>  <A NAME="t:FormatTime"
><A NAME="t%3AFormatTime"
></A
></A
><B
>FormatTime</B
> t  <SPAN CLASS="keyword"
>where</SPAN
></TD
></TR
><TR
><TD CLASS="body"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="section4"
>Methods</TD
></TR
><TR
><TD CLASS="body"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="decl"
><A NAME="v:formatCharacter"
><A NAME="v%3AformatCharacter"
></A
></A
><B
>formatCharacter</B
> :: <A HREF="../ghc-prim/GHC-Types.html#t%3AChar"
>Char</A
> -&gt; <A HREF="../base/Data-Maybe.html#t%3AMaybe"
>Maybe</A
> (<A HREF="../old-locale/System-Locale.html#t%3ATimeLocale"
>TimeLocale</A
> -&gt; <A HREF="../base/Data-Maybe.html#t%3AMaybe"
>Maybe</A
> <A HREF="Data-Time-Format.html#t%3ANumericPadOption"
>NumericPadOption</A
> -&gt; t -&gt; <A HREF="../base/Data-Char.html#t%3AString"
>String</A
>)</TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="section4"
><IMG SRC="minus.gif" CLASS="coll" ONCLICK="toggle(this,'i:FormatTime')" ALT="show/hide"
> Instances</TD
></TR
><TR
><TD CLASS="body"
><DIV ID="i:FormatTime" STYLE="display:block;"
><TABLE CLASS="vanilla" CELLSPACING="1" CELLPADDING="0"
><TR
><TD CLASS="decl"
><A HREF="Data-Time-Format.html#t%3AFormatTime"
>FormatTime</A
> <A HREF="Data-Time-Calendar.html#t%3ADay"
>Day</A
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="Data-Time-Format.html#t%3AFormatTime"
>FormatTime</A
> <A HREF="Data-Time-Clock.html#t%3AUTCTime"
>UTCTime</A
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="Data-Time-Format.html#t%3AFormatTime"
>FormatTime</A
> <A HREF="Data-Time-LocalTime.html#t%3ATimeZone"
>TimeZone</A
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="Data-Time-Format.html#t%3AFormatTime"
>FormatTime</A
> <A HREF="Data-Time-LocalTime.html#t%3ATimeOfDay"
>TimeOfDay</A
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="Data-Time-Format.html#t%3AFormatTime"
>FormatTime</A
> <A HREF="Data-Time-LocalTime.html#t%3AZonedTime"
>ZonedTime</A
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="Data-Time-Format.html#t%3AFormatTime"
>FormatTime</A
> <A HREF="Data-Time-LocalTime.html#t%3ALocalTime"
>LocalTime</A
></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v:formatTime"
><A NAME="v%3AformatTime"
></A
></A
><B
>formatTime</B
> :: <A HREF="Data-Time-Format.html#t%3AFormatTime"
>FormatTime</A
> t =&gt; <A HREF="../old-locale/System-Locale.html#t%3ATimeLocale"
>TimeLocale</A
> -&gt; <A HREF="../base/Data-Char.html#t%3AString"
>String</A
> -&gt; t -&gt; <A HREF="../base/Data-Char.html#t%3AString"
>String</A
></TD
></TR
><TR
><TD CLASS="doc"
><P
>Substitute various time-related information for each %-code in the string, as per <TT
><A HREF="Data-Time-Format.html#v%3AformatCharacter"
>formatCharacter</A
></TT
>.
</P
><P
>For all types (note these three are done here, not by <TT
><A HREF="Data-Time-Format.html#v%3AformatCharacter"
>formatCharacter</A
></TT
>):
</P
><DL
><DT
><TT
>%%</TT
></DT
><DD
> <TT
>%</TT
>
</DD
><DT
><TT
>%t</TT
></DT
><DD
> tab
</DD
><DT
><TT
>%n</TT
></DT
><DD
> newline
</DD
></DL
><P
>glibc-style modifiers can be used before the letter (here marked as <TT
>z</TT
>):
</P
><DL
><DT
><TT
>%-z</TT
></DT
><DD
> no padding
</DD
><DT
><TT
>%_z</TT
></DT
><DD
> pad with spaces
</DD
><DT
><TT
>%0z</TT
></DT
><DD
> pad with zeros
</DD
><DT
><TT
>%^z</TT
></DT
><DD
> convert to upper case
</DD
><DT
><TT
>%#z</TT
></DT
><DD
> convert to lower case (consistently, unlike glibc)
</DD
></DL
><P
>For <TT
><A HREF="Data-Time-LocalTime.html#t%3ATimeZone"
>TimeZone</A
></TT
> (and <TT
><A HREF="Data-Time-LocalTime.html#t%3AZonedTime"
>ZonedTime</A
></TT
> and <TT
><A HREF="Data-Time-Clock.html#t%3AUTCTime"
>UTCTime</A
></TT
>):
</P
><DL
><DT
><TT
>%z</TT
></DT
><DD
> timezone offset on the format <TT
>-HHMM</TT
>.
</DD
><DT
><TT
>%Z</TT
></DT
><DD
> timezone name
</DD
></DL
><P
>For <TT
><A HREF="Data-Time-LocalTime.html#t%3ALocalTime"
>LocalTime</A
></TT
> (and <TT
><A HREF="Data-Time-LocalTime.html#t%3AZonedTime"
>ZonedTime</A
></TT
> and <TT
><A HREF="Data-Time-Clock.html#t%3AUTCTime"
>UTCTime</A
></TT
>):
</P
><DL
><DT
><TT
>%c</TT
></DT
><DD
> as <TT
><A HREF="../old-locale/System-Locale.html#v%3AdateTimeFmt"
>dateTimeFmt</A
></TT
> <TT
>locale</TT
> (e.g. <TT
>%a %b %e %H:%M:%S %Z %Y</TT
>)
</DD
></DL
><P
>For <TT
><A HREF="Data-Time-LocalTime.html#t%3ATimeOfDay"
>TimeOfDay</A
></TT
> (and <TT
><A HREF="Data-Time-LocalTime.html#t%3ALocalTime"
>LocalTime</A
></TT
> and <TT
><A HREF="Data-Time-LocalTime.html#t%3AZonedTime"
>ZonedTime</A
></TT
> and <TT
><A HREF="Data-Time-Clock.html#t%3AUTCTime"
>UTCTime</A
></TT
>):
</P
><DL
><DT
><TT
>%R</TT
></DT
><DD
> same as <TT
>%H:%M</TT
>
</DD
><DT
><TT
>%T</TT
></DT
><DD
> same as <TT
>%H:%M:%S</TT
>
</DD
><DT
><TT
>%X</TT
></DT
><DD
> as <TT
><A HREF="../old-locale/System-Locale.html#v%3AtimeFmt"
>timeFmt</A
></TT
> <TT
>locale</TT
> (e.g. <TT
>%H:%M:%S</TT
>)
</DD
><DT
><TT
>%r</TT
></DT
><DD
> as <TT
><A HREF="../old-locale/System-Locale.html#v%3Atime12Fmt"
>time12Fmt</A
></TT
> <TT
>locale</TT
> (e.g. <TT
>%I:%M:%S %p</TT
>)
</DD
><DT
><TT
>%P</TT
></DT
><DD
> day half from (<TT
><A HREF="../old-locale/System-Locale.html#v%3AamPm"
>amPm</A
></TT
> <TT
>locale</TT
>), converted to lowercase, <TT
>am</TT
>, <TT
>pm</TT
>
</DD
><DT
><TT
>%p</TT
></DT
><DD
> day half from (<TT
><A HREF="../old-locale/System-Locale.html#v%3AamPm"
>amPm</A
></TT
> <TT
>locale</TT
>), <TT
>AM</TT
>, <TT
>PM</TT
>
</DD
><DT
><TT
>%H</TT
></DT
><DD
> hour, 24-hour, leading 0 as needed, <TT
>00</TT
> - <TT
>23</TT
>
</DD
><DT
><TT
>%I</TT
></DT
><DD
> hour, 12-hour, leading 0 as needed, <TT
>01</TT
> - <TT
>12</TT
>
</DD
><DT
><TT
>%k</TT
></DT
><DD
> hour, 24-hour, leading space as needed, <TT
> 0</TT
> - <TT
>23</TT
>
</DD
><DT
><TT
>%l</TT
></DT
><DD
> hour, 12-hour, leading space as needed, <TT
> 1</TT
> - <TT
>12</TT
>
</DD
><DT
><TT
>%M</TT
></DT
><DD
> minute, <TT
>00</TT
> - <TT
>59</TT
>
</DD
><DT
><TT
>%S</TT
></DT
><DD
> second, without decimal part, <TT
>00</TT
> - <TT
>60</TT
>
</DD
><DT
><TT
>%q</TT
></DT
><DD
> picosecond, including trailing zeros, <TT
>000000000000</TT
> - <TT
>999999999999</TT
>.
</DD
><DT
><TT
>%Q</TT
></DT
><DD
> decimal point and up to 12 second decimals, without trailing zeros.
 For a whole number of seconds, <TT
>%Q</TT
> produces the empty string.
</DD
></DL
><P
>For <TT
><A HREF="Data-Time-Clock.html#t%3AUTCTime"
>UTCTime</A
></TT
> and <TT
><A HREF="Data-Time-LocalTime.html#t%3AZonedTime"
>ZonedTime</A
></TT
>:
</P
><DL
><DT
><TT
>%s</TT
></DT
><DD
> number of whole seconds since the Unix epoch. For times before
 the Unix epoch, this is a negative number. Note that in <TT
>%s.%q</TT
> and <TT
>%s%Q</TT
> 
 the decimals are positive, not negative. For example, 0.9 seconds
 before the Unix epoch is formatted as <TT
>-1.1</TT
> with <TT
>%s%Q</TT
>.
</DD
></DL
><P
>For <TT
><A HREF="Data-Time-Calendar.html#t%3ADay"
>Day</A
></TT
> (and <TT
><A HREF="Data-Time-LocalTime.html#t%3ALocalTime"
>LocalTime</A
></TT
> and <TT
><A HREF="Data-Time-LocalTime.html#t%3AZonedTime"
>ZonedTime</A
></TT
> and <TT
><A HREF="Data-Time-Clock.html#t%3AUTCTime"
>UTCTime</A
></TT
>):
</P
><DL
><DT
><TT
>%D</TT
></DT
><DD
> same as <TT
>%m/%d/%y</TT
>
</DD
><DT
><TT
>%F</TT
></DT
><DD
> same as <TT
>%Y-%m-%d</TT
>
</DD
><DT
><TT
>%x</TT
></DT
><DD
> as <TT
><A HREF="../old-locale/System-Locale.html#v%3AdateFmt"
>dateFmt</A
></TT
> <TT
>locale</TT
> (e.g. <TT
>%m/%d/%y</TT
>)
</DD
><DT
><TT
>%Y</TT
></DT
><DD
> year
</DD
><DT
><TT
>%y</TT
></DT
><DD
> last two digits of year, <TT
>00</TT
> - <TT
>99</TT
>
</DD
><DT
><TT
>%C</TT
></DT
><DD
> century (being the first two digits of the year), <TT
>00</TT
> - <TT
>99</TT
>
</DD
><DT
><TT
>%B</TT
></DT
><DD
> month name, long form (<TT
><A HREF="../base/Data-Tuple.html#v%3Afst"
>fst</A
></TT
> from <TT
><A HREF="../old-locale/System-Locale.html#v%3Amonths"
>months</A
></TT
> <TT
>locale</TT
>), <TT
>January</TT
> - <TT
>December</TT
>
</DD
><DT
><TT
>%b</TT
>, <TT
>%h</TT
></DT
><DD
> month name, short form (<TT
><A HREF="../base/Data-Tuple.html#v%3Asnd"
>snd</A
></TT
> from <TT
><A HREF="../old-locale/System-Locale.html#v%3Amonths"
>months</A
></TT
> <TT
>locale</TT
>), <TT
>Jan</TT
> - <TT
>Dec</TT
>
</DD
><DT
><TT
>%m</TT
></DT
><DD
> month of year, leading 0 as needed, <TT
>01</TT
> - <TT
>12</TT
>
</DD
><DT
><TT
>%d</TT
></DT
><DD
> day of month, leading 0 as needed, <TT
>01</TT
> - <TT
>31</TT
>
</DD
><DT
><TT
>%e</TT
></DT
><DD
> day of month, leading space as needed,  <TT
> 1</TT
> - <TT
>31</TT
>
</DD
><DT
><TT
>%j</TT
></DT
><DD
> day of year for Ordinal Date format, <TT
>001</TT
> - <TT
>366</TT
>
</DD
><DT
><TT
>%G</TT
></DT
><DD
> year for Week Date format
</DD
><DT
><TT
>%g</TT
></DT
><DD
> last two digits of year for Week Date format, <TT
>00</TT
> - <TT
>99</TT
>
</DD
><DT
><TT
>%f</TT
></DT
><DD
> century (first two digits of year) for Week Date format, <TT
>00</TT
> - <TT
>99</TT
>
</DD
><DT
><TT
>%V</TT
></DT
><DD
> week for Week Date format, <TT
>01</TT
> - <TT
>53</TT
>
</DD
><DT
><TT
>%u</TT
></DT
><DD
> day for Week Date format, <TT
>1</TT
> - <TT
>7</TT
>
</DD
><DT
><TT
>%a</TT
></DT
><DD
> day of week, short form (<TT
><A HREF="../base/Data-Tuple.html#v%3Asnd"
>snd</A
></TT
> from <TT
><A HREF="../old-locale/System-Locale.html#v%3AwDays"
>wDays</A
></TT
> <TT
>locale</TT
>), <TT
>Sun</TT
> - <TT
>Sat</TT
>
</DD
><DT
><TT
>%A</TT
></DT
><DD
> day of week, long form (<TT
><A HREF="../base/Data-Tuple.html#v%3Afst"
>fst</A
></TT
> from <TT
><A HREF="../old-locale/System-Locale.html#v%3AwDays"
>wDays</A
></TT
> <TT
>locale</TT
>), <TT
>Sunday</TT
> - <TT
>Saturday</TT
>
</DD
><DT
><TT
>%U</TT
></DT
><DD
> week number of year, where weeks start on Sunday (as <TT
><A HREF="Data-Time-Calendar-OrdinalDate.html#v%3AsundayStartWeek"
>sundayStartWeek</A
></TT
>), <TT
>00</TT
> - <TT
>53</TT
>
</DD
><DT
><TT
>%w</TT
></DT
><DD
> day of week number, <TT
>0</TT
> (= Sunday) - <TT
>6</TT
> (= Saturday)
</DD
><DT
><TT
>%W</TT
></DT
><DD
> week number of year, where weeks start on Monday (as <TT
><A HREF="Data-Time-Calendar-OrdinalDate.html#v%3AmondayStartWeek"
>mondayStartWeek</A
></TT
>), <TT
>00</TT
> - <TT
>53</TT
>
</DD
></DL
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="section1"
><A NAME="2"
><A NAME="2"
>UNIX-style parsing
</A
></A
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v:parseTime"
><A NAME="v%3AparseTime"
></A
></A
><B
>parseTime</B
></TD
></TR
><TR
><TD CLASS="body"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="arg"
>:: <A HREF="Data-Time-Format.html#t%3AParseTime"
>ParseTime</A
> t</TD
><TD CLASS="rdoc"
></TD
></TR
><TR
><TD CLASS="arg"
>=&gt; <A HREF="../old-locale/System-Locale.html#t%3ATimeLocale"
>TimeLocale</A
></TD
><TD CLASS="rdoc"
>Time locale.
</TD
></TR
><TR
><TD CLASS="arg"
>-&gt; <A HREF="../base/Data-Char.html#t%3AString"
>String</A
></TD
><TD CLASS="rdoc"
>Format string.
</TD
></TR
><TR
><TD CLASS="arg"
>-&gt; <A HREF="../base/Data-Char.html#t%3AString"
>String</A
></TD
><TD CLASS="rdoc"
>Input string.
</TD
></TR
><TR
><TD CLASS="arg"
>-&gt; <A HREF="../base/Data-Maybe.html#t%3AMaybe"
>Maybe</A
> t</TD
><TD CLASS="rdoc"
>The time value, or <TT
><A HREF="../base/Data-Maybe.html#v%3ANothing"
>Nothing</A
></TT
> if the input could
 not be parsed using the given format.
</TD
></TR
><TR
><TD CLASS="ndoc" COLSPAN="2"
><P
>Parses a time value given a format string. Supports the same %-codes as
 formatTime. Leading and trailing whitespace is accepted. Case is not
 significant. Some variations in the input are accepted:
</P
><DL
><DT
><TT
>%z</TT
></DT
><DD
> accepts any of <TT
>-HHMM</TT
> or <TT
>-HH:MM</TT
>.
</DD
><DT
><TT
>%Z</TT
></DT
><DD
> accepts any string of letters, or any
 of the formats accepted by <TT
>%z</TT
>.
</DD
></DL
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v:readTime"
><A NAME="v%3AreadTime"
></A
></A
><B
>readTime</B
></TD
></TR
><TR
><TD CLASS="body"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="arg"
>:: <A HREF="Data-Time-Format.html#t%3AParseTime"
>ParseTime</A
> t</TD
><TD CLASS="rdoc"
></TD
></TR
><TR
><TD CLASS="arg"
>=&gt; <A HREF="../old-locale/System-Locale.html#t%3ATimeLocale"
>TimeLocale</A
></TD
><TD CLASS="rdoc"
>Time locale.
</TD
></TR
><TR
><TD CLASS="arg"
>-&gt; <A HREF="../base/Data-Char.html#t%3AString"
>String</A
></TD
><TD CLASS="rdoc"
>Format string.
</TD
></TR
><TR
><TD CLASS="arg"
>-&gt; <A HREF="../base/Data-Char.html#t%3AString"
>String</A
></TD
><TD CLASS="rdoc"
>Input string.
</TD
></TR
><TR
><TD CLASS="arg"
>-&gt; t</TD
><TD CLASS="rdoc"
>The time value.
</TD
></TR
><TR
><TD CLASS="ndoc" COLSPAN="2"
>Parse a time value given a format string. Fails if the input could
 not be parsed using the given format. See <TT
><A HREF="Data-Time-Format.html#v%3AparseTime"
>parseTime</A
></TT
> for details.
</TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v:readsTime"
><A NAME="v%3AreadsTime"
></A
></A
><B
>readsTime</B
></TD
></TR
><TR
><TD CLASS="body"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="arg"
>:: <A HREF="Data-Time-Format.html#t%3AParseTime"
>ParseTime</A
> t</TD
><TD CLASS="rdoc"
></TD
></TR
><TR
><TD CLASS="arg"
>=&gt; <A HREF="../old-locale/System-Locale.html#t%3ATimeLocale"
>TimeLocale</A
></TD
><TD CLASS="rdoc"
>Time locale.
</TD
></TR
><TR
><TD CLASS="arg"
>-&gt; <A HREF="../base/Data-Char.html#t%3AString"
>String</A
></TD
><TD CLASS="rdoc"
>Format string
</TD
></TR
><TR
><TD CLASS="arg"
>-&gt; <A HREF="../base/Text-ParserCombinators-ReadP.html#t%3AReadS"
>ReadS</A
> t</TD
><TD CLASS="rdoc"
></TD
></TR
><TR
><TD CLASS="ndoc" COLSPAN="2"
>Parse a time value given a format string.  See <TT
><A HREF="Data-Time-Format.html#v%3AparseTime"
>parseTime</A
></TT
> for details.
</TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><SPAN CLASS="keyword"
>class</SPAN
>  <A NAME="t:ParseTime"
><A NAME="t%3AParseTime"
></A
></A
><B
>ParseTime</B
> t  <SPAN CLASS="keyword"
>where</SPAN
></TD
></TR
><TR
><TD CLASS="body"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="ndoc"
>The class of types which can be parsed given a UNIX-style time format
 string.
</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="section4"
>Methods</TD
></TR
><TR
><TD CLASS="body"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="decl"
><A NAME="v:buildTime"
><A NAME="v%3AbuildTime"
></A
></A
><B
>buildTime</B
></TD
></TR
><TR
><TD CLASS="body"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="arg"
>:: <A HREF="../old-locale/System-Locale.html#t%3ATimeLocale"
>TimeLocale</A
></TD
><TD CLASS="rdoc"
>The time locale.
</TD
></TR
><TR
><TD CLASS="arg"
>-&gt; [(<A HREF="../ghc-prim/GHC-Types.html#t%3AChar"
>Char</A
>, <A HREF="../base/Data-Char.html#t%3AString"
>String</A
>)]</TD
><TD CLASS="rdoc"
>Pairs of format characters and the 
 corresponding part of the input.
</TD
></TR
><TR
><TD CLASS="arg"
>-&gt; t</TD
><TD CLASS="rdoc"
></TD
></TR
><TR
><TD CLASS="ndoc" COLSPAN="2"
>Builds a time value from a parsed input string.
 If the input does not include all the information needed to
 construct a complete value, any missing parts should be taken
 from 1970-01-01 00:00:00 +0000 (which was a Thursday).
</TD
></TR
></TABLE
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="section4"
><IMG SRC="minus.gif" CLASS="coll" ONCLICK="toggle(this,'i:ParseTime')" ALT="show/hide"
> Instances</TD
></TR
><TR
><TD CLASS="body"
><DIV ID="i:ParseTime" STYLE="display:block;"
><TABLE CLASS="vanilla" CELLSPACING="1" CELLPADDING="0"
><TR
><TD CLASS="decl"
><A HREF="Data-Time-Format.html#t%3AParseTime"
>ParseTime</A
> <A HREF="Data-Time-Calendar.html#t%3ADay"
>Day</A
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="Data-Time-Format.html#t%3AParseTime"
>ParseTime</A
> <A HREF="Data-Time-Clock.html#t%3AUTCTime"
>UTCTime</A
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="Data-Time-Format.html#t%3AParseTime"
>ParseTime</A
> <A HREF="Data-Time-LocalTime.html#t%3ATimeZone"
>TimeZone</A
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="Data-Time-Format.html#t%3AParseTime"
>ParseTime</A
> <A HREF="Data-Time-LocalTime.html#t%3ATimeOfDay"
>TimeOfDay</A
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="Data-Time-Format.html#t%3AParseTime"
>ParseTime</A
> <A HREF="Data-Time-LocalTime.html#t%3AZonedTime"
>ZonedTime</A
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="Data-Time-Format.html#t%3AParseTime"
>ParseTime</A
> <A HREF="Data-Time-LocalTime.html#t%3ALocalTime"
>LocalTime</A
></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="botbar"
>Produced by <A HREF="http://www.haskell.org/haddock/"
>Haddock</A
> version 2.4.2</TD
></TR
></TABLE
></BODY
></HTML
>