TaskView is a self-hosted project and task management platform focused on clarity, ownership, and control. TaskView is built for teams that want a transparent, self-hosted alternative to SaaS task managers.
TypeScript graphviewkanban-boardnodejsproductivityproject-managementself-hostedtasktask-managementtask-managertodoapp
ю# Форматирование дат в приложении
Обзор
Для форматирования дат в приложении используется composable useTvFormatDate, который предоставляет гибкие возможности отображения дат в различных форматах с поддержкой локализации.
Использование
import { useTvFormatDate } from '@/composition/useTvFormatDate';
// Базовое использование
const formattedDate = useTvFormatDate(date);
// С опциями
const formattedDate = useTvFormatDate(date, {
format: 'relative',
showDayName: true,
locale: 'ru'
});
Опции форматирования
format
'relative'(по умолчанию) - относительные даты (Сегодня, Завтра, Через 2 дня)'short'- краткий формат (15.12 или 15.12.2023)'full'- полный формат (15 декабря 2023)
showDayName
true- добавляет день недели в скобкахfalse(по умолчанию) - без дня недели
showTime
true- добавляет время (только для полного формата)false(по умолчанию) - без времени
locale
'ru'- русская локализация'en'- английская локализация- Если не указано, используется текущая локаль приложения
Примеры использования
1. Список задач (относительный формат)
const taskDate = useTvFormatDate(task.startDate, {
format: 'relative',
showDayName: true
});
// Результат: "Завтра", "Через 2 дня", "15.12 (Пт)"
2. Таблица (краткий формат)
const tableDate = useTvFormatDate(task.startDate, {
format: 'short'
});
// Результат: "15.12", "15.12.2023"
3. Детальная страница (полный формат)
const detailDate = useTvFormatDate(task.startDate, {
format: 'full',
showTime: true
});
// Результат: "15 декабря 2023 14:30"
Рекомендации по UX
1. Контекст использования
- Списки и дашборды: используйте относительный формат
- Таблицы: используйте краткий формат
- Детальные страницы: используйте полный формат
2. Относительные даты
- Показывайте "Сегодня", "Завтра", "Вчера" для близких дат
- Для дат в пределах недели используйте "Через X дней" или "X дней назад"
- Для более дальних дат используйте абсолютный формат
3. День недели
- Добавляйте день недели для дат, которые не являются сегодня/завтра
- Это помогает пользователям лучше ориентироваться в календаре
4. Локализация
- Всегда учитывайте локаль пользователя
- Используйте правильные окончания для русского языка
- Адаптируйте форматы под культурные особенности
Лучшие практики
- Консистентность: используйте одинаковые форматы в похожих контекстах
- Читаемость: избегайте слишком длинных форматов в компактных интерфейсах
- Доступность: убедитесь, что даты читаются скринридерами
- Производительность: используйте computed для реактивных дат
- Тестирование: тестируйте с различными датами и локалями
Примеры вывода
Русская локаль
- Сегодня
- Завтра
- Вчера
- Через 2 дня
- 2 дня назад
- 15.12 (Пт)
- 15 декабря 2023
- 15 декабря 2023 14:30
Английская локаль
- Today
- Tomorrow
- Yesterday
- In 2 days
- 2 days ago
- 15.12 (Fri)
- December 15, 2023
- December 15, 2023 14:30