DateTime
From CometWiki
(Difference between revisions)
(Initial Construction of page) |
|||
| (2 intermediate revisions not shown) | |||
| Line 3: | Line 3: | ||
'''Syntax:''' DateTime(FormatString) | '''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. | + | '''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 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. | ||
| Line 28: | Line 28: | ||
%X = Time representation for current locale | %X = Time representation for current locale | ||
%y = Year without century, as decimal number (00 – 99) | %y = Year without century, as decimal number (00 – 99) | ||
| - | %Y = | + | %Y = Year with century, as decimal number |
%z, %Z = Time-zone name or abbreviation; no characters if time zone is unknown | %z, %Z = Time-zone name or abbreviation; no characters if time zone is unknown | ||
%% = Percent sign | %% = Percent sign | ||
| Line 34: | Line 34: | ||
%#x = Long date representation, appropriate to 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 | %#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]]. | For a reference of all of the functions associated with CometDates see this page [[CometDates]]. | ||
Latest revision as of 04:13, 22 July 2012
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.
