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