PX_TIME2STRING(3)

💖 PX_TIME2STRING(3) — the library functions manual page, but make it cute 💖

okay bestie, so this is the manual page for PX_time2string from the Library Functions Manual section 3. yes it's a real manpage and yes we're gonna read it together, grab a boba 🧋

✨ NAME ✨

PX_time2string — literally converts a paradox time into a formatted string. that's the whole job. she's focused. 💅

🌸 SYNOPSIS 🌸

#include <paradox.h>

char * PX_time2string(pxdoc_t *pxdoc, long time, const char *format)

look at her signature, so clean, so iconic 👑

🦋 DESCRIPTION 🦋

so what she does is: she creates a string representation of a paradox time, exactly the way you asked for it in the format parameter. the way that she's just handing you a string version of a time, no cap.

now where do you even get that time from, bestie? two options, both valid:

• grab it with PX_get_data_long(3) after you've called PX_get_record(3), or
• just use the long value sitting right there in the pxval_t struct that PX_retrieve_record(3) hands back to you. lowkey the easier path ngl.

internally she's using the PX_timestamp2string(3) function to do the heavy lifting. she's not out here reinventing anything, she's delegating. main character energy but collaborative. 🫶

about that format string: it can contain all the chars that are documented over in PX_timestamp2string(3). BUT — and this is important, so listen — only the ones that concern the time will actually produce reasonable results. the rest are just kinda there, vibing, doing nothing. 🙈

fr fr, don't expect the date-y format chars to do anything useful here. time only. periodt.

💀 RETURN VALUE 💀

• on success → she returns a pointer to the string 💖
• on failure → you get NULL 😭

that's it. no in-between. she either ate or she didn't.

👑 SEE ALSO 👑

• PX_timestamp2string(3)
• PX_date2string(3)

go read those too, they're the siblings, the whole family is slaying 🌈

🎀 AUTHOR 🎀

this manual page was written by Uwe Steinmann uwe@steinmann.cx. give them their flowers 💐

sign-off time bestie ✨ this lil masterpiece lives in the Library Functions Manual, she's page PX_TIME2STRING(3), and yeah the footer is just her name again because she's that girl. mwah 💋 slay, go format some times 💅🦋🌸