PX_TIMESTAMP2STRING(3)

💖 PX_TIMESTAMP2STRING(3) 💖

okay bestie, welcome to the PX_timestamp2string page from the Library Functions Manual 🌸 this one is lowkey iconic, it's all about turning a paradox timestamp into a cute lil formatted string ✨

🎀 NAME 🎀

PX_timestamp2string — converts a paradox timestamp into a formatted string 💅

✨ SYNOPSIS ✨

#include <paradox.h>

char * PX_timestamp2string(pxdoc_t *pxdoc, double timestamp, const char *format)

🦋 DESCRIPTION 🦋

so basically, this function makes a string representation of a paradox timestamp, and it does it exactly how you tell it to in the format parameter 🫶

now, the timestamp you pass in has to come from one of two places, no exceptions:

• you grabbed it with PX_get_data_double(3) after calling PX_get_record(3), or
• you just used the double value straight out of the pxval_t struct that PX_retrieve_record(3) handed you

either way, a timestamp is giving both time and date energy — it's not one or the other, it's the whole package 💖

the format string is where the magic happens. it's full of chars, and each char stands for a specific value of the date/time. here's the whole list, no skips, no gatekeeping:

🔥 Characters and their meaning in date/time format string 🔥

• Y — year, numeric, 4 digits
• y — year, numeric, 2 digits
• m — month, numeric
• n — month, numeric, no leading zeroes
• d — day of the month, numeric
• j — day of the month, numeric, no leading zeros
• H — hour, numeric, 24 hour format
• h — hour, numeric, 12 hour format
• G — hour, numeric, 24 hour format, no leading zeroes
• g — hour, numeric, 12 hour format, no leading zeroes
• i — minutes, numeric
• s — seconds, numeric
• A — AM/PM
• a — am/pm
• L — boolean for leap year

and the rest? every other character just gets copied unmodified straight to the output string, no notes, no changes 💅

⚠️ but bestie listen — if you've got a special character that you do NOT want interpreted, you have to precede it with a backslash. otherwise it's getting read as a format char, periodt. 😭

🌈 RETURN VALUE 🌈

• returns a pointer to string on success 🎉
• returns NULL on failure 💀

👑 SEE ALSO 👑

• PX_time2string(3)
• PX_date2string(3)

🌸 AUTHOR 🌸

this manual page was written by Uwe Steinmann <uwe@steinmann.cx> 💜

and that's the whole page, bestie!! this one lives in the Library Functions Manual alongside PX_TIMESTAMP2STRING(3) — no date stamp on this baddie, it's timeless fr fr ✨ go format some timestamps, you're gonna ate 🫶💖