TWiki Variables » Search » Category: Date & Time

CALENDAR -- show a monthly calendar with highlighted events

• Events are defined by bullets, see CalendarPlugin#Event_Syntax for details. The %CALENDAR{}% variable is handled by the CalendarPlugin.
• Syntax: %CALENDAR{ parameters }%
• Parameters:

  Parameter	Description	Default
  width="n" or "n%"	Width of calendar table in pixels or percent	Minimum width needed
  web="Webname"	Web containing the event topic	The current web
  vcellalignment="middle"	Vertical cell alignment of day cells: "top", "middle", "bottom", "baseline"	"top"
  topic="Web.TopicName1, Web.TopicName2"	Topics containing events	The topics containing the tags
  topic="TopicName"	Topic containing events	The topic containing the tag
  gmtoffset="+/-hh"	Timezone expressed as number of hours offset from GMT	Server timezone
  year="yyyy"	The year	Current year
  month="mm"	The month	Current month
  header="..."	Text at the top of the calendar; use $m for current month, $y for year	Current month and year
  months	Specifies how many months of calendars to display. Only valid if aslist="0".	"1"
  days	Specifies how many days of calendar data to list. Only valid if aslist="1".	"1"
  multidayformat	Specifies formatting of the description for multi-day events. See Multi-Day Event Formatting for details.	$description
  datenumberformat	Specifies formatting for the date number in each cell. The formatting codes accepted are the same as those for the %GMTIME% variable.	$day (if aslist="0")   * $day $mon $year (if aslist="1")
  todaydatenumberformat	Specifies formatting for the date number for the current day (today) in the calendar. The formatting codes accepted are the same as those for the %GMTIME% variable.	datenumberformat
  cellspacing="n"	Spacing of calendar cells. (sharpborders="0" required)	"0"
  showweekdayheaders="1"	Show the weekday headers	"0"
  showdatenumbers="0"	Show day numbers 1...31 in date cells. Note that showdatenumbers=1 means that HTML::CalendarMonthSimple will add the date numbers to the cells. If showdatenumbers=0, then the plugin adds the date numbers. The result of this is that a calendar will always show the date numbers.	"0" (except with aslist="1", see below)
  year="+yy" or "-yy"	Relative year	Current year
  month="+mm" or "-mm"	relative month	Current month
  nowrap="1" or "0"	Prevent cell content from wrapping	"0"
  cellpadding="n"	Padding of calendar cells. (sharpborders="0" required)	"3"
  lang="language"	Language: First few characters of "English", "Francais", "Deutsch", "Espagnol", "Portugues", "Nederlands", "Italiano", "Norsk", "Svenska", "Dansk", "Suomi", "Magyar", "Polski	"English"
  sharpborders="n"	If set to 1, this gives very crisp edges between the table cells. If set to 0 standard HTML cells are used.	"1"
  weekdayheadersbig="0"	If enabled, show weekday headers in bold cell headings	"1"
  format="..."	How to highlight a date	See Event Formatting below
  cellalignment="left"	Horizontal cell alignment of day cells: "left", "center", "right", "justify", "char"	"center"
  cellheight="n"	Height in pixels of each cell in the calendar	Minimum height needed
  weekstartsonmonday="1" or "0"	Flag to start week on Monday	"0" (Sunday)
  contentcolor="#nnnn"	Default content color of all cells unless redefined	"black"
  bgcolor="#nnnn"	Default background color of all cells unless redefined by other color settings below (use an HTML color-code like "#000000" as defined in StandardColors)	"white"
  daynames="Mon|Tue|..."	Custom day names	"Monday|Tuesday| Wednesday|Thursday| Friday|Saturday| Sunday"
  aslist	Controls whether events displayed in calendar style (aslist=0) or list style (aslist=1). Note that specifying aslist=1 forces showdatenumbers=1. This is done to ensure that the date number is formatted according to datenumberformat and that only the days that have an event are listed.	"0"
  weekendheadercontentcolor= "#nnnn"	Content color of weekends' headers	contentcolor setting
  weekendcontentcolor="#nnnn"	Content color of weekend cells	contentcolor setting
  weekdayheadercontentcolor= "#nnnn"	Content color of weekdays' headers	contentcolor setting
  weekdaycontentcolor="#nnnn"	Content color of weekday cells	contentcolor setting
  todaycontentcolor="#nnnn"	Content color of today's cell	contentcolor setting
  headercontentcolor="#nnnn"	Content color of the Month+Year header	contentcolor setting
  border="n"	Border width of calendar table. (sharpborders="0" required)	"1"
  weekendcolor="#nnnn"	Background of weekend cells	light gray
  todaycolor="#nnnn"	Background of today's cell	The web bgcolor
  weekendheadercolor="#nnnn"	Background color of weekends' headers	bgcolor setting
  weekdayheadercolor="#nnnn"	Background color of weekdays' headers	bgcolor setting
  weekdaycolor="#nnnn"	Background color of weekday cells	bgcolor setting
  headercolor="#nnnn"	Background color of the Month+Year header	The web bgcolor
  and other attributes of HTML::CalendarMonthSimple

• Example: %CALENDAR{ month="2" year="2025" bgcolor="cyan" }% shows a February 2025 calendar
• Category: DateAndTimeVariables, FormattingAndRenderingVariables
• Related: DATE, DISPLAYTIME, GMTIME{"format"}, SERVERTIME, CalendarPlugin (this topic)

DATE -- signature format date

• Syntax: %DATE%
• Expands to: 2025-03-15
• Date format defined as {DefaultDateFormat} in configure, default $year-$mo-$day
• Note: When used in a template topic, this variable will be expanded when the template is used to create a new topic. See TWikiTemplates#TemplateTopicsVars for details.
• Category: DateAndTimeVariables, SystemInformationVariables
• Related: DISPLAYTIME, GMTIME{"format"}, SERVERTIME (this topic)

DATEPICKER{} -- pop-up calendar to select a date for use in HTML forms

• The %DATEPICKER{}% variable is handled by the DatePickerPlugin.
• Syntax: %DATEPICKER{ name="..." value="..." }%
• Parameters:

  Parameter	Description	Default	Example
  name	Name of input field. φ: No output is shown if the name parameter is missing, but the CSS and Javascript are loaded.	(requiredφ)	name="Start"
  value	Initial date value.	"" (today)	value="2012-12-31"
  format	Format of resulting date value. • %a - abbreviated weekday name • %A - full weekday name • %b - abbreviated month name • %B - full month name • %C - century number • %d - the day of the month (00 ... 31) • %e - the day of the month (0 ... 31) • %H - hour (00 ... 23) • %I - hour (01 ... 12) • %j - day of the year ( 000 ... 366) • %k - hour (0 ... 23) • %l - hour (1 ... 12) • %m - month (01 ... 12) • %M - minute (00 ... 59) • %n - a newline character • %p - "PM" or "AM" • %P - "pm" or "am" • %S - second (00 ... 59) • %s - number of seconds since Epoch (since Jan 01 1970 00:00:00 UTC) • %t - a tab character • %U, %W, %V - the week number. The week 01 is the week that has the Thursday in the current year, which is equivalent to the week that contains the fourth day of January. Weeks start on Monday. • %u - the day of the week (1 ... 7, 1 = MON) • %w - the day of the week (0 ... 6, 0 = SUN) • %y - year without the century (00 ... 99) • %Y - year including the century (ex. 2012) • %% - a literal % character	"%Y-%m-%d"	format="%e %b %Y"
  id	ID of input field, optional.	"id_" + name	id="idStart"
  size	Size of input field, in number of characters.	(calculated as needed)	size="12"
  class	CSS class of input field.	"twikiInputField"	class="dateField"
  Additional HTML input field attributes, such as alt, disabled, maxlength, onblur, onchange, onfocus, readonly, style, tabindex, title

• Example:
  <form action="...">
%DATEPICKER{ name="Start_Date" }%
<form>
• Expands to:
• Category: ApplicationsAndComponentsVariables, DatabaseAndFormsVariables, DateAndTimeVariables, EditingAndContentUpdateVariables, FormattingAndRenderingVariables, UIAndVisualizationVariables
• Related: DatePickerPlugin, TWikiForms (this topic)

DISPLAYTIME -- display date and time

• Syntax: %DISPLAYTIME%
• Expands to: 2025-03-15 - 06:38
• Date part of the format is displayed as defined by the {DefaultDateFormat} in configure, default $year-$mo-$day. The time is shown as hh:mm (24 hour clock)
• Category: DateAndTimeVariables, SystemInformationVariables
• Related: DISPLAYTIME{"format"}, GMTIME, SERVERTIME (this topic)

DISPLAYTIME{"format"} -- formatted display time

• Formatted time - either GMT or Local server time, depending on {DisplayTimeValues} setting in configure, default $year-$mo-$day. Same format qualifiers as %GMTIME%
• Syntax: %DISPLAYTIME{"format"}%
• Supported variables: $seconds, $minutes, $hours, $day, $wday, $dow, $month, $mo, $year, $ye, $tz, $iso, $rcs, $http, $epoch
• Example: %DISPLAYTIME{"$hou:$min"}% expands to 06:38
• Category: DateAndTimeVariables, SystemInformationVariables
• Related: DISPLAYTIME, GMTIME, SERVERTIME (this topic)

GMTIME -- GM time

• Syntax: %GMTIME%
• Expands to: 2025-03-15 - 06:38
• Date format defined as {DefaultDateFormat} in configure, default $year-$mo-$day
• Note: When used in a template topic, this variable will be expanded when the template is used to create a new topic. See TWikiTemplates#TemplateTopicsVars for details.
• Category: DateAndTimeVariables
• Related: DISPLAYTIME, GMTIME{"format"}, SERVERTIME (this topic)

GMTIME{"format"} -- formatted GM time

• Syntax: %GMTIME{"format"}%
• Supported variables:

  Variable:	Unit:	Example
  $seconds	seconds	59
  $minutes	minutes	59
  $hours	hours	23
  $day	day of month	31
  $wday	day of the Week (Sun, Mon, Tue, Wed, Thu, Fri, Sat)	Thu
  $dow	day of the week (Sun = 0)	2
  $week	number of week in year (ISO 8601)	34
  $month	short name of month	Dec
  $mo	2 digit month	12
  $year	4 digit year	1999
  $ye	2 digit year	99
  $tz	either "GMT" (if set to gmtime), or offset such as "-0700" (if set to servertime)	GMT
  $iso	ISO format timestamp	2025-03-15T06:38:49Z
  $rcs	RCS format timestamp	2025/03/15 06:38:49
  $http	E-mail & http format timestamp	Sat, 15 Mar 2025 06:38:49 GMT
  $epoch	Number of seconds since 00:00 on 1st January, 1970	1742020729

• Variables can be shortened to 3 characters
• Example: %GMTIME{"$day $month, $year - $hour:$min:$sec"}% expands to 15 Mar, 2025 - 06:38:49
• Note: When used in a template topic, this variable will be expanded when the template is used to create a new topic. See TWikiTemplates#TemplateTopicsVars for details.
• Category: DateAndTimeVariables
• Related: DISPLAYTIME, GMTIME, REVINFO, SERVERTIME (this topic)

SERVERTIME -- server time

• Syntax: %SERVERTIME%
• Expands to: 2025-03-15 - 07:38
• Date format defined as {DefaultDateFormat} in configure, default $year-$mo-$day
• Note: When used in a template topic, this variable will be expanded when the template is used to create a new topic. See TWikiTemplates#TemplateTopicsVars for details.
• Category: DateAndTimeVariables, SystemInformationVariables
• Related: DISPLAYTIME, GMTIME, SERVERTIME{"format"} (this topic)

SERVERTIME{"format"} -- formatted server time

• Same format qualifiers as %GMTIME%
• Syntax: %SERVERTIME{"format"}%
• Supported variables: $seconds, $minutes, $hours, $day, $wday, $dow, $month, $mo, $year, $ye, $tz, $iso, $rcs, $http, $epoch
• Example: %SERVERTIME{"$hou:$min"}% expands to 07:38
• Note: When used in a template topic, this variable will be expanded when the template is used to create a new topic. See TWikiTemplates#TemplateTopicsVars for details.
• Category: DateAndTimeVariables, SystemInformationVariables
• Related: DISPLAYTIME, GMTIME, SERVERTIME (this topic)

Total: 9 variables

Related Topics: TWikiVariables, TWikiVariablesSearch, TWikiVariablesQuickStart