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