DateTime

From CometWiki

DateTime Function -- Part of the CometDate series of functions.

Syntax: DateTime(FormatString)

Discussion: The DateTime function uses the input string as a formatting template to form an output string containing date and time elements. This function uses the current date and time, not a comet date.

The Input string can contain any text as well as the special formatting elements as listed below. Any characters not part of a format element will be copied to the output string without change.

The Format elements are:

%a = Abbreviated weekday name
%A = Full weekday name
%b = Abbreviated month name
%B = Full month name
%c = Date and time representation appropriate for locale
%d = Day of month as decimal number (01 – 31)
%H = Hour in 24-hour format (00 – 23)
%I = Hour in 12-hour format (01 – 12)
%j = Day of year as decimal number (001 – 366)
%m = Month as decimal number (01 – 12)
%M = Minute as decimal number (00 – 59)
%p = Current locale’s A.M./P.M. indicator for 12-hour clock
%S = Second as decimal number (00 – 59)
%U = Week of year as decimal number, with Sunday as first day of week (00 – 53)
%w = Weekday as decimal number (0 – 6; Sunday is 0)
%W = Week of year as decimal number, with Monday as first day of week (00 – 53)
%x = Date representation for current locale
%X = Time representation for current locale
%y = Year without century, as decimal number (00 – 99)
%Y = Year with century, as decimal number
%z, %Z = Time-zone name or abbreviation; no characters if time zone is unknown
%% = Percent sign
%#c = Long date and time representation, appropriate for current locale
%#x = Long date representation, appropriate to current locale
%#d, %#H, %#I, %#j, %#m, %#M, %#S, %#U, %#w, %#W, %#y, %#Y = Remove leading zeros 

for example:

a$ = DateTime('This is the %dth of %B, and it is a %A.') would set a$ to 'This is the 15th of July, and it is a Sunday.'

For a reference of all of the functions associated with CometDates see this page CometDates.