Name

convert_date — convert date to a specified format

DESCRIPTION

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.

EXAMPLES

Example: Filter example

Year is [filter convert_date.%Y][time][/filter].

          

Example: Filter example

To get a pretty formatted date, such as "May 16, 2007", use
[filter convert_date."%B %e, %Y"][time][/filter].

NOTES

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.

AVAILABILITY

convert_date is available in Interchange versions:

4.6.0-5.7.0 (git-head)

SOURCE

Interchange 5.7.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;
shift(@_);
my $fmt = shift(@_);
while(my $add = shift(@_)) {
  $fmt .= " $add";
}
return $Tag->convert_date({ fmt => $fmt, body => $time});
}
EOR

AUTHORS

Interchange Development Group

SEE ALSO

DocBook! Interchange!