Show: Delphi C++
Display Preferences

Vcl.ComCtrls.TDateTimePicker.Format

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

property Format: String read FFormat write SetFormat;

C++

__property System::UnicodeString Format = {read=FFormat, write=SetFormat};

Properties

Type Visibility Source Unit Parent
property published
Vcl.ComCtrls.pas
Vcl.ComCtrls.hpp
Vcl.ComCtrls TDateTimePicker

Description

Specify format for date-time string.

Format specifies custom format string for the date-time display, overriding the control panel strings. A custom format can include both date and time fields, but time fields are not editable unless the Kind property is dtkTime. The following format characters are understood.



Element Description

d

The one- or two-digit day.

dd

The two-digit day. Single-digit day values are preceded by a zero.

ddd

The three-character weekday abbreviation.

dddd

The full weekday name.

h

The one- or two-digit hour in 12-hour format.

hh

The two-digit hour in 12-hour format. Single-digit values are preceded by a zero.

H

The one- or two-digit hour in 24-hour format.

HH

The two-digit hour in 24-hour format. Single-digit values are preceded by a zero.

m

The one- or two-digit minute.

mm

The two-digit minute. Single-digit values are preceded by a zero.

M

The one- or two-digit month number.

MM

The two-digit month number. Single-digit values are preceded by a zero.

MMM

The three-character month abbreviation.

MMMM

The full month name.

t

The one-letter AM/PM abbreviation (that is, AM is displayed as "A").

tt

The two-letter AM/PM abbreviation (that is, AM is displayed as "AM").

yy

The last two digits of the year (that is, 2001 would be displayed as "01").

yyyy

The full year (that is, 2001 would be displayed as "2001").



To include literal strings in the format, enclose them in single quotes. Failing to quote literal strings can have unpredictable results, even if they do not include formatting codes. Use two single quotes to represent one single quote character in a literal string. For example,

Today's date: MMM dd, yyyy

entered in the property editor, produces the following results for April 1, 2001:

"Today's date: Apr 01, 2001"

Note: When setting Format programmatically in Delphi code, double each single quote again:



DateTimePicker1.Format := '''Today''''s date:'' MMM dd, yyyy';



See Also

Code Examples


Personal tools
In Other Languages
Previous Versions
Assistance