NAME

Gtk2::Ex::FormFactory::Timestamp - Enter a valid timestamp

SYNOPSIS

  Gtk2::Ex::FormFactory::Timestamp->new (
    format    => A format string describing the the time fields
    ...    
    Gtk2::Ex::FormFactory::Widget attributes
  );

DESCRIPTION

This class implements a bunch of text entries to manage a valid timestamp (date and time down to minute level). The object value is a unix timestamp (in localtime).

OBJECT HIERARCHY

  Gtk2::Ex::FormFactory::Intro

  Gtk2::Ex::FormFactory::Widget
  +--- Gtk2::Ex::FormFactory::Timestamp

  Gtk2::Ex::FormFactory::Layout
  Gtk2::Ex::FormFactory::Rules
  Gtk2::Ex::FormFactory::Context
  Gtk2::Ex::FormFactory::Proxy

ATTRIBUTES

Attributes are handled through the common get_ATTR(), set_ATTR() style accessors, but they are mostly passed once to the object constructor and must not be altered after the associated FormFactory was built.

format = SCALAR [optional]

This is a format string to define which timestamp fields should be edited and how they should be displayed.

Format wildcards are defined as follows:

  %Y    Year, four digits
  %m    Month, two digits
  %d    Day of month, two digits
  %k    Hour of the day, two digits
  %M    Minutes, two digits

Everything else in the format string will be rendered as labels between the time field text entries.

The format string defaults to

  %d.%m.%Y %k:%M

All time fields which are not part of the format string will get a default value of 0.

For more attributes refer to Gtk2::Ex::FormFactory::Widget.

AUTHORS

 Jörn Reder <joern at zyn dot de>

COPYRIGHT AND LICENSE

Copyright 2004-2006 by Jörn Reder.

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Library General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

This library 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 Library General Public License for more details.

You should have received a copy of the GNU Library General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307 USA.