Ruby - Data e Hora

o Timeclasse representa datas e horas em Ruby. É uma camada fina sobre a funcionalidade de data e hora do sistema fornecida pelo sistema operacional. Esta classe pode não ser capaz em seu sistema de representar datas antes de 1970 ou depois de 2038.

Este capítulo o familiariza com todos os conceitos mais desejados de data e hora.

Obtendo data e hora atuais

A seguir está o exemplo simples para obter a data e hora atuais -

#!/usr/bin/ruby -w

time1 = Time.new
puts "Current Time : " + time1.inspect

# Time.now is a synonym:
time2 = Time.now
puts "Current Time : " + time2.inspect

Isso produzirá o seguinte resultado -

Current Time : Mon Jun 02 12:02:39 -0700 2008
Current Time : Mon Jun 02 12:02:39 -0700 2008

Obtendo componentes de uma data e hora

Podemos usar o objeto Time para obter vários componentes de data e hora. A seguir está o exemplo que mostra o mesmo -

#!/usr/bin/ruby -w

time = Time.new

# Components of a Time
puts "Current Time : " + time.inspect
puts time.year    # => Year of the date 
puts time.month   # => Month of the date (1 to 12)
puts time.day     # => Day of the date (1 to 31 )
puts time.wday    # => 0: Day of week: 0 is Sunday
puts time.yday    # => 365: Day of year
puts time.hour    # => 23: 24-hour clock
puts time.min     # => 59
puts time.sec     # => 59
puts time.usec    # => 999999: microseconds
puts time.zone    # => "UTC": timezone name

Isso produzirá o seguinte resultado -

Current Time : Mon Jun 02 12:03:08 -0700 2008
2008
6
2
1
154
12
3
8
247476
UTC

Funções Time.utc, Time.gm e Time.local

Essas duas funções podem ser usadas para formatar a data em um formato padrão da seguinte forma -

# July 8, 2008
Time.local(2008, 7, 8)  
# July 8, 2008, 09:10am, local time
Time.local(2008, 7, 8, 9, 10)   
# July 8, 2008, 09:10 UTC
Time.utc(2008, 7, 8, 9, 10)  
# July 8, 2008, 09:10:11 GMT (same as UTC)
Time.gm(2008, 7, 8, 9, 10, 11)

A seguir está o exemplo para obter todos os componentes em uma matriz no seguinte formato -

[sec,min,hour,day,month,year,wday,yday,isdst,zone]

Experimente o seguinte -

#!/usr/bin/ruby -w

time = Time.new
values = time.to_a
p values

Isso irá gerar o seguinte resultado -

[26, 10, 12, 2, 6, 2008, 1, 154, false, "MST"]

Essa matriz pode ser passada para as funções Time.utc ou Time.local para obter formatos diferentes de datas da seguinte forma -

#!/usr/bin/ruby -w

time = Time.new
values = time.to_a
puts Time.utc(*values)

Isso irá gerar o seguinte resultado -

Mon Jun 02 12:15:36 UTC 2008

A seguir está a maneira de obter o tempo representado internamente como segundos desde a época (dependente da plataforma) -

# Returns number of seconds since epoch
time = Time.now.to_i  

# Convert number of seconds into Time object.
Time.at(time)

# Returns second since epoch which includes microseconds
time = Time.now.to_f

Fusos horários e horário de verão

Você pode usar um objeto Time para obter todas as informações relacionadas aos fusos horários e horário de verão da seguinte forma -

time = Time.new

# Here is the interpretation
time.zone       # => "UTC": return the timezone
time.utc_offset # => 0: UTC is 0 seconds offset from UTC
time.zone       # => "PST" (or whatever your timezone is)
time.isdst      # => false: If UTC does not have DST.
time.utc?       # => true: if t is in UTC time zone
time.localtime  # Convert to local timezone.
time.gmtime     # Convert back to UTC.
time.getlocal   # Return a new Time object in local zone
time.getutc     # Return a new Time object in UTC

Formatação de horas e datas

Existem várias maneiras de formatar a data e a hora. Aqui está um exemplo mostrando alguns -

#!/usr/bin/ruby -w

time = Time.new
puts time.to_s
puts time.ctime
puts time.localtime
puts time.strftime("%Y-%m-%d %H:%M:%S")

Isso produzirá o seguinte resultado -

Mon Jun 02 12:35:19 -0700 2008
Mon Jun  2 12:35:19 2008
Mon Jun 02 12:35:19 -0700 2008
2008-06-02 12:35:19

Diretivas de formatação de hora

Essas diretivas na tabela a seguir são usadas com o método Time.strftime .

Sr. Não.	Diretriz e descrição
1	%a O nome abreviado do dia da semana (Dom).
2	%A O nome completo do dia da semana (domingo).
3	%b O nome abreviado do mês (janeiro).
4	%B O nome completo do mês (janeiro).
5	%c A representação local preferida de data e hora.
6	%d Dia do mês (01 a 31).
7	%H Hora do dia, relógio de 24 horas (00 a 23).
8	%I Hora do dia, relógio de 12 horas (01 a 12).
9	%j Dia do ano (001 a 366).
10	%m Mês do ano (01 a 12).
11	%M Minuto da hora (00 a 59).
12	%p Indicador de meridiano (AM ou PM).
13	%S Segundo do minuto (00 a 60).
14	%U Número da semana do ano atual, começando com o primeiro domingo como primeiro dia da primeira semana (00 a 53).
15	%W Número da semana do ano atual, começando com a primeira segunda-feira como o primeiro dia da primeira semana (00 a 53).
16	%w Dia da semana (domingo é 0, 0 a 6).
17	%x Representação preferida apenas para data, sem hora.
18	%X Representação preferida para o tempo sozinho, sem data.
19	%y Ano sem século (00 a 99).
20	%Y Ano com século.
21	%Z Nome do fuso horário.
22	%% Caractere% literal.

Tempo Aritmético

Você pode realizar aritmética simples com o tempo da seguinte maneira -

now = Time.now          # Current time
puts now

past = now - 10         # 10 seconds ago. Time - number => Time
puts past

future = now + 10  # 10 seconds from now Time + number => Time
puts future

diff = future - past     # => 10  Time - Time => number of seconds
puts diff

Isso produzirá o seguinte resultado -

Thu Aug 01 20:57:05 -0700 2013
Thu Aug 01 20:56:55 -0700 2013
Thu Aug 01 20:57:15 -0700 2013
20.0