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