Компоненты для работы с датами

Компоненты MonthCalendar и DateTimePicker предназначены для упрощения ввода пользователем дат, избавляя разработчика от заботы над тем, как и в каком формате пользователь будет вводить даты.

Компонент MonthCalendar представляет собой календарь на 1 месяц.

Свойства компонента MonthCalendar
Свойство	Тип	Описание
CalColors	TMonthCalColors	Позволяет определить цвета для различных элементов календаря
Date	TDate	Определяет дату, являющуюся выбранной в календаре, или первую дату в диапазоне, если выбран диапазон
EndDate	TDate	Указывает на последнюю дату, являющуюся выбранной, если выбран диапазон дат
FirstDayOfWeek	TCalDayOfWeek	Определяет первый день недели. Значение по умолчанию берется из региональных настроек Windows (для России - понедельник)
MaxDate	TDate	Определяет макс. дату, которая будет доступна в календаре
MaxSelectRange	Integer	Определяет макс. к-во дней, которые можно выбрать диапазоном дат
MinDate	TDate	Определяет мин. дату, которая будет доступна в календаре
MultiSelect	Boolean	Определяет возможность выбора диапазона дат
ShowToday	Boolean	Определяет, видна ли строка, показывающая текущую дату
ShowTodayCircle	Boolean	Определяет, должен ли текущий день быть отмечен в календаре
WeekNumbers	Boolean	Определяет, должны или нет отображаться номера недель

Если отбросить все оформительские свойства, то наиболее пристального внимания заслуживают, прежде всего, свойство Date, а так же EndDate, если разрешен выбор диапазона дат (что достигается путем присваивания истины свойству MultiSelect). Для диапазонов важно так же свойство MaxSelectRange - по умолчанию оно установлено в 31, но, установив его, скажем, в 7, можно ограничить выбор одной неделей.

Другой компонент, предназначенный для отображения и ввода дат - это DateTimePicker. Если поместить такой компонент на форму, то он выглядит как раскрывающийся список, с тем лишь исключением, что вместо текста будет отображать дату. Но если запустить приложение и щелкнуть по кнопке раскрытия, то вместо списка мы увидим как раз тот самый календарь.

Вместе с тем, для компонента DateTimePicker доступны только такие свойства, как CalColors, Date, DateTime, MaxDate и MinDate. Это вызвано, прежде всего, тем, что он не поддерживает возможности работы с диапазонами дат. В то же время, он имеет и ряд иных свойств, и помимо всего прочего, может быть использован для ввода не только дат, но и времени.

Собственные свойства DateTimePicker
Свойство	Тип	Описание
CalAlignment	TDTCalAlignment	Определяет выравнивание раскрывающегося календаря - по левому (dtaLeft) или по правому (dtaRight) краю
Checked	Boolean	Указывает, отмечен ли переключатель (наличие переключателя определяется свойством ShowCheckbox)
DateFormat	TDTDateFormat	Определяет формат вывода даты - короткий или полный.
DateMode	TDTDateMode	Определяет способ ввода даты - при помощи ниспадающего календаря (dmUpDown) или только стрелками (dmComboBox)
DroppedDown	Boolean	Указывает, раскрыт ли календарь в данный момент
Format	String	Позволяет указать произвольный формат отображения дат
Kind	TDateTimeKind	Определяет тип вводимых данных - дата (dtkDate) или время (dtkTime)
ShowCheckbox	Boolean	Определяет, должен ли отображаться переключатель рядом с датой

Отдельно следует выделить свойство Format, отвечающее за вид выводимых значений. Например, используя собственный формат можно одновременно отобразить и дату, и время.

Шаблоны формата вывода даты и времени для свойства Format
Маска	Описание
d	Число 1 или 2 цифрами
dd	Число 2 цифрами. Однозначные значения дополняются 0
ddd	Название дня недели в сокращенной форме
dddd	Название дня недели полностью
h	Час 1 или 2 цифрами, в 12-часовом формате
hh	Час 2 цифрами, в 12-часовом формате. Однозначные значения дополняются 0
H	Час 1 или 2 цифрами, в 24-часовом формате
HH	Час 2 цифрами, в 24-часовом формате. Однозначные значения дополняются 0
m	Минута 1 или 2 цифрами
mm	Минута 2 цифрами. Однозначные значения дополняются 0
M	Месяц 1 или 2 цифрами
MM	Месяц 2 цифрами. Однозначные значения дополняются 0
MMM	Название месяца в сокращенной форме
MMMM	Название месяца полностью
t	Часть дня (AM/PM) 1 буквой - A или P
tt	Часть дня (AM/PM) 2 буквами - AM или PM
yy	Последние 2 цифры года
yyyy	Год полностью

Кроме того, можно добавить поясняющий текст. Например, если в качестве шаблона указать "Сегодня dddd, dd MMMM yyyy г.", то дата будет отображаться как "Сегодня четверг, 1 сентября 2005.". В дополнение к дате можно добавить время, например, благодаря шаблону типа "dd/MM/yy HH:mm" будет выводиться информация вида "01/09/05 12:30". При этом следует учитывать, что к дате следует обращаться через свойство Date, а ко времени - через свойство Time. Программно доступно свойство DateTime, при помощи которого можно установить и дату, и время: DateTimePicker1.DateTime:=now();

Здесь функция now возвращает текущую дату и время по часам компьютера, и присваивает это значение свойству DateTime компонента DateTimePicker. При этом автоматически обновятся оба его свойства, отвечающие за хранение даты и времени отдельно, т.е. Date и Time.

Дата добавления: 2014-01-20