strftime ( format-string -- quot )
Formatted printing

Prev:

sprintf ( format-string -- quot )

Vocabulary
formatting

Inputs

format-string

a string

Outputs
None

Word description
Writes the timestamp (specified on the stack) formatted according to the format string.

Different attributes of the timestamp can be retrieved using format specifications.

%a	Abbreviated weekday name.
%A	Full weekday name.
%b	Abbreviated month name.
%B	Full month name.
%c	Date and time representation.
%d	Day of the month as a decimal number [01,31].
%H	Hour (24-hour clock) as a decimal number [00,23].
%I	Hour (12-hour clock) as a decimal number [01,12].
%j	Day of the year as a decimal number [001,366].
%m	Month as a decimal number [01,12].
%M	Minute as a decimal number [00,59].
%p	Either AM or PM.
%S	Second as a decimal number [00,59].
%U	Week number of the year (Sunday as the first day of the week) as a decimal number [00,53].
%w	Weekday as a decimal number [0(Sunday),6].
%W	Week number of the year (Monday as the first day of the week) as a decimal number [00,53].
%x	Date representation.
%X	Time representation.
%y	Year without century as a decimal number [00,99].
%Y	Year with century as a decimal number.
%Z	Time zone name (no characters if no time zone exists).
%%	A literal '%' character.

Examples

USING: calendar formatting io ; now "%c" strftime print
Mon Dec 15 14:40:43 2008

Definition

USING: formatting.private kernel sequences strings ;

IN: formatting

MACRO: strftime ( format-string -- quot )
    parse-strftime [
        dup string?
        [ [ append! ] curry ]
        [ [ [ over ] ] dip [ append! ] compose compose ] if
    ] map concat [ [ SBUF" " clone ] ] dip
    [ nip "" like ] compose compose ;