Data.Time.Exts.Local

Local timestamps of varying granularity.

Local Class

class Local u where

The local timestamp type class.

Methods

localBase :: u -> Int64

Get the base component of a local timestamp.

localZone :: u -> Word8

Get the zone component of a local timestamp.

Instances

Local Transition

Local LocalDateTimePicos

Local LocalDateTimeNanos

Local LocalDateTimeMicros

Local LocalDateTimeMillis

Local LocalDateTime

Local LocalDate

Local Timestamps

data LocalDate

Days since Unix epoch.

Constructors

LocalDate

Fields

_ld_day_base :: !Int32

_ld_day_zone :: !Word8

Instances

Bounded LocalDate

Enum LocalDate

Eq LocalDate

Ord LocalDate

Show LocalDate

Typeable LocalDate

Generic LocalDate

ToJSON LocalDate

FromJSON LocalDate

Storable LocalDate

NFData LocalDate

Random LocalDate

DateZone LocalDate

Zone LocalDate

Local LocalDate

Convertible Day LocalDate

Convertible LocalDateTimePicos LocalDate

Convertible LocalDateTimeNanos LocalDate

Convertible LocalDateTimeMicros LocalDate

Convertible LocalDateTimeMillis LocalDate

Convertible LocalDateTime LocalDate

Convertible LocalDate Day

DateTimeMath LocalDate Day

Duration LocalDate Day

data LocalDateTime

Seconds since Unix epoch (including leap seconds).

Constructors

LocalDateTime

Fields

_ldt_sec_base :: !Int64

_ldt_sec_zone :: !Word8

Instances

Bounded LocalDateTime

Enum LocalDateTime

Eq LocalDateTime

Ord LocalDateTime

Show LocalDateTime

Typeable LocalDateTime

Generic LocalDateTime

ToJSON LocalDateTime

FromJSON LocalDateTime

Storable LocalDateTime

NFData LocalDateTime

Random LocalDateTime

DateTimeZone LocalDateTime

DateZone LocalDateTime

Zone LocalDateTime

Local LocalDateTime

Convertible UTCTime LocalDateTime

Convertible LocalDateTime UTCTime

Convertible LocalDateTime LocalDate

DateTimeMath LocalDateTime Second

Duration LocalDateTime Second

data LocalDateTimeMillis

Milliseconds since Unix epoch (including leap seconds).

Constructors

LocalDateTimeMillis

Fields

_ldt_mil_base :: !Int64

_ldt_mil_zone :: !Word8

Instances

Bounded LocalDateTimeMillis

Enum LocalDateTimeMillis

Eq LocalDateTimeMillis

Ord LocalDateTimeMillis

Show LocalDateTimeMillis

Typeable LocalDateTimeMillis

Generic LocalDateTimeMillis

ToJSON LocalDateTimeMillis

FromJSON LocalDateTimeMillis

Storable LocalDateTimeMillis

NFData LocalDateTimeMillis

Random LocalDateTimeMillis

DateTimeZone LocalDateTimeMillis

DateZone LocalDateTimeMillis

Zone LocalDateTimeMillis

Local LocalDateTimeMillis

Convertible UTCTime LocalDateTimeMillis

Convertible LocalDateTimeMillis UTCTime

Convertible LocalDateTimeMillis LocalDate

DateTimeMath LocalDateTimeMillis Millis

DateTimeMath LocalDateTimeMillis Second

Duration LocalDateTimeMillis Millis

Duration LocalDateTimeMillis Second

data LocalDateTimeMicros

Microseconds since Unix epoch (including leap seconds).

Constructors

LocalDateTimeMicros

Fields

_ldt_mic_base :: !Int64

_ldt_mic_zone :: !Word8

Instances

Bounded LocalDateTimeMicros

Eq LocalDateTimeMicros

Ord LocalDateTimeMicros

Show LocalDateTimeMicros

Typeable LocalDateTimeMicros

Generic LocalDateTimeMicros

ToJSON LocalDateTimeMicros

FromJSON LocalDateTimeMicros

Storable LocalDateTimeMicros

NFData LocalDateTimeMicros

Random LocalDateTimeMicros

DateTimeZone LocalDateTimeMicros

DateZone LocalDateTimeMicros

Zone LocalDateTimeMicros

Local LocalDateTimeMicros

Convertible UTCTime LocalDateTimeMicros

Convertible LocalDateTimeMicros UTCTime

Convertible LocalDateTimeMicros LocalDate

DateTimeMath LocalDateTimeMicros Micros

DateTimeMath LocalDateTimeMicros Millis

DateTimeMath LocalDateTimeMicros Second

Duration LocalDateTimeMicros Micros

Duration LocalDateTimeMicros Millis

Duration LocalDateTimeMicros Second

data LocalDateTimeNanos

Nanoseconds since Unix epoch (including leap seconds).

Constructors

LocalDateTimeNanos

Fields

_ldt_nan_base :: !Int64

_ldt_nan_nano :: !Int16

_ldt_nan_zone :: !Word8

Instances

Bounded LocalDateTimeNanos

Eq LocalDateTimeNanos

Ord LocalDateTimeNanos

Show LocalDateTimeNanos

Typeable LocalDateTimeNanos

Generic LocalDateTimeNanos

ToJSON LocalDateTimeNanos

FromJSON LocalDateTimeNanos

Storable LocalDateTimeNanos

NFData LocalDateTimeNanos

Random LocalDateTimeNanos

DateTimeZone LocalDateTimeNanos

DateZone LocalDateTimeNanos

Zone LocalDateTimeNanos

Local LocalDateTimeNanos

Convertible UTCTime LocalDateTimeNanos

Convertible LocalDateTimeNanos UTCTime

Convertible LocalDateTimeNanos LocalDate

DateTimeMath LocalDateTimeNanos Nanos

DateTimeMath LocalDateTimeNanos Micros

DateTimeMath LocalDateTimeNanos Millis

DateTimeMath LocalDateTimeNanos Second

Duration LocalDateTimeNanos Nanos

Duration LocalDateTimeNanos Micros

Duration LocalDateTimeNanos Millis

Duration LocalDateTimeNanos Second

data LocalDateTimePicos

Picoseconds since Unix epoch (including leap seconds).

Constructors

LocalDateTimePicos

Fields

_ldt_pic_base :: !Int64

_ldt_pic_pico :: !Int32

_ldt_pic_zone :: !Word8

Instances

Bounded LocalDateTimePicos

Eq LocalDateTimePicos

Ord LocalDateTimePicos

Show LocalDateTimePicos

Typeable LocalDateTimePicos

Generic LocalDateTimePicos

ToJSON LocalDateTimePicos

FromJSON LocalDateTimePicos

Storable LocalDateTimePicos

NFData LocalDateTimePicos

Random LocalDateTimePicos

DateTimeZone LocalDateTimePicos

DateZone LocalDateTimePicos

Zone LocalDateTimePicos

Local LocalDateTimePicos

Convertible UTCTime LocalDateTimePicos

Convertible LocalDateTimePicos UTCTime

Convertible LocalDateTimePicos LocalDate

DateTimeMath LocalDateTimePicos Picos

DateTimeMath LocalDateTimePicos Nanos

DateTimeMath LocalDateTimePicos Micros

DateTimeMath LocalDateTimePicos Millis

DateTimeMath LocalDateTimePicos Second

Duration LocalDateTimePicos Picos

Duration LocalDateTimePicos Nanos

Duration LocalDateTimePicos Micros

Duration LocalDateTimePicos Millis

Duration LocalDateTimePicos Second

Create Local Timestamps

createLocalDate :: Year -> Month -> Day -> TimeZone -> LocalDate

Create a local date.

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

createLocalDateTime :: Year -> Month -> Day -> Hour -> Minute -> Second -> TimeZone -> LocalDateTime

Create a local date and time.

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

createLocalDateTimeMillis :: Year -> Month -> Day -> Hour -> Minute -> Second -> Millis -> TimeZone -> LocalDateTimeMillis

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

createLocalDateTimeMicros :: Year -> Month -> Day -> Hour -> Minute -> Second -> Micros -> TimeZone -> LocalDateTimeMicros

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

createLocalDateTimeNanos :: Year -> Month -> Day -> Hour -> Minute -> Second -> Nanos -> TimeZone -> LocalDateTimeNanos

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

createLocalDateTimePicos :: Year -> Month -> Day -> Hour -> Minute -> Second -> Picos -> TimeZone -> LocalDateTimePicos

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 Current Local Timestamps

getCurrentLocalDate :: City -> IO LocalDate

Get the current local date from the system clock.

 >>> getCurrentLocalDate London 
 2013-11-03 GMT

getCurrentLocalDateTime :: City -> IO LocalDateTime

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

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

getCurrentLocalDateTimeMillis :: City -> IO LocalDateTimeMillis

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

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

getCurrentLocalDateTimeMicros :: City -> IO LocalDateTimeMicros

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

getCurrentLocalDateTimeNanos :: City -> IO LocalDateTimeNanos

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.

getCurrentLocalDateTimePicos :: City -> IO LocalDateTimePicos

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 Times

newtype Transition

Time zone transition time.

Constructors

Transition

Fields

unboxTrans :: LocalDateTime

Instances

Eq Transition

Show Transition

Typeable Transition

Generic Transition

Local Transition

getTransitions :: City -> IO [Transition]

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

lastTransition :: (DateTime dt, Unix dt) => City -> dt -> IO (Maybe Transition)

Get the last time zone transition time for the given city and time.

Get Current Local Timestamps Using Preloaded Time Zone Transitions Times

getCurrentLocalDate' :: [Transition] -> IO LocalDate

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.

getCurrentLocalDateTime' :: [Transition] -> IO LocalDateTime

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.

getCurrentLocalDateTimeMillis' :: [Transition] -> IO LocalDateTimeMillis

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.

getCurrentLocalDateTimeMicros' :: [Transition] -> IO LocalDateTimeMicros

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.

getCurrentLocalDateTimeNanos' :: [Transition] -> IO LocalDateTimeNanos

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.

getCurrentLocalDateTimePicos' :: [Transition] -> IO LocalDateTimePicos

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.

Pretty Local Timestamps

prettyLocalDate :: LocalDate -> String

Show a local date as a pretty string.

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

prettyLocalDateTime :: DateTimeZone dtz => dtz -> String

Show a local date and time as a pretty string.

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

Base Conversions

baseUnixToUTC :: Int64 -> Int64

Convert Unix seconds into a UTC seconds.

baseUTCToUnix :: Int64 -> (Int64, Double)

Convert UTC seconds into Unix and leap seconds.