Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
DateTime::Format::RomaUser Contributed Perl DocumentDateTime::Format::Roman(3)

NAME
       DateTime::Format::Roman - Roman day numbering for DateTime objects

SYNOPSIS
	 use DateTime::Format::Roman;

	 my $formatter = DateTime::Format::Roman->new(
			     pattern =>	'%d %f %b %y' );

	 my $dt	= DateTime->new( year => 2003, month =>	5, day => 28 );

	 $formatter->format_datetime($dt);
	  # '5 Kal Jun 2003'

DESCRIPTION
       This module formats dates in the	Roman style.

       The Romans expressed their dates	in relation to three fixed dates per
       month. For example: the Ides of March was the 15th of that month; 14
       March was called	"2 Ides", 13 March was called "3 Ides",	etcetera. The
       days in the second half of the month were named after the first day of
       the next	month, the "Kalends"; e.g. 16 March was	called "17 Kalends of
       April".

METHODS
       o   new(	pattern	=> $string )

	   Creates a new formatter object. The optional	formatting pattern
	   defines the format of the output of format_datetime(). If no
	   formatting pattern is given,	a reasonable default is	used.

       o   format_datetime($datetime)

	   Retruns the formatted string. This method can be called on a
	   formatter object (created by	new()),	or it can be called as a class
	   method. In the latter case, the default pattern is used.

   PATTERN SPECIFIERS
       The following specifiers	are allowed in the format strings given	to the
       new() method:

       o   %b

	   The abbreviated month name.

       o   %B

	   The full month name.

       o   %d

	   The day of the month	as a decimal number (including '1' for the
	   fixed days).

       o   %D

	   The day of the month, written as a number plus the corresponding
	   fixed day.

       o   %f

	   The 'fixed day' part	of the date.

       o   %m

	   The month as	a decimal number (range	1 to 12).

       o   %y

	   The year as a decimal number.

       If a specifier is preceded by 'O' or 'o', numbers will be written in
       uppercase and lowercase Roman numerals, respectively.

       The %f specifier	accepts	an additional argument of 1 digit, specifying
       the length of the output:

	   %0f : abbreviated name (e.g.	"Kal")
	   %1f : full name (e.g. "Kalends")
	   %2f : one-letter abbreviation (e.g. "K")

SUPPORT
       Support for  this module	is  provided via the  datetime@perl.org	email
       list. See <https://lists.perl.org/> for more details.

       Note that this is a beta	release. The interface *will* change,
       especially the format specifiers, and the way the "fixed	days" are
       returned.

AUTHOR
       First author: Eugene van	der Pijll <pijll@gmx.net>

       First co-maintainer: Dave Rolsky	<autarch@urth.org>

       Second co-maintainer: Jean Forget <JFORGET@cpan.org>

COPYRIGHT
       Copyright (c) 2003, 2004, 2018, 2019 Eugene van der Pijll, Dave Rolsky
       and Jean	Forget.	 All rights reserved. This program  is free software;
       you can redistribute it and/or modify  it under the same	terms as Perl
       itself.

       This program is	distributed under the same terms  as Perl 5.28.0: GNU
       Public License version 1	or later and Perl Artistic License

       You can find the	text of	the licenses in	the LICENSE file or at
       <https://dev.perl.org/licenses/artistic.html> and
       <https://www.gnu.org/licenses/gpl-1.0.html>.

       Here is the summary of GPL:

       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 1, or (at	 your option)
       any later version.

       This program  is	distributed in the  hope that it will  be useful, but
       WITHOUT	 ANY  WARRANTY;	  without  even	  the  implied	 warranty  of
       MERCHANTABILITY	or FITNESS  FOR	A  PARTICULAR PURPOSE.	 See  the GNU
       General Public License for more details.

       You should  have	received  a copy  of the  GNU General  Public License
       along with  this	program; if not,  see <https://www.gnu.org/licenses/>
       or write	to the Free Software Foundation, Inc., <https://fsf.org>.

SEE ALSO
       DateTime

       datetime@perl.org mailing list

perl v5.32.1			  2019-01-28	    DateTime::Format::Roman(3)

NAME | SYNOPSIS | DESCRIPTION | METHODS | SUPPORT | AUTHOR | COPYRIGHT | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=DateTime::Format::Roman&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help