time_methods 1.0.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    ZGI0ODJmNjMzYjVhNzVlY2FlZGU4ZjU5MDZiNjU4MDk3NTExYzU0NQ==
+  data.tar.gz: !binary |-
+    ZjJmM2Q5YTY2ZmIzZTNiYmRiMGU3MGM4OTJjMjU5ZTM4ZDdlYjRkNw==
+SHA512:
+  metadata.gz: !binary |-
+    MzRiMWM3Y2ZiNzk1YjA4ZTA2NzNhYmQ4ZWNjNDUwY2EzZGMzYzdkMTZkMWQ1
+    YmQzZTZiOTY4ODhmNmJhNjE2MTY4MmQ2ZDE4NTU2NTU5MjZiNGI5OWY2MmEz
+    NTk5ZmRkZmQ4NmZmNjk4NmNiMTViY2FhMjY3ZDMyZWU0Mjg3MTk=
+  data.tar.gz: !binary |-
+    NmVlZGFkYTdkMDA3NzE1NGI5ZWU5M2ViYmU0NTEwMGY3ZTg4NzUwYzEyZWYw
+    MGI0OGM5MzVmYWQ5ZDBkNGU0Y2E3ZmQxNTRiMDA0M2ZlMjc4MWNiOTc5OGI5
+    NjcwYjAzZDc0YjkzMjg1ZWY4M2ViYWVjYjUwZWJhZjAwZmI2ODg=

data/lib/time_methods.rb

@@ -0,0 +1,103 @@
+# coding: utf-8
+# @author Jonathan Raiman
+
+# perform relative time conversions really easily.
+module TimeMethods
+
+	# Pluralizes a string by adding "s" to the element name when there are 0 or 2+ elements.
+	# @param number [FixNum] number of elements to pluralize
+	# @param text [String] the element being pluralized
+	# @return [String] the pluralized string.
+	def self.pluralize(number, text)
+		return "#{text}s" if number != 1
+		text
+	end
+
+	# convert time to non-relative human-readable format
+	# @param t [Time] the time to convert
+	# @return [String] the time in human-readable format (Not words per-se).
+	def self.factual_time(t)
+		msg = ""
+		if t.day == Time.now.day
+			msg += "Today"
+		elsif Time.now-3600*48 < t
+			msg += "Yesterday"
+		else
+			msg += t.strftime('%-d %B %Y')
+		end
+		msg += t.strftime(' %H:%M:%S')
+		# msg += " "
+		# msg += t.hour.to_s+":"+t.min.to_s+":"+t.sec.to_s
+		msg
+	end
+
+	# Converts time from an integer or float amount of seconds to words.
+	# @param diff_seconds [Fixnum, Float] time to convert to words
+	# @return [String] time in words elapsed
+	def self.relative_time(diff_seconds)
+		delta_t = (diff_seconds.class == Float) ? diff_seconds.to_i : diff_seconds
+		case delta_t
+			when 0 .. 5
+				if diff_seconds.class == Float
+					"#{sprintf('%.2f',diff_seconds)} "+pluralize(delta_t, 'second')
+				else
+					"#{delta_t} "+pluralize(delta_t, 'second')
+				end
+			when 6 .. 59
+				"#{delta_t} "+pluralize(delta_t, 'second')
+			when 60 .. (3600-1)
+				"#{delta_t/60} "+pluralize((delta_t/60), 'minute')
+			when 3600 .. (3600*24-1)
+				"#{delta_t/3600} "+pluralize((delta_t/3600), 'hour')
+			when (3600*24) .. (3600*24*7-1) 
+				"#{delta_t/(3600*24)} "+pluralize((delta_t/(3600*24)), 'day')
+			when (3600*24*7) .. (3600*24*30-1)
+				"#{delta_t/(3600*24*7)} "+pluralize((delta_t/(3600*24*7)), 'week')
+			when (3600*24*30) .. (3600*24*365.25)
+				"#{delta_t/(3600*24*30)} "+pluralize((delta_t/(3600*24*30)), 'month')
+			when (3600*24*365.25) .. (3600*24*3652.5)
+				"#{delta_t/(3600*24*30)} "+pluralize((delta_t/(3600*24*365.25)), 'year')
+			else
+				"#{delta_t}s"
+		end
+	end
+
+	# Converts time into words with a Facebook like lingo ("just now", "an hour ago", etc...).
+	# @param start_time [Time] time to convert to words
+	# @return [String] time in words elapsed
+	def self.time_ago(start_time)
+		diff_seconds = Time.now.to_i - start_time.to_i
+		case diff_seconds
+			when 0 .. 59
+				"just now"
+			when 60 .. (3000-1)
+				"#{diff_seconds/60} "+pluralize((diff_seconds/60), 'minute')+" ago"
+			when 3000 .. (3500-1)
+				"almost an hour ago"
+			when 3500 .. (3700-1)
+				"an hour ago"
+			when 3700 .. (3900-1)
+				"over an hour ago"
+			when 3900 .. (3600*24-1)
+				"#{diff_seconds/3600} "+pluralize((diff_seconds/3600), 'hour')+" ago"
+			when (3600*24) .. (3600*24*7-1) 
+				"#{diff_seconds/(3600*24)} "+pluralize((diff_seconds/(3600*24)), 'day')+" ago"
+			when (3600*24*7) .. (3600*24*30-1)
+				"#{diff_seconds/(3600*24*7)} "+pluralize((diff_seconds/(3600*24*7)), 'week')+" ago"
+			when (3600*24*30) .. (3600*24*365.25)
+				"#{diff_seconds/(3600*24*30)} "+pluralize((diff_seconds/(3600*24*30)), 'month')+" ago"
+			else
+				start_time.strftime('%-d %B %Y')
+		end
+	end
+
+end
+
+class Time
+	def ago
+		TimeMethods.time_ago(self)
+	end
+	def factual
+		TimeMethods.factual_time(self)
+	end
+end

metadata

@@ -0,0 +1,45 @@
+--- !ruby/object:Gem::Specification
+name: time_methods
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Jonathan Raiman
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-11-18 00:00:00.000000000 Z
+dependencies: []
+description: Converts time and time intervals to human readable forms.
+email: jraiman@mit.edu
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/time_methods.rb
+homepage: http://github.org/JonathanRaiman/time_methods
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.1.10
+signing_key: 
+specification_version: 4
+summary: Converts time and time intervals to human readable forms.
+test_files: []
+has_rdoc: yard