POM(1)

📦 version 1.053, in alpine 3.24

🌙 POM(1) — the moon phase bestie manual 🦋

okay so first things first: this is the User Contributed Perl Documentation page for POM(1), and honestly it's giving “tiny utility, huge main character energy.” We're talking about pom, bestie. ✨

🎀 NAME 🎀

pom — display the phase of the moon. No cap, that's literally the whole name. 🌙

🌟 SYNOPSIS 🌟

pom [-d] [-e] [[[[[[cc]yy]mm]dd]HH]]

💖 DESCRIPTION 💖

The pom utility displays the current phase of the moon. Iconic. This is useful for selecting software completion target dates, predicting managerial behavior, or determining thoth's current mood. :) Yes, really.

Pom will display the current moon phase, unless a new time is specified on the command line. The parameter's format is similar to the canonical representation used by date(1). iykyk 🫶

Pom has two modes: “standard” and “enhanced”. Standard mode presents a brief description of the moon's phase. It is the default. Enhanced mode shows the phase's date and time, the brief description, and an ASCII art representation of the moon's phase. ASCII moon art is highkey a vibe. 🌈

Current options, bestie:

  • -d — Enable debugging. This calculates phase information every hour for a month.
  • -e — Enable enhanced mode. Turns on the ASCII art feature.

👀 SEE ALSO 👀

Go check out date(1), bestie. That's the reference. 💅

💀 BUGS 💀

  • Times must be within the range of the Unix epoch.
  • The local timezone and coordinates are not considered.
  • Day validation does not consider the current month, or leap days.
  • The default character cell aspect ratio is likely to be wrong.
  • There is some jitter in the current calculations. It may only be noticeable while debugging.
  • The calculations in this version are a few percent different from the original pom.
fr fr, these are real caveats — read them before you trust the moon math too hard. 😭

🌸 ACKNOWLEDGEMENTS 🌸

A lot of the documentation was cribbed from the OpenBSD Reference Manual.

The moon phase calculations were ported from pcal, which is available from <ftp://www.decus.org/pub/lib/vs0174/pcal/>. slay, pcal. 🧚

Pom is Copyright 1999 Rocco Caputo <troc@netrus.net>. All rights reserved. Pom is free software; you may redistribute it and/or modify it under the same terms as Perl itself. periodt. 💛

okay that's the whole page, bestie 🫶 this is from perl v5.42.2, dated 2026-02-15, and it's the POM(1) manual — slay. 💅✨

📦 where this page comes from