[Overview][Constants][Types][Classes][Procedures and functions][Variables][Index] Reference for unit 'sysutils' (#rtl)

FormatDateTime

Return a string representation of a TDateTime value with a given format.

Declaration

Source position: datih.inc line 155

function FormatDateTime(

  const FormatStr: string;

  DateTime: TDateTime;

  Options: TFormatDateTimeOptions = []

):string;

function FormatDateTime(

  const FormatStr: string;

  DateTime: TDateTime;

  const FormatSettings: TFormatSettings;

  Options: TFormatDateTimeOptions = []

):string;

Description

FormatDateTime formats the date and time encoded in DateTime according to the formatting given in FormatStr. The complete list of formatting characters can be found in formatchars.

Errors

On error (such as an invalid character in the formatting string), and EConvertError exception is raised.

See also

DateTimeToStr

  

Converts a TDateTime value to a string using a predefined format.

DateToStr

  

Converts a TDateTime value to a date string with a predefined format.

TimeToStr

  

Convert a TDateTime time to a string using a predefined format.

StrToDateTime

  

Convert a date/time string to a TDateTime value.

EConvertError

  

Conversion error.

Example

Program Example14;

{ This program demonstrates the FormatDateTime function }

Uses sysutils;

Var ThisMoment : TDateTime;

Begin
  ThisMoment:=Now;
  Writeln ('Now : ',FormatDateTime('hh:nn',ThisMoment));
  Writeln ('Now : ',FormatDateTime('DD MM YYYY',ThisMoment));
  Writeln ('Now : ',FormatDateTime('c',ThisMoment));
End.
Documentation generated on: Mar 17 2017