datetime

[](https://gitter.im/EvilBeaver/oscript-library)

Описание библиотеки datetime

Возможности

• Конвертация даты и времени из/в unix timestamp
• Конвертация даты и времени из строкового представления по формату

Установка

Для установки необходимо:

• Скачать файл datetime*.ospx из раздела releases
• Воспользоваться командой:

opm install -f <ПутьКФайлу>

или установить с хаба пакетов

opm install datetime

Пример работы

• Конвертация в формат unix timestamp

      ПроцессорДаты = Новый ДатаВремя();
  
      ПроверяемаяДата = Дата("20180101");
  
      МеткаВремени = ПроцессорДаты.ВМеткуВремени(ПроверяемаяДата);
  
      Утверждения.ПроверитьРавенство(МеткаВремени, 1514764800, "Полученные числа должны быть равны");
  
  

• Конвертация из формата unix timestamp

      ПроцессорДаты = Новый ДатаВремя();
  
      ПроверяемаяДата = Дата("20180101");
  
      ПолучившаясяДата = ПроцессорДаты.ИзМеткиВремени(1514764800);
  
      Утверждения.ПроверитьРавенство(ПроверяемаяДата, ПолучившаясяДата, "Полученные числа должны быть равны");
  
  

• Конвертация из строки по формату

  
      ДатаПроверки = Дата("20180101");
      ФорматДатыСтроки = "dd MM yy";
      ДатаПроверкиПоФормату = Формат(ДатаПроверки, СтрШаблон("ДФ='%1'", ФорматДатыСтроки));
  
  	Лог.Информация("Проверка чтения даты в формате <%1> строка даты <%2>", ФорматДатыСтроки, ДатаПроверкиПоФормату);
  
  	Результат = ПроцессорДаты.СтрокаВДату(ДатаПроверкиПоФормату, ФорматДатыСтроки);
  
  	Утверждения.ПроверитьРавенство(Результат, ДатаПроверки, "Даты должны быть равны");
  
  

Публичный интерфейс

Библиотека реализовывает следующие объекты:

• Класс ДатаВремя

  • Метод ВМеткуВремени - Конвертирует дату в формат метки времени (timestamp)
  • Метод ИзМеткиВремени - Конвертирует дату из формата метки времени (timestamp) в формат дата
  • Метод СтрокаВДату - Конвертирует строку в дату по шаблону форматной строки
  • Метод ТекущаяДатаВМеткуВремени - Конвертирует текущую дату в формат метки времени (timestamp)

• Модуль РаботаСДатой - методы аналогичные классу ДатаВремя

Документация публичного интерфейса

Доработка

Доработка проводится по git-flow. Жду ваших PR.

Лицензия

Смотри файл LICENSE.