client_date.gemspec @@ -1 +1,2 @@ -TIMELOG \ No newline at end of file +TIMELOG +*.gem \ No newline at end of file .gitignore @@ -1,4 +1,9 @@ +== 0.1.0 + +May 26 += added GitHub gemspec + May 1 2008 - move to GitHub CHANGELOG @@ -6,25 +6,19 @@ Was hosted at Google Code http://code.google.com/p/client-date/ -= client_date plugin for Ruby on Rails += client_date The client_date Ruby on Rails plugin uses client-side Javascript to format a date/time in a view instead of the server. The client is given UTC time for formatting so the server doesn't have to store which time zone each user is in. -== Installation - - It looks like Rails 2.1 will support "script/plugin install" with Git - repositories. Until then you can put this plugin in vendor/plugins with: - - git clone git://github.com/ryanlowe/client_date.git +Of course it's also very handy for users that haven't logged in +or do not have a login. - and delete the .git directory inside it before committing it to source control. - - When Rails 2.1 supports Git you should be able to do: +== Installation - script/plugin install git://github.com/ryanlowe/client_date.git + gem install ryanlowe-client_date --source http://gems.github.com/ == Setup @@ -45,24 +39,22 @@ store which time zone each user is in. == Usage - In a view you can use these two: - - # month, day - format_date(date) + In a view you can use: - # month, day, hour, minute - format_datetime(date) + format_date(date) # month, day + format_datetime(date) # month, day, hour, minute + format_datetime(date,true) # month, day, hour, minute, seconds The date parameter should be a normal Ruby date, like the "datetime" used in Rails migrations. Example: - Created at: <%= format_datetime(post.created_at) %><br/> + <p>Created at: <%= format_datetime(post.created_at) %></p> == Customization - Change how client_date formats dates and datetimes by changing the + Change how client_date formats dates and times by changing the fd() and fdt() Javascript functions. \ No newline at end of file README @@ -1,2 +1,3 @@ -- optionally show seconds in the time \ No newline at end of file +- assumes the server stores in UTC? + -- convert anyway with .utc() ? \ No newline at end of file TODO ea782f9a1ea2563481fb5e26d8e4cab690538b73 Ryan Lowe ryanlowe@gmail.com http://github.com/ryanlowe/client_date/commit/44e44b00c58ea174a74a2fdbc07cc82c4fcba9e6 44e44b00c58ea174a74a2fdbc07cc82c4fcba9e6 2008-05-26T10:45:39-07:00 2008-05-26T10:45:39-07:00 added GitHub gemspec fdc13f1b1deb8747d29815c2dc48d5cb241f9a90 Ryan Lowe ryanlowe@gmail.com