strftime ( format-string -- quot ) - Factor Documentation

strftime ( format-string -- quot )
Formatted printing

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 ;