====== @amperka/rtc ======

Библиотека для управления [[amp>product/troyka-rtc|часами реального времени]].

<code javascript>
// Настраиваем шину I2C
PrimaryI2C.setup({sda: SDA, scl: SCL, bitrate: 100000});

// Создаем новый объект Rtc
var rtc = require('@amperka/rtc').connect(PrimaryI2C);

// Устанавливаем на часах текущее время контроллера
rtc.setTime();

// Результат в формате unixtime: 1459166474
print(rtc.getTime('unixtime'));

// Результат в виде строки ISO: 2016-1-21T12:1:14
print(rtc.getTime('iso'));

// Результат в виде объекта Date: { "ms": 1459166474000 }
print(rtc.getTime());
</code>
===== Функции библиотеки =====

func:: connect([i2c])

Возвращает новый объект ''Rtc'' для управления часами реального времени. Если параметр ''i2c'' не передан, он считается равным ''PrimaryI2C''.

class:: Rtc

Класс для работы с часами реального времени. Для создания нового объекта, используйте функцию ''connect''.

meth:: Rtc.setTime([time])

Устанавливает время ''time'' на часах. Если параметр не передан, устанавливается текущее время контроллера. Параметр ''time'' может быть:
  * числом, значение которого равно количеству секунд с 1 января 1970 года (unixtime);
  * строкой в формате ISO, например ''2016-03-28T13:45:43'';
  * объектом ''Date'';
  * объектом со свойствами:
    * ''year'' — четырехзначный год;
    * ''month'' — номер месяца от 1 до 12;
    * ''day'' — дата от 1 до 31;
    * ''hour'' — час от 0 до 23;
    * ''minute'' — минута от 0 до 59;
    * ''second'' — секунда от 0 до 59.

meth:: Rtc.getTime([unit])

Возвращает текущее время на часах. Если параметр ''unit'' не передан, возвращается объект Date. Другие доступные варианты:
  * ''unixtime'' — количество секунд с 1 января 1970 года (unixtime);
  * ''iso'' — строка в формате ISO.