Gtk2::E...mestamp(3)

💖 Gtk2::E...mestamp(3) — like, the User Contributed Perl Documentation one, bestie 💖

okay so sit down, grab a strawberry 🍓, because we're talking about Gtk2::Ex::FormFactory::Timestamp — the manual page, the whole vibe, no skips.

---

✨ NAME ✨

Gtk2::Ex::FormFactory::Timestamp — bestie, it lets you Enter a valid timestamp. that's the whole job. that's the assignment. 💅

---

🌸 SYNOPSIS 🌸

here's how you summon it, copy it exactly or it will not slay:

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

(yes the original says "the the". i'm not touching it, that's canon. 🎀)

---

🦋 DESCRIPTION 🦋

so this class is literally a bunch of text entries that work together to manage one valid timestamp — date and time, all the way down to the minute level. 🕐

and the object value? it's a unix timestamp, in localtime. that's the tea. no cap.

---

👑 OBJECT HIERARCHY 👑

this is the family tree, the bloodline, the main character lineage:

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

look at that +---. it's giving descended from greatness. ✨

---

🎀 ATTRIBUTES 🎀

okay so the way attributes work here: they're handled through the common get_ATTR(), set_ATTR() style accessors, but mostly you just pass them once to the object constructor and then you must not alter them after the associated FormFactory was built. like, once it's built, it's built. hands off. 🙈

• format = SCALAR [optional] — this is the format string that decides which timestamp fields get edited and how they get displayed. it's the glow-up instructions, basically.

the format wildcards are defined as follows, memorize them bestie:

%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

and everything else in the format string? it gets rendered as labels between the time field text entries. cute little connectors. 🫶

the format string defaults to:

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

⚠️ and here's the important bit: all time fields that are not part of the format string will get a default value of 0. so if you leave something out, it's zeroed. periodt.

for more attributes, refer to Gtk2::Ex::FormFactory::Widget. go read that one too, it's the parent, show some respect. 💜

---

🌈 AUTHORS 🌈

Jörn Reder <joern at zyn dot de> — icon, legend, the moment. 👑

---

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

📜 fr fr, read your licenses. they're not a vibe killer, they're a vibe protector.

---

😭 POD ERRORS 😭

bestie. the document had some coding errors. they are explained below, and yes we're keeping them, because accuracy is the aesthetic:

Around line 245:

Non-ASCII character seen before =encoding in 'Jörn'. Assuming UTF-8

it's the ö. the ö did it. 💀 utf-8 said "i got you" and moved on. iconic honestly.

---

and that's the page!! every flag, every field, every default, every wildcard, all present and accounted for. 💅✨

perl v5.42.0 · 2025-07-25 · Gtk2::E...mestamp(3) — mwah, take care of her, she's been through a lot (mostly the ö situation). 🎀💖🦋