-

docs/forms/utils.rst

@@ -113,3 +113,72 @@ AS.FORMS.ComponentUtils
         Используется для добавления кастомных событий компоненту.
 
         :param object object:       Любой объект
+
+AS.FORMS.DateUtils
+~~~~~~~~~~~~~~~~~~
+
+.. js:class:: AS.FORMS.DateUtils
+
+    Утилиты для работы с датами
+
+    .. js:function:: formatDate(date, format)
+
+        Привести дату к указанному формату
+
+        :param Date date:       Дата, которую надо привести к формату
+        :param string format:   Форматная строка. Поддерживаются следующие подстановки:
+
+                                * ``${yyyy}``, ``${yy}`` - год (число)
+                                * ``${mm}``, ``${m}`` - месяц (число)
+                                * ``${month}`` - месяц в именительном падеже
+                                * ``${month_short}`` - сокращенное значение месяца
+                                * ``${monthed}`` - месяц в родительном падеже
+                                * ``${dd}``, ``${d}`` - день месяца
+                                * ``${hh}``, ``${h}`` - часы в 12-часовом формате
+                                * ``${HH}``, ``${H}`` - часы в 24-часовом формате
+                                * ``${MM}``, ``${M}`` - минуты
+                                * ``${SS}``, ``${S}`` - секунды
+
+        :returns:               ``string`` Значение даты согласно формату
+
+    .. js:function:: getMonthName(monthNumber)
+
+        Получить строковое значение месяца по его номеру
+
+        :param number monthNumber:  порядковый номер месяца 1-12
+        :returns:                   ``string`` наименование месяца
+
+    .. js:function:: getMonthPossessiveName(monthNumber)
+
+        Получить строковое значение месяца в родительном падеже по его номеру
+
+        :param number monthNumber:  порядковый номер месяца 1-12
+        :returns:                   ``string`` наименование месяца в родительном падеже
+
+    .. js:function:: getMonthShortName(monthNumber)
+
+        Получить строковое сокращенное значение месяца по его номеру
+
+        :param number monthNumber:  порядковый номер месяца 1-12
+        :returns:                   ``string`` сокращенное наименование месяца
+
+    .. js:function:: getWeekDayName(dayNumber)
+
+        Получить наименование дня недели по его номеру
+
+        :param number dayNumber:    порядковый номер дня недели 1-7
+        :returns:                   ``string`` наименование дня недели
+
+    .. js:function:: getWeekDayShortName(dayNumber)
+
+        Получить сокращенное наименование дня недели по его номеру
+
+        :param number dayNumber:    порядковый номер дня недели 1-7
+        :returns:                   ``string`` сокращенное наименование дня недели
+
+    .. js:function:: parseDate(dateStr)
+
+        Получить дату по его строковому представлению
+
+        :param string dateStr:      Дата в формате ``yyyy-MM-dd HH:mm``
+        :returns:                   ``Date`` Объект даты