Module: Time::Zone

Defined in:
lib/time/zone.rb,
lib/time/zone/locking.rb,
lib/time/zone/version.rb,
lib/time/zone/timestamp.rb

Defined Under Namespace

Classes: Timestamp

Constant Summary collapse

LOCK = 
Mutex.new
UTC = 
"UTC".freeze
VERSION = 
"1.2.0"

Class Method Summary collapse

Class Method Details

.convert(time, zone) ⇒ Object 



45
46
47
48
49
 
# File 'lib/time/zone.rb', line 45

def self.convert(time, zone)
	with(zone) do
		return Time.new(time.year, time.month, time.day, time.hour, time.minute, time.second, time.utc_offset).localtime
	end
end

.new(year, month, day, hour, minute, second, zone) ⇒ Object 



32
33
34
35
36
 
# File 'lib/time/zone.rb', line 32

def self.new(year, month, day, hour, minute, second, zone)
	with(zone) do
		return Time.new(year, month, day, hour, minute, second).localtime
	end
end

.now(zone) ⇒ Object 



38
39
40
41
42
43
 
# File 'lib/time/zone.rb', line 38

def self.now(zone)
	with(zone) do
		# Time instances are lazy initialized, so we need to force it to pick up the current TZ by invoking #localtime
		return Time.new.localtime
	end
end

.parse(string, zone = "UTC", *args) ⇒ Object 



51
52
53
54
55
56
57
58
59
60
61
 
# File 'lib/time/zone.rb', line 51

def self.parse(string, zone = "UTC", *args)
	string = string.dup
	
	if string.sub!(/\s([a-zA-Z][\w]*(\/[\w]+)?)$/, "")
		zone = $1
	end
	
	with(zone) do
		return Time.parse(string, *args).localtime, zone
	end
end

.utc? ⇒ Boolean

Returns:

  • (Boolean) 


41
42
43
 
# File 'lib/time/zone/locking.rb', line 41

def self.utc?
	zone == UTC
end

.with(zone) ⇒ Object 



45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
 
# File 'lib/time/zone/locking.rb', line 45

def self.with(zone)
	LOCK.synchronize do
		original_zone = ENV['TZ']
		
		begin
			ENV['TZ'] = zone
			
			yield
		ensure
			if original_zone
				ENV['TZ'] = original_zone
			else
				ENV.delete('TZ')
			end
		end
	end
end

.zone ⇒ Object 



33
34
35
36
37
 
# File 'lib/time/zone/locking.rb', line 33

def self.zone
	LOCK.synchronize do
		ENV['TZ']
	end
end

.zone=(zone) ⇒ Object 



27
28
29
30
31
 
# File 'lib/time/zone/locking.rb', line 27

def self.zone=(zone)
	LOCK.synchronize do
		ENV['TZ'] = zone
	end
end