Формат времени в UTC

services/pcp-tgu-ui-service/src/utils/localTime.ts

@@ -1,14 +1,16 @@
 /**
- * Единый разбор и форматирование времени в локальной зоне.
+ * Единые утилиты времени для UI.
  *
- * Бэкенд (Kotlin `LocalDateTime`) отдаёт время как ISO-строку без зоны
- * (например `"2026-05-29T01:00:00"`) — это настенные часы локальной зоны, в которой
- * работают все сервисы, без UTC-семантики. Браузер по умолчанию трактует такую naive-строку
- * как локальное время — это нам и нужно: разбор, показ и ввод идут в зоне браузера, а
- * сериализация назад отдаёт те же настенные часы naive-строкой без зоны.
+ * Контракт API после UTC-перевода:
+ * - backend/БД/DTO используют UTC;
+ * - API отдаёт ISO-8601 UTC с `Z`;
+ * - UI показывает время в часовом поясе браузера;
+ * - значения из локальных полей ввода перед отправкой в API конвертируются в UTC ISO.
  *
- * Строки с явной зоной (`...Z`/офсет, напр. валидность платформ из НСИ) парсятся как
- * абсолютный момент и показываются в локальной зоне.
+ * Legacy-строки API без зоны всё ещё могут встретиться при неполностью обновлённых сервисах.
+ * В основном UI они обычно приходят из локальных input-полей, поэтому `parseLocal` сохраняет старое
+ * поведение: naive-строка разбирается как локальное время браузера. После полного перевода API
+ * новые ответы должны приходить с `Z` и будут разобраны как абсолютный UTC-момент.
  */
 
 function pad(n: number): string {
@@ -60,10 +62,15 @@ export function toLocalInputValue(ms: number): string {
 }
 
 /**
- * naive `LocalDateTime` без зоны (`YYYY-MM-DDTHH:mm:ss`) из локальных компонент эпохи-мс.
- * Все бэкенды ожидают `LocalDateTime` без зоны — настенные часы локальной зоны.
+ * Локальная ISO-строка без зоны (`YYYY-MM-DDTHH:mm:ss`) из локальных компонент.
+ * Оставлена для локальных UI-расчётов и полей времени, не использовать для отправки API DTO.
  */
 export function toLocalIso(ms: number): string {
   const d = new Date(ms);
   return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}T${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`;
 }
+
+/** UTC ISO-строка для DTO/query-параметров API. */
+export function toUtcIso(ms: number): string {
+  return new Date(ms).toISOString();
+}