Skip to content

Latest commit

 

History

History
102 lines (70 loc) · 2.86 KB

README.md

File metadata and controls

102 lines (70 loc) · 2.86 KB

yaclot

Yaclot is a light Clojure conversion library. Use it to convert, parse and format values or records of different types.

Usage

Simple conversions:

(convert "2011-02-12" (to-type java.util.Date))
; => #<Date Sat Feb 12 00:00:00 CET 2011>

(convert (java.util.Date. 111 1 12) (to-type String))
; => "2011-02-12"

(convert 42 (to-type String))
; => "42"

(convert "42e-2" (to-type Number))
; => 0.42M

Conversions with specified format:

(convert "2/12/11" (using-format "M/dd/yy" (to-type java.util.Date)))
; => #<Date Sat Feb 12 00:00:00 CET 2011>

; This one attempts parsing with each of the formats and returns first result
; which didn't throw ParseException
(convert "2/12/11" (using-format ["yyyy-MM-dd" "M/dd/yy"] (to-type java.util.Date)))
; => #<Date Sat Feb 12 00:00:00 CET 2011>

(convert 5000.42 (to-type String (using-format "%,.2f")))
; => "5,000.42"

Date formatting aliases

(convert "2013-03-01T10:00:00Z" (using-format :iso-date-time (to-type :date)))
; => #inst "2013-03-01T10:00:00.000-00:00"

(convert "2013-03-01" (using-format :iso-date (to-type :date)))
; => #inst "2013-02-28T23:00:00.000-00:00"

(convert "10:00" (using-format :iso-time-hh-mm (to-type :date)))
; => #inst "1970-01-01T09:00:00.000-00:00"

(convert "10:20:30" (using-format :iso-time-hh-mm-ss (to-type :date)))
; => #inst "1970-01-01T09:20:30.000-00:00"

Aliases:

(convert "2011-02-12" (to-type :date))
; => #<Date Sat Feb 12 00:00:00 CET 2011>

(convert (java.util.Date. 111 1 12) (to-type :string))
; => "2011-02-12"

(convert 42 (to-type :string))
; => "42"

Supported aliases:

:string        - String
:date          - java.util.Date
:boolean       - Boolean
:integer       - Integer
:decimal       - BigDecimal
:double        - Double
:number        - Number
:long          - Long
:sql-date      - java.sql.Date
:sql-time      - java.sql.Time
:sql-timestamp - java.sql.Timestamp

Bulk-convert maps:

(map-convert 
  {:dt "2011-02-12" :int 42} 
  {:dt (to-type java.util.Date) 
   :int (to-type String)})
; => {:dt #<Date Sat Feb 12 00:00:00 CET 2011>, :int "42"}

Supported Conversions

String <-> Date
String <-> Integer
String <-> Double
String <-> BigDecimal
String <-> Number (using BigDecimal)
String  -> Boolean
Date   <-> Long
nil     -> (anything) gives nil

Planned features

Error handling with local bindings rather than throwing exceptions.

Pre-Validation: Assertions on value before conversion (e.g. checking that it's not null or matches a regular expression).

Post-Validation: Assertions after conversion (e.g. checking that parsed number is positive).

License

Distributed under the Eclipse Public License, the same as Clojure.