Работа с датами в 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.