rzaripov.kz

Работа с датами в FireMonkey: форматирование и конвертация

В мобильных и настольных приложениях, которые я разрабатываю на Delphi и FireMonkey, даты входят в бизнес-логику: сроки платежей, отметки синхронизации, журналы событий и календарные записи. Код должен одинаково работать на Android, iOS, Windows, macOS и Linux, поэтому разбор ввода, вычисления и отображение стоит разделять.

Базовый тип Delphi, TDateTime, хранит календарную дату и время как число: целая часть отвечает за дни, дробная — за время суток. Он не содержит локали или часового пояса. Поэтому одно значение можно преобразовать в разные строки, а для UTC и местного времени нужны отдельные правила хранения.

Задача Подход в Delphi Особенность
Показать дату пользователю FormatDateTime, DateTimeToStr, TFormatSettings Учитываются язык и региональные настройки
Разобрать пользовательский ввод TryStrToDate, TryStrToDateTime Возвращается признак успеха вместо исключения
Получить год, месяц и день DecodeDate Компоненты даты возвращаются отдельно
Оставить только дату или время DateOf, TimeOf Ненужная часть TDateTime отбрасывается
Обменяться с API в ISO 8601 DateTimeToISO8601, ISO8601ToDateTime Используется машинно-ориентированный формат
Получить Unix-время DateTimeToUnix, UnixToDateTime Метка считается в секундах от эпохи Unix
Сравнить календарные дни DaysBetween Возвращается число полных суток
Сдвинуть дату IncDay, IncMonth Исходное время суток сохраняется

Модель даты и времени в FireMonkey

TDateTime использует отсчёт от 30 декабря 1899 года. Целая часть числа соответствует количеству прошедших дней, а дробная представляет время от полуночи. Логические типы TDate и TTime используют ту же основу, поэтому нельзя считать, что TDate физически не способен хранить время. Это особенно важно при преобразовании значений, полученных из элементов интерфейса или внешних сервисов.

Для извлечения компонентов применяются функции модуля System.DateUtils. Метод DecodeDate возвращает год, месяц и день, а DecodeTime — часы, минуты, секунды и миллисекунды:

var
  LValue: TDateTime;
  LYear, LMonth, LDay: Word;
begin
  LValue := Now;
  DecodeDate(LValue, LYear, LMonth, LDay);
end;

Календарные операции также сосредоточены в DateUtils: IncDay, IncMonth, DaysBetween и YearsBetween. Перед вычислением следует определить, что означает результат: разницу между календарными днями, полными сутками или интервалом в местном часовом поясе. Смешивание этих трактовок приводит к ошибке в один день при переходе через полночь.

Форматирование дат под локаль пользователя

Пользовательский интерфейс обычно требует короткую дату, полную дату с названием месяца или время в привычном виде. Для этого применяется FormatDateTime с настройками TFormatSettings. Лучше работать с копией активных настроек, не изменяя глобальное состояние приложения:

var
  LS: TFormatSettings;
  LText: string;
begin
  LS := FormatSettings;
  LS.ShortDateFormat := 'dd.MM.yyyy';
  LS.ShortTimeFormat := 'HH:mm';
  LText := FormatDateTime(LS.ShortDateFormat, Now, LS);
end;

В шаблонах dd обозначает день, MM — месяц, yyyy — год, HH — час в 24-часовом формате, mm — минуты, а ss — секунды. Регистр символов имеет значение: mm обозначает минуты, тогда как MM — месяц. Конструкция mmm выводит сокращённое название месяца из настроек локали, а tt добавляет обозначение AM/PM.

Экранная дата и дата в интерфейсе API имеют разные требования. Пользователю удобно видеть 8 марта 2025 года, но серверному контракту лучше передавать 2025-03-08T00:00:00. Если API требует конкретный вариант ISO 8601, его следует указать в документации и проверять при разборе входящих данных. Локальное представление не должно влиять на вычисления и формат сетевой передачи.

Конвертация строк и временных меток

Пользовательский ввод лучше разбирать через TryStrToDate, TryStrToTime или TryStrToDateTime. Эти функции возвращают логический признак успеха, поэтому некорректный текст можно обработать без необработанного исключения:

var
  LValue: TDateTime;
  LResult: string;
begin
  if TryStrToDateTime(ASource, LValue) then
    LResult := FormatDateTime('dd.MM.yyyy', LValue)
  else
    LResult := '';
end;

Неоднозначные значения вроде 01/02/2025 способны трактоваться как первый или второй месяц. Надёжный интерфейс задаёт порядок компонентов подсказкой, маской или раздельными полями. Для фиксированного формата применяется перегрузка с TFormatSettings, а готовые значения проверяются на допустимость календарной даты.

Для обмена с большинством API удобен ISO 8601. Функции DateTimeToISO8601 и ISO8601ToDateTime выполняют прямое преобразование между TDateTime и строкой. Однако часовой пояс не хранится в TDateTime: символ Z или числовое смещение нужно учитывать отдельно и нельзя добавлять к значению, которое ещё не переведено в UTC.

Unix-время представляет количество секунд от эпохи Unix и также является независимым от локали:

LSeconds := DateTimeToUnix(LValue);
LValue := UnixToDateTime(LSeconds);

Если сервис передаёт метку в миллисекундах, перед преобразованием выполняется умножение на 1000, а при обратной конвертации — деление. Такое значение следует считать UTC, даже если оно затем показывается пользователю в местном времени.

Календарные вычисления и часовые пояса

Функции DateOf и TimeOf помогают отделить календарную дату от времени суток. DateOf возвращает начало указанного дня, а TimeOf сохраняет только временную часть. Это избавляет от лишних часов и минут при сравнении событий, созданных в один день:

LDateOnly := DateOf(LValue);
LTimeOnly := TimeOf(LValue);
LNextDate := IncDay(LValue);

DaysBetween удобен для оценки расстояния между календарными днями, а HoursBetween — для интервала в часах. Если направление разницы имеет значение, безопаснее сравнить исходные значения и получить разность в секундах. При этом нужно учитывать, календарная это величина или фактическая длительность.

Наиболее тонкий случай возникает при переходе на летнее время. Местные сутки могут содержать 23 или 25 часов, а одинаковое локальное время может встретиться дважды. TDateTime не хранит правила перехода, поэтому для долговременного хранения разумно использовать UTC, а местное значение получать через TTimeZone.Local при выводе. Расписание событий при этом создаётся в календарной зоне пользователя.

Надёжная архитектура обработки дат

В кроссплатформенном приложении полезно выделить границы, на которых меняется представление даты. Формат ответа сервера преобразуется в TDateTime или собственный тип модели, бизнес-правила работают с календарными значениями, а слой представления форматирует их для выбранной локали. Такой подход уменьшает зависимость логики от языка интерфейса и конкретной платформы.

В модели можно закрепить отдельные типы для календарной даты, времени суток и момента с часовым поясом. Это избавляет от неявного смешивания даты рождения, времени напоминания и UTC-метки синхронизации. Для входных данных применяются безопасные методы разбора, а результаты календарных операций проверяются на граничных значениях.

Тесты обработки дат должны охватывать високосные годы, 29 февраля, последние дни месяцев, полночь, миллисекунды, разные локали и переход на летнее время. Отдельно проверяются форматы API, точность Unix-меток и поведение при ошибочном вводе. В результате приложение получает одинаковую и предсказуемую работу с датами на всех поддерживаемых платформах FireMonkey.