The local timestamp type class.

Days since Unix epoch.

Seconds since Unix epoch (including leap seconds).

Milliseconds since Unix epoch (including leap seconds).

Microseconds since Unix epoch (including leap seconds).

Nanoseconds since Unix epoch (including leap seconds).

Picoseconds since Unix epoch (including leap seconds).

Create a local date.

 >>> createLocalDate 2013 November 03 Pacific_Standard_Time
 2013-11-03 PST

Create a local date and time.

 >>> createLocalDateTime 2013 November 03 22 55 52 South_Africa_Standard_Time
 2013-11-03 22:55:52 SAST

Create a local date and time with millisecond granularity.

 >>> createLocalDateTimeMillis 2013 November 03 13 57 43 830 Mountain_Standard_Time
 2013-11-03 13:57:43.830 MST

Create a local date and time with microsecond granularity.

 >>> createLocalDateTimeMicros 2013 November 03 21 01 42 903539 Coordinated_Universal_Time 
 2013-11-03 21:01:42.903539 UTC

Create a local date and time with nanosecond granularity.

 >>> createLocalDateTimeNanos 2013 November 04 06 05 07 016715087 Japan_Standard_Time
 2013-11-04 06:05:07.016715087 JST

Create a local date and time with picosecond granularity.

 >>> createLocalDateTimePicos 2013 November 03 23 13 56 838238648311 Eastern_European_Time
 2013-11-03 23:13:56.838238648311 EET

Get the current local date from the system clock.

 >>> getCurrentLocalDate London 
 2013-11-03 GMT

Get the current local date and time from the system clock.

 >>> getCurrentLocalDateTime New_York 
 2013-11-03 16:38:16 EST

Get the current local date and time with millisecond granularity from the system clock.

 >>> getCurrentLocalDateTimeMillis Auckland
 2013-11-04 10:46:13.123 NZDT

Get the current local date and time with microsecond granularity from the system clock.

 >>> getCurrentLocalDateTimeMicros Tel_Aviv 
 2013-11-03 23:55:30.935387 IST

Get the current local date and time with nanosecond granularity from the system clock.

 >>> getCurrentLocalDateTimeNanos Brussels 
 2013-11-03 23:01:07.337488000 CET

Note that this functions calls gettimeofday behind the scenes. Therefore, the resultant timestamp will have nanosecond granularity, but only microsecond resolution.

Get the current local date and time with picosecond granularity from the system clock.

 >>> getCurrentLocalDateTimePicos Karachi
 2013-11-04 22:05:17.556043000000 PKT

Note that this functions calls gettimeofday() behind the scenes. Therefore, the resultant timestamp will have picosecond granularity, but only microsecond resolution.

Time zone transition time.

Get a list of time zone transition times for the given city.

Get the current local date from the system clock using preloaded transition times.

 >>> ttimes <- getTransitions Tokyo 
 >>> getCurrentLocalDate' ttimes
 2013-11-04 JST

Use this function if you need to get the current local date more than once. The use of preloaded transition times will avoid unnecessary parsing of Olson files.

Get the current local date and time from the system clock using preloaded transition times.

 >>> ttimes <- getTransitions Moscow
 >>> getCurrentLocalDateTime' ttimes
 2013-11-04 01:41:50 MSK

Use this function if you need to get the current local date and time more than once. The use of preloaded transition times will avoid unnecessary parsing of Olson files.

Get the current local date and time with millisecond granularity from the system clock using preloaded transition times.

 >>> ttimes <- getTransitions Tehran
 >>> getCurrentLocalDateTimeMillis' ttimes
 2013-11-04 01:20:49.435 IRST

Use this function if you need to get the current local date and time with millisecond granularity more than once. The use of preloaded transition times will avoid unnecessary parsing of Olson files.

Get the current local date and time with microsecond granularity from the system clock using preloaded transition times.

 >>> ttimes <- getTransitions Sao_Paulo
 >>> getCurrentLocalDateTimeMicros' ttimes
 2013-11-03 19:58:50.405806 BRST

Use this function if you need to get the current local date and time with microsecond granularity more than once. The use of preloaded transition times will avoid unnecessary parsing of Olson files.

Get the current local date and time with nanosecond granularity from the system clock using preloaded transition times.

 >>> ttimes <- getTransitions Mogadishu
 >>> getCurrentLocalDateTimeNanos' ttimes
 2013-11-04 01:15:08.664426000 EAT

Use this function if you need to get the current local date and time with nanosecond granularity more than once. The use of preloaded transition times will avoid unnecessary parsing of Olson files.

Note that this functions calls gettimeofday behind the scenes. Therefore, the resultant timestamp will have nanosecond granularity, but only microsecond resolution.

Get the current local date and time with picosecond granularity from the system clock using preloaded transition times.

 >>> ttimes <- getTransitions Baghdad
 >>> getCurrentLocalDateTimePicos' ttimes
 2013-11-04 01:20:57.502906000000 AST

Use this function if you need to get the current local date and time with picosecond granularity more than once. The use of preloaded transition times will avoid unnecessary parsing of Olson files.

Note that this functions calls gettimeofday() behind the scenes. Therefore, the resultant timestamp will have picosecond granularity, but only microsecond resolution.

Show a local date as a pretty string.

 >>> prettyLocalDate $ createLocalDate 2014 September 25 Japan_Standard_Time 
 "Thursday, September 25th, 2014 (JST)"

Show a local date and time as a pretty string.

 >>> getCurrentLocalDateTime Los_Angeles >>= return . prettyLocalDateTime 
 "2:17 AM, Wednesday, January 1st, 2014 (PST)"