convert_date — convert date to a specified format


The filter calls [convert-date] to output date according to the specified format string.

For the accepted formats in which the input date needs to be specified, see [convert-date].

See time glossary entry for a list and description of format specifiers.


Example: Filter example

Year is [filter convert_date.%Y][time][/filter].
Example in action:
              Year is 2020.

Example: Filter example

To get a pretty formatted date, such as "May 16, 2007", use
[filter convert_date."%B %e, %Y"][time][/filter].
Example in action:
October 31, 2020.


This filter looks almost exactly like the [convert-date] tag, but there's a simple difference in the implementation. [convert-date] tag called with an empty or invalid time string it will default to the current time; this filter called with an empty or invalid time string will default to an empty value.


convert_date is available in Interchange versions:

4.6.0-5.9.0 (git-head)


Interchange 5.9.0:

Source: code/Filter/convert_date.filter
Lines: 26

# Copyright 2002-2007 Interchange Development Group and others
# Copyright 1996-2002 Red Hat, Inc.
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.  See the LICENSE file for details.
# $Id: convert_date.filter,v 1.7 2007-03-30 23:40:44 pajamian Exp $

CodeDef convert_date Filter
CodeDef convert_date Description Convert date
CodeDef convert_date Visibility  private
CodeDef convert_date Routine <<EOR
sub {
my $time = shift(@_);
# Don't convert nothing to something
return '' unless $time;
my $fmt = shift(@_);
while(my $add = shift(@_)) {
  $fmt .= " $add";
return $Tag->convert_date({ fmt => $fmt, body => $time});


Interchange Development Group


DocBook! Interchange!