Skip over navigation

Roxen Interactive RXML Help

<date/>

Inserts the time and date. Does not require attributes.

<date/>
20:05, December the 17th, 2014

Attributes

unix-time
unix-time=number of seconds

Display this time instead of the current. This attribute uses the specified Unix 'time_t' time as the starting time (which is 01:00, January the 1st, 1970), instead of the current time. This is mostly useful when the <date> tag is used from a Pike-script or Roxen module.

<date unix-time='120'/>
19:02, December the 31st, 1969

http-time
http-time=http time stamp

Display this time instead of the current. This attribute uses the specified http-time, instead of the current time.

All three http-time formats are supported:

<p>RFC 822, updated by RFC 1123: <date http-time='Sun, 06 Nov 1994 08:49:37 GMT'/></p> <p>RFC 850, obsoleted by RFC 1036: <date http-time='Sunday, 06-Nov-94 08:49:37 GMT' /></p> <p>ANSI C's asctime() format: <date http-time='Sun Nov 6 08:49:37 1994' /></p>

RFC 822, updated by RFC 1123: 03:49, November the 6th, 1994

RFC 850, obsoleted by RFC 1036: 03:49, November the 6th, 1994

ANSI C's asctime() format: 08:49, November the 6th, 1994

iso-time
iso-time={yyyy-mm-dd, yyyy-mm-dd hh:mm, yyyy-mm-dd hh:mm:ss}

Display this time instead of the current. This attribute uses the specified ISO 8601 time as the starting time, instead of the current time. The character between the date and the time can be either " " (space) or "T" (the letter T).

<date iso-time='2002-09-03 16:06'/>
16:06, September the 3rd, 2002

timezone
timezone={local, GMT} (local)

Display the time from another timezone.

to-timezone
to-timezone={local, GMT, Europe/Stockholm, ...} (local)

Display the time in another timezone.

years
years=number

Add this number of years to the result.

<date date='' years='2'/>
December the 17th in the year of 2016

months
months=number

Add this number of months to the result.

<date date='' months='2'/>
February the 17th in the year of 2015

weeks
weeks=number

Add this number of weeks to the result.

<date date='' weeks='2'/>
December the 31st in the year of 2014

days
days=number

Add this number of days to the result.

hours
hours=number

Add this number of hours to the result.

<date time='' hours='2' type='iso'/>
22:05:21

beats
beats=number

Add this number of beats to the result.

<date time='' beats='10' type='iso'/>
20:19:45

minutes
minutes=number

Add this number of minutes to the result.

seconds
seconds=number

Add this number of seconds to the result.

adjust
adjust=number

Add this number of seconds to the result.

brief

Show in brief format.

<date brief=''/>
today, 20:05

time

Show only time.

<date time=''/>
20:05

date

Show only date.

<date date=''/>
December the 17th in the year of 2014

type
type={number, ordered, string, discordian, http, iso, stardate, unix}

Defines in which format the date should be displayed in.

The following types are only useful together with the "part" attribute:

type=number

<date part='day' type='number'/>
4

type=ordered

<date part='day' type='ordered'/>
4th

type=string

<date part='day' type='string'/>
Wednesday

The following types are only useful without the "part" attribute:

type=discordian

<date type='discordian'/><br/> <date type='discordian' year='' holiday=''/>
Sweetmorn, the 59th day of The Aftermath
Sweetmorn, the 59th day of The Aftermath in the YOLD of 3180

type=http

<date type='http'/>
Thu, 18 Dec 2014 01:05:21 GMT

type=iso

<date type='iso' time=''/><br/> <date type='iso' date=''/><br/> <date type='iso'/>
20:05:21
2014-12-17
2014-12-17T20:05:21

type=stardate

<date type='stardate' prec='5'/>
41989.28419

type=unix

<date type='unix'/>
1418864721

'http' is the format specified for use in the HTTP protocol (useful for headers etc).

'stardate' has a separate companion attribute "prec" which sets the precision.

part
part={year, month, day, wday, date, mday, hour, minute, second, yday, beat, week, seconds}

Defines which part of the date should be displayed. Day and wday is the same. Date and mday is the same. Yday is the day number of the year. Seconds is unix time type. Only the types string, number and ordered applies when the part attribute is used.

PartMeaning

year

Display the year.

<date part='year' type='number'/>
2014

month

Display the month.

<date part='month' type='ordered'/>
12th

day

Display the weekday, starting with Sunday.

<date part='day' type='ordered'/>
4th

wday

Display the weekday. Same as 'day'.

<date part='wday' type='string'/>
Wednesday

date

Display the day of this month.

<date part='date' type='ordered'/>
17th

mday

Display the number of days since the last full month.

<date part='mday' type='number'/>
17

hour

Display the numbers of hours since midnight.

<date part='hour' type='ordered'/>
20th

minute

Display the numbers of minutes since the last full hour.

<date part='minute' type='number'/>
5

second

Display the numbers of seconds since the last full minute.

<date part='second' type='string'/>
twentyone

yday

Display the number of days since the first of January.

<date part='yday' type='ordered'/>
350th

beat

Display the number of beats since midnight Central European Time(CET). There is a total of 1000 beats per day. The beats system was designed by Swatch as a means for a universal time, without time zones and day/night changes.

<date part='beat' type='number'/>
@087

week

Display the number of the current week.

<date part='week' type='number'/>
51

seconds

Display the total number of seconds this year.

<date part='seconds' type='number'/>
1418864721

strftime
strftime=string

If this attribute is given to date, it will format the result according to the argument string.

FormatMeaning

%%

Percent character

%a

Abbreviated weekday name, e.g. "Mon"

%A

Weekday name

%b

Abbreviated month name, e.g. "Jan"

%B

Month name

%c

Date and time, e.g. "%a %b %d %H:%M:%S %Y"

%C

Century number, zero padded to two charachters.

%d

Day of month (1-31), zero padded to two characters.

%D

Date as "%m/%d/%y"

%e

Day of month (1-31), space padded to two characters.

%H

Hour (24 hour clock, 0-23), zero padded to two characters.

%h

See %b

%I

Hour (12 hour clock, 1-12), zero padded to two charcters.

%j

Day numer of year (1-366), zero padded to three characters.

%k

Hour (24 hour clock, 0-23), space padded to two characters.

%l

Hour (12 hour clock, 1-12), space padded to two characters.

%m

Month number (1-12), zero padded to two characters.

%M

Minute (0-59), zero padded to two characters.

%n

Newline

%p

"a.m." or "p.m."

%P

"am" or "pm"

%r

Time in 12 hour clock format with %p

%R

Time as "%H:%M"

%S

Seconds (0-60), zero padded to two characters. 60 only occurs in case of a leap second.

%t

Tab

%T

Time as "%H:%M:%S"

%u

Weekday as a decimal number (1-7), 1 is Sunday.

%U

Week number of year as a decimal number (0-53), with sunday as the first day of week 1, zero padded to two characters.

%V

ISO week number of the year as a decimal number (1-53), zero padded to two characters.

%w

Weekday as a decimal number (0-6), 0 is Sunday.

%W

Week number of year as a decimal number (0-53), with sunday as the first day of week 1, zero padded to two characters.

%x

Date as "%a %b %d %Y"

%X

See %T

%y

Year (0-99), zero padded to two characters.

%Y

Year (0-9999), zero padded to four characters.

<date strftime="%B %e %Y, %A %T"/>
December 17 2014, Wednesday 20:05:21

lang
lang=langcode

Defines in what language a string will be presented in. Used together with type=string and the part attribute to get written dates in the specified language.

<date part='day' type='string' lang='de'/>
Mittwoch

case
case={upper, lower, capitalize}

Changes the case of the output to upper, lower or capitalize.

<date date='' lang='&client.language;' case='upper'/>
DECEMBER THE 17TH IN THE YEAR OF 2014

prec
prec=number

The number of decimals in the stardate.