GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
DateTime::Format::Roman(3) User Contributed Perl Documentation DateTime::Format::Roman(3)

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

  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'

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".

  • 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.

  • 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.

The following specifiers are allowed in the format strings given to the new() method:
  • %b

    The abbreviated month name.

  • %B

    The full month name.

  • %d

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

  • %D

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

  • %f

    The 'fixed day' part of the date.

  • %m

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

  • %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 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.

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 (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>.

DateTime

datetime@perl.org mailing list

2019-01-28 perl v5.32.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.