DM_DATE(1)

📦
version 7.00 · 9 versions
, in fedora 43, fedora 44

💖 dm_date — the date command but make it Date::Manip 💖

okay bestie so real talk: this is the <rainbow>dm_date</rainbow> manual page, and she's giving unix date command, but with the Date::Manip glow-up. same energy, different engine, no cap. 🫶

✨ SYNOPSIS ✨

she does the exact same thing the unix date command does, except she's running on the Date::Manip module underneath. same job, fancier internals, periodt.

dm_date [OPTION]... [+FORMAT]

🌸 DESCRIPTION 🌸

dm_date shows you the tea about the current system time... or literally any other time you wanna ask about, because she's flexible like that. 💅

here's the whole option menu, no skips, no crumbs left behind:

  • -h, --help — prints the online help. that's it, that's the whole vibe. 🙈
  • -d STRING, --date=STRING — shows the time described by STRING. and bestie, STRING can be any string that Date::Manip can parse — she's not picky. for the deets, go read the Date::Manip::Date documentation. 💖
  • -f DATEFILE, --file=DATEFILE — reads every line in DATEFILE, pulls a date out of each one, and prints out the info. super chill about what she skips, too:
    • blank lines? ignored. 🦋
    • lines starting with a pound (#)? ignored. 💜
    • lines that don't contain a valid date? also ignored, no judgement. 😌
  • -r FILE, --reference=FILE — shows you the last modification time of FILE. like checking when your bestie last texted, but for files. 🎀
  • -R, --rfc-2822 — displays the date and time in RFC 2822 format. fancy formal fit, but cute:
    • example: Mon, 07 Aug 2006 12:34:56 -0600
  • -u, --utc, --universal — converts the date to UT (GMT) and prints out the info. timezone-hopping, main character energy. 🌈
okay so important: only ONE of -d, -f, or -r should be included at a time. if you go feral and pass more than one, she uses the first one from that list (-d, -f, -r, in that order) and ignores the rest. pick a lane bestie. 💀

and about the format string: it starts with a plus (+) and contains any of the format directives described in Date::Manip::Date. that's where the customization lives. ✨

🫶 KNOWN BUGS 🫶

none known. she's flawless. not a single one. 😭✨

💌 BUGS AND QUESTIONS 💌

got beef? got questions? wanna submit a bug report? please refer to the Date::Manip::Problems documentation for the info on how to submit bug reports or questions to the author. she's got a whole system for it, respect the system. 🌸

👑 SEE ALSO 👑

  • Date::Manip::Date

📜 LICENSE 📜

this script is free software; you can redistribute it and/or modify it under the same terms as Perl itself. free as in freedom, slay. 💅

🎀 AUTHOR 🎀

Sullivan Beck (https://github.com/SBECK-github/)

and that's the whole page bestie!! this one shipped as part of perl v5.42.3, dated 2026-09-01 — so if you're reading this, hi from the future, hope your dates all parse on the first try. mwah. 🦋💖✨

📦 where this page comes from