7.2. Работа с конкретными датами (после точки отсчета).

Большинству программ нужно работать только с датами, относящимися к будущему или недавнему прошлому. Для таких целей класса Time достаточно. Наиболее интересны методы mktime, local, gm и utc.

Метод mktime создает новый объект Time на основе переданных параметров. Параметры задаются по убыванию длительности промежутка: год, месяц, день, часы, минуты, секунды, микросекунды. Все параметры, кроме года, необязательны; по умолчанию предполагается минимально возможное значение. В некоторых машинных архитектурах микросекунды игнорируются. Час выражается числом от 0 до 23.

T1 = Time.mktime(2001)               # 1 января 2001 года, 0:00:00.

T2 = Time.mktime(2001,3).

T3 = Time.mktime(2001,3,15).

T4 = Time.mktime(2001,3,15,21).

T5 = Time.mktime(2001,3,15,21,30).

T6 = Time.mktime(2001,3,15,21,30,15) # 15 марта 2001 года, 21:30:15.

Отметим, что в методе mktime используется местное поясное время. Поэтому у него есть синоним T ime.local.

T7 = Time.local(2001,3,15,21,30,15) # 15 марта 2001 года, 21:30:15.

Метод Time.gm, по сути, делает то же самое, но в нем предполагается время GMT (или UTC). Поскольку автор книги проживает в центральном часовом поясе США, то разница составляет 8 часов:

T8 = Time.gm(2001,3,15,21,30,15) # March 15, 2001 21:30:15 pm.

# Это 13:30:15 по центральному времени!

У этого метода есть синоним Time.utc:

T9 = Time.utc(2001,3,15,21,30,15) # March 15, 2001 21:30:15 pm.

# Снова 13:30:15 по центральному времени.

Отметим одну важную вещь. Все эти методы могут принимать и альтернативный набор параметров. Метод экземпляра to_a (который преобразует время в массив отдельных компонентов) возвращает набор значений в следующем порядке: секунды, минуты, часы, день, месяц, год, день недели ( 0..6), порядковый номер дня в году ( 1..366), летнее время ( true или false), часовой пояс (строка). Поэтому такие вызовы тоже допустимы:

T0 = Time.local(0,15,3,20,11,1979,2,324,false,"GMT-8:00").

T1 = Time.gm(*Time.now.to_a).

Однако, глядя на первый пример, не думайте, что вы сможете изменить вычисляемые параметры, например день недели (в данном случае 2 означает вторник). Такое действие противоречило бы принципам организации календаря, поэтому на созданном объекте Time оно никак не отражается. 20 ноября 1979 года был вторник, и никакой код не сможет этого изменить.

И наконец, отметим, что есть много способов задать время некорректно, например указав тринадцатый месяц или 35-й день месяца. При любой подобной попытке возникнет исключение ArgumentError.